o q_a(@sFddlmZddlmZmZddlmZddlmZGdddZdS))InvalidVersion)check_resourceminimum_version) version_lt)utilsc@seZdZdddZ    dddZedddd Zed d d Zed dd dZ ed   dddZ ed dddZ dS)NetworkApiMixinNcCsX|duri}|r ||d<|r||d<dt|i}|d}|j||d}|j|ddS) 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. Nnameidfiltersz /networksparamsTZjson)rconvert_filters_url_get_result)selfnamesZidsr r urlresr4/usr/lib/python3/dist-packages/docker/api/network.pynetworkss zNetworkApiMixin.networksFc Cs2|dur t|ts td|||||d} |dur0t|jdr#tdt|ts,td|| d<|r@t|jdr>> 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) Nzoptions must be a dictionary)NameZDriverZOptionsZIPAMZCheckDuplicatez1.23z*network labels were introduced in API 1.23zlabels must be a dictionaryZLabelsz&enable_ipv6 was introduced in API 1.23TZ EnableIPv61.22z9Internal networks are not supported in API version < 1.22ZInternalz1.24z1attachable is not supported in API version < 1.24Z Attachablez1.29z.ingress is not supported in API version < 1.29ZIngressz1.30z,scope is not supported in API version < 1.30ZScopez/networks/createdatar ) isinstancedict TypeErrorr_versionrr _post_jsonr)rrZdriveroptionsZipamZcheck_duplicateZinternallabelsZ enable_ipv6Z attachablescopeZingressrrrrrrcreate_network)s^7        zNetworkApiMixin.create_networkz1.25cCs6i}|r t||d<|d}||j||ddS)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/pruner T)rrrrZ_post)rr r rrrrprune_networkss  zNetworkApiMixin.prune_networksnet_idcCs$|d|}||}||dS)z Remove a network. Similar to the ``docker network rm`` command. Args: net_id (str): The network's id /networks/{0}N)rZ_delete_raise_for_status)rr'rrrrrremove_networks  zNetworkApiMixin.remove_networkcCsti}|durt|jdrtd||d<|dur&t|jdr"td||d<|d|}|j||d }|j|d 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``). Nz1.28z"verbose was introduced in API 1.28verbosez1.31z scope was introduced in API 1.31r$r(r Tr )rr rrrr)rr'r+r$r rrrrrinspect_networks    zNetworkApiMixin.inspect_network containerc CsD||j||||||dd} |d|} |j| | d} || dS)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) ContainerZEndpointConfigz/networks/{0}/connectrN)Zcreate_endpoint_configrr!r)) rr-r'r0r1r.r/r2r3rrrrrrconnect_container_to_networks z,NetworkApiMixin.connect_container_to_networkcCsPd|i}|rt|jdrtd||d<|d|}|j||d}||dS)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`` r4rz,Forced disconnect was introduced in API 1.22ZForcez/networks/{0}/disconnectrN)rr rrr!r))rr-r'Zforcerrrrrr!disconnect_container_from_networks   z1NetworkApiMixin.disconnect_container_from_network)NNN) NNNNFNFNNN)N)NN)NNNNNN)F) __name__ __module__ __qualname__rr%rr&rr*r,r5r6rrrrrs* ! r    $rN)errorsrrrrrrrrrrs