o khi@stdZddlZddlZddlZddlZddlmZddlmZe e Z   d ddZ    d ddZ d d ZdS) aw lml.loader ~~~~~~~~~~~~~~~~~~~ Plugin discovery module. It supports plugins installed via pip tools and pyinstaller. :func:`~lml.loader.scan_plugins` is expected to be called in the main package of yours at an earliest time of convenience. :copyright: (c) 2017-2018 by Onni Software Ltd. :license: New BSD License, see LICENSE for more details N)chain) do_importcCs&d|}tdt||||ddS)a Implicitly discover plugins via pkgutil and pyinstaller path Parameters ----------------- prefix:string module prefix. This prefix should become the prefix of the module name of all plugins. In the tutorial, robotchef-britishcuisine is a plugin package of robotchef and its module name is 'robotchef_britishcuisine'. When robotchef call scan_plugins to load its cuisine plugins, it specifies its prefix as "robotchef_". All modules that starts with 'robotchef_' will be auto-loaded: robotchef_britishcuisine, robotchef_chinesecuisine, etc. pyinstaller_path:string used in pyinstaller only. When your end developer would package your main library and its plugins using pyinstaller, this path helps pyinstaller to find the plugins. black_list:list a list of module names that should be skipped. white_list:list a list of modules that comes with your main module. If you have a built-in module, the module name should be inserted into the list. For example, robot_cuisine is a built-in module inside robotchef. It is listed in white_list. z^%s.+$z?Deprecated! since version 0.0.3. Please use scan_plugins_regex!)plugin_name_patternspyinstaller_path black_list white_listN)warningswarnscan_plugins_regex)prefixrrrr__plugin_name_patternsr ss z%scan_plugins_regex..zignored z scanning done)logdebugpkgutil iter_modulesscan_from_pyinstallerrr ImportError) rrrr module_namesmodule_names_from_pyinstaller all_modules module_nameer rrr Js6 !     r ccsVt}ddttj|DD]}||O}q|D]}d|vrqt||r(|VqdS)z+ Discover plugins from pyinstaller css |] }t|dr|jVqdS)tocN)hasattrr#)rimporterr r rrs z(scan_from_pyinstaller...N)setmapr get_importerrr)rpathtable_of_contenta_tocr!r r rrs   r)NNN)NNNN)__doc__rloggingrr itertoolsr lml.utilsr getLogger__name__rrr rr r r rs$     4 L