ó —‰]c@sdZddlZddlZddlZddlmZmZdefd„ƒYZdefd„ƒYZ d „Z e ed ƒrd „Z n d „Z e ed ƒo·ej jdkZd„Zdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdS(sA Internal hook annotation, representation and calling machinery. iÿÿÿÿNi(t_legacymulticallt _multicalltHookspecMarkercBs,eZdZd„Zdeedd„ZRS(s Decorator helper class for marking functions as hook specifications. You can instantiate it with a project_name to get a decorator. Calling PluginManager.add_hookspecs later will discover all marked functions if the PluginManager uses the same project_name. cCs ||_dS(N(t project_name(tselfR((s+lib/python2.7/site-packages/pluggy/hooks.pyt__init__scs6‡‡‡‡fd†}|dk r.||ƒS|SdS(sA if passed a function, directly sets attributes on the function which will make it discoverable to add_hookspecs(). If passed no function, returns a decorator which can be applied to a function later using the attributes supplied. If firstresult is True the 1:N hook call (N being the number of registered hook implementation functions) will stop at I<=N when the I'th function returns a non-None result. If historic is True calls to a hook will be memorized and replayed on later registered plugins. c sKˆrˆrtdƒ‚nt|ˆjdtdˆdˆdˆƒƒ|S(Ns'cannot have a historic firstresult hookt_spect firstresultthistorict warn_on_impl(t ValueErrortsetattrRtdict(tfunc(RRRR (s+lib/python2.7/site-packages/pluggy/hooks.pytsetattr_hookspec_opts&s   N(tNone(RtfunctionRRR R((RRRR s+lib/python2.7/site-packages/pluggy/hooks.pyt__call__s  N(t__name__t __module__t__doc__RRtFalseR(((s+lib/python2.7/site-packages/pluggy/hooks.pyR s tHookimplMarkercBs/eZdZd„Zdeeeed„ZRS(s  Decorator helper class for marking functions as hook implementations. You can instantiate with a project_name to get a decorator. Calling PluginManager.register later will discover all marked functions if the PluginManager uses the same project_name. cCs ||_dS(N(R(RR((s+lib/python2.7/site-packages/pluggy/hooks.pyRBscs9‡‡‡‡‡fd†}|dkr+|S||ƒSdS(sz if passed a function, directly sets attributes on the function which will make it discoverable to register(). If passed no function, returns a decorator which can be applied to a function later using the attributes supplied. If optionalhook is True a missing matching hook specification will not result in an error (by default it is an error if no matching spec is found). If tryfirst is True this hook implementation will run as early as possible in the chain of N hook implementations for a specification. If trylast is True this hook implementation will run as late as possible in the chain of N hook implementations. If hookwrapper is True the hook implementations needs to execute exactly one "yield". The code before the yield is run early before any non-hookwrapper function is run. The code after the yield is run after all non-hookwrapper function have run. The yield receives a ``_Result`` object representing the exception or result outcome of the inner calls (including other hookwrapper calls). c s6t|ˆjdtdˆdˆdˆdˆƒƒ|S(Nt_implt hookwrappert optionalhookttryfirstttrylast(R RR (R (RRRRR(s+lib/python2.7/site-packages/pluggy/hooks.pytsetattr_hookimpl_optses  N(R(RRRRRRR((RRRRRs+lib/python2.7/site-packages/pluggy/hooks.pyREs  N(RRRRRRR(((s+lib/python2.7/site-packages/pluggy/hooks.pyR:s cCsD|jdtƒ|jdtƒ|jdtƒ|jdtƒdS(NRRRR(t setdefaultR(topts((s+lib/python2.7/site-packages/pluggy/hooks.pytnormalize_hookimpl_optsxstgetfullargspeccCs tj|ƒS(N(tinspectR (R ((s+lib/python2.7/site-packages/pluggy/hooks.pyt _getargspecscCs tj|ƒS(N(R!t getargspec(R ((s+lib/python2.7/site-packages/pluggy/hooks.pyR"‡stpypy_version_infoicCs»t|diƒ}y |dSWntk r1nXtj|ƒrly |j}Wq¯tk rhd d fSXnCtj|ƒs¯yt|d|ƒ}Wq¯tk r«d d fSXnyt|ƒ}Wnt k rÙddfSXt |j ƒ|j }}|r$t |ƒ }|| t ||ƒ}}nd}ts6dnd}|r‰tj|ƒsydt|ddƒkr‰|d|kr‰|d }q‰ny||f|d(R?(R((s+lib/python2.7/site-packages/pluggy/hooks.pyt__repr__ scOs³|rtdƒ‚n|jƒ s(t‚|jrš|jjršt|jjƒtdgƒt|jƒƒ}|rštjdj t |ƒƒddƒqšn|j ||j ƒ|ƒS(Ns,hook calling supports only keyword argumentsRZsTArgument(s) {} which are declared in the hookspec can not be found in this hook callt stackleveli( R0RPRFR8RCtsettkeysR]R^tformatR1RBRY(RR2R:t notincall((s+lib/python2.7/site-packages/pluggy/hooks.pyRs/ cCs‘|dk r%tjdtƒ|}n|jj|p7i|fƒ|j||jƒ|ƒ}|dkrldSx|pxgD]}||ƒqyWdS(s\Call the hook with given ``kwargs`` for all registered plugins and for all plugins which will be registered afterwards. If ``result_callback`` is not ``None`` it will be called for for each non-None result obtained from a hook implementation. .. note:: The ``proc`` argument is now deprecated. sXSupport for `proc` argument is now deprecated and will beremoved in an upcoming release.N(RR]R^R_RNR\RBRY(Rtresult_callbackR:tproctrestx((s+lib/python2.7/site-packages/pluggy/hooks.pyt call_historic s   cCs”t|jƒt|jƒf}xK|D]C}tdtdtdtƒ}tdd||ƒ}|j|ƒq%Wz||SWd|\|_|_XdS(s} Call the hook with some additional temporarily participating methods using the specified kwargs as call parameters. RRRsN(tlistRAR@R RtHookImplRRb(RRaR:toldRVRR`((s+lib/python2.7/site-packages/pluggy/hooks.pyt call_extra;s cCsh|jƒrdxU|jD]G\}}|j||g|ƒ}|r|dk r||dƒqqWndS(sJApply call history to a new hookimpl if it is marked as historic. iN(RPRNRBR(RRVR:RiRk((s+lib/python2.7/site-packages/pluggy/hooks.pyt_maybe_apply_historyHs  N(RRRRRKRGRPRXRYRbRcRRmRqRr(((s+lib/python2.7/site-packages/pluggy/hooks.pyR>És        RocBseZd„Zd„ZRS(cCsS||_t|jƒ\|_|_||_||_||_|jj|ƒdS(N( RR<RCRDRRRt plugin_nameR%tupdate(RRRRsRthook_impl_opts((s+lib/python2.7/site-packages/pluggy/hooks.pyRSs     cCsd|j|jfS(Ns$(RsRR(R((s+lib/python2.7/site-packages/pluggy/hooks.pyRc[s(RRRRc(((s+lib/python2.7/site-packages/pluggy/hooks.pyRoRs RLcBseZd„ZRS(cCsx||_t||ƒ|_}||_t|ƒ\|_|_||_dgt|jƒ|_|j dƒ|_ dS(NRZR ( t namespaceR*RR?R<RCRDRRnRMR (RRvR?RR((s+lib/python2.7/site-packages/pluggy/hooks.pyR`s   (RRR(((s+lib/python2.7/site-packages/pluggy/hooks.pyRL_s(RR!tsysR]tcallersRRtobjectRRRROR"t version_infotmajorR5R<R=R>RoRL(((s+lib/python2.7/site-packages/pluggy/hooks.pyts    0>   ! 4‰