Bj2UdZddlmZddlmZddlmZddlZddlZddlZddlm Z ddl m Z ddl m Z dd l m Z dd l mZdd l mZddlZd d lmZd dlmZededefZe ezZded<e GddZe GddZej6j8dk(ZerdndZeddhZ ded<dd  d$d!Z!e Gd"d#Z"y)%z4 Hook markers, specifications, and related helpers. ) annotations)Callable)MappingN) ModuleType)Final)final)overload) TypeAlias)TypeVar) HookimplOpts) HookspecOpts_F.)boundr _NamespaceceZdZdZdZddZe d d dZe d d dZ d ddZy)HookspecMarkeraDecorator for marking functions as hook specifications. Instantiate it with a project_name to get a decorator. Calling :meth:`PluginManager.add_hookspecs` later will discover all marked functions if the :class:`PluginManager` uses the same project name.  project_namec||_yNrselfrs U/root/repos/pocs/video-evals/.venv/lib/python3.12/site-packages/pluggy/_decorators.py__init__zHookspecMarker.__init__( #/Ncyrrfunction firstresulthistoric warn_on_implwarn_on_impl_argss r__call__zHookspecMarker.__call__+srcyrrr s rr&zHookspecMarker.__call__5s!rc8dfd }|||S|S)awIf passed a function, directly sets attributes on the function which will make it discoverable to :meth:`PluginManager.add_hookspecs`. If passed no function, returns a decorator which can be applied to a function later using the attributes supplied. :param firstresult: If ``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. See :ref:`firstresult`. :param historic: If ``True``, every call to the hook will be memorized and replayed on plugins registered after the call was made. See :ref:`historic`. :param warn_on_impl: If given, every implementation of this hook will trigger the given warning. See :ref:`warn_on_impl`. :param warn_on_impl_args: If given, every implementation of this hook which requests one of the arguments in the dict will trigger the corresponding warning. See :ref:`warn_on_impl`. .. versionadded:: 1.5 chr r tdd}t|jdz||S)Nz'cannot have a historic firstresult hook)r"r#r$r%_spec) ValueErrorsetattrr)funcoptsr"r#rr$r%s rsetattr_hookspec_optsz6HookspecMarker.__call__..setattr_hookspec_optsbsEK !JKK*$ ,%6 "D D$++g5t <Krr-rreturnrr)rr!r"r#r$r%r/s` ```` rr&zHookspecMarker.__call__?s'F    (2 2( (rrstrr1None)FFNN) r!rr"boolr#r5r$Warning | Noner%Mapping[str, Warning] | Noner1r).....) r!r4r"r5r#r5r$r6r%r7r1Callable[[_F], _F])NFFNN) r! _F | Noner"r5r#r5r$r6r%r7r1_F | Callable[[_F], _F]__name__ __module__ __qualname____doc__ __slots__rr r&rrrrrs"I0"'+:>   %  8  '*:= !!! ! % ! 8 ! !!#!'+:> 2)2)2) 2) % 2) 8 2) !2)rrceZdZdZdZddZe d d dZe d d dZ d ddZy)HookimplMarkeraDecorator for marking functions as hook implementations. Instantiate it with a ``project_name`` to get a decorator. Calling :meth:`PluginManager.register` later will discover all marked functions if the :class:`PluginManager` uses the same project name. rc||_yrrrs rrzHookimplMarker.__init__rrcyrrrr! hookwrapper optionalhooktryfirsttrylastspecnamewrappers rr&zHookimplMarker.__call__srcyrrrEs rr&zHookimplMarker.__call__s!rNc@dfd }||S||S)a If passed a function, directly sets attributes on the function which will make it discoverable to :meth:`PluginManager.register`. If passed no function, returns a decorator which can be applied to a function later using the attributes supplied. :param optionalhook: If ``True``, a missing matching hook specification will not result in an error (by default it is an error if no matching spec is found). See :ref:`optionalhook`. :param tryfirst: If ``True``, this hook implementation will run as early as possible in the chain of N hook implementations for a specification. See :ref:`callorder`. :param trylast: If ``True``, this hook implementation will run as late as possible in the chain of N hook implementations for a specification. See :ref:`callorder`. :param wrapper: If ``True`` ("new-style hook wrapper"), the hook implementation needs to execute exactly one ``yield``. The code before the ``yield`` is run early before any non-hook-wrapper function is run. The code after the ``yield`` is run after all non-hook-wrapper functions have run. The ``yield`` receives the result value of the inner calls, or raises the exception of inner calls (including earlier hook wrapper calls). The return value of the function becomes the return value of the hook, and a raised exception becomes the exception of the hook. See :ref:`hookwrapper`. :param hookwrapper: If ``True`` ("old-style hook wrapper"), the hook implementation needs to execute exactly one ``yield``. The code before the ``yield`` is run early before any non-hook-wrapper function is run. The code after the ``yield`` is run after all non-hook-wrapper function have run The ``yield`` receives a :class:`Result` object representing the exception or result outcome of the inner calls (including earlier hook wrapper calls). This option is mutually exclusive with ``wrapper``. See :ref:`old_style_hookwrapper`. :param specname: If provided, the given name will be used instead of the function name when matching this hook implementation to a hook specification during registration. See :ref:`specname`. .. versionadded:: 1.2.0 The ``wrapper`` parameter. cNd}t|jdz||S)N)rKrFrGrHrIrJ_impl)r,r) r-r.rFrGrrJrHrIrKs rsetattr_hookimpl_optsz6HookimplMarker.__call__..setattr_hookimpl_optss:"* ,$"$ "D D$++g5t <Krr0r) rr!rFrGrHrIrJrKrPs ` `````` rr&zHookimplMarker.__call__s'z    ( ((2 2rr2)......)r!rrFr5rGr5rHr5rIr5rJ str | NonerKr5r1r).......)r!r4rFr5rGr5rHr5rIr5rJrQrKr5r1r8)NFFFFNF)r!r9rFr5rGr5rHr5rIr5rJrQrKr5r1r:r;rrrrBrBtsu"I0  "              " ! ! ! !  !  ! ! !  ! !#!"#L3L3L3 L3  L3  L3L3L3 !L3rrBpypy)rclsobj)rrSz%TimeoutHooks.pytest_timeout_set_timerz(TimeoutHooks.pytest_timeout_cancel_timerzfrozenset[str]_NOSELF_WARN_SUPPRESSF legacy_noselfcd}tj|r |j}d}n#tj|s t |d|}tj|rd}tj|}tj|rd}|j} |j}|j}|j}|jd|j}|rt| }|d|||d}}nd}|j!dd d } d | v} |rI|s | r|d t"vr |dd}||fS| r/|r-| t$vr%t'j(|d |d dt*d||fS#t$rYywxYw#t $rYywxYw#t$rYywxYw)aReturn tuple of positional and keyword parameter names for a callable. In case of a class, its ``__init__`` method is considered. For bound methods, the already-bound first parameter is not included. For unbound methods with a dotted ``__qualname__``, the first parameter is stripped only if its name is a known implicit name (``self``, ``cls``). Keyword-only parameters are not included. :param legacy_noself: If ``True``, support hookspec classes whose methods omit ``self``. When the function looks like a class method but has no implicit first parameter, a :class:`DeprecationWarning` is emitted. F)rrTr&Nrz .r )maxsplit.rz% is a method but its first parameter z is not 'self'. Add 'self' as the first parameter or use @staticmethod. This will become an error in a future version of pluggy.) stacklevel)inspectisclassrAttributeError isroutinegetattr Exceptionismethodunwrap__func____code__ __defaults__r> co_varnames co_argcountlenrsplit_IMPLICIT_NAMESrUwarningswarnDeprecationWarning) r-rWis_boundcodedefaultsqualnameargsindexkwargs_tail_is_class_methods rvarnamesrzs Ht ==D   t $ 4T2D  >>$ D}}#}}.2.?.?)) !,,-?t/?/?@DXFU|T%&\f OOK!O 4R 8Ee| (T!W-G8D <-EAV4V MM*G;LM#   <s     s4 E E+$E: E('E(+ E76E7: FFceZdZdZddZy)HookSpec) argnamesr! kwargdefaults kwargnamesname namespacer.r$r%c ||_||_t|||_t j |xr%t t j||t }t|j|\|_ |_ t j|jj}tt|j|xsd|_||_|j%d|_|j%d|_y)NrVrr$r%)rrrbr!r^r_ isinstancegetattr_static staticmethodrzr}rrerhdictzipr~r.getr$r%)rrrr.rWrss rrzHookSpec.__init__Vs" /6y$/G  2 :  " "9d 3\< 8 *2 MM* & t>>$--0==!#doox~2"FG  HH^4!%*=!>rN)rrrr3r.rr1r4)r<r=r>r@rrrrr|r|Hs I?rr|)r-objectrWr5r1z'tuple[tuple[str, ...], tuple[str, ...]])#r? __future__rcollections.abcrrr^systypesrtypingrrr r r rn_configr rrrtyper__annotations__rrBimplementationr_PYPYrm frozensetrUrzr|rrrrs#$# !! T#v+./"T) I)S)S)S)lq3q3q3h 6),1( )2 02)~,1M M$(M,M`???r