9v?%|{ V d Z ddlmZ ddlZddlZddlZddlmZ ddlm Z ddlm
Z
ddlm Z ddlm Z dd lm
Z
dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ er ddlmZ ddlmZ ed Z ede de f Z eee f Z e Z e e!ed ee!e f e"gee e
e f f Z#e deee dee df f f Z$er G d d e Z% G d d e Z& G d d Z' G d! d" Z(d5d&Z) e*ed' Z+d6d+Z, G d, d- Z-e
eee!e f ee e
gdf f Z. G d. d/ Z/ G d0 d1e/ Z0 G d2 d Z1 G d3 d4 Z2dS )7zA
Internal hook annotation, representation and calling machinery.
) annotationsN)
ModuleType) AbstractSet)Any)Callable) Generator)List)Mapping)Optional)overload)Sequence)Tuple)
TYPE_CHECKING)TypeVar)Union )_Result) TypedDict)Final_T_F.)boundHookImplc . e Zd ZU ded< ded< ded< dS )
_HookSpecOptsbool firstresulthistoricWarning | None warn_on_implN__name__
__module__ __qualname____annotations__ _/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/pluggy/_hooks.pyr r * s3 $$$$$$r' r c L e Zd ZU ded< ded< ded< ded< ded< ded< d S )
_HookImplOptsr wrapper hookwrapper optionalhooktryfirsttrylast
str | NonespecnameNr! r& r' r( r* r* / sQ
r' r* c r e Zd ZdZdZddZe ddd Ze dd d Z d d dZd S ) HookspecMarkera Decorator 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_namer5 strreturnNonec || _ d S Nr4 selfr5 s r( __init__zHookspecMarker.__init__B #/r' FNfunctionr r r r r r c d S r: r& r< r? r r r s r( __call__zHookspecMarker.__call__E r' .Callable[[_F], _F]c d S r: r& rA s r( rB zHookspecMarker.__call__O rC r' _F | None_F | Callable[[_F], _F]c : d fd }| || S |S )a If 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.
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``, every call to the hook will be memorized
and replayed on plugins registered after the call was made.
funcr r7 c l rrt d d}t | j dz | | S )Nz'cannot have a historic firstresult hook)r r r _spec)
ValueErrorsetattrr5 )rI optsr r r< r s r( setattr_hookspec_optsz6HookspecMarker.__call__..setattr_hookspec_optsn sY
LK
L !JKKK * $ ,# #D
D$+g5t < < <Kr' NrI r r7 r r& )r< r? r r r rO s ` ``` r( rB zHookspecMarker.__call__Y sR * ((22 2( (r' r5 r6 r7 r8 )FFN)
r? r r r r r r r r7 r )....)
r? r8 r r r r r r r7 rD )NFFN)
r? rF r r r r r r r7 rG r" r# r$ __doc__ __slots__r= r rB r& r' r( r3 r3 8 s "I0 0 0 0 " '+ X '* X # ! '+ #) #) #) #) #) #) #)r' r3 c e Zd ZdZdZddZe d d d Ze d d d Z d d!dZdS )"HookimplMarkera Decorator 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.
r4 r5 r6 r7 r8 c || _ d S r: r4 r; s r( r= zHookimplMarker.__init__ r> r' .r? r r, r r- r. r/ r1 r0 r+ c d S r: r& r< r? r, r- r. r/ r1 r+ s r( rB zHookimplMarker.__call__ r' rD c d S r: r& rY s r( rB zHookimplMarker.__call__ rZ r' NFrF rG c F d fd }||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.
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 ``wrapper`` is ``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.
If ``hookwrapper`` is ``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``.
If ``specname`` is provided, it will be used instead of the function
name when matching this hook implementation to a hook specification
during registration.
.. versionadded:: 1.2.0
The ``wrapper`` parameter.
rI r r7 c L d}t | j dz | | S )N)r+ r, r- r. r/ r1 _impl)rM r5 ) rI rN r, r- r< r1 r. r/ r+ s r( setattr_hookimpl_optsz6HookimplMarker.__call__..setattr_hookimpl_opts sB " * , $" $
# #D
D$+g5t < < <Kr' NrP r& ) r< r? r, r- r. r/ r1 r+ r_ s ` `````` r( rB zHookimplMarker.__call__ se f
( (((22 2r' rQ )......)r? r r, r r- r r. r r/ r r1 r0 r+ r r7 r ).......)r? r8 r, r r- r r. r r/ r r1 r0 r+ r r7 rD )NFFFFNF)r? rF r, r r- r r. r r/ r r1 r0 r+ r r7 rG rR r& r' r( rV rV s "I0 0 0 0 "
X
"
X
# ! " # B3 B3 B3 B3 B3 B3 B3r' rV rN r7 r8 c | dd | dd | dd | dd | dd | dd d S )Nr. Fr/ r+ r, r- r1 )
setdefault)rN s r( normalize_hookimpl_optsrb s OOJ&&&OOIu%%%OOIu%%%OOM5)))OONE***OOJ%%%%%r' pypy_version_inforI object'tuple[tuple[str, ...], tuple[str, ...]]c d t j | r | j } nI# t $ r Y dS w xY wt j | s$ t | d| } n# t $ r Y dS w xY w t j t j | r| j n| }n# t $ r Y dS w xY wt j j t j j
f fd|j D }t! | }t! d | D pd}|r2t% | }|d| t! ||d }}nd}t& sd}nd}|r=t | d d
}t j | sd |v r|d |v r
|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.
)r& r& rB c . i | ]\ }}|j v ||S r& )kind).0nameparam_valid_param_kindss r(
z varnames.. s7 D% :+ + +
e + + +r' c 3 @ K | ]}|j |j u|j V d S r: )defaultempty)ri rk s r( zvarnames.. s?
}EK//
M////
r' Nr& r< )r< objr$ .r r )inspectisclassr= AttributeError isroutinegetattr Exception signatureismethod__func__ TypeError ParameterPOSITIONAL_ONLYPOSITIONAL_OR_KEYWORD
parametersitemstuplevalueslen_PYPY)
rI sig
_valid_paramsargsdefaultsindexkwargsimplicit_namesqualnamerl s
@r( varnamesr s= t =DD 66
t
$
$ 4T22DD 66 $ -d 3 3 =DMM
vv )/ >//11 M
D
&--//
X FUF|U4<%8%8f )*3( nb99 D ! ! cXoo$q'^:S:S8D <s0
--A
A%$A%)/B
B'&B'c & e Zd ZdZdZerd dZdS dS )
_HookRelayzaHook holder object for performing 1:N hook calls where N is the number
of registered plugins.)__dict__rj r6 r7 _HookCallerc d S r: r& )r< rj s r( __getattr__z_HookRelay.__getattr__@ s Cr' N)rj r6 r7 r )r" r# r$ rS rT r r r& r' r( r r 8 sK I r' r c e Zd ZdZ d,d-d
Zd.dZd/dZd.dZd0dZd1dZ d2dZ
d3d Z d4d Z d5d"Z
d,d6d&Zd7d)Zd8d+ZdS )9r )rj spec _hookexec
_hookimpls
_call_historyNrj r6 hook_execute _HookExecspecmodule_or_class_Namespace | None spec_opts_HookSpecOpts | Noner7 r8 c || _ || _ g | _ d | _ d | _ | |J | || d S d S r: )rj r r r r set_specification)r< rj r r r s r( r= z_HookCaller.__init__P s_ ,1326%) * ((( " "#6 B B B B B + *r' r c | j d uS r: )r rr s r( has_specz_HookCaller.has_spec` s y$$r'
_Namespacer c | j )t d| j j d| j j t || j | | _ | d r g | _ d S d S )NzHook z( is already registered within namespace r )r rL rj namespaceHookSpecgetr )r< r r s r( r z _HookCaller.set_specificationc s
9 : : :$(I$7: :
0$)YGG == $ $ $!#D $ $r' c | j d uS r: )r rr s r( is_historicz_HookCaller.is_historicq s !--r' plugin_Pluginc t | j D ]\ }}|j |k r | j |= d S t d|d )Nzplugin z
not found) enumerater r rL )r< r imethods r( _remove_pluginz_HookCaller._remove_plugint s^ "4?33 IAv}&&OA& ' 76777888r' list[HookImpl]c 4 | j S r: )r copyrr s r(
get_hookimplsz_HookCaller.get_hookimpls{ s ##%%%r' hookimplr c t | j D ]\ }}|j s|j r|} nt | j }|j s|j r|t | j }}nd|}}|j r | j || dS |j r | j || dS |dz
}||k r/| j | j r |dz }||k r| j | j | j |dz | dS )z,Add an implementation to the callback chain.r r N)r r r, r+ r r/ insertr. )r< r r r
splitpointstartends r(
_add_hookimplz_HookCaller._add_hookimpl~ s> "4?33 . .IAv!
V^
T_--J '8#3 '#S %9%93EEJ3E 4 O " "5( 3 3 3 3 3
4 O " "3 1 1 1 1 1 aAu** !3!<*Q u** !3!<* O " "1q5( 3 3 3 3 3r' c d| j dS )Nz
<_HookCaller >rj rr s r( __repr__z_HookCaller.__repr__ s -ty----r' r Mapping[str, object]c | j rj| j j D ]_}|vrWd fd| j j D }t j d | d d S ^d S d S )Nz, c 3 b K | ])}| vt | V *d S r: )keysrepr)ri argnamer s r( rq z<_HookCaller._verify_all_args_are_provided.. sJ * * #"&++--77 W
8777 * *r' zSArgument(s) {} which are declared in the hookspec cannot be found in this hook call )
stacklevel)r argnamesjoinwarningswarnformat)r< r r notincalls ` r( _verify_all_args_are_providedz)_HookCaller._verify_all_args_are_provided s 9 9-
&(( $ * * * *'+y'9* * * ! !I M<>>QV ~~di &+NNNr' result_callback Callable[[Any], None] | NoneMapping[str, object] | Nonec | j J |pi }| | | j ||f | | j | j |d }|dS t
|t r|D ]} || dS dS )a Call the hook with given ``kwargs`` for all registered plugins and
for all plugins which will be registered afterwards.
If ``result_callback`` is provided, it will be called for each
non-``None`` result obtained from a hook implementation.
NF)r r appendr rj r
isinstancelist)r< r r resxs r(
call_historicz_HookCaller.call_historic s !--- 2 **6222 !!6?";<<< nnTYGG " F c4 #
#
# """" # #
#
#r' methods Sequence[Callable[..., object]]c z | r
J d | | ddddddd}| j }|D ]}t dd|| }t | dz
}|dk rY|| j rL|| j s?|| j s2|dz }|dk r'|| j r|| j s
|| j 2| |dz | | j
r | j
j dd nd}|
| j ||| S ) zCall the hook with some additional temporarily participating
methods using the specified ``kwargs`` as call parameters.r FN)r+ r, r- r/ r. r1 zr r r )r r r r r r r. r, r+ r r rN r r rj ) r< r r rN hookimplsr r r r s r(
call_extraz_HookCaller.call_extra s "" O O N O O " **6222 !
O((**
.
.F h==HI"AQ aL) "1 1 5>q\5I Q Q aL) "1 1 5>q\5I
QUH - - - -BF)Vdin(( >>>QV ~~diFKHHHr' r c | r`| j J | j D ]Q\ }}| | j |g|d }|r*|(t |t
sJ ||d PdS dS )zAApply call history to a new hookimpl if it is marked as historic.NFr )r r r rj r r )r< r r r r s r( _maybe_apply_historyz _HookCaller._maybe_apply_history s ,%111+/+=
,
,'nnTY&%HH ,?6%c400000#OCF+++ , ,
,
,r' )NN)
rj r6 r r r r r r r7 r8 )r7 r )r r r r r7 r8 )r r r7 r8 r7 r )r r r7 r8 r7 r6 )r r r7 r8 )r rd r7 r )r r r r r7 r8 )r r r r r7 r )r r r7 r8 )r" r# r$ rT r= r r r r r r r r rB r r r r& r' r( r r G sG I 26*. C C C C C % % % % $ $ $ $ . . . .9 9 9 9& & & &4 4 4 40. . . . $O O O O 9=.2# # # # #0 I I I I@ , , , , , ,r' r c n e Zd ZdZdZdd Zedd Zedd
Zedd Z ddZ
dS )_SubsetHookCallerztA proxy to another HookCaller which manages calls to all registered
plugins except the ones from remove_plugins.)_orig_remove_pluginsorigr remove_pluginsAbstractSet[_Plugin]r7 r8 c R || _ || _ |j | _ |j | _ d S r: )r r rj r )r< r r s r( r= z_SubsetHookCaller.__init__
s'
- I r' r c 4 fd j j D S )Nc 0 g | ]}|j j v|S r& )r r )ri implr< s r(
z0_SubsetHookCaller._hookimpls.. s3
{$"666
666r' )r r rr s `r( r z _SubsetHookCaller._hookimpls s3
-
r' HookSpec | Nonec | j j S r: )r r rr s r( r z_SubsetHookCaller.spec s z r' _CallHistory | Nonec | j j S r: )r r rr s r( r z _SubsetHookCaller._call_history s
z''r' r6 c d| j dS )Nz<_SubsetHookCaller r r rr s r( r z_SubsetHookCaller.__repr__ s 3TY3333r' N)r r r r r7 r8 r )r7 r )r7 r r ) r" r# r$ rS rT r= propertyr r r r r& r' r( r r s 4 4I
( ( ( (
X
X ( ( ( X(4 4 4 4 4 4r' r c " e Zd ZdZdd Zdd
ZdS )r ) r? r
kwargnamesr rN plugin_namer+ r, r- r. r/ r r r r6 r? _HookImplFunction[object]hook_impl_optsr* r7 r8 c || _ t | j \ | _ | _ || _ || _ || _ |d | _ |d | _ |d | _ |d | _
|d | _ d S )Nr+ r, r- r. r/ ) r? r r r r rN r r+ r, r- r. r/ )r< r r r? r s r( r= zHookImpl.__init__3 s{ (
)1$-)@)@&
t " &%i0 )-8 *> :&z2
%i0 r' c ( d| j d| j dS )Nzr
s/ # " " " " "
(++++++''''''
WT]] WT#v+.///
:t#
$
(:
V 4d; &$v,
!
S%IdGBK6M,N(N"O OP
% % % % % % % %
D) D) D) D) D) D) D) D)Ni3 i3 i3 i3 i3 i3 i3 i3X& & & & ())> > > >B E'#v+.3%+9N0OOPQ m, m, m, m, m, m, m, m,`*4 *4 *4 *4 *4 *4 *4 *4Z"V "V "V "V "V "V "V "VJ5 5 5 5 5 5 5 5 5 5r'