o Nrf#@s"ddlmZmZGdddZdS))authutilsc@seZdZededddZeddddZedddd Zeddd d Z edd dZ eddddZ edddZ edddZ ededddZededdddZededddZdS) PluginApiMixinz1.25namecCsH|d|}|}t|trdd|D}|j||d}||dS)aC Configure a plugin. Args: name (string): The name of the plugin. The ``:latest`` tag is optional, and is the default if omitted. options (dict): A key-value mapping of options Returns: ``True`` if successful z/plugins/{0}/setcSsg|] \}}|d|qS)=).0kvrrZ/var/www/html/software/conda/envs/catlas/lib/python3.10/site-packages/docker/api/plugin.py sz3PluginApiMixin.configure_plugin..)dataT)_url isinstancedictitems _post_json_raise_for_status)selfroptionsurlr resrrr configure_plugins   zPluginApiMixin.configure_pluginFcCsj|d}tj||ttj|gd}|j|d|i|d}Wdn1s)wY||dS)a* Create a new plugin. Args: name (string): The name of the plugin. The ``:latest`` tag is optional, and is the default if omitted. plugin_data_dir (string): Path to the plugin data directory. Plugin data directory must contain the ``config.json`` manifest file and the ``rootfs`` directory. gzip (bool): Compress the context using gzip. Default: False Returns: ``True`` if successful z/plugins/create)rootgzipfilesr)paramsr NT)rrcreate_archivesetbuildwalk_postr)rrZplugin_data_dirrrZarchvrrrr create_plugins  zPluginApiMixin.create_plugincC,|d|}|j|d|id}||dS)aP Disable an installed plugin. Args: name (string): The name of the plugin. The ``:latest`` tag is optional, and is the default if omitted. force (bool): To enable the force query parameter. Returns: ``True`` if successful z/plugins/{0}/disableforcerTrr!rrrr$rrrrr disable_plugin5s  zPluginApiMixin.disable_plugincCs0|d|}d|i}|j||d}||dS)aV Enable an installed plugin. Args: name (string): The name of the plugin. The ``:latest`` tag is optional, and is the default if omitted. timeout (int): Operation timeout (in seconds). Default: 0 Returns: ``True`` if successful z/plugins/{0}/enabletimeoutr%Tr&)rrr*rrrrrr enable_pluginGs  zPluginApiMixin.enable_plugincCs|d|}|||dS)a Retrieve plugin metadata. Args: name (string): The name of the plugin. The ``:latest`` tag is optional, and is the default if omitted. Returns: A dict containing plugin info z/plugins/{0}/jsonTr_result_get)rrrrrr inspect_pluginZs zPluginApiMixin.inspect_pluginNc Cst|d}d|i}|r||d<i}t|\}}t||} | r$| |d<|j||||dd} || |j| ddS)a Pull and install a plugin. After the plugin is installed, it can be enabled using :py:meth:`~enable_plugin`. Args: remote (string): Remote reference for the plugin to install. The ``:latest`` tag is optional, and is the default if omitted. privileges (:py:class:`list`): A list of privileges the user consents to grant to the plugin. Can be retrieved using :py:meth:`~plugin_privileges`. name (string): Local name for the pulled plugin. The ``:latest`` tag is optional, and is the default if omitted. Returns: An iterable object streaming the decoded API logs z /plugins/pullremoterX-Registry-AuthTrheadersr streamdecoderrresolve_repository_nameget_config_headerrr_stream_helper) rr0 privilegesrrrr3registry repo_nameheaderresponserrr pull_pluginis   zPluginApiMixin.pull_plugincCs|d}|||dS)z Retrieve a list of installed plugins. Returns: A list of dicts, one per plugin z/pluginsTr,)rrrrr pluginss zPluginApiMixin.pluginscCsTd|i}i}t|\}}t||}|r||d<|d}||j|||ddS)al Retrieve list of privileges to be granted to a plugin. Args: name (string): Name of the remote plugin to examine. The ``:latest`` tag is optional, and is the default if omitted. Returns: A list of dictionaries representing the plugin's permissions r0r1z/plugins/privileges)rr3T)rr8r9rr-r.)rrrr3r<r=r>rrrr plugin_privilegess  z PluginApiMixin.plugin_privilegescCs\|d|}i}t|\}}t||}|r||d<|j||d}|||j|ddS)a Push a plugin to the registry. Args: name (string): Name of the plugin to upload. The ``:latest`` tag is optional, and is the default if omitted. Returns: ``True`` if successful z/plugins/{0}/pullr1)r3Tr5)rrr8r9r!rr:)rrrr3r<r=r>rrrr push_plugins   zPluginApiMixin.push_plugincCr#)a Remove an installed plugin. Args: name (string): Name of the plugin to remove. The ``:latest`` tag is optional, and is the default if omitted. force (bool): Disable the plugin before removing. This may result in issues if the plugin is in use by a container. Returns: ``True`` if successful z /plugins/{0}r$r%T)r_deleterr'rrr remove_plugins  zPluginApiMixin.remove_pluginz1.26c Csj|d|}d|i}i}t|\}}t||} | r| |d<|j||||dd} || |j| ddS)a Upgrade an installed plugin. Args: name (string): Name of the plugin to upgrade. The ``:latest`` tag is optional and is the default if omitted. remote (string): Remote reference to upgrade to. The ``:latest`` tag is optional and is the default if omitted. privileges (:py:class:`list`): A list of privileges the user consents to grant to the plugin. Can be retrieved using :py:meth:`~plugin_privileges`. Returns: An iterable object streaming the decoded API logs z/plugins/{0}/upgrader0r1Tr2r5r7) rrr0r;rrr3r<r=r>r?rrr upgrade_plugins   zPluginApiMixin.upgrade_plugin)F)r))N)__name__ __module__ __qualname__rminimum_versionZcheck_resourcerr"r(r+r/r@rArBrCrErFrrrr rs6      %   rN)rrrrrrr s