HEX

File: //lib/python3/dist-packages/docker/api/__pycache__/network.cpython-310.pyc
o

q_a�(�@sFddlmZddlmZmZddlmZddlmZGdd�d�ZdS)�)�InvalidVersion)�check_resource�minimum_version)�
version_lt)�utilsc@s�eZdZddd�Z				ddd�Zed�ddd	��Zed
�dd��Zed
�dd
d��Z	ed�			ddd��Z
ed�	ddd��ZdS)�NetworkApiMixinNcCsX|duri}|r||d<|r||d<dt�|�i}|�d�}|j||d�}|j|dd�S)	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=[<driver-name>]`` Matches a network's driver.
                - ``label=[<key>]``, ``label=[<key>=<value>]`` 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.
        N�name�id�filtersz	/networks��paramsT��json)r�convert_filters�_url�_get�_result)�self�names�idsr
r�url�res�r�4/usr/lib/python3/dist-packages/docker/api/network.py�networkss
zNetworkApiMixin.networksFcCs2|dur
t|t�s
td��|||||d�}|dur0t|jd�r#td��t|t�s,td��||d<|r@t|jd�r<td��d	|d
<|rPt|jd�rLtd��d	|d
<|	durbt|jd�r^td��|	|d<|durtt|jd�rptd��||d<|
dur�t|jd�r�td��|
|d<|�d�}
|j|
|d�}|j|d	d�S)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)
        Nzoptions must be a dictionary)�Name�Driver�Options�IPAM�CheckDuplicatez1.23z*network labels were introduced in API 1.23zlabels must be a dictionary�Labelsz&enable_ipv6 was introduced in API 1.23T�
EnableIPv6�1.22z9Internal networks are not supported in API version < 1.22�Internalz1.24z1attachable is not supported in API version < 1.24�
Attachablez1.29z.ingress is not supported in API version < 1.29�Ingressz1.30z,scope is not supported in API version < 1.30�Scopez/networks/create��datar
)	�
isinstance�dict�	TypeErrorr�_versionrr�
_post_jsonr)rr�driver�options�ipam�check_duplicate�internal�labels�enable_ipv6�
attachable�scope�ingressr(rrrrr�create_network)s^7��
����
zNetworkApiMixin.create_networkz1.25cCs6i}|rt�|�|d<|�d�}|�|j||d�d�S)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
rrrrr�prune_networks�s

zNetworkApiMixin.prune_networks�net_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)r�_delete�_raise_for_status)rr;rrrrr�remove_network�s
zNetworkApiMixin.remove_networkcCsti}|durt|jd�rtd��||d<|dur&t|jd�r"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.28�verbosez1.31z scope was introduced in API 1.31r6r<rTr
)rr,rrrr)rr;r@r6rrrrrr�inspect_network�szNetworkApiMixin.inspect_network�	containerc		CsD||j||||||d�d�}	|�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.
        )�aliases�links�ipv4_address�ipv6_address�link_local_ips�
driver_opt)�	Container�EndpointConfigz/networks/{0}/connectr'N)�create_endpoint_configrr-r>)rrBr;rErFrCrDrGrHr(rrrrr�connect_container_to_network�s��	z,NetworkApiMixin.connect_container_to_networkcCsPd|i}|rt|jd�rtd��||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``
        rIr"z,Forced disconnect was introduced in API 1.22�Forcez/networks/{0}/disconnectr'N)rr,rrr-r>)rrBr;�forcer(rrrrr�!disconnect_container_from_network�s
�z1NetworkApiMixin.disconnect_container_from_network)NNN)
NNNNFNFNNN)N)NN)NNNNNN)F)�__name__�
__module__�__qualname__rr8rr:rr?rArLrOrrrrrs*
!
�r
�$�rN)�errorsrrrrr�rrrrr�<module>s