Ae,dZddlZddlZddlZGddZGddZdZeedZd Z Gd d Z Gd d Z GddZ GddZ y)zA Internal hook annotation, representation and calling machinery. Nc eZdZdZdZ ddZy)HookspecMarkera,Decorator helper class for marking functions as hook specifications. You can instantiate it with a project_name to get a decorator. Calling :py:meth:`.PluginManager.add_hookspecs` later will discover all marked functions if the :py:class:`.PluginManager` uses the same project_name. c||_yN project_nameselfrs -lib/python3.12/site-packages/pluggy/_hooks.py__init__zHookspecMarker.__init__ (Nc2fd}|||S|S)akif passed a function, directly sets attributes on the function which will make it discoverable to :py:meth:`.PluginManager.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 rr r tdt|jdzt|S)Nz'cannot have a historic firstresult hook_spec) firstresulthistoric warn_on_impl) ValueErrorsetattrrdict)funcrrr rs r setattr_hookspec_optsz6HookspecMarker.__call__..setattr_hookspec_opts%sEK !JKK !!G+ +%!- Kr)r functionrrrrs` ``` r __call__zHookspecMarker.__call__s!"   (2 2( (r)NFFN__name__ __module__ __qualname____doc__r rrrr rr s)NR")rrc*eZdZdZdZ ddZy)HookimplMarkera)Decorator helper class for marking functions as hook implementations. You can instantiate with a ``project_name`` to get a decorator. Calling :py:meth:`.PluginManager.register` later will discover all marked functions if the :py:class:`.PluginManager` uses the same project_name. c||_yrrr s r r zHookimplMarker.__init__Ar rNc:fd}||S||S)a~if passed a function, directly sets attributes on the function which will make it discoverable to :py:meth:`.PluginManager.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 :py:class:`.callers._Result` object representing the exception or result outcome of the inner calls (including other hookwrapper calls). If ``specname`` is provided, it will be used instead of the function name when matching this hook implementation to a hook specification during registration. c Xt|jdzt|S)N_impl) hookwrapper optionalhooktryfirsttrylastspecname)rrr)rr(r)r r,r*r+s r setattr_hookimpl_optsz6HookimplMarker.__call__..setattr_hookimpl_optshs: !!G+ +!-%#%  Krr)r rr(r)r*r+r,r-s` ````` r rzHookimplMarker.__call__Ds'H    ( ((2 2r)NFFFFNrrrr r#r#9s%) 53rr#c|jdd|jdd|jdd|jdd|jddy)Nr*Fr+r(r)r,) setdefault)optss r normalize_hookimpl_optsr1|sHOOJ&OOIu%OOM5)OONE*OOJ%rpypy_version_infoctj|r |j}n#tj|s t |d|} tj|}t|j|j}}|r t| }|d|t||d}}nd}tsdnd}|r0tj|sdt |ddvr |d |vr|d d}||fS#t$rYywxYw#t $rYywxYw#t$rYywxYw) zReturn tuple of positional and keywrord argument names for a function, method, class or callable. In case of a class, its ``__init__`` method is considered. For methods the ``self`` parameter is not included. )rrrNrr )r obj.r r)inspectisclassr AttributeError isroutinegetattr Exceptiongetfullargspec TypeErrortupleargsdefaultslen_PYPYismethod)rspecrArBindexkwargsimplicit_namess r varnamesrJs"t ==D  t $ 4T2D%%d+499%t}}(DXFU|U4<%8f',YN   D ! 744 4aN9R8D <;      s4 C" C1D" C.-C.1 C=<C= D  D ceZdZdZy) _HookRelayzghook holder object for performing 1:N hook calls where N is the number of registered plugins. N)rrr r!rrr rLrLsrrLcXeZdZddZdZdZdZdZdZdZ d Z d Z dd Z d Z d Zy) _HookCallerNc||_g|_g|_||_d|_d|_||J|j ||yyr)name _wrappers _nonwrappers _hookexec _call_historyrFset_specification)r rP hook_executespecmodule_or_class spec_optss r r z_HookCaller.__init__sS %!  *( (  " "#6 B +rc|jduSr)rFr4s r has_specz_HookCaller.has_specsyy$$rc|jrJt||j||_|j drg|_yy)Nr)rZHookSpecrPrFgetrT)r rWrXs r rUz_HookCaller.set_specifications<==?"0$))YG == $!#D  %rc|jduSr)rTr4s r is_historicz_HookCaller.is_historics!!--rcxfd}||j"||jtddyy)NcTt|D]\}}|jk(s||=yy)NT) enumerateplugin)wrappersimethodrcs r removez*_HookCaller._remove_plugin..removes1&x0 6==F*   rzplugin z not found)rQrRr)r rcrgs ` r _remove_pluginz_HookCaller._remove_pluginsH $.. ! )d''(0 76*J!?@@1 *rc4|j|jzSr)rRrQr4s r get_hookimplsz_HookCaller.get_hookimplss  4>>11rcj|jr |j}n |j}|jr|j d|y|j r|j |yt|dz }|dk\r)||j r|dz}|dk\r||j r|j |dz|y)z,Add an implementation to the callback chain.rr7N)r(rQrRr+insertr*appendrC)r hookimplmethodsres r _add_hookimplz_HookCaller._add_hookimpls   nnG''G    NN1h '    NN8 $G q Aq&WQZ00Qq&WQZ00 NN1q5( +rc"d|jdS)Nz <_HookCaller >)rPr4s r __repr__z_HookCaller.__repr__styym1--rc|r td|jrJ|jr|jjD]g}||vst t |jj|j z }tjdj|dn|jjjd}nd}|j|j|j||S)Nz,hook calling supports only keyword argumentszTArgument(s) {} which are declared in the hookspec can not be found in this hook call) stacklevelrF)r?r_rFargnamesr@setkeyswarningswarnformatr0r]rSrPrj)r rArHargname notincallrs r rz_HookCaller.__call__s JK K##%% 9999-- &( %c$))*<*<&= &M NIMM==CVI=N#$  ))..,,];KK~~dii););)=v{SSrc|jj|xsi|f|j|j|j |d}|y|xsgD] }|| y)aCall 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. FN)rTrmrSrPrj)r result_callbackrHresxs r call_historicz_HookCaller.call_historic sh !!6r)listrRrQrHookImplrp)r rorHoldrfr0rns r call_extraz_HookCaller.call_extras4$$%tDNN';; )FE55IDh=H   x ( ) 4>&>03 -D t~ -D t~s A77Bc|jrE|jD]5\}}|j|j|g|d}|s(|+||d7yy)zAApply call history to a new hookimpl if it is marked as historic.FNr)r_rTrSrP)r rfrHrrs r _maybe_apply_historyz _HookCaller._maybe_apply_history(s[    +/+=+= ,'nnTYY&%H?6#CF+ , r)NN)rrr r rZrUr_rhrjrprsrrrrrrr rNrNsA C%$ . A2,$.T. 4,rrNceZdZdZdZy)rc||_t|j\|_|_||_||_||_|jj|yr) rrJrw kwargnamesrcr0 plugin_name__dict__update)r rcrrhook_impl_optss r r zHookImpl.__init__2sH  )1$--)@& t " & ^,rc<d|jd|jdS)Nzs5rr\)r!r8sysrzrr#r1hasattrrDrJrLrNrr\rrr rst -)-)`@3@3F& ()'Tv,v,r V V55r