| 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�9 � @ s� d dl Z d dlZd dlZddlmZ ddlmZmZ ddlm Z m
Z
m Z m Z ej
dkrdd dlmZ nd dlZdd � ZG d
d � d e�ZG d d
� d
�ZG dd� d�Zdd� ZdS )� N� )�_tracing)�_Result�
_multicall)�HookImpl�
_HookRelay� _HookCaller�normalize_hookimpl_opts)� � ��metadatac C s" t j| t| �|jj|jjd� d S )N)�lineno�filename)�warnings�
warn_explicit�type�__code__�co_firstlineno� co_filename)Zwarning�function� r �3/usr/lib/python3.9/site-packages/pluggy/_manager.py�_warn_for_function s �r c s e Zd ZdZ� fdd�Z� ZS )�PluginValidationErrorz�plugin failed validation.
:param object plugin: the plugin which failed validation,
may be a module or an arbitrary object.
c s || _ tt| ��|� d S �N)�plugin�super� Exception�__init__)�selfr �message�� __class__r r r s z PluginValidationError.__init__)�__name__�
__module__� __qualname__�__doc__r �
__classcell__r r r" r r s r c @ s6 e Zd ZdZdd� Zedd� �Zd dd�Zd d
� ZdS ) �
DistFacadez$Emulate a pkg_resources Distributionc C s
|| _ d S r )�_dist)r �distr r r r ' s zDistFacade.__init__c C s
| j d S )N�namer �r r r r � project_name* s zDistFacade.project_nameNc C s t | j||�S r )�getattrr* )r �attr�defaultr r r � __getattr__. s zDistFacade.__getattr__c C s t t| j�ddg �S )Nr* r. )�sorted�dirr* r- r r r �__dir__1 s zDistFacade.__dir__)N) r$ r% r& r' r �propertyr. r2 r5 r r r r r) $ s
r) c @ s� e Zd ZdZdd� Zdd� Zd3dd�Zd d
� Zd4d d �Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd5d%d&�Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zd1d2� ZdS )6�
PluginManagera� Core :py:class:`.PluginManager` class which manages registration
of plugin objects and 1:N hook calling.
You can register new hooks by calling :py:meth:`add_hookspecs(module_or_class)
<.PluginManager.add_hookspecs>`.
You can register plugin objects (which contain hooks) by calling
:py:meth:`register(plugin) <.PluginManager.register>`. The :py:class:`.PluginManager`
is initialized with a prefix that is searched for in the names of the dict
of registered plugin objects.
For debugging purposes you can call :py:meth:`.PluginManager.enable_tracing`
which will subsequently send debug information to the trace helper.
c C s: || _ i | _i | _g | _t�� �d�| _t� | _ t
| _ d S )NZ pluginmanage) r. � _name2plugin�_plugin2hookcallers�_plugin_distinfor Z TagTracer�get�tracer �hookr �_inner_hookexec)r r. r r r r D s zPluginManager.__init__c C s | � ||||�S r �r> )r � hook_name�methods�kwargs� firstresultr r r � _hookexecM s zPluginManager._hookexecNc C s |p | � |�}|| jv s"|| jv rL| j�|d�du r8dS td||| jf ��|| j|< g | j|< }t|�D ]�}| �||�}|durlt|� t||�}t ||||�}|�d�p�|}t| j
|d�}|du r�t || j �}t
| j
||� n |�� �r| �||� |�|� |�|� |�|� ql|S )z�Register a plugin and return its canonical name or ``None`` if the name
is blocked from registering. Raise a :py:class:`ValueError` if the plugin
is already registered.���Nz#Plugin already registered: %s=%s
%sZspecname)�get_canonical_namer8 r9 r; �
ValueErrorr4 �parse_hookimpl_optsr r/ r r= r rD �setattr�has_spec� _verify_hookZ_maybe_apply_history�
_add_hookimpl�append) r r r, � plugin_nameZ hookcallersZ
hookimpl_opts�method�hookimplr= r r r �registerR s8
��
zPluginManager.registerc C s` t ||�}t�|�sd S zt || jd d �}W n tyD i }Y n0 |d ur\t|t�s\d }|S )NZ_impl)r/ �inspectZ isroutiner. r �
isinstance�dict)r r r, rO �resr r r rH x s
z!PluginManager.parse_hookimpl_optsc C sj |du r"|dusJ d��| � |�}|du r4| �|�}| j�|�rH| j|= | j�|g �D ]}|�|� qV|S )zlunregister a plugin object and all its contained hook implementations
from internal data structures.Nz+one of name or plugin needs to be specified)�get_name�
get_pluginr8 r; r9 �popZ_remove_plugin)r r r, Z
hookcallerr r r �
unregister� s
zPluginManager.unregisterc C s | j |d� d| j|< dS )zHblock registrations of the given name, unregister if already registered.�r, N)rY r8 �r r, r r r � set_blocked� s zPluginManager.set_blockedc C s || j v o| j | du S )z4return ``True`` if the given plugin name is blocked.N)r8 r[ r r r �
is_blocked� s zPluginManager.is_blockedc C s� g }t |�D ]~}| �||�}|dur t| j|d�}|du rZt|| j||�}t| j||� n&|�||� |�� D ]}| � ||� qn|�
|� q |s�t d| j �d|����dS )z�add new hook specifications defined in the given ``module_or_class``.
Functions are recognized if they have been decorated accordingly.Nzdid not find any z
hooks in )
r4 �parse_hookspec_optsr/ r= r rD rI Zset_specification�
get_hookimplsrK rM rG r. )r �module_or_class�namesr, Z spec_opts�hcZ hookfunctionr r r �
add_hookspecs� s �zPluginManager.add_hookspecsc C s t ||�}t || jd d �S )NZ_spec)r/ r. )r r` r, rO r r r r^ � s
z!PluginManager.parse_hookspec_optsc C s
t | j�S )z%return the set of registered plugins.)�setr9 r- r r r � get_plugins� s zPluginManager.get_pluginsc C s
|| j v S )z4Return ``True`` if the plugin is already registered.)r9 �r r r r r �
is_registered� s zPluginManager.is_registeredc C s t |dd�ptt|��S )aV Return canonical name for a plugin object. Note that a plugin
may be registered under a different name which was specified
by the caller of :py:meth:`register(plugin, name) <.PluginManager.register>`.
To obtain the name of an registered plugin use :py:meth:`get_name(plugin)
<.PluginManager.get_name>` instead.r$ N)r/ �str�idrf r r r rF � s z PluginManager.get_canonical_namec C s | j �|�S )z/Return a plugin or ``None`` for the given name.)r8 r; r[ r r r rW � s zPluginManager.get_pluginc C s | � |�duS )z>Return ``True`` if a plugin with the given name is registered.N)rW r[ r r r �
has_plugin� s zPluginManager.has_pluginc C s( | j �� D ]\}}||kr
| S q
dS )z@Return name for registered plugin or ``None`` if not registered.N)r8 �items)r r r, �valr r r rV � s zPluginManager.get_namec C s� |� � r&|jr&t|jd|j|jf ��|jjr>t|jj|j � t
|j �t
|jj � }|rzt|jd|j|jt |j �|f ��|jr�t
�|j �s�t|jd|j|jt |j �f ��d S )Nz6Plugin %r
hook %r
historic incompatible to hookwrapperz~Plugin %r for hook %r
hookimpl definition: %s
Argument(s) %s are declared in the hookimpl but can not be found in the hookspeczsPlugin %r for hook %r
hookimpl definition: %s
Declared as hookwrapper=True but function is not a generator function)Z is_historicZ hookwrapperr r rN r, �specZ warn_on_implr r rd Zargnames�
_formatdefrR Zisgeneratorfunction)r r= rP Z notinspecr r r rK � s8
�����
��zPluginManager._verify_hookc C s\ | j jD ]N}|d dkrt| j |�}|�� s|�� D ] }|js4t|jd||jf ��q4qdS )z�Verify that all hooks which have not been verified against
a hook specification are optional, otherwise raise :py:class:`.PluginValidationError`.r �_z unknown hook %r in plugin %rN)r= �__dict__r/ rJ r_ Z optionalhookr r )r r, r= rP r r r �
check_pending� s ��zPluginManager.check_pendingc C s� d}t t�� �D ]z}|jD ]n}|j|ks|dur:|j|ks| �|j�s| �|j�rTq|�� }| j ||jd� | j
� |t |�f� |d7 }qq|S )a* Load modules from querying the specified setuptools ``group``.
:param str group: entry point group to load plugins
:param str name: if given, loads only plugins with the given ``name``.
:rtype: int
:return: return the number of loaded plugins by this call.
r NrZ r )
�list�importlib_metadataZ
distributionsZ entry_points�groupr, rW r] �loadrQ r: rM r) )r rt r, �countr+ Zepr r r r �load_setuptools_entrypoints s&
���
�
� z)PluginManager.load_setuptools_entrypointsc C s
t | j�S )zTreturn list of distinfo/plugin tuples for all setuptools registered
plugins.)rr r: r- r r r �list_plugin_distinfo% s z"PluginManager.list_plugin_distinfoc C s t | j�� �S )z!return list of name/plugin pairs.)rr r8 rk r- r r r �list_name_plugin* s z PluginManager.list_name_pluginc C s | j �|�S )z.get all hook callers for the specified plugin.)r9 r; rf r r r �get_hookcallers. s z PluginManager.get_hookcallersc s. �j �� ��fdd�}|�_ ��fdd�}|S )aP add before/after tracing functions for all hooks
and return an undo function which, when called,
will remove the added tracers.
``before(hook_name, hook_impls, kwargs)`` will be called ahead
of all hook calls and receive a hookcaller instance, a list
of HookImpl instances and the keyword arguments for the hook call.
``after(outcome, hook_name, hook_impls, kwargs)`` receives the
same arguments as ``before`` but also a :py:class:`pluggy._callers._Result` object
which represents the result of the overall hook call.
c s< ����� t �� ����fdd��}�|���� |�� S )Nc s ����� �S r r r )rC �
hook_implsr@ rB �oldcallr r �<lambda>D � zPPluginManager.add_hookcall_monitoring.<locals>.traced_hookexec.<locals>.<lambda>)r Z from_call�
get_result)r@ r{ rB rC �outcome)�after�beforer| )rC r{ r@ rB r �traced_hookexecA s �z>PluginManager.add_hookcall_monitoring.<locals>.traced_hookexecc s
� �_ d S r r? r )r| r r r �undoK s z3PluginManager.add_hookcall_monitoring.<locals>.undor? )r r� r� r� r� r )r� r� r| r r �add_hookcall_monitoring2 s
z%PluginManager.add_hookcall_monitoringc s2 | j j�d�� � fdd�}� fdd�}| �||�S )z9enable tracing of hook calls and return an undo function.r= c s � j jd7 _� | |� d S )Nr )�root�indent)r@ rA rB �Z hooktracer r r� T s z,PluginManager.enable_tracing.<locals>.beforec s0 | j d u r � d|d| �� � � j jd8 _d S )NZfinishz-->r )�excinfor r� r� )r� r@ rA rB r� r r r� X s
z+PluginManager.enable_tracing.<locals>.after)r< r� r; r� )r r� r� r r� r �enable_tracingP s z PluginManager.enable_tracingc s~ t | j� �}� fdd�|D �}|rzt|j|j|jj|jj�}|�� D ]0}|j }||vrD|�
|� | j � |g ��
|� qD|S |S )z�Return a new :py:class:`._hooks._HookCaller` instance for the named method
which manages calls to all registered plugins except the
ones from remove_plugins.c s g | ]}t |� �r|�qS r )�hasattr)�.0ZplugrZ r r �
<listcomp>d r~ z4PluginManager.subset_hook_caller.<locals>.<listcomp>)r/ r= r r, rD rm � namespaceZoptsr_ r rL r9 �
setdefaultrM )r r, Zremove_pluginsZorigZplugins_to_removerb rP r r rZ r �subset_hook_caller_ s �
z PluginManager.subset_hook_caller)N)NN)N) r$ r% r& r' r rD rQ rH rY r\ r] rc r^ re rg rF rW rj rV rK rq rw rx ry rz r� r� r� r r r r r7 5 s2
&
#
r7 c C s | j � t�| �� �S r )r$ rR Z signature)�funcr r r rn t s rn )rR �sysr � r Z_callersr r Z_hooksr r r r � version_info� importlibr
rs r r r r) r7 rn r r r r �<module> s
A