2.a"(ddlmZmZGddZy))authutilsceZdZejdej ddZejdddZejddZejdddZ ejddZ ejddd Z ejdd Z ejdd Z ejdej dd Zejdej ddd Zejdej ddZy)PluginApiMixinz1.25namec|jd|}|}t|tr'|jDcgc] \}}|d|}}}|j ||}|j |ycc}}w)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}/set=)dataT)_url isinstancedictitems _post_json_raise_for_status)selfroptionsurlr kvress 3/usr/lib/python3/dist-packages/docker/api/plugin.pyconfigure_pluginzPluginApiMixin.configure_pluginssii*D1 dD !+/::<841aqc1#J8D8ooco- s#9sA1c |jd}tj||ttjj |g5}|j |d|i|}ddd|jy#1swYxYw)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)r rcreate_archivesetbuildwalk_postr)rrplugin_data_dirrrarchvrs r create_pluginzPluginApiMixin.create_plugins ii)*  ! ! tekk&&;<  E**S&$e*DC  E s#  E Es BB cl|jd|}|j|}|j|y)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}/disableTr r"r)rrrrs rdisable_pluginzPluginApiMixin.disable_plugin5s3ii.5jjo s#cx|jd|}d|i}|j||}|j|y)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}/enabletimeoutrTr')rrr+rrrs r enable_pluginzPluginApiMixin.enable_pluginFsBii-t4W%jjVj, s#r)ch|jd|}|j|j|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)rrrs rinspect_pluginzPluginApiMixin.inspect_pluginYs.ii+T2||DIIcND11r)Nc|jd}d|i}|r||d<i}tj|\}}tj||} | r| |d<|j ||||d} |j | |j | dS)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 streamdecoder rresolve_repository_nameget_config_headerrr_stream_helper) rr4 privilegesrrrr7registry repo_nameheaderresponses r pull_pluginzPluginApiMixin.pull_pluginhs&ii( f  !F6N"::6B)''h7 )/G% &?? j#  x(""8D"99r)cf|jd}|j|j|dS)z Retrieve a list of installed plugins. Returns: A list of dicts, one per plugin z/pluginsTr/)rrs rpluginszPluginApiMixin.pluginss+ii #||DIIcND11r)cd|i}i}tj|\}}tj||}|r||d<|jd}|j |j |||dS)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 r4r5z/plugins/privileges)rr7T)rr<r=r r0r1)rrrr7r@rArBrs rplugin_privilegesz PluginApiMixin.plugin_privilegess d "::4@)''h7 )/G% &ii-.|| IIc&'I :D  r)c|jd|}i}tj|\}}tj||}|r||d<|j ||}|j ||j |dS)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}/pullr5)r7Tr9)r rr<r=r"rr>)rrrr7r@rArBrs r push_pluginzPluginApiMixin.push_pluginsii+T2"::4@)''h7 )/G% &jjgj. s#""3t"44r)ct|jd|}|j|d|i}|j|y)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)rrrLrrs r remove_pluginzPluginApiMixin.remove_plugins<ii-ll3'7l8 s#r)z1.26c|jd|}d|i}i}tj|\}}tj||} | r| |d<|j ||||d} |j | |j | dS)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}/upgrader4r5Tr6r9r;) rrr4r?rrr7r@rArBrCs rupgrade_pluginzPluginApiMixin.upgrade_plugins&ii.5 f "::6B)''h7 )/G% &?? j#  x(""8D"99r))F))N)__name__ __module__ __qualname__rminimum_versioncheck_resourcerr%r(r-r2rDrFrHrJrNrPr)rrrsU6"U&!"#(U6"#2U6"# U6"#$U6" 2# 2U6"#:##:JU6"2#2U6" # 8U6"U&!5"#5,U6"U&!"#$U6"U&! :"# :r)rN)rrrrWr)rrYs@:@:r)