ó „¾^Yc@s"dZddlZddlZddlZddlmZddlmZddlmZej e ƒZ dZ e ƒZde fd „ƒYZd e fd „ƒYZd „Zde fd„ƒYZde fd„ƒYZdefd„ƒYZdeefd„ƒYZd efd„ƒYZdS(s0Plugin loading and management logic and classes.iÿÿÿÿN(t exceptions(tutils(tnotifiertCheckerst ListenerstPlugint PluginManagertReportFormatterscBsÚeZdZd„Zd„Zd„Zd„Zd„Zed„ƒZ ed„ƒZ ed„ƒZ ed „ƒZ ed „ƒZ ed „ƒZd „Zd „Zed„Zdd„Zd„Zd„Zd„ZRS(s3Wrap an EntryPoint from setuptools and other logic.cCsL||_||_d|_d|_d|_d|_d|_d|_dS(s "Initialize our Plugin. :param str name: Name of the entry-point as it was registered with setuptools. :param entry_point: EntryPoint returned by setuptools. :type entry_point: setuptools.EntryPoint N( tnamet entry_pointtNonet_plugint _parameterst_parameter_namest_groupt _plugin_namet_version(tselfRR ((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyt__init__s       cCsdj|j|jƒS(s:Provide an easy to read description of the current plugin.s%Plugin(name="{0}", entry_point="{1}")(tformatRR (R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyt__repr__.scCs6i|jd6|jd6|jd6|jd6|jd6S(s$Convert this plugin to a dictionary.Rt parameterstparameter_namestplugint plugin_name(RRRRR(R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyt to_dictionary4s     cCs|jƒdk S(s£Determine if this plugin is in a group. :returns: True if the plugin is in a group, otherwise False. :rtype: bool N(tgroupR (R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyt is_in_a_group>scCsl|jdkrR|jjddƒ}t|ƒdkrF|d|_qRt|_n|jtkredS|jS(s*Find and parse the group the plugin is in.t.iiN(RR RtsplittlentNO_GROUP_FOUND(RR((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRHs cCs+|jdkr$tj|ƒ|_n|jS(s7List of arguments that need to be passed to the plugin.N(R R Rtparameters_for(R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRTscCs+|jdkr$t|jƒ|_n|jS(s<List of argument names that need to be passed to the plugin.N(R R tlistR(R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyR[scCs|jƒ|jS(sThe loaded (and cached) plugin associated with the entry-point. This property implicitly loads the plugin and then caches it. (t load_pluginR (R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRbs cCsF|jdkr?|jƒr-t|ƒ|_q?|jj|_n|jS(s!Return the version of the plugin.N(RR Rt version_forRtversion(R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyR$ks  cCsF|jdkr?|jƒr-|jƒ|_q?|jj|_n|jS(sReturn the name of the plugin.N(RR RRRR(R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRvs  cCst|jdtƒS(s0Return whether the plugin is ignored by default.toff_by_default(tgetattrRtFalse(R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyR%scOs|j||ŽS(s+Call the plugin with \*args and \*\*kwargs.(R(Rtargstkwargs((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytexecute†scCs¼t|jddƒ}t|jddƒ}|rh|rh|rYtjd|jƒ|ƒn|ƒ|_n|jjd|ƒ|_t|jƒs¸d|j}tj |ƒt |ƒ‚ndS(Ntresolvetrequires%Verifying plugin "%s"'s requirements.stPlugin %r is not a callable. It might be written for an older version of flake8 and might not work with this version( R&R R tLOGtdebugRR tloadtcallabletcriticalt TypeError(Rtverify_requirementsR+R,tmsg((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyt_loadŠs        cCsŽ|jdkrŠtjd|jƒy|j|ƒWqŠtk r†}tj|ƒtj d|d|ƒ}tj t |ƒƒ|‚qŠXndS(s§Retrieve the plugin for this entry-point. This loads the plugin, stores it on the instance and then returns it. It does not reload it after the first time, it merely returns the cached plugin. :param bool verify_requirements: Whether or not to make setuptools verify that the requirements for the plugin are satisfied. :returns: Nothing s%Loading plugin "%s" from entry-point.Rt exceptionN( R R R-tinfoRR5t ExceptionR6RtFailedToLoadPluginR1tstr(RR3tload_exceptiontfailed_to_load((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyR"Ÿs    cCsx|j|jgƒ|j|jgƒ|s0dSy|jj|jƒWn*ttfk rstjd|jƒnXdS(s0Remove plugin name from the default ignore list.NsPAttempted to remove %s from the ignore list but it was not a member of the list.( tremove_from_default_ignoreRtextend_default_selecttignoretremovet ValueErrortKeyErrorR-R.(Rt optmanagertoptions((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytenable¹s cCs|j|jgƒdS(s/Add the plugin name to the default ignore list.N(textend_default_ignoreR(RRC((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytdisableÅscCs’t|jddƒ}|dk ritjd|jƒy||||ƒWqitk re||ƒqiXn|j|jkrŽ|j||ƒndS(s:Pass the parsed options and extra arguments to the plugin.t parse_optionss!Providing options to plugin "%s".N( R&RR R-R.RR2tenable_extensionsRE(RRCRDt extra_argsRH((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytprovide_optionsÉs  cCsat|jddƒ}|dk rDtjd|j|ƒ||ƒn|jr]|j|ƒndS(sRegister the plugin's command-line options on the OptionManager. :param optmanager: Instantiated OptionManager to register options on. :type optmanager: flake8.options.manager.OptionManager :returns: Nothing t add_optionss8Registering options from plugin "%s" on OptionManager %rN(R&RR R-R.RR%RG(RRCRL((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytregister_optionsÖs     N(t__name__t __module__t__doc__RRRRRtpropertyRRRR$RR%R*R5R'R"R RERGRKRM(((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRs&           cBs5eZdZed„Zd„Zd„Zd„ZRS(s%Find and manage plugins consistently.cCs2||_||_i|_g|_|jƒdS(s'Initialize the manager. :param str namespace: Namespace of the plugins to manage, e.g., 'flake8.extension'. :param bool verify_requirements: Whether or not to make setuptools verify that the requirements for the plugin are satisfied. N(t namespaceR3tpluginstnamest_load_all_plugins(RRRR3((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRïs    cCs}tjd|jƒxctj|jƒD]O}|j}t||ƒ|j|<|jj |ƒtj d|j||ƒq&WdS(NsLoading entry-points for "%s".sLoaded %r for plugin "%s".( R-R7RRt pkg_resourcestiter_entry_pointsRRRSRTtappendR.(RR R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRUþs  cos0x)|jD]}||j|||ŽVq WdS(sùCall ``func`` with the plugin and \*args and \**kwargs after. This yields the return value from ``func`` for each plugin. :param collections.Callable func: Function to call with each plugin. Signature should at least be: .. code-block:: python def myfunc(plugin): pass Any extra positional or keyword arguments specified with map will be passed along to this function after the plugin. The plugin passed is a :class:`~flake8.plugins.manager.Plugin`. :param args: Positional arguments to pass to ``func`` after each plugin. :param kwargs: Keyword arguments to pass to ``func`` after each plugin. N(RTRS(RtfuncR(R)R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytmapsccsgtƒ}xW|jD]L}|j|}|j}|j|krDqn|j|ƒ||jfVqWdS(s‘Generate the versions of plugins. :returns: Tuples of the plugin_name and version :rtype: tuple N(tsetRTRSRtaddR$(Rt plugins_seententry_point_nameRR((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytversionss    (RNRORPR'RRURZR_(((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRìs    cCsA|jj}yt|ƒ}Wntk r0dSXt|ddƒS(sÑDetermine the version of a plugin by it's module. :param plugin: The loaded plugin :type plugin: Plugin :returns: version string for the module :rtype: str t __version__N(RROt __import__t ImportErrorR R&(Rt module_nametmodule((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyR#1s  tPluginTypeManagercBsŒeZdZd Zd„Zd„Zd„Zd d„Ze d„ƒZ e d„ƒZ e d„ƒZ d„Zd „Zd „Zd „ZRS( s3Parent class for most of the specific plugin types.cCst|jƒ|_t|_dS(s%Initialize the plugin type's manager.N(RRRtmanagerR'tplugins_loaded(R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRLscCstjd|ƒ||jkS(s=Check if the entry-point name is in this plugin type manager.s)Checking for "%s" in plugin type manager.(R-R.RS(RR((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyt __contains__QscCstjd|ƒ|j|S(sRetrieve a plugin by its name.sRetrieving plugin for "%s".(R-R.RS(RR((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyt __getitem__VscCs||kr||S|S(sIRetrieve the plugin referred to by ``name`` or return the default. :param str name: Name of the plugin to retrieve. :param default: Default value to return. :returns: Plugin object referred to by name, if it exists. :rtype: :class:`Plugin` ((RRtdefault((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytget[s cCs |jjS(s&Proxy attribute to underlying manager.(RfRT(R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRTkscCs |jjS(s&Proxy attribute to underlying manager.(RfRS(R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRSpscs‡‡‡‡fd†}|S(NcsDt|ˆdƒ}|dk r@t|tjƒr@|ˆˆˆŽSdS(s=Function that attempts to call a specific method on a plugin.N(R&R t isinstancet collectionstCallable(Rtmethod(R(R)t method_nameRC(s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytgenerated_functionws ((RpRCR(R)Rq((R(R)RpRCs6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyt_generate_call_functionuscCs;|jr dSd„}t|jj|ƒƒ}t|_|S(s?Load all plugins of this type that are managed by this manager.NcSs |jƒS(s&Call each plugin's load_plugin method.(R"(R((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyR"„s(RgR!RfRZtTrue(RR"RS((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyt load_pluginss    cCsD|jƒx3|jjƒD]"\}}|jd|d|ƒqWdS(s?Register the plugins and their versions with the OptionManager.RR$N(RtRfR_tregister_plugin(RRCRR$((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytregister_plugin_versionss cCs6|jƒ|jd|ƒ}t|jj|ƒƒdS(s;Register all of the checkers' options to the OptionManager.RMN(RtRrR!RfRZ(RRCtcall_register_options((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRM“s  cCs2|jd|||ƒ}t|jj|ƒƒdS(s:Provide parsed options and extra arguments to the plugins.RKN(RrR!RfRZ(RRCRDRJtcall_provide_options((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRKœsN(RNRORPR RRRRhRiRkRQRTRSt staticmethodRrRtRvRMRK(((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyReGs       tNotifierBuilderMixincBseZdZd„ZRS(s8Mixin class that builds a Notifier from a PluginManager.cCs;tjƒ}x(|jD]}|j||j|ƒqW|S(sÚBuild a Notifier for our Listeners. :returns: Object to notify our listeners of certain error codes and warnings. :rtype: :class:`~flake8.notifier.Notifier` (RtNotifierRTtregister_listenerRf(Rt notifier_trieR((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytbuild_notifier¨s (RNRORPR~(((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRz¥scBs\eZdZdZd„Zd„Zd„Zed„ƒZed„ƒZ ed„ƒZ RS(s4All of the checkers registered through entry-ponits.sflake8.extensionccs9x2|jjƒD]!}||jdkr|VqqWdS(s“Retrieve checks that expect an argument with the specified name. Find all checker plugins that are expecting a specific argument. iN(RStvaluesR(Rt argument_nameR((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytchecks_expecting¼scCsmig|jD]}|jƒ^q d6g|jD]}|jƒ^q0d6g|jD]}|jƒ^qSd6S(s2Return a dictionary of AST and line-based plugins.t ast_pluginstlogical_line_pluginstphysical_line_plugins(R‚RRƒR„(RR((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRÅs##csH|jƒ|jdˆƒ‰‡‡fd†}t|jj|ƒƒdS(sÏRegister all of the checkers' options to the OptionManager. This also ensures that plugins that are not part of a group and are enabled by default are enabled on the option manager. RMcs:ˆ|ƒ|jƒdkr6|j r6|jˆƒndS(N(RR R%RE(R(RwRC(s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pytregister_and_enableãs N(RtRrR!RfRZ(RRCR…((RwRCs6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRMÓs  cCs=t|dgƒ}|s9t|jdƒƒ}||_n|S(s)List of plugins that expect the AST tree.t _ast_pluginsttree(R&R!RR†(RRS((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyR‚ês  cCs=t|dgƒ}|s9t|jdƒƒ}||_n|S(s.List of plugins that expect the logical lines.t_logical_line_pluginst logical_line(R&R!RRˆ(RRS((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRƒós  cCs=t|dgƒ}|s9t|jdƒƒ}||_n|S(s/List of plugins that expect the physical lines.t_physical_line_pluginst physical_line(R&R!RRŠ(RRS((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyR„üs  ( RNRORPRRRRRMRQR‚RƒR„(((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyR·s    cBseZdZdZRS(s5All of the listeners registered through entry-points.s flake8.listen(RNRORPRR(((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyRscBseZdZdZRS(s=All of the report formatters registered through entry-points.s flake8.report(RNRORPRR(((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyR s(sCheckerss ListenerssPlugins PluginManagersReportFormatters(RPRmtloggingRVtflake8RRtflake8.pluginsRt getLoggerRNR-t__all__tobjectRRRR#ReRzRRR(((s6/tmp/pip-build-EndXZ2/flake8/flake8/plugins/manager.pyts*    ÔE ^O