U ™K7\Ô"ã@s,ddlZddlmZmZGdd„deƒZdS)éNé)Ú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¡d dd„ƒƒZe d¡e d¡dd„ƒƒZdS)!ÚPluginApiMixinz1.25ÚnamecCsJ| d|¡}|}t|tƒr.dd„t |¡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)z{0}={1})Úformat)Ú.0ÚkÚv©r ú3/usr/lib/python3/dist-packages/docker/api/plugin.pyÚ sz3PluginApiMixin.configure_plugin..)ÚdataT)Ú_urlÚ isinstanceÚdictÚsixZ iteritemsÚ _post_jsonÚ_raise_for_status)ÚselfrZoptionsÚurlrÚresr r r Úconfigure_plugins   zPluginApiMixin.configure_pluginFc CsV| d¡}tj||ttj |g¡ƒd}|j|d|i|d}W5QRX| |¡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)ÚparamsrT)rrZcreate_archiveÚsetZbuildÚwalkÚ_postr)rrZplugin_data_dirrrZarchvrr r r Ú 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)rrrrr r r Údisable_plugin7s   zPluginApiMixin.disable_pluginrcCs0| 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#rrrr r r Ú enable_pluginHs  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)rrrr r r Úinspect_plugin[s zPluginApiMixin.inspect_pluginNc Cst| d¡}d|i}|r||d<i}t |¡\}}t ||¡} | rH| |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*Ú privilegesrrrr-ÚregistryÚ repo_nameÚheaderÚresponser r r Ú pull_pluginjs( ÿ þ zPluginApiMixin.pull_plugincCs| d¡}| | |¡d¡S)z Retrieve a list of installed plugins. Returns: A list of dicts, one per plugin z/pluginsTr&)rrr r r Úpluginss zPluginApiMixin.pluginscCsTd|i}i}t |¡\}}t ||¡}|r2||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*r+z/plugins/privileges)rr-T)rr2r3rr'r()rrrr-r6r7r8rr r r Úplugin_privileges›sÿ  ÿz PluginApiMixin.plugin_privilegescCs\| d|¡}i}t |¡\}}t ||¡}|r6||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}/pullr+)r-Tr/)rrr2r3rrr4)rrrr-r6r7r8rr r r Ú 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>rrr r r Ú 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*r+Tr,r/r1) rrr*r5rrr-r6r7r8r9r r r Úupgrade_pluginäs$ ÿ þ zPluginApiMixin.upgrade_plugin)F)r)N)F)Ú__name__Ú __module__Ú __qualname__rZminimum_versionZcheck_resourcerr r"r%r)r:r;r<r=r?r@r r r r rs4      %   r)rÚrrÚobjectrr r r r Ús