B `0@sdZddlZddlZddlZddlmZmZGdddeZGdddeZ d d Z e ed rhd d Z ndd Z e edoej jdkZddZGdddeZGdddeZGdddeZGdddeZdS)zA Internal hook annotation, representation and calling machinery. N)_legacymulticall _multicallc@s"eZdZdZddZdddZdS) 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. cCs ||_dS)N) project_name)selfrrT/home/kop/projects/devel/pgwui/test_venv/lib/python3.7/site-packages/pluggy/hooks.py__init__szHookspecMarker.__init__NFcs*fdd}|dk r"||S|SdS)al 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. cs0rrtdt|jdtd|S)Nz'cannot have a historic firstresult hook_spec) firstresulthistoric warn_on_impl) ValueErrorsetattrrdict)func)r r rrrr setattr_hookspec_opts&s z6HookspecMarker.__call__..setattr_hookspec_optsNr)rfunctionr r rrr)r r rrr __call__szHookspecMarker.__call__)NFFN)__name__ __module__ __qualname____doc__r rrrrr r src@s"eZdZdZddZdddZdS) 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. cCs ||_dS)N)r)rrrrr r BszHookimplMarker.__init__NFcs,fdd}|dkr |S||SdS)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). c s"t|jdtd|S)N_impl) hookwrapper optionalhooktryfirsttrylast)rrr)r)rrrrrrr setattr_hookimpl_optses z6HookimplMarker.__call__..setattr_hookimpl_optsNr)rrrrrrr r)rrrrrr rEs  zHookimplMarker.__call__)NFFFF)rrrrr rrrrr r:srcCs4|dd|dd|dd|dddS)NrFrrr) setdefault)optsrrr normalize_hookimpl_optsxs   r#getfullargspeccCs t|S)N)inspectr$)rrrr _getargspecsr&cCs t|S)N)r% getargspec)rrrr r&spypy_version_infocCsht|di}y|dStk r(YnXt|rVy |j}Wqtk rRdSXn0t|syt|d|}Wntk rdSXy t|}Wnt k rdSXt |j |j }}|rt | }|d|t ||d}}nd}tsdnd}|r8t|s,d t|d dkr8|d |kr8|d d}y||f|d<Wnt k r^YnX||fS) zReturn 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. __dict__Z _varnames)rrrNr)r)robj.rrr)getattrKeyErrorr%isclassr AttributeError isroutine Exceptionr& TypeErrortupleargsdefaultslen_PYPY3ismethod)rcachespecr5r6indexkwargsZimplicit_namesrrr varnamessD          r>c@seZdZdZdS) _HookRelayzh hook holder object for performing 1:N hook calls where N is the number of registered plugins. N)rrrrrrrr r?sr?c@speZdZdddZddZddZdd Zd d Zd d ZddZ ddZ ddZ dddZ ddZ ddZdS) _HookCallerNcCsT||_g|_g|_||_d|_d|_t|_d|_|dk rP|dk sDt | ||dS)N) name _wrappers _nonwrappers _hookexecargnames kwargnamesr multicallr;AssertionErrorset_specification)rrAZ hook_executespecmodule_or_class spec_optsrrr r s z_HookCaller.__init__cCs |jdk S)N)r;)rrrr has_specsz_HookCaller.has_speccCs0|r tt||j||_|dr,g|_dS)Nr )rLrHHookSpecrAr;get _call_history)rrJrKrrr rIs  z_HookCaller.set_specificationcCs t|dS)NrO)hasattr)rrrr is_historicsz_HookCaller.is_historiccs:fdd}||jdkr6||jdkr6tdfdS)Ncs.x(t|D]\}}|jkr ||=dSq WdS)NT) enumerateplugin)wrappersimethod)rSrr removes z*_HookCaller._remove_plugin..removezplugin %r not found)rBrCr)rrSrWr)rSr _remove_plugins z_HookCaller._remove_plugincCs |j|jS)N)rCrB)rrrr get_hookimplssz_HookCaller.get_hookimplscCs|jr|j}n|j}|jr(|d|nN|jr:||n)rA)rrrr __repr__ sz_HookCaller.__repr__cOsv|r td|rt|jrd|jjrdt|jjtdgt|}|rdtjd t |dd| || |S)Nz,hook calling supports only keyword argumentsrZzTArgument(s) {} which are declared in the hookspec can not be found in this hook call) stacklevel) r3rQrHr;rEsetkeysr]r^formatr4rDrY)rr5r=Z notincallrrr rs "z_HookCaller.__call__cCsh|dk rtdt|}|j|p$i|f||||}|dkrJdSx|pRgD] }||qTWdS)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. .. note:: The ``proc`` argument is now deprecated. NzXSupport for `proc` argument is now deprecated and will beremoved in an upcoming release.)r]r^r_rOr\rDrY)rresult_callbackr=procresxrrr call_historic s z_HookCaller.call_historicc Csft|jt|jf}x2|D]*}tdddd}tdd||}||qWz |f|S|\|_|_XdS)z Call the hook with some additional temporarily participating methods using the specified ``kwargs`` as call parameters. F)rrrNz)listrCrBrHookImplrb)rrar=oldrVr"r`rrr call_extra;s  z_HookCaller.call_extracCsH|rDx:|jD]0\}}|||g|}|r|dk r||dqWdS)zJApply call history to a new hookimpl if it is marked as historic. Nr)rQrOrD)rrVr=rirkrrr _maybe_apply_historyHs  z _HookCaller._maybe_apply_history)NN)NNN)rrrr rLrIrQrXrYrbrcrrmrqrrrrrr r@s    r@c@seZdZddZddZdS)rocCs:||_t|j\|_|_||_||_||_|j|dS)N) rr>rErFrSr" plugin_namer*update)rrSrsrZhook_impl_optsrrr r Ss zHookImpl.__init__cCsd|j|jfS)Nz$)rsrS)rrrr rc[szHookImpl.__repr__N)rrrr rcrrrr roRsroc@seZdZddZdS)rMcCsT||_t|||_}||_t|\|_|_||_dgt|j|_| d|_ dS)NrZr) namespacer-rrAr>rErFr"rnrNr)rrurAr"rrrr r `szHookSpec.__init__N)rrrr rrrr rM_srM)rr%sysr]callersrrobjectrrr#rPr& version_infomajorr8r>r?r@rorMrrrr s"0>  4