h_dddlmZddlmZddlmZddlmZmZGddeZ Gdd eZ y ) ) APIClient) version_gte) Container)Model CollectioncBeZdZdZedZedZdZdZdZ y)Networkz A Docker network. c8|jjdS)z* The name of the network. Name)attrsgetselfs 8/usr/lib/python3/dist-packages/docker/models/networks.pynamez Network.name s zz~~f%%c|jjdxsijDcgc]'}|jjj|)c}Scc}w)z The containers that are connected to the network, as a list of :py:class:`~docker.models.containers.Container` objects. Containers)r rkeysclient containers)rcids rrzNetwork.containerssQZZ^^L ) /R 5 5 7 03DKK " " & &s +   s,Act|tr |j}|jjj ||jg|i|S)a Connect a container to this network. Args: container (str): Container to connect to this network, as either an ID, name, or :py:class:`~docker.models.containers.Container` object. 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 linkedto 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. driver_opt (dict): A dictionary of options to provide to the network driver. Defaults to ``None``. Raises: :py:class:`docker.errors.APIError` If the server returns an error. ) isinstanceridrapiconnect_container_to_networkr containerargskwargss rconnectzNetwork.connectsM6 i +! I;t{{;; tww !% )/  rct|tr |j}|jjj ||jg|i|S)a Disconnect a container from this network. Args: container (str): Container to disconnect from this network, as either an ID, name, or :py:class:`~docker.models.containers.Container` object. force (bool): Force the container to disconnect from a network. Default: ``False`` Raises: :py:class:`docker.errors.APIError` If the server returns an error. )rrrrr!disconnect_container_from_networkrs r disconnectzNetwork.disconnect>sM i +! I@t{{@@ tww !% )/  rc`|jjj|jS)z Remove this network. Raises: :py:class:`docker.errors.APIError` If the server returns an error. )rrremove_networkrrs rremovezNetwork.removeSs!{{--dgg66rN) __name__ __module__ __qualname____doc__propertyrrr#r&r)rrr r s?&&    B *7rr cdeZdZdZeZdZdZdZddZ e jje _y)NetworkCollectionz( Networks on the Docker server. c~|jjj|g|i|}|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: (:py:class:`Network`): The network that was created. Raises: :py:class:`docker.errors.APIError` If the server returns an error. Example: A network using the bridge driver: >>> client.networks.create("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.networks.create( "network1", driver="bridge", ipam=ipam_config ) Id)rrcreate_networkr)rrr!r"resps rcreatezNetworkCollection.createds<p.t{{--dDTDVDxxT ##rct|j|jjj|g|i|S)aU Get a network by its ID. Args: network_id (str): The ID of the network. verbose (bool): Retrieve the service details across the cluster in swarm mode. scope (str): Filter the network by scope (``swarm``, ``global`` or ``local``). Returns: (:py:class:`Network`) The network. Raises: :py:class:`docker.errors.NotFound` If the network does not exist. :py:class:`docker.errors.APIError` If the server returns an error. ) prepare_modelrrinspect_network)r network_idr!r"s rrzNetworkCollection.gets9,!! +DKKOO + +J H H H  rcB|jdd}|jjj|i|}|Dcgc]}|j |}}|rAt |jjj dr|D]}|j|Scc}w)a List networks. Similar to the ``docker networks 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` (str|list): format either ``"key"``, ``"key=value"`` or a list of such. - ``type=["custom"|"builtin"]`` Filters networks by type. greedy (bool): Fetch more details for each network individually. You might want this to get the containers attached to them. Returns: (list of :py:class:`Network`) The networks on the server. Raises: :py:class:`docker.errors.APIError` If the server returns an error. greedyFz1.28)poprrnetworksr8r_versionreload)rr!r"r<r5itemr>nets rlistzNetworkCollection.lists.He,'t{{''889=>D&&t,>> k$++//":":FC    ?sBNcN|jjj|S)N)filters)rrprune_networks)rrEs rprunezNetworkCollection.prunes{{--g->>r)N) r*r+r,r-r modelr6rrCrGrrFr/rrr1r1^s6 E9$v 4>?,,44EMrr1N) rrutilsrrrresourcerrr r1r/rrrKs.!'T7eT7n|5 |5r