0Ic9ddlZddlZddlZddlmZddlmZmZddlm Z m Z m Z m Z ej dkrddlmZnddlZdZGd d eZGd d ZGd dZdZdS)N)_tracing)_Result _multicall)HookImpl _HookRelay _HookCallernormalize_hookimpl_opts)metadatacxtj|t||jj|jjdS)N)linenofilename)warnings warn_explicittype__code__co_firstlineno co_filename)warningfunctions /lib/python3.11/site-packages/pluggy/_manager.py_warn_for_functionrsD  W  /". c"eZdZdZfdZxZS)PluginValidationErrorzplugin failed validation. :param object plugin: the plugin which failed validation, may be a module or an arbitrary object. cf||_tt||dSN)pluginsuper Exception__init__)selfr!message __class__s rr$zPluginValidationError.__init__s.  i''00000r)__name__ __module__ __qualname____doc__r$ __classcell__)r's@rrrsB 111111111rrc<eZdZdZdZedZddZdZdS) DistFacadez$Emulate a pkg_resources Distributionc||_dSr )_dist)r%dists rr$zDistFacade.__init__'s  rc|jdS)Nnamer r%s r project_namezDistFacade.project_name*s}V$$rNc.t|j||Sr )getattrr0)r%attrdefaults r __getattr__zDistFacade.__getattr__.stz4111rcNtt|jddgzS)Nr0r5)sorteddirr0r4s r__dir__zDistFacade.__dir__1s"c$*oo.(AABBBrr ) r(r)r*r+r$propertyr5r:r>rrr.r.$sl..%%X%2222CCCCCrr.ceZdZdZdZdZddZdZddZdZ d Z d Z d Z d Z d ZdZdZdZdZdZdZddZdZdZdZdZdZdZdS) 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 jd|_t|_ t|_ dS)N pluginmanage) r5 _name2plugin_plugin2hookcallers_plugin_distinfor TagTracergettracerhookr_inner_hookexec)r%r5s rr$zPluginManager.__init__DsY(#% "'))--n== LL )rc2|||||Sr rL)r% hook_namemethodskwargs firstresults r _hookexeczPluginManager._hookexecMs##Iw LLLrNc:|p||}||jvs ||jvr:|j|ddSt d|d|d|j||j|<gx|j|<}t |D]}|||}|t|t||}t||||}|dp|}t|j |d}|,t||j }t|j ||n?|r+||||||||||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== $+ + v9Q/Q  $$["55 *;;(9(9; *0+&:<; (;KK ) )D 44VTBBM )' 666 ..#FKOO$((44<ty$558&tT^<t-D-LLrcg}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 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$GGI #TYd33<$T4>?IVVBDItR0000(()DDD(*(8(8(:(:<< ))"l;;;; T""" VD$5VV?VV   rcTt||}t||jdzdS)N_spec)r7r5)r%rr3res rr}z!PluginManager.parse_hookspec_optss+$//vt07:DAAArc*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_registereds111rc\t|ddptt|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' vz400CC6 OOCrc6|j|S)z/Return a plugin or ``None`` for the given name.)rErIrxs rrqzPluginManager.get_plugins $$T***rc0||duS)z>Return ``True`` if a plugin with the given name is registered.N)rqrxs r has_pluginzPluginManager.has_pluginst$$D00rcX|jD]\}}||kr|cSdS)z@Return name for registered plugin or ``None`` if not registered.N)rEitems)r%r!r3vals rrpzPluginManager.get_namesH*0022  ID#}     rc t|r-|jr&t|jd|jd|jd|jjrt|jj|j t|j t|jj z }|r>t|jd|jd|jdt|j d|d |jrTtj|j s=t|jd|jd|jdt|j ddSdS) 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_hookst      ("6 ''''4  9 ! J ty5x7H I I I)**S1C-D-DD  ' (((IIIx01111II      (CHDU(V(V ''''Jx?P4Q4Q4Q4QS     rc  |jjD]u}|ddkrgt|j|}|s>|D])}|js t |jd|d|j*vdS)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_pendingsI&  DAw#~ ty$//}}$($6$6$8$8'4"7 (#'44!:##  rcd}ttjD]}|jD]}|j|ksA| |j|ks4||js||jrO|}| ||j|j |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. rNrwr) listimportlib_metadata distributions entry_pointsgroupr3rqr{loadrgrGrar.)r%rr3countr1epr!s rload_setuptools_entrypointsz)PluginManager.load_setuptools_entrypoints s+9;;<<  D'  H%-/W_rw//  rw//  f27 333%,,fj6F6F-GHHH   rc*t|jS)zTreturn list of distinfo/plugin tuples for all setuptools registered plugins.)rrGr4s rlist_plugin_distinfoz"PluginManager.list_plugin_distinfo%sD)***rcNt|jS)z!return list of name/plugin pairs.)rrErr4s rlist_name_pluginzPluginManager.list_name_plugin*sD%++--...rc6|j|S)z.get all hook callers for the specified plugin.)rFrIrs rget_hookcallerszPluginManager.get_hookcallers.s'++F333rcDjfd}|_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}||S)Nc Sr r@)rR hook_implsrOrQoldcallsrzPPluginManager.add_hookcall_monitoring..traced_hookexec..Ds :v{KKr)r from_call get_result)rOrrQrRoutcomeafterbeforers```` rtraced_hookexecz>PluginManager.add_hookcall_monitoring..traced_hookexecAso F9j& 1 1 1'KKKKKKKKG E'9j& 9 9 9%%'' 'rc_dSr rN)rr%srundoz3PluginManager.add_hookcall_monitoring..undoKs#*D rrN)r%rrrrrs``` @radd_hookcall_monitoringz%PluginManager.add_hookcall_monitoring2sb& ( ( ( ( ( ( ( / + + + + + + rc|jjdfd}fd}|||S)z9enable tracing of hook calls and return an undo function.rKcJjxjdz c_||dS)Nr)rootindent)rOrPrQ hooktraces rrz,PluginManager.enable_tracing..beforeTs1 N ! !Q & ! ! Ii ( ( ( ( (rc|j d|d|jxjdzc_dS)Nfinishz-->r)excinforrr)rrOrPrQrs rrz+PluginManager.enable_tracing..afterXsL L (Iug6H6H6J6JKKK N ! !Q & ! ! ! !r)rJrrIr)r%rrrs @renable_tracingzPluginManager.enable_tracingPsdJO''//  ) ) ) ) ) ' ' ' ' ' ++FE:::rct|j}fd|D}|rt|j|j|jj|jj}|D]P}|j }||vrC| ||j |g |Q|S|S)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.c4g|]}t||Sr@)hasattr).0plugr3s r z4PluginManager.subset_hook_caller..ds(TTTdd@S@STTTTTr)r7rKr r3rSr namespaceoptsrr!r`rF setdefaultra)r%r3remove_pluginsorigplugins_to_removerrfr!s ` rsubset_hook_callerz PluginManager.subset_hook_caller_sty$''TTTTnTTT   4>49+> B!..00 O O!!22O$$X...,77CCJJ2NNNI rr )NN)r(r)r*r+r$rSrgr[ruryr{rr}rrrYrqrrpr^rrrrrrrrr@rrrBrB5s  ***MMM $$$$L   &''' MMM.BBB---222DDD+++111 !!!F   2+++ ///444< ; ; ;rrBc<|jtj|Sr )r(rj signature)funcs rrrts m 6W.t44 6 66r)rjsysrr_callersrr_hooksrrr r version_info importlibrrrr#rr.rBrr@rrrsR ))))))))NNNNNNNNNNNNv8888888 1 1 1 1 1I 1 1 1CCCCCCCC"||||||||~ 77777r