0Ic,dZddlZddlZddlZGddZGddZdZeedZd Z Gd d Z Gd d Z GddZ GddZ dS)zA Internal hook annotation, representation and calling machinery. Nc"eZdZdZdZ ddZdS)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||_dSN project_nameselfrs -lib/python3.11/site-packages/pluggy/_hooks.py__init__zHookspecMarker.__init__(NFc8fd}| ||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 rrtdt|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%se LK L !JKKK !G+ +%!-   Kr)r functionrrrrs` ``` r __call__zHookspecMarker.__call__sO"          )((22 2( (r)NFFN__name__ __module__ __qualname____doc__r rrrr rr sH)))NR")")")")")")rrc,eZdZdZdZ ddZdS)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||_dSrrr s r r zHookimplMarker.__init__Ar rNFc@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 ^t|jdzt|S)N_impl) hookwrapper optionalhooktryfirsttrylastspecname)rrr)rr(r)r r,r*r+s r setattr_hookimpl_optsz6HookimplMarker.__call__..setattr_hookimpl_optshsK !G+ +!-%#%    Krr)r rr(r)r*r+r,r-s` ````` r rzHookimplMarker.__call__Ds\H            3( (((22 2r)NFFFFNrrrr r#r#9sU))) 535353535353rr#c|dd|dd|dd|dd|dddS)Nr*Fr+r(r)r,) setdefault)optss r normalize_hookimpl_optsr1|slOOJ&&&OOIu%%%OOM5)))OONE***OOJ%%%%%rpypy_version_infocVtj|r |j}nI#t$rYdSwxYwtj|s$ t |d|}n#t $rYdSwxYw tj|}n#t$rYdSwxYwt|j |j }}|r2t| }|d|t||d}}nd}tsdnd}|r;tj|sdt |ddvr|d |vr |d d}||fS) 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 varnamesrJst  =DD   66   t $ $ 4T22DD   66 %d++ vv49%%t}(DXFUF|U4<%8%8f',@YYN   D ! !  7444 4 9=aN9R 8D <s0 ,,A A$#A$(A== B  B ceZdZdZdS) _HookRelayzghook holder object for performing 1:N hook calls where N is the number of registered plugins. N)rrr r!rrr rLrLsrrLcZeZdZddZdZdZdZdZdZdZ d Z d Z dd Z d Z d ZdS) _HookCallerNc||_g|_g|_||_d|_d|_||J|||dSdSr)name _wrappers _nonwrappers _hookexec _call_historyrFset_specification)r rP hook_executespecmodule_or_class spec_optss r r z_HookCaller.__init__sl %!  C ( ( (  " "#6 B B B B B C Crc|jduSr)rFr4s r has_specz_HookCaller.has_specsy$$rc|rJt||j||_|dr g|_dSdS)Nr)rZHookSpecrPrFgetrT)r rWrXs r rUz_HookCaller.set_specificationsX==??"""0$)YGG == $ $ $!#D    $ $rc|jduSr)rTr4s r is_historicz_HookCaller.is_historics!--rc|fd}||j#||jtdddSdS)NcTt|D]\}}|jkr||=dSdS)NT) enumerateplugin)wrappersimethodrcs r removez*_HookCaller._remove_plugin..removesJ&x00  6=F*   44   rzplugin z not found)rQrRr)r rcrgs ` r _remove_pluginz_HookCaller._remove_plugins{     6$. ! ! Avd'(( A !?6!?!?!?@@@ A A A Arc |j|jzSr)rRrQr4s r get_hookimplsz_HookCaller.get_hookimplss 4>11rcX|jr|j}n|j}|jr|d|dS|jr||dSt|dz }|dkr%||jr|dz}|dkr ||j||dz|dS)z,Add an implementation to the callback chain.rr7N)r(rQrRr+insertr*appendrC)r hookimplmethodsres r _add_hookimplz_HookCaller._add_hookimpls   (nGG'G   , NN1h ' ' ' ' '   , NN8 $ $ $ $ $G q Aq& WQZ0 Qq& WQZ0  NN1q5( + + + + +rcd|jdS)Nz <_HookCaller >)rPr4s r __repr__z_HookCaller.__repr__s-ty----rc|rtd|rJ|jr|jjD]l}||vrft t |jj|z }tjd |dnm|jj d}nd}| |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  LJKK K##%%%%% 9 9-  &( %c$)*<&=&= &M N NIM==CVI=N=N#$ E).,,];;KKK~~di););)=)=v{SSSrc|j|pi|f||j||d}|dS|pgD] }||dS)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 s !!6r)listrRrQrHookImplrp)r rorHoldrfr0rns r call_extraz_HookCaller.call_extras4$%%tDN';';; ) )FE55IIIDh==H   x ( ( ( ( 44>>&>>03 -D t~~ -D t~ 3 3 3 3s (A??Bc|r@|jD]:\}}||j|g|d}|r|||d9dSdS)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      ,+/+= , ,'nnTY&%HH,?,#OCF+++  , , , ,r)NN)rrr r rZrUr_rhrjrprsrrrrrrr rNrNs C C C C%%%$$$ ... A A A222,,,$...TTT. 4 4 4,,,,,rrNceZdZdZdZdS)rc||_t|j\|_|_||_||_||_|j|dSr) rrJrw kwargnamesrcr0 plugin_name__dict__update)r rcrrhook_impl_optss r r zHookImpl.__init__2sS  )1$-)@)@& t " & ^,,,,,rc(d|jd|jdS)Nzs#55555rr\)r!r8sysrzrr#r1hasattrrDrJrLrNrr\rrr rst -)-)-)-)-)-)-)-)`@3@3@3@3@3@3@3@3F&&& ())'''Tv,v,v,v,v,v,v,v,r V V V V V V V V5555555555r