ó —‰]c@s ddlZddlZddlmZddlmZddlmZmZm Z m Z ddl Z ej ddfkrŽddl mZn ddlZd „Zd efd „ƒYZd efd „ƒYZdefd„ƒYZeedƒrd„Zn d„ZdS(iÿÿÿÿNi(t_tracing(t_Result(tHookImplt _HookRelayt _HookCallertnormalize_hookimpl_optsii(tmetadatacCs2tj|t|ƒd|jjd|jjƒdS(Ntlinenotfilename(twarningst warn_explicitttypet__code__tco_firstlinenot co_filename(twarningtfunction((s-lib/python2.7/site-packages/pluggy/manager.pyt_warn_for_functions   tPluginValidationErrorcBseZdZd„ZRS(sŽ plugin failed validation. :param object plugin: the plugin which failed validation, may be a module or an arbitrary object. cCs#||_tt|ƒj|ƒdS(N(tplugintsupert Exceptiont__init__(tselfRtmessage((s-lib/python2.7/site-packages/pluggy/manager.pyRs (t__name__t __module__t__doc__R(((s-lib/python2.7/site-packages/pluggy/manager.pyRst DistFacadecBs;eZdZd„Zed„ƒZdd„Zd„ZRS(s$Emulate a pkg_resources DistributioncCs ||_dS(N(t_dist(Rtdist((s-lib/python2.7/site-packages/pluggy/manager.pyR&scCs |jdS(Ntname(R(R((s-lib/python2.7/site-packages/pluggy/manager.pyt project_name)scCst|j||ƒS(N(tgetattrR(Rtattrtdefault((s-lib/python2.7/site-packages/pluggy/manager.pyt __getattr__-scCstt|jƒddgƒS(NRR (tsortedtdirR(R((s-lib/python2.7/site-packages/pluggy/manager.pyt__dir__0sN( RRRRtpropertyR tNoneR$R'(((s-lib/python2.7/site-packages/pluggy/manager.pyR#s   t PluginManagercBsõeZdZdd„Zd„Zdd„Zd„Zddd„Zd„Z d„Z d„Z d „Z d „Z d „Zd „Zd „Zd„Zd„Zd„Zd„Zdd„Zd„Zd„Zd„Zd„Zd„Zd„ZRS(s Core Pluginmanager class which manages registration of plugin objects and 1:N hook calling. You can register new hooks by calling ``add_hookspecs(module_or_class)``. You can register plugin objects (which contain hooks) by calling ``register(plugin)``. The Pluginmanager is initialized with a prefix that is searched for in the names of the dict of registered plugin objects. For debugging purposes you can call ``enable_tracing()`` which will subsequently send debug information to the trace helper. cCs†||_i|_i|_g|_tjƒjdƒ|_tƒ|_ |dk rmt j dt ddƒn||_d„|_dS(suIf ``implprefix`` is given implementation functions will be recognized if their name matches the implprefix. t pluginmanagesySupport for the `implprefix` arg is now deprecated and will be removed in an upcoming release. Please use HookimplMarker.t stacklevelicSs4|j||d|jr-|jjjdƒntƒS(Nt firstresult(t multicalltspectoptstgettFalse(thooktmethodstkwargs((s-lib/python2.7/site-packages/pluggy/manager.pytSsN(R t _name2plugint_plugin2hookcallerst_plugin_distinfoRt TagTracerR1ttraceRR3R)R twarntDeprecationWarningt _implprefixt_inner_hookexec(RR t implprefix((s-lib/python2.7/site-packages/pluggy/manager.pyRBs        cCs|j|||ƒS(N(R?(RR3R4R5((s-lib/python2.7/site-packages/pluggy/manager.pyt _hookexecYsc Csˆ|p|j|ƒ}||jks3||jkrq|jj|dƒdkrRdStd|||jfƒ‚n||j|t startswithRR=(RRRRNtres((s-lib/python2.7/site-packages/pluggy/manager.pyRDƒs    ' cCs¤|dkr6|dk s$tdƒ‚|j|ƒ}n|dkrT|j|ƒ}n|jj|ƒrs|j|=nx*|jj|gƒD]}|j|ƒq‰W|S(sn unregister a plugin object and all its contained hook implementations from internal data structures. s+one of name or plugin needs to be specifiedN( R)tAssertionErrortget_namet get_pluginR7R1R8tpopt_remove_plugin(RRRt hookcaller((s-lib/python2.7/site-packages/pluggy/manager.pyt unregisteršs   cCs!|jd|ƒd|j| Return name for registered plugin or None if not registered. N(R7titems(RRRtval((s-lib/python2.7/site-packages/pluggy/manager.pyRYès cCs¼|jƒr:|jr:t|jd|j|jfƒ‚n|jjr_t|jj|j ƒnt |j ƒt |jj ƒ}|r¸t|jd|j|jt |j ƒ|fƒ‚ndS(Ns6Plugin %r hook %r historic incompatible to hookwrappers~Plugin %r for hook %r hookimpl definition: %s Argument(s) %s are declared in the hookimpl but can not be found in the hookspec( t is_historict hookwrapperRRRKRR/t warn_on_implRRRktargnamest _formatdef(RR3ROt notinspec((s-lib/python2.7/site-packages/pluggy/manager.pyRGîs   cCs‘xŠ|jjD]|}|ddkr t|j|ƒ}|jƒs‰xB|jƒD]1}|jsNt|jd||jfƒ‚qNqNWq‰q q WdS(sŒ Verify that all hooks which have not been verified against a hook specification are optional, otherwise raise PluginValidationErrorit_sunknown hook %r in plugin %rN(R3t__dict__R!RFRct optionalhookRR(RRR3RO((s-lib/python2.7/site-packages/pluggy/manager.pyt check_pendings  cCsÑd}xÄtjƒD]¶}x­|jD]¢}|j|ks#|dk rS|j|ks#|j|jƒs#|j|jƒr}q#n|jƒ}|j |d|jƒ|j j |t |ƒfƒ|d7}q#WqW|S(s+ Load modules from querying the specified setuptools ``group``. :param str group: entry point group to load plugins :param str name: if given, loads only plugins with the given ``name``. :rtype: int :return: return the number of loaded plugins by this call. iRiN( timportlib_metadatat distributionst entry_pointstgroupR)RRZR`tloadRPR9RJR(RR€RtcountRtepR((s-lib/python2.7/site-packages/pluggy/manager.pytload_setuptools_entrypointss cCs t|jƒS(sV return list of distinfo/plugin tuples for all setuptools registered plugins. (tlistR9(R((s-lib/python2.7/site-packages/pluggy/manager.pytlist_plugin_distinfo/scCst|jjƒƒS(s# return list of name/plugin pairs. (R…R7Rq(R((s-lib/python2.7/site-packages/pluggy/manager.pytlist_name_plugin4scCs|jj|ƒS(s0 get all hook callers for the specified plugin. (R8R1(RR((s-lib/python2.7/site-packages/pluggy/manager.pytget_hookcallers8scs=ˆj‰‡‡‡fd†}|ˆ_‡‡fd†}|S(sB add before/after tracing functions for all hooks and return an undo function which, when called, will remove the added tracers. ``before(hook_name, hook_impls, kwargs)`` will be called ahead of all hook calls and receive a hookcaller instance, a list of HookImpl instances and the keyword arguments for the hook call. ``after(outcome, hook_name, hook_impls, kwargs)`` receives the same arguments as ``before`` but also a :py:class:`_Result`` object which represents the result of the overall hook call. csTˆˆjˆˆƒtj‡‡‡‡fd†ƒ}ˆ|ˆjˆˆƒ|jƒS(NcsˆˆˆˆƒS(N(((R3t hook_implsR5toldcall(s-lib/python2.7/site-packages/pluggy/manager.pyR6Mt(RRt from_callt get_result(R3R‰R5toutcome(taftertbeforeRŠ(R3R‰R5s-lib/python2.7/site-packages/pluggy/manager.pyttraced_hookexecKs!cs ˆˆ_dS(N(R?((RŠR(s-lib/python2.7/site-packages/pluggy/manager.pytundoSs(R?(RRRR‘R’((RRRŠRs-lib/python2.7/site-packages/pluggy/manager.pytadd_hookcall_monitoring<s  csC|jjjdƒ‰‡fd†}‡fd†}|j||ƒS(s; enable tracing of hook calls and return an undo function. R3cs#ˆjjd7_ˆ||ƒdS(Ni(troottindent(t hook_nameR4R5(t hooktrace(s-lib/python2.7/site-packages/pluggy/manager.pyR\scsA|jdkr+ˆd|d|jƒƒnˆjjd8_dS(Ntfinishs-->i(texcinfoR)RR”R•(RŽR–R4R5(R—(s-lib/python2.7/site-packages/pluggy/manager.pyR`s(R;R”R1R“(RRR((R—s-lib/python2.7/site-packages/pluggy/manager.pytenable_tracingXsc CsÇt|j|ƒ}g|D]}t||ƒr|^q}|rÃt|j|j|jj|jjƒ}xU|j ƒD]G}|j }||krt|j |ƒ|j j |gƒj|ƒqtqtW|S|S(s› Return a new _HookCaller instance for the named method which manages calls to all registered plugins except the ones from remove_plugins. (R!R3thasattrRRRAR/t namespaceR0RcRRIR8t setdefaultRJ( RRtremove_pluginstorigtplugtplugins_to_removeRgROR((s-lib/python2.7/site-packages/pluggy/manager.pytsubset_hook_callergs($   #N(RRRR)RRARPRDR^R_R`RiRaRlRmRBRZRpRYRGR|R„R†R‡RˆR“RšR¢(((s-lib/python2.7/site-packages/pluggy/manager.pyR*4s2    %                   t signaturecCs d|jttj|ƒƒfS(Ns%s%s(RRnRRR£(tfunc((s-lib/python2.7/site-packages/pluggy/manager.pyRw~scCs#d|jtjtj|ƒŒfS(Ns%s%s(RRRt formatargspect getargspec(R¤((s-lib/python2.7/site-packages/pluggy/manager.pyRw„s(RRtsysR‹RtcallersRthooksRRRRR t version_infot importlibRR}RRRtobjectRR*R›Rw(((s-lib/python2.7/site-packages/pluggy/manager.pyts  "    ÿI