| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/pluggy/__pycache__/ |
Upload File : |
a
Pi�a�, � @ s� d Z ddlZddlZddlZG dd� d�ZG dd� d�Zdd� Zeed �Zd
d � Z G d d
� d
�Z
G dd� d�Z G dd� d�Z G dd� d�Z
dS )zA
Internal hook annotation, representation and calling machinery.
� Nc @ s" e Zd ZdZdd� Zddd�ZdS ) �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 C s
|| _ d S �N�� project_name��selfr � r �1/usr/lib/python3.9/site-packages/pluggy/_hooks.py�__init__ s zHookspecMarker.__init__NFc s* � ���fdd�}|dur"||�S |S dS )ak if 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 s0 �r� rt d��t| �jd t� ��d�� | S )Nz'cannot have a historic firstresult hookZ_spec)� firstresult�historic� warn_on_impl)�
ValueError�setattrr �dict��func�r r r r
r r �setattr_hookspec_opts% s �� z6HookspecMarker.__call__.<locals>.setattr_hookspec_optsNr )r �functionr r r
r r r r �__call__ s zHookspecMarker.__call__)NFFN��__name__�
__module__� __qualname__�__doc__r
r r r r r r s �r c @ s" e Zd ZdZdd� Zddd�ZdS ) �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 C s
|| _ d S r r r r r r r
A s zHookimplMarker.__init__NFc s. � �����fdd�}|du r"|S ||�S dS )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
s$ t | �jd t� ����d�� | S )NZ_impl)� hookwrapper� optionalhook�tryfirst�trylast�specname)r r r r �r r r r! r r r r �setattr_hookimpl_optsh s �� z6HookimplMarker.__call__.<locals>.setattr_hookimpl_optsNr )r r r r r r r! r# r r" r r D s $zHookimplMarker.__call__)NFFFFNr r r r r r 9 s �r c C s@ | � dd� | � dd� | � dd� | � dd� | � dd � d S )Nr Fr r r r! )�
setdefault)�optsr r r �normalize_hookimpl_opts| s
r& Zpypy_version_infoc C s t �| �r,z
| j} W q\ ty( Y dS 0 n0t �| �s\zt| d| �} W n tyZ Y dS 0 zt �| �}W n ty~ Y dS 0 t |j
�|j }}|r�t |� }|d|� t ||d� � }}nd}t
s�dnd}|�rt �| ��sdt| dd�v �r|d |v �r|d
d� }||fS ) z�Return 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 r Nr �r )r �obj�.r r � )�inspectZisclassr
�AttributeErrorZ isroutine�getattr� ExceptionZgetfullargspec� TypeError�tuple�args�defaults�len�_PYPYZismethod)r �specr1 r2 �index�kwargsZimplicit_namesr r r �varnames� s8
�
� r8 c @ s e Zd ZdZdS )�
_HookRelayzghook holder object for performing 1:N hook calls where N is the number
of registered plugins.
N)r r r r r r r r r9 � s r9 c @ sp e Zd Zddd�Zdd� Zdd� Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dd� Z ddd�Z dd� Z
dd� ZdS ) � _HookCallerNc C s< || _ g | _g | _|| _d | _d | _|d ur8| �||� d S r )�name� _wrappers� _nonwrappers� _hookexec�
_call_historyr5 �set_specification)r r; Z hook_execute�specmodule_or_class� spec_optsr r r r
� s z_HookCaller.__init__c C s
| j d uS r )r5 r' r r r �has_spec� s z_HookCaller.has_specc C s$ t || j|�| _|�d�r g | _d S )Nr )�HookSpecr; r5 �getr? )r rA rB r r r r@ � s
z _HookCaller.set_specificationc C s
| j d uS r )r? r' r r r � is_historic� s z_HookCaller.is_historicc s< � fdd�}|| j �d u r8|| j�d u r8td� �d���d S )Nc s, t | �D ] \}}|j� kr| |= dS qd S )NT)� enumerate�plugin)Zwrappers�i�method�rH r r �remove� s
z*_HookCaller._remove_plugin.<locals>.removezplugin z
not found)r< r= r )r rH rL r rK r �_remove_plugin� s z_HookCaller._remove_pluginc C s | j | j S r )r= r< r' r r r �
get_hookimpls� s z_HookCaller.get_hookimplsc C sv |j r| j}n| j}|jr(|�d|� nJ|jr:|�|� n8t|�d }|dkrb|| jrb|d8 }qF|�|d |� dS )z,Add an implementation to the callback chain.r r* N)r r< r= r �insertr �appendr3 )r �hookimpl�methodsrI r r r �
_add_hookimpl� s
z_HookCaller._add_hookimplc C s d| j �d�S )Nz
<_HookCaller �>)r; r' r r r �__repr__� s z_HookCaller.__repr__c O s� |r t d��| jrh| jjD ]<}||vrtt| jj�|�� �}tjd�|�dd� qXq| 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� )�
stacklevelr F)r/ r5 �argnamesr0 �set�keys�warnings�warn�formatr% rE r> r; rN )r r1 r7 �argnameZ notincallr r r r r � s ��z_HookCaller.__call__c C sP | j �|p i |f� | �| j| �� |d�}|du r6dS |p<g D ] }||� q>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 not ``None`` it will be called for for each
non-``None`` result obtained from a hook implementation.
FN)r? rP r> r; rN )r �result_callbackr7 �res�xr r r �
call_historic s z_HookCaller.call_historicc C st t | j�t | j�f}|D ]*}tdddd�}tdd||�}| �|� qz | f i |��W |\| _| _S |\| _| _0 dS )zCall the hook with some additional temporarily participating
methods using the specified ``kwargs`` as call parameters.F)r r r Nz<temp>)�listr= r< r �HookImplrS )r rR r7 �oldrJ r% rQ r r r �
call_extra s �z_HookCaller.call_extrac C sH | � � rD| jD ]4\}}| �| j|g|d�}|r|dur||d � qdS )zAApply call history to a new hookimpl if it is marked as historic.FNr )rF r? r> r; )r rJ r7 r_ r` r r r �_maybe_apply_history( s
z _HookCaller._maybe_apply_history)NN)NN)r r r r
rC r@ rF rM rN rS rU r rb rf rg r r r r r: � s
r: c @ s e Zd Zdd� Zdd� ZdS )rd c C s: || _ t| j �\| _| _|| _|| _|| _| j�|� d S r ) r r8 rX �
kwargnamesrH r% � plugin_name�__dict__�update)r rH ri r Zhook_impl_optsr r r r
2 s zHookImpl.__init__c C s d| j �d| j�d�S )Nz<HookImpl plugin_name=z , plugin=rT )ri rH r' r r r rU : s zHookImpl.__repr__N)r r r r
rU r r r r rd 1 s rd c @ s e Zd Zdd� ZdS )rD c C sB || _ t||� | _}|| _t|�\| _| _|| _|�d�| _ d S )Nr
)
� namespacer- r r; r8 rX rh r% rE r
)r rl r; r% r r r r r
? s zHookSpec.__init__N)r r r r
r r r r rD > s rD )r r+ �sysr[ r r r& �hasattrr4 r8 r9 r: rd rD r r r r �<module> s 0C
*y