q_a(LddlmZddlmZmZddlmZddlmZGddZy))InvalidVersion)check_resourceminimum_version) version_lt)utilsceZdZd dZ d dZedddZeddZedddZ ed  dd Z ed  dd Z y)NetworkApiMixinNc|i}|r||d<|r||d<dtj|i}|jd}|j||}|j |dS)a List networks. Similar to the ``docker network ls`` command. Args: names (:py:class:`list`): List of names to filter by ids (:py:class:`list`): List of ids to filter by filters (dict): Filters to be processed on the network list. Available filters: - ``driver=[]`` Matches a network's driver. - ``label=[]``, ``label=[=]`` or a list of such. - ``type=["custom"|"builtin"]`` Filters networks by type. Returns: (dict): List of network objects. Raises: :py:class:`docker.errors.APIError` If the server returns an error. nameidfiltersz /networksparamsTjson)rconvert_filters_url_get_result)selfnamesidsr rurlress 4/usr/lib/python3/dist-packages/docker/api/network.pynetworkszNetworkApiMixin.networkssn, ?G #GFO GDMU227;<ii $iiFi+||Cd|++c |t|ts td|||||d} |At|jdr t dt|ts td|| d<|r&t|jdr t dd| d <|r&t|jd r t d d| d <| &t|jd r t d| | d<| &t|jdr t d| | d<| &t|jdr t d| | d<|j d} |j| | }|j|dS)a Create a network. Similar to the ``docker network create``. Args: name (str): Name of the network driver (str): Name of the driver used to create the network options (dict): Driver options as a key-value dictionary ipam (IPAMConfig): Optional custom IP scheme for the network. check_duplicate (bool): Request daemon to check for networks with same name. Default: ``None``. internal (bool): Restrict external access to the network. Default ``False``. labels (dict): Map of labels to set on the network. Default ``None``. enable_ipv6 (bool): Enable IPv6 on the network. Default ``False``. attachable (bool): If enabled, and the network is in the global scope, non-service containers on worker nodes will be able to connect to the network. scope (str): Specify the network's scope (``local``, ``global`` or ``swarm``) ingress (bool): If set, create an ingress network which provides the routing-mesh in swarm mode. Returns: (dict): The created network reference object Raises: :py:class:`docker.errors.APIError` If the server returns an error. Example: A network using the bridge driver: >>> client.api.create_network("network1", driver="bridge") You can also create more advanced networks with custom IPAM configurations. For example, setting the subnet to ``192.168.52.0/24`` and gateway address to ``192.168.52.254``. .. code-block:: python >>> ipam_pool = docker.types.IPAMPool( subnet='192.168.52.0/24', gateway='192.168.52.254' ) >>> ipam_config = docker.types.IPAMConfig( pool_configs=[ipam_pool] ) >>> client.api.create_network("network1", driver="bridge", ipam=ipam_config) zoptions must be a dictionary)NameDriverOptionsIPAMCheckDuplicatez1.23z*network labels were introduced in API 1.23zlabels must be a dictionaryLabelsz&enable_ipv6 was introduced in API 1.23T EnableIPv61.22z9Internal networks are not supported in API version < 1.22Internalz1.24z1attachable is not supported in API version < 1.24 Attachablez1.29z.ingress is not supported in API version < 1.29Ingressz1.30z,scope is not supported in API version < 1.30Scopez/networks/createdatar) isinstancedict TypeErrorr_versionrr _post_jsonr)rr driveroptionsipamcheck_duplicateinternallabels enable_ipv6 attachablescopeingressr,rrs rcreate_networkzNetworkApiMixin.create_network)sn  z'4'@:; ;-    $--0$@fd+ =>>#DN $--0$<"&D  $--0$&GHH#D   !$--0$G",D   $--0$D&DO  $--0$B"DMii*+ooco-||Cd|++rz1.25ci}|rtj||d<|jd}|j|j ||dS)a Delete unused networks Args: filters (dict): Filters to process on the prune list. Returns: (dict): A dict containing a list of deleted network names and the amount of disk space reclaimed in bytes. Raises: :py:class:`docker.errors.APIError` If the server returns an error. r z/networks/prunerT)rrrr_post)rr rrs rprune_networkszNetworkApiMixin.prune_networkssN   % 5 5g >F9 ii)*||DJJs6J:DAArnet_idcl|jd|}|j|}|j|y)z Remove a network. Similar to the ``docker network rm`` command. Args: net_id (str): The network's id /networks/{0}N)r_delete_raise_for_status)rr@rrs rremove_networkzNetworkApiMixin.remove_networks0ii0ll3 s#rci}|&t|jdr td||d<|&t|jdr td||d<|jd|}|j ||}|j |d S) aD Get detailed information about a network. Args: net_id (str): ID of network verbose (bool): Show the service details across the cluster in swarm mode. scope (str): Filter the network by scope (``swarm``, ``global`` or ``local``). z1.28z"verbose was introduced in API 1.28verbosez1.31z scope was introduced in API 1.31r:rBrTr)rr0rrrr)rr@rGr:rrrs rinspect_networkzNetworkApiMixin.inspect_networks  $--0$%IJJ 'F9   $--0$%GHH#F7Oii0iiFi+||Cd|++r containerc ||j||||||d} |jd|} |j| | } |j| y)a Connect a container to a network. Args: container (str): container-id/name to be connected to the network net_id (str): network id aliases (:py:class:`list`): A list of aliases for this endpoint. Names in that list can be used within the network to reach the container. Defaults to ``None``. links (:py:class:`list`): A list of links for this endpoint. Containers declared in this list will be linked to this container. Defaults to ``None``. ipv4_address (str): The IP address of this container on the network, using the IPv4 protocol. Defaults to ``None``. ipv6_address (str): The IP address of this container on the network, using the IPv6 protocol. Defaults to ``None``. link_local_ips (:py:class:`list`): A list of link-local (IPv4/IPv6) addresses. )aliaseslinks ipv4_address ipv6_addresslink_local_ips driver_opt) ContainerEndpointConfigz/networks/{0}/connectr+N)create_endpoint_configrr1rD) rrIr@rMrNrKrLrOrPr,rrs rconnect_container_to_networkz,NetworkApiMixin.connect_container_to_networksc2#"99u<).%: ii/8ooco- s#rcd|i}|r&t|jdr td||d<|jd|}|j ||}|j |y)aA Disconnect a container from a network. Args: container (str): container ID or name to be disconnected from the network net_id (str): network ID force (bool): Force the container to disconnect from a network. Default: ``False`` rQr&z,Forced disconnect was introduced in API 1.22Forcez/networks/{0}/disconnectr+N)rr0rrr1rD)rrIr@forcer,rrs r!disconnect_container_from_networkz1NetworkApiMixin.disconnect_container_from_networkskY' $--0$B"DMii2F;ooco- s#r)NNN) NNNNFNFNNN)N)NN)NNNNNN)F) __name__ __module__ __qualname__rr<rr?rrErHrTrXrrr r s,BDHDHAE#p,dVBB*H $ $H,,2K EI9=EI"$!"$HK 05$!$rr N)errorsrrrrrr r\rrr_s#3K$K$r