Ae9ddlZddlZddlZddlmZddlmZmZddlm Z m Z m Z m Z ejdk\rddlmZnddlZdZGd d eZGd d ZGd dZdZy)N)_tracing)_Result _multicall)HookImpl _HookRelay _HookCallernormalize_hookimpl_opts)metadatactj|t||jj|jj y)N)linenofilename)warnings warn_explicittype__code__co_firstlineno co_filename)warningfunctions /lib/python3.12/site-packages/pluggy/_manager.py_warn_for_functionrs8  W   //"".. c"eZdZdZfdZxZS)PluginValidationErrorzplugin failed validation. :param object plugin: the plugin which failed validation, may be a module or an arbitrary object. c:||_tt||yN)pluginsuper Exception__init__)selfr!message __class__s rr$zPluginValidationError.__init__s  i'0r)__name__ __module__ __qualname____doc__r$ __classcell__)r's@rrrs 11rrc4eZdZdZdZedZddZdZy) DistFacadez$Emulate a pkg_resources Distributionc||_yr )_dist)r%dists rr$zDistFacade.__init__'s  rc |jdS)Nnamer r%s r project_namezDistFacade.project_name*s}}V$$rNc0t|j||Sr )getattrr0)r%attrdefaults r __getattr__zDistFacade.__getattr__.stzz411rcHtt|jddgzS)Nr0r5)sorteddirr0r4s r__dir__zDistFacade.__dir__1sc$**o.(AABBrr ) r(r)r*r+r$propertyr5r:r>rrr.r.$s).%%2Crr.ceZdZdZdZdZddZdZddZdZ d Z d Z d Z d Z d ZdZdZdZdZdZdZddZdZdZdZdZdZdZy) PluginManageraCore :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||_i|_i|_g|_t j j d|_t|_ t|_ y)N pluginmanage) r5 _name2plugin_plugin2hookcallers_plugin_distinfor TagTracergettracerhookr_inner_hookexec)r%r5s rr$zPluginManager.__init__DsN(#% "'')--n= L )rc*|j||||Sr rL)r% hook_namemethodskwargs firstresults r _hookexeczPluginManager._hookexecMs##Iw LLrNc|xs|j|}||jvs||jvr;|jj|dyt d|d|d|j||j|<gx|j|<}t |D]}|j ||}|t|t||}t||||}|jdxs|}t|j|d}|.t||j}t|j||n3|jr#|j|||j!||j#||j%||S)zRegister 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.NzPlugin already registered: = specname)get_canonical_namerErFrI ValueErrorr=parse_hookimpl_optsr r7rrKr rSsetattrhas_spec _verify_hook_maybe_apply_history _add_hookimplappend) r%r!r3 plugin_name hookcallers hookimpl_optsmethodhookimplrKs rregisterzPluginManager.registerRs~=d55f= $++ +v9Q9Q/Q  $$["5=(9(9; *0+&:<;  (;K )D 44VTBM(' 6 .#FKO$((4<tyy$5<&tT^^__T*F     &!!$'2266vrB .J  % %f - . rcF|j|d|j|<y)zHblock registrations of the given name, unregister if already registered.r3N)rurEr%r3s r set_blockedzPluginManager.set_blockeds  T""&$rcD||jvxr|j|duS)z4return ``True`` if the given plugin name is blocked.N)rErxs r is_blockedzPluginManager.is_blockeds(t(((LT->->t-D-LLrcg}t|D]}|j||}|t|j|d}|0t ||j ||}t |j||n9|j|||jD]}|j|||j||std|jd|y)zadd 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 ) r=parse_hookspec_optsr7rKr rSr\set_specification get_hookimplsr^rarZr5)r%module_or_classnamesr3 spec_optshc hookfunctions r add_hookspecszPluginManager.add_hookspecss( #D00$GI$TYYd3:$T4>>?IVBDIItR0(()D(*(8(8(:< ))"l;< T" ##D$5$5#8 ?BUV rcNt||}t||jdzdS)N_spec)r7r5)r%rr3res rr}z!PluginManager.parse_hookspec_optss($/vt007:DAArc,t|jS)z%return the set of registered plugins.)setrFr4s r get_pluginszPluginManager.get_pluginss4++,,rc||jvS)z4Return ``True`` if the plugin is already registered.)rFr%r!s r is_registeredzPluginManager.is_registereds1111rcHt|ddxstt|S)aVReturn 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)r7stridrs rrYz PluginManager.get_canonical_names vz40CC6 OCrc8|jj|S)z/Return a plugin or ``None`` for the given name.)rErIrxs rrqzPluginManager.get_plugins  $$T**rc(|j|duS)z>Return ``True`` if a plugin with the given name is registered.N)rqrxs r has_pluginzPluginManager.has_pluginst$D00rcZ|jjD]\}}||k(s |cSy)z@Return name for registered plugin or ``None`` if not registered.N)rEitems)r%r!r3vals rrpzPluginManager.get_names0**002 ID#}  rc |jr=|jr1t|jd|jd|j d|j jr*t|j j|jt|jt|j jz }|rJt|jd|jd|j dt|jd|d |jrgtj|jsGt|jd|jd|j dt|jdyy) NzPlugin z hook z% historic incompatible to hookwrapperz for hook z hookimpl definition: z Argument(s) zB are declared in the hookimpl but can not be found in the hookspeczF Declared as hookwrapper=True but function is not a generator function) is_historic hookwrapperrr!rbr3spec warn_on_implrrrargnames _formatdefrjisgeneratorfunction)r%rKrf notinspecs rr^zPluginManager._verify_hooks+    ("6"6'''4  99 ! ! tyy55x7H7H I))*S1C1C-DD ' ((IIx001     (C(CHDUDU(V'''Jx?P?P4QS )W rc (|jjD]y}|ddk7s t|j|}|jr3|j D]4}|j rt |jd|d|j{y)zVerify that all hooks which have not been verified against a hook specification are optional, otherwise raise :py:class:`.PluginValidationError`.r_z unknown hook z in plugin N)rK__dict__r7r]r optionalhookrr!)r%r3rKrfs r check_pendingzPluginManager.check_pendingsII&& DAw#~tyy$/}}$($6$6$8'44"7 (#'!:# rcd}ttjD]}|jD]}|j|k7sG||j |k7s6|j |j s|j|j rZ|j}|j||j |jj|t|f|dz }|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. rrwr) listimportlib_metadata distributions entry_pointsgroupr3rqr{loadrgrGrar.)r%rr3countr1epr!s rload_setuptools_entrypointsz)PluginManager.load_setuptools_entrypoints s+99;< D'' HH%(RWW_rww/rww/ f277 3%%,,fj6F-GH    rc,t|jS)zTreturn list of distinfo/plugin tuples for all setuptools registered plugins.)rrGr4s rlist_plugin_distinfoz"PluginManager.list_plugin_distinfo%sD))**rcHt|jjS)z!return list of name/plugin pairs.)rrErr4s rlist_name_pluginzPluginManager.list_name_plugin*sD%%++-..rc8|jj|S)z.get all hook callers for the specified plugin.)rFrIrs rget_hookcallerszPluginManager.get_hookcallers.s''++F33rcNjfd}|_fd}|S)aPadd 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. ctjfd}||jS)NcSr r@)rR hook_implsrOrQoldcallsrzPPluginManager.add_hookcall_monitoring..traced_hookexec..Ds :v{Kr)r from_call get_result)rOrrQrRoutcomeafterbeforers```` rtraced_hookexecz>PluginManager.add_hookcall_monitoring..traced_hookexecAsA 9j& 1''KG '9j& 9%%' 'rc_yr rN)rr%srundoz3PluginManager.add_hookcall_monitoring..undoKs #*D rrN)r%rrrrrs``` @radd_hookcall_monitoringz%PluginManager.add_hookcall_monitoring2s+&& ( / + rc|jjjdfd}fd}|j||S)z9enable tracing of hook calls and return an undo function.rKcVjxjdz c_||y)Nr)rootindent)rOrPrQ hooktraces rrz,PluginManager.enable_tracing..beforeTs" NN ! !Q & ! i (rc|jd|d|jjxjdzc_y)Nfinishz-->r)excinforrr)rrOrPrQrs rrz+PluginManager.enable_tracing..afterXs9&(Iug6H6H6JK NN ! !Q & !r)rJrrIr)r%rrrs @renable_tracingzPluginManager.enable_tracingPs:JJOO''/  ) ' ++FE::rct|j|}|Dcgc]}t||s|}}|rt|j|j |j j|j j}|jD]O}|j}||vs|j||jj|gj|Q|S|Scc}w)zReturn a new :py:class:`._hooks._HookCaller` instance for the named method which manages calls to all registered plugins except the ones from remove_plugins.)r7rKhasattrr r3rSr namespaceoptsrr!r`rF setdefaultra) r%r3remove_pluginsorigplugplugins_to_removerrfr!s rsubset_hook_callerz PluginManager.subset_hook_caller_styy$'.<Tdd@STTT  4>>499+>+> B!..0 O!!22$$X.,,77CJJ2N  OI Us C%C%r )NN)r(r)r*r+r$rSrgr[ruryr{rr}rrrYrqrrpr^rrrrrrrrr@rrrBrB5s *M $L &' M.B-2D+1 !F 2+ /4< ;rrBcH|jtj|Sr )r(rj signature)funcs rrrts!mm_W..t45 66r)rjsysrr_callersrr_hooksrrr r version_info importlibrrrr#rr.rBrr@rrrs] )NNv8 1I 1CC"||~ 7r