F-PhN ddlmZddlmZddlmZddlmZddlZddlZddlm Z ddlm Z ddlm Z dd lm Z dd lm Z ddlZd d lmZd d lmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZe rddl Z!e e"eeee"e fgdfZ#e ee e"eeee"e fgdfZ$d)dZ%Gd d!e&Z'Gd"d#Z(Gd$d%Z)d*d(Z*dS)+) annotations)Iterable)Mapping)SequenceN)Any)Callable)cast)Final) TYPE_CHECKING)_tracing) _multicall)_HookImplFunction) _Namespace)_Plugin)_SubsetHookCaller) HookCaller)HookImpl) HookimplOpts) HookRelay) HookspecOpts)normalize_hookimpl_opts)ResultwarningWarningfunctionCallable[..., object]returnNonecttj|}tj|t ||jj|jjdS)N)linenofilename) r types FunctionTypewarnings warn_explicittype__code__co_firstlineno co_filename)rrfuncs O/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/pluggy/_manager.py_warn_for_functionr-'sT "H - -D  W }+* c$eZdZdZd fd ZxZS) PluginValidationErrorzyPlugin failed validation. :param plugin: The plugin which failed validation. :param message: Error message. pluginrmessagestrrrcXt|||_dSN)super__init__r1)selfr1r2 __class__s r,r7zPluginValidationError.__init__8s& !!! r.)r1rr2r3rr)__name__ __module__ __qualname____doc__r7 __classcell__)r9s@r,r0r01sG r.r0cDeZdZdZddZeddZdddZddZd S) DistFacadez$Emulate a pkg_resources Distributiondistimportlib.metadata.Distributionrrc||_dSr5)_dist)r8rAs r,r7zDistFacade.__init__As  r.r3c |jd}|S)Nname)metadatar8rFs r, project_namezDistFacade.project_nameDsM&) r.Nattrdefault Any | Nonerc.t|j||Sr5)getattrrD)r8rJrKs r, __getattr__zDistFacade.__getattr__Istz4111r. list[str]cNtt|jddgzS)NrDrI)sorteddirrDr8s r,__dir__zDistFacade.__dir__Ls"c$*oo.(AABBBr.)rArBrr)rr3r5)rJr3rKrLrr)rrP) r:r;r<r=r7propertyrIrOrUr.r,r@r@>s..X22222CCCCCCr.r@ceZdZdZdCdZdDdZdEdFdZdGdZ dHdIdZdJdZ dKdZ dKdZ dLd Z dMd"Z dNd$ZdOd%ZdPd&ZdQd'ZdKd(ZdRd)ZdSd.ZdTd/ZdEdUd2ZdVd4ZdWd6ZdXd8ZdYd>ZdZd?Zd[dBZdS)\ PluginManageraQCore class which manages registration of plugin objects and 1:N hook calling. You can register new hooks by calling :meth:`add_hookspecs(module_or_class) `. You can register plugin objects (which contain hook implementations) by calling :meth:`register(plugin) `. For debugging purposes you can call :meth:`PluginManager.enable_tracing` which will subsequently send debug information to the trace helper. :param project_name: The short project name. Prefer snake case. Make sure it's unique! rIr3rrc||_i|_g|_t|_t jd|_t|_ dS)N pluginmanage) rI _name2plugin_plugin_distinforhookr TagTracergettracer_inner_hookexec)r8rIs r,r7zPluginManager.__init__asZ#/79IK%;; 3;3E3G3G3K3K 4 4   *r. hook_namemethodsSequence[HookImpl]kwargsMapping[str, object] firstresultboolobject | list[object]c2|||||Sr5rb)r8rcrdrfrhs r, _hookexeczPluginManager._hookexecos##Iw LLLr.Nr1rrF str | NonecR|p||}||jvr:|j|ddStd|d|d|j||jvrtd|d|d|j||j|<t |D]}|||}|t|t||}t||||}|dp|}t|j |d}|,t||j }t|j ||n?|r+||||||||S)aRegister a plugin and return its name. :param name: The name under which to register the plugin. If not specified, a name is generated using :func:`get_canonical_name`. :returns: The plugin name. If the name is blocked from registering, returns ``None``. If the plugin is already registered, raises a :exc:`ValueError`. Nz Plugin name already registered: = z2Plugin already registered under a different name: specname)get_canonical_namer\r` ValueErrorvaluesrSparse_hookimpl_optsrrNrr^rrmsetattrhas_spec _verify_hook_maybe_apply_history _add_hookimpl)r8r1rF plugin_name hookimpl_optsmethodhookimplr^s r,registerzPluginManager.registerzs=d55f== $+ + + $$["55=t???!'??+/+<??  T&--// / /???!'??+/+<?? *0+&KK - -D 44VTBBM(' 6664;FD4I4I#FKOO$((44<*1$)T4*H*H<%dDN;;DDItT2222]]__8%%dH555--h777""8,,,r.HookimplOpts | Nonect||}tj|sdS t||jdzd}n#t$ri}YnwxYw|t |t sd}|S)aTry to obtain a hook implementation from an item with the given name in the given plugin which is being searched for hook impls. :returns: The parsed hookimpl options, or None to skip the given item. This method can be overridden by ``PluginManager`` subclasses to customize how hook implementation are picked up. By default, returns the options for items decorated with :class:`HookimplMarker`. N_impl)rNinspect isroutinerI Exception isinstancedict)r8r1rFrress r,rwz!PluginManager.parse_hookimpl_optss!.. (( 4 '.)G3T((CC   CCC  ?:c4#8#8?C sA AA_Plugin | NonerLcH|-| Jd||}| Jd|||}|dS||}|r|D]}|||j|r |J|j|=|S)a Unregister a plugin and all of its hook implementations. The plugin can be specified either by the plugin object or the plugin name. If both are specified, they must agree. Returns the unregistered plugin, or ``None`` if not found. Nz+one of name or plugin needs to be specifiedzplugin is not registered)get_name get_pluginget_hookcallers_remove_pluginr\r`)r8r1rF hookcallers hookcallers r, unregisterzPluginManager.unregisters <%%'T%%%==((D##%?### >__T**F~t**622  2) 2 2 ))&1111    & & (###!$' r.cF||d|j|<dS)zHBlock registrations of the given name, unregister if already registered.rFN)rr\rHs r, set_blockedzPluginManager.set_blockeds) T""""&$r.c2||jvo|j|duS)z0Return whether the given plugin name is blocked.N)r\rHs r, is_blockedzPluginManager.is_blockeds"t((LT->t-D-LLr.cP|j|d |j|=dSdS)zQUnblocks a name. Returns whether the name was actually blocked. rpNTFr\r`rHs r,unblockzPluginManager.unblocks2   r * * 2!$'4ur.module_or_classrcg}t|D]}|||}|t|j|d}|.t ||j||}t |j||nC||||D]}| ||| ||std|j d|dS)zAdd new hook specifications defined in the given ``module_or_class``. Functions are recognized as hook specifications if they have been decorated with a matching :class:`HookspecMarker`. Nzdid not find any z hooks in ) rSparse_hookspec_optsrNr^rrmrxset_specification get_hookimplsrzappendrurI)r8rnamesrF spec_optshc hookfunctions r, add_hookspecszPluginManager.add_hookspecss (( # #D00$GGI$(/ 4(F(F:#D$./9UUBDItR0000(()DDD(*(8(8(:(:<< ))"l;;;; T""" VD$5VV?VV   r.HookspecOpts | NonecXt||}t||jdzd}|S)aTry to obtain a hook specification from an item with the given name in the given module or class which is being searched for hook specs. :returns: The parsed hookspec options for defining a hook, or None to skip the given item. This method can be overridden by ``PluginManager`` subclasses to customize how hook specifications are picked up. By default, returns the options for items decorated with :class:`HookspecMarker`. _specN)rNrI)r8rrFroptss r,rz!PluginManager.parse_hookspec_optss2$//$+FD4E4OQU$V$V r.set[Any]cHd|jDS)z.Return a set of all registered plugin objects.ch|]}||Sr5rW).0xs r, z,PluginManager.get_plugins..'sGGGar.)r\rvrTs r, get_pluginszPluginManager.get_plugins%s%GG4,3355GGGGr.chtfd|jDS)z0Return whether the plugin is already registered.c3$K|] }|kV dSr5rW)rvalr1s r, z.PluginManager.is_registered..+s'GGS6S=GGGGGGr.)anyr\rv)r8r1s `r, is_registeredzPluginManager.is_registered)s5GGGGD,=,D,D,F,FGGGGGGr.c`t|dd}|ptt|S)a3Return a canonical name for a plugin object. Note that a plugin may be registered under a different name specified by the caller of :meth:`register(plugin, name) `. To obtain the name of a registered plugin use :meth:`get_name(plugin) ` instead. r:N)rNr3id)r8r1rFs r,rtz PluginManager.get_canonical_name-s,#6:t<<&s2f::&r.c6|j|S)z:Return the plugin registered under the given name, if any.rrHs r,rzPluginManager.get_plugin8s $$T***r.c0||duS)z:Return whether a plugin with the given name is registered.N)rrHs r, has_pluginzPluginManager.has_plugin<st$$D00r.cX|jD]\}}||kr|cSdS)zPReturn the name the plugin is registered under, or ``None`` if is isn't.N)r\items)r8r1rFrs r,rzPluginManager.get_name@sB*0022  ID#}} tr.r^rrrc |r4|js|jr&t|jd|jd|jd|jJ|jjrt|jj|j t|j t|jj z }|r>t|jd|jd|jdt|j d|d |jjr@|j D]8}|jj|}|t||j 9|js|jrTt!j|j s;t|jd|jd|jdt|j d|jrB|jr=t|jd|jd|jdt|j d dSdS) NzPlugin z hook z5 historic incompatible with yield/wrapper/hookwrapperz for hook z hookimpl definition: z Argument(s) zB are declared in the hookimpl but can not be found in the hookspeczV Declared as wrapper=True or hookwrapper=True but function is not a generator functionzE The wrapper=True and hookwrapper=True options are mutually exclusive) is_historic hookwrapperwrapperr0r1r}rFspec warn_on_implr-rsetargnames _formatdefwarn_on_impl_argsr`risgeneratorfunction)r8r^r notinspechookimpl_argnameargname_warnings r,rzzPluginManager._verify_hookHs      8#7 8;K 'G(.GGGGG  y$$$ 9 ! J ty5x7H I I I)**S1C-D-DD  '3(.33DI33(283D(E(E33(333  9 & K$,$5 K K "&)"="A"ABR"S"S".&8IJJJ    ( 4 -h.?@@ (;(.;;DI;;(283D(E(E;;;     4 'W(.WWDIWW(283D(E(EWWW     r.c  |jjD]v}|ddkrt|j|}|s>|D])}|js t |jd|d|j*wdS)zVerify that all hooks which have not been verified against a hook specification are optional, otherwise raise :exc:`PluginValidationError`.r_z unknown hook z in plugin N)r^__dict__rNryr optionalhookr0r1)r8rFr^rs r, check_pendingzPluginManager.check_pendingxsI&  DAw#~~&ty$77D==??  $ 2 2 4 4H#03$ORDRRxRR  r.groupintcddl}d}t|jD]}|jD]}|j|ksA| |j|ks4||js||jrO| }| ||j|j |t|f|dz }|S)a-Load modules from querying the specified setuptools ``group``. :param group: Entry point group to load plugins. :param name: If given, loads only plugins with the given ``name``. :return: The number of plugins loaded by this call. rNrr )importlib.metadatalistrG distributions entry_pointsrrFrrloadrr]rr@)r8rrF importlibcountrAepr1s r,load_setuptools_entrypointsz)PluginManager.load_setuptools_entrypointss "!!!+99;;<<  D'  H%%(RW__rw//.=rw//.=  f27 333%,,fj6F6F-GHHH   r. list[tuple[_Plugin, DistFacade]]c*t|jS)zXReturn a list of (plugin, distinfo) pairs for all setuptools-registered plugins.)rr]rTs r,list_plugin_distinfoz"PluginManager.list_plugin_distinfosD)***r.list[tuple[str, _Plugin]]cNt|jS)zAReturn a list of (name, plugin) pairs for all registered plugins.)rr\rrTs r,list_name_pluginzPluginManager.list_name_pluginsD%++--...r.list[HookCaller] | Nonec||dSg}|jjD]7}|D] }|j|ur||!8|S)zGet all hook callers for the specified plugin. :returns: The hook callers, or ``None`` if ``plugin`` is not registered in this plugin manager. N)rr^rrvrr1r)r8r1rrrs r,rzPluginManager.get_hookcallerss == (4 ),3355 3 3J&4466 3 3?f,,&&z222 3r.before _BeforeTraceafter _AfterTraceCallable[[], None]cHjdfd }|_dfd }|S)a7Add before/after tracing functions for all hooks. Returns an undo function which, when called, removes 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 :class:`~pluggy.Result` object which represents the result of the overall hook call. rcr3 hook_implsre caller_kwargsrgrhrirrjctjfd}||S)Nc Sr5rW)rrhrrcoldcallsr,zPPluginManager.add_hookcall_monitoring..traced_hookexec..s :}kRRr.)r from_call get_result)rcrrrhoutcomerrrs```` r,traced_hookexecz>PluginManager.add_hookcall_monitoring..traced_hookexecsq F9j- 8 8 8&RRRRRRRRG E'9j- @ @ @%%'' 'r.rc_dSr5rl)rr8sr,undoz3PluginManager.add_hookcall_monitoring..undos#*D r.) rcr3rrerrgrhrirrjrrrl)r8rrrrrs``` @r,add_hookcall_monitoringz%PluginManager.add_hookcall_monitoringsl& ( ( ( ( ( ( ( ( / + + + + + + + r.c|jjddfd }dfd }|||S)zwEnable tracing of hook calls. Returns an undo function which, when called, removes the added tracing. r^rcr3rdrerfrgrrcJjxjdz c_||dS)Nr )rootindent)rcrdrf hooktraces r,rz,PluginManager.enable_tracing..befores3 N ! !Q & ! ! Ii ( ( ( ( (r.rResult[object]c|j d|d|jxjdzc_dS)Nfinishz-->r ) exceptionrrr)rrcrdrfrs r,rz+PluginManager.enable_tracing..aftersL  ( (Iug6H6H6J6JKKK N ! !Q & ! ! ! !r.)rcr3rdrerfrgrr) rrrcr3rdrerfrgrr)rarr`r)r8rrrs @r,enable_tracingzPluginManager.enable_tracingsp JO''//  ) ) ) ) ) )  ' ' ' ' ' '++FE:::r.remove_pluginsIterable[_Plugin]crt|j}fd|D}|rt||S|S)zReturn a proxy :class:`~pluggy.HookCaller` instance for the named method which manages calls to all registered plugins except the ones from remove_plugins.c4h|]}t||SrW)hasattr)rplugrFs r,rz3PluginManager.subset_hook_caller..s(TTTdd@S@STTTTTr.)rNr^r)r8rFrorigplugins_to_removes ` r,subset_hook_callerz PluginManager.subset_hook_callersN #49d33TTTTnTTT  >$T+<== = r.)rIr3rr) rcr3rdrerfrgrhrirrjr5)r1rrFrnrrn)r1rrFr3rr)NN)r1rrFrnrrL)rFr3rr)rFr3rri)rrrr)rrrFr3rr)rr)r1rrri)r1rrr3)rFr3rrL)r1rrrn)r^rrrrrr)rr3rFrnrr)rr)rr)r1rrr)rrrrrr)rr)rFr3rrrr)r:r;r<r=r7rmrrwrrrrrrrrrtrrrrzrrrrrrrr rWr.r,rYrYPs< * * * * M M M M11111f4AE@'''' MMMM4$HHHHHHHH ' ' ' '++++1111....` <++++ //// ####J;;;;2      r.rYr+r3c<|jtj|Sr5)r:r signature)r+s r,rr s m 6W.t44 6 66r.)rrrrrr)r+rrr3)+ __future__rcollections.abcrrrrr#typingrrr r r r%r _callersr_hooksrrrrrrrrrr_resultrrrr3rrr-rr0r@rYrrWr.r,rs""""""$$$$$$######$$$$$$   %%%%%%%%%%%%  ++++++hx0'#s(2CDdJK s S(8*OPRVVW      I   CCCCCCCC$wwwwwwwwt 777777r.