Wwg UddlZddlmZmZmZmZddlZddlmZddl m Z gdZ GddejZ gZee ed<d Zd Zy) N)ClassVarContextManagerListOptional) CLIContext)Signer)SigningCommandPluginregister_signing_pluginrSIGNING_PLUGIN_REGISTRY SIGNING_PLUGIN_ENTRY_POINT_GROUPceZdZUdZeeed< eeed< dZeeeed< de e jfdZ de e jfdZdefd Zd edeefd Zy) r a .. versionadded:: 0.18.0 Interface for integrating custom, user-supplied signers into the pyHanko CLI as subcommands of ``addsig``. Implementations are discovered through the ``pyhanko.cli_plugin.signing`` package entry point. Such entry points can be registered in ``pyproject.toml`` as follows: .. code-block:: toml [project.entry-points."pyhanko.cli_plugin.signing"] your_plugin = "some_package.path.to.module:SomePluginClass" Subclasses exposed as entry points are required to have a no-arguments ``__init__`` method. .. warning:: This is an incubating feature. API adjustments are still possible. .. warning:: Plugin support requires Python 3.8 or later. subcommand_name help_summaryNunavailable_messagereturnct)zH The list of ``click`` options for your custom command. NotImplementedErrorselfs M/var/www/horilla/myenv/lib/python3.12/site-packages/pyhanko/cli/plugin_api.py click_optionsz"SigningCommandPlugin.click_options<s "!cgS)zJ The list of ``click`` arguments for your custom command. rs rclick_extra_argumentsz*SigningCommandPlugin.click_extra_argumentsBs  rcy)a A hook to determine whether your plugin is available or not (e.g. based on the availability of certain dependencies). This should not depend on the pyHanko configuration, but may query system information in other ways as appropriate. The default is to always report the plugin as available. :return: return ``True`` if the plugin is available, else ``False`` Trrs r is_availablez!SigningCommandPlugin.is_availableHsrcontextc t)a Instantiate a context manager that creates and potentially also implements a deallocator for a :class:`.Signer` object. :param context: The active :class:`.CLIContext`. :param kwargs: All keyword arguments processed by ``click`` through the CLI, resulting from :meth:`click_options` and :meth:`click_extra_arguments`. :return: A context manager that manages the lifecycle for a :class:`.Signer`. r)rrkwargss r create_signerz"SigningCommandPlugin.create_signerVs "!r)__name__ __module__ __qualname____doc__rstr__annotations__rrrclickOptionrArgumentrboolrrrrr"rrrr r s4c]"3-48(3-07"tELL1" tENN'; d "!"  "rr r zpyhanko.cli_plugin.signingc:tj||S)z Manually put a plugin into the signing plugin registry. :param cls: A plugin class. :return: The same class. )r append)clss rr r ms""35) Jr)abctypingrrrrr)pyhanko.cli._ctxr pyhanko.signr__all__ABCr r r(r r rrrr6sO ;; ' T"377T"n79238#?  r