o Ó2.a­"ć@s"ddlmZmZGdd„dƒZdS)é)ŚauthŚutilsc@seZdZe d”e d”dd„ƒƒZe d”ddd„ƒZe d”dd „ƒZe d”dd d „ƒZ e d”d d„ƒZ e d”ddd„ƒZ e d”dd„ƒZ e d”dd„ƒZ e d”e d”dd„ƒƒZe d”e d”ddd„ƒƒZe d”e d”dd„ƒƒZdS) ŚPluginApiMixinz1.25ŚnamecCsH| d|”}|}t|tƒrdd„| ”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)ś=©)Ś.0ŚkŚvrrś3/usr/lib/python3/dist-packages/docker/api/plugin.pyŚ sz3PluginApiMixin.configure_plugin..)ŚdataT)Ś_urlŚ isinstanceŚdictŚitemsŚ _post_jsonŚ_raise_for_status)ŚselfrŚoptionsŚurlr Śresrrr Śconfigure_plugins   zPluginApiMixin.configure_pluginFcCsj| d”}tj||ttj |g”ƒd}|j|d|i|d}Wdƒn1s)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)ŚrootŚgzipŚfilesr)Śparamsr NT)rrZcreate_archiveŚsetZbuildŚwalkŚ_postr)rrZplugin_data_dirrrZarchvrrrr Ś create_plugins žü zPluginApiMixin.create_plugincCs$| d|”}| |”}| |”dS)a  Disable an installed plugin. Args: name (string): The name of the plugin. The ``:latest`` tag is optional, and is the default if omitted. Returns: ``True`` if successful z/plugins/{0}/disableT©rrr)rrrrrrr Śdisable_plugin5s  zPluginApiMixin.disable_pluginécCs0| 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}/enableŚtimeout©rTr!)rrr$rrrrrr Ś enable_pluginFs  zPluginApiMixin.enable_plugincCs| d|”}| | |”d”S)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}/jsonT©rŚ_resultŚ_get)rrrrrr Śinspect_pluginYs zPluginApiMixin.inspect_pluginNc Cst| d”}d|i}|r||d<i}t |”\}}t ||”} | r$| |d<|j||||dd} | | ”|j| ddS)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/pullŚremoterśX-Registry-AuthT©rŚheadersr Śstream©Śdecode©rrŚresolve_repository_nameŚget_config_headerrrŚ_stream_helper) rr+Ś privilegesrrrr.ŚregistryŚ repo_nameŚheaderŚresponserrr Ś pull_pluginhs ’ ž zPluginApiMixin.pull_plugincCs| d”}| | |”d”S)z Retrieve a list of installed plugins. Returns: A list of dicts, one per plugin z/pluginsTr')rrrrr ŚpluginsŽs zPluginApiMixin.pluginscCsTd|i}i}t |”\}}t ||”}|r||d<| d”}| |j|||dd”S)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 r+r,z/plugins/privileges)rr.T)rr3r4rr(r))rrrr.r7r8r9rrrr Śplugin_privileges™s’  ’z PluginApiMixin.plugin_privilegescCs\| d|”}i}t |”\}}t ||”}|r||d<|j||d}| |”|j|ddS)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}/pullr,)r.Tr0)rrr3r4rrr5)rrrr.r7r8r9rrrr Ś push_plugin¶s   zPluginApiMixin.push_plugincCs,| d|”}|j|d|id}| |”dS)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}Śforcer%T)rZ_deleter)rrr?rrrrr Ś remove_pluginĪs  zPluginApiMixin.remove_pluginz1.26c Csj| d|”}d|i}i}t |”\}}t ||”} | r| |d<|j||||dd} | | ”|j| ddS)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}/upgrader+r,Tr-r0r2) rrr+r6rrr.r7r8r9r:rrr Śupgrade_pluginās ’ ž zPluginApiMixin.upgrade_plugin)F)r#)N)Ś__name__Ś __module__Ś __qualname__rZminimum_versionZcheck_resourcerr r"r&r*r;r<r=r>r@rArrrr rs6      %   rN)Śrrrrrrr Śs