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)rrÚcreate_archiveÚsetÚbuildÚwalkÚ_postr)rrÚplugin_data_dirrrÚarchvrrrr Ú 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©rr!r)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| 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/pullÚremoterúX-Registry-AuthT©rÚheadersr Ústream©Údecode©rrÚresolve_repository_nameÚget_config_headerrrÚ_stream_helper) rr/Ú privilegesrrrr2Ú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|||dd¡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/r0z/plugins/privileges)rr2T)rr7r8rr,r-)rrrr2r;r<r=rrrr Úplugin_privileges™sÿ  ÿ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}/pullr0)r2Tr4)rrr7r8r!rr9)rrrr2r;r<r=rrrr Ú 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)rÚ_deleter)rrrCrrrrr Ú remove_pluginÎs  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}/upgrader/r0Tr1r4r6) rrr/r:rrr2r;r<r=r>rrr Úupgrade_pluginâs ÿ þ zPluginApiMixin.upgrade_plugin)F)r')N)Ú__name__Ú __module__Ú __qualname__rÚminimum_versionÚcheck_resourcerr$r&r*r.r?r@rArBrErFrrrr rs6      %   rN)Úrrrrrrr Ús