HEX

File: //usr/lib/python3/dist-packages/cloudinit/net/__pycache__/network_state.cpython-310.pyc
o

�Ad6��@s�UddlZddlZddlZddlmZmZmZmZddlm	Z	m
Z
ddlmZm
Z
mZmZmZmZmZmZmZer?ddlmZe�e�ZdZdgd�iZgd�Zd	d
ddd
ddddddddddd�dddddddddd dd!�d"�Zeeeeeffed#<d$e d%dfd&d'�Z!d(d)�Z"d*d+�Z#Gd,d-�d-e$�Z%d.d/�Z&Gd0d1�d1e'�Z(Gd2d3�d3�Z)Gd4d5�d5e(d6�Z*d7d8�Z+dEd:d;�Z,d<d=�Z-d>d?�Z.	@	dFdAe dBe/d%e)fdCdD�Z0dS)G�N)�
TYPE_CHECKING�Any�Dict�Optional)�safeyaml�util)	�find_interface_name_from_mac�get_interfaces_by_mac�ipv4_mask_to_net_prefix�ipv6_mask_to_net_prefix�
is_ip_network�is_ipv4_network�is_ipv6_address�is_ipv6_network�net_prefix_to_ipv4_mask��Renderer���version�config�
network_state)�	addresses�dhcp4�dhcp4-overrides�dhcp6�dhcp6-overrides�gateway4�gateway6�
interfaces�match�mtu�nameservers�renderer�set-name�	wakeonlan�	accept-raz	ad-selectzarp-intervalz
arp-ip-targetzarp-validatez
down-delayzfail-over-mac-policyz	lacp-ratezmii-monitor-intervalz	min-links�mode�gratuitous-arp�primaryzprimary-reselect-policyzup-delayztransmit-hash-policy)zbond-ad-selectzbond-arp-intervalzbond-arp-ip-targetzbond-arp-validatezbond-downdelayzbond-fail-over-maczbond-lacp-ratezbond-miimonzbond-min-linksz	bond-modezbond-num-grat-arpzbond-primaryzbond-primary-reselectzbond-updelayzbond-xmit-hash-policyzageing-time�priorityz
forward-delayz
hello-timezmax-agez	path-costz
port-priority�stp)�
bridge_ageing�bridge_bridgeprio�	bridge_fd�bridge_gcint�bridge_hello�
bridge_maxage�bridge_maxwait�bridge_pathcost�bridge_portprio�
bridge_stp�bridge_waitport)�bond�bridge�NET_CONFIG_TO_V2�dikt�returncCs"d|vsd|vrt�d�dSdS)z8Warn about deprecations of v2 properties for all devicesrrz�DEPRECATED: The use of `gateway4` and `gateway6` is deprecated. For more info check out: https://cloudinit.readthedocs.io/en/latest/topics/network-config-format-v2.htmlN��LOG�warning)r:�r?�=/usr/lib/python3/dist-packages/cloudinit/net/network_state.py�warn_deprecated_all_devicesVs
��rAcCst�|�}t�}|�|�|S�N)r�	read_conf�NetworkStateInterpreter�load)�
state_file�state�nsir?r?r@�from_state_file`s

rIcCs t|�}|D]}|�|�q|SrB)�set�discard)�expected�actual�missing�keyr?r?r@�	diff_keysgsrPc@seZdZdS)�InvalidCommandN)�__name__�
__module__�__qualname__r?r?r?r@rQnsrQcs�fdd�}|S)Ncst�����fdd��}|S)Ncs:�rt�|�}|rtd|�f���||g|�Ri|��S)Nz&Command missing %s of required keys %s)rPrQ)�self�command�args�kwargs�missing_keys)�func�
required_keysr?r@�	decoratorts
��z7ensure_command_keys.<locals>.wrapper.<locals>.decorator)�	functools�wraps)rZr\�r[)rZr@�wrapperss
z$ensure_command_keys.<locals>.wrapperr?)r[r`r?r_r@�ensure_command_keysrsracs eZdZdZ�fdd�Z�ZS)�CommandHandlerMetaaMetaclass that dynamically creates a 'command_handlers' attribute.

    This will scan the to-be-created class for methods that start with
    'handle_' and on finding those will populate a class attribute mapping
    so that those methods can be quickly located and called.
    csbi}|��D]\}}t|�r!|�d�r!|td�d�}|r!|||<q||d<tt|��||||�S)N�handle_�command_handlers)�items�callable�
startswith�len�superrb�__new__)�cls�name�parents�dctrd�	attr_name�attr�handles_what��	__class__r?r@rj�s�zCommandHandlerMeta.__new__)rRrSrT�__doc__rj�
__classcell__r?r?rrr@rb�srbc@s�eZdZefdedefdd�Zedefdd��Zedd	��Z	ed
d��Z
edd
��Zedd��Zddd�Z
ddd�Zdd�Zdd�Zededdfdd��ZdS)�NetworkStaterrcCs*t�|�|_||_|�dd�|_d|_dS)N�use_ipv6F)�copy�deepcopy�_network_state�_version�getrw�_has_default_route)rUrrr?r?r@�__init__�s
zNetworkState.__init__r;cCs
|jdS)Nr)rz�rUr?r?r@r��
zNetworkState.configcCs|jSrB)r{rr?r?r@r�szNetworkState.versioncC�(z|jddWStygYSw)N�dnsr"�rz�KeyErrorrr?r?r@�dns_nameservers��
�zNetworkState.dns_nameserverscCr�)Nr��searchr�rr?r?r@�dns_searchdomains�r�zNetworkState.dns_searchdomainscCs|jdur
|��|_|jSrB)r}�_maybe_has_default_routerr?r?r@�has_default_route�s

zNetworkState.has_default_routeNccs@�|j�di�}|��D]}|dur|Vq||�r|VqdS)Nr)rzr|�values)rU�filter_func�ifaces�ifacer?r?r@�iter_interfaces�s���zNetworkState.iter_interfacesccs8�|j�dg�D]}|dur||�r|Vq|VqdS�N�routes�rzr|)rUr��router?r?r@�iter_routes�s���zNetworkState.iter_routescCsh|��D]
}|�|�rdSq|��D]}|�dg�D]}|�dg�D]}|�|�r/dSq#qqdS)NT�subnetsr�F)r��_is_default_router�r|)rUr�r��subnetr?r?r@r��s
�

���z%NetworkState._maybe_has_default_routecCs d}|�d�dko|�d�|vS)N)z::z0.0.0.0�prefixr�network)r|)rUr��default_netsr?r?r@r��s�zNetworkState._is_default_routecCs,i}d|vr|d|d<|d|ifi|��S)z�Instantiates a `NetworkState` without interpreting its data.

        That means only `config` and `version` are copied.

        :param network_state: Network state data.
        :return: Instance of `NetworkState`.
        rrr?)rkrrXr?r?r@�to_passthrough�s	zNetworkState.to_passthroughrB)rRrSrT�NETWORK_STATE_VERSION�dict�intr~�propertyrrr�r�r�r�r�r�r��classmethodr�r?r?r?r@rv�s.��
�





	rvc@s�eZdZigggd�ddd�Zeddf	dHdd�Zed	efd
d��Zedd
��Z	e	j
dd
��Z	dd�Zdd�Zdd�Z
dd�ZdIdd�ZdIdd�ZdIdd�Zedg�dd ��Zedg�d!d"��Zegd#��d$d%��Zegd&��d'd(��Zedd)g�d*d+��Zedg�d,d-��Zd.d/�Zed0g�d1d2��Zed0g�d3d4��Zed5g�d6d7��Zd8d9�Zd:d;�Zd<d=�Zd>d?�Z d@dA�Z!dJdBdC�Z"dKdDdE�Z#dFdG�Z$dS)LrD�r"r�FN)rr�r�rwrr#�Optional[Renderer]cCs:||_||_t�|j�|_||jd<d|_i|_||_dS)NrF)	r{�_configrxry�initial_network_staterz�_parsed�_interface_dns_map�	_renderer)rUrrr#r?r?r@r~�s

z NetworkStateInterpreter.__init__r;cCsHddlm}|jdkrt|j|�rt�d�t�|j	�St|j
|jd�S)Nrr�zPassthrough netplan v2 config�r)�cloudinit.net.netplanrr{�
isinstancer�r=�debugrvr�r�rz)rU�NetplanRendererr?r?r@rs

z%NetworkStateInterpreter.network_statecCs|j�d�S�Nrwr�rr?r?r@rwsz NetworkStateInterpreter.use_ipv6cCs|j�d|i�dSr�)rz�update)rU�valr?r?r@rwscCs|j|j|jd�}t�|�S)Nr)r{r�rzr�dumps)rUrGr?r?r@�dumps
�
zNetworkStateInterpreter.dumpcCsvd|vr
t�d�td��t|d}t||�}|r'd|}t�|�t|��dd�|D�D]
}t||||�q.dS)Nrz$Invalid state, missing version fieldzInvalid state, missing keys: %scSsg|]}|dvr|�qS)r�r?)�.0�kr?r?r@�
<listcomp>.sz0NetworkStateInterpreter.load.<locals>.<listcomp>)r=�error�
ValueError�NETWORK_STATE_REQUIRED_KEYSrP�setattr)rUrGr[rY�msgrOr?r?r@rE!s


�zNetworkStateInterpreter.loadcCst�|j�SrB)rr�rzrr?r?r@�dump_network_state1sz*NetworkStateInterpreter.dump_network_statecCs|j|jd�S)N)rr)r{r�rr?r?r@�as_dict4szNetworkStateInterpreter.as_dictTcCsD|jdkr|j|d�d|_dS|jdkr |j|d�d|_dSdS)Nr��skip_brokenTr�)r{�parse_config_v1r��parse_config_v2)rUr�r?r?r@�parse_config7s



�z$NetworkStateInterpreter.parse_configcCs|jD]C}|d}z|j|}Wnty#}ztd|�|�d}~wwz|||�WqtyF|s5�tjd|dd�t�|���Yqw|j	�
�D]1\}}d}z	|jd|}Wntyo}ztd�
|��|�d}~ww|r}|\}	}
|	|
d�|d	<qLdS)
N�typez"No handler found for  command '%s'�Skipping invalid command: %sT��exc_inforzINameserver specified for interface {0}, but interface {0} does not exist!)rr�r�)r�rdr��RuntimeErrorrQr=r>r�r�r�rerzr��format)rUr�rV�command_type�handler�e�	interfacer�r�r"r�r?r?r@r�?sT
����������
���z'NetworkStateInterpreter.parse_config_v1cCs�ddlm}t|j|�rdS|j��D]K\}}|dvrqz|j|}Wnty6}ztd|�|�d}~wwz|||�|�	|�Wqt
y^|sM�tjd|dd�t�
|���YqwdS)Nrr)rr#z!No handler found for command '%s'r�Tr�)r�rr�r�r�rerdr�r��
_v2_commonrQr=r>r�r�)rUr�r�r�rVr�r�r?r?r@r�bs8����
���z'NetworkStateInterpreter.parse_config_v2rlcCs
|�|�SrB��handle_physical�rUrVr?r?r@�handle_loopback~r�z'NetworkStateInterpreter.handle_loopbackc
Cs(|j�di�}|�|di�}|�di���D]\}}|�||i�qt|�d��}|jsF|D]}|�d��d�s@t|�d��rEd|_nq/|�d	d
�}|d
urUt�	|�}|�dd
�}	|	d
urdt�	|	�}	|�|�d�|�d�|�d�d
d|�d�d
d
|||	d��|jd�|�d�|i�|�
�d
S)z�
        command = {
            'type': 'physical',
            'mac_address': 'c0:d6:9f:2c:e8:80',
            'name': 'eth0',
            'subnets': [
                {'type': 'dhcp4'}
             ],
            'accept-ra': 'true'
        }
        rrl�paramsr�r��6�addressTr&Nr%�mac_address�inet�manualr!)rlr�r�r�r'r!r��gatewayr�r&r%)rzr|rer��_normalize_subnetsrw�endswithrr�is_truer�)
rUrVrr��paramr�r�r��	accept_rar%r?r?r@r��sF��

��z'NetworkStateInterpreter.handle_physical)rl�vlan_id�	vlan_linkcCs\|j�di�}|�|�|�|�d�i�}|�d�|d<|�d�|d<|�|d|i�dS)z�
        auto eth0.222
        iface eth0.222 inet static
                address 10.10.10.1
                netmask 255.255.255.0
                hwaddress ether BC:76:4E:06:96:B3
                vlan-raw-device eth0
        rrlr�zvlan-raw-devicer�N)rzr|r�r�)rUrVrr�r?r?r@�handle_vlan�s

z#NetworkStateInterpreter.handle_vlan)rl�bond_interfacesr�c	Cs|�|�|j�d�}|�|�d�i�}|�d���D]\}}|�||i�q|�ddi�|jd�|d|i�|�d�D]@}||vrO|dd�}|�|�|j�di�}|�|�}|�d�|d	<|�d���D]\}}|�||i�qi|jd�||i�q?d
S)aU
        #/etc/network/interfaces
        auto eth0
        iface eth0 inet manual
            bond-master bond0
            bond-mode 802.3ad

        auto eth1
        iface eth1 inet manual
            bond-master bond0
            bond-mode 802.3ad

        auto bond0
        iface bond0 inet static
             address 192.168.0.10
             gateway 192.168.0.1
             netmask 255.255.255.0
             bond-slaves none
             bond-mode 802.3ad
             bond-miimon 100
             bond-downdelay 200
             bond-updelay 200
             bond-lacp-rate 4
        rrlr�zbond-slaves�noner�r7)rlr�zbond-masterN)r�rzr|rer�)	rUrVrr�r�r��ifname�cmd�bond_ifr?r?r@�handle_bond�s(
�

�z#NetworkStateInterpreter.handle_bond�bridge_interfacesc	Cs|j�di�}|�d�D]}||vrqd|i}|�|�q|j�di�}|�|�|�|�d�i�}|d|d<|�di���D]\}}|�||i�q@|�d�}|durxt|�tkrx|dvrbd	}n|d
vrid}ntdj|d
���|�d|i�|�|d|i�dS)a�
            auto br0
            iface br0 inet static
                    address 10.10.10.1
                    netmask 255.255.255.0
                    bridge_ports eth0 eth1
                    bridge_stp off
                    bridge_fd 0
                    bridge_maxwait 0

        bridge_params = [
            "bridge_ports",
            "bridge_ageing",
            "bridge_bridgeprio",
            "bridge_fd",
            "bridge_gcint",
            "bridge_hello",
            "bridge_hw",
            "bridge_maxage",
            "bridge_maxwait",
            "bridge_pathcost",
            "bridge_portprio",
            "bridge_stp",
            "bridge_waitport",
        ]
        rr�rl�bridge_portsr�r5N)�on�1rT)�off�0rFz2Cannot convert bridge_stp value ({stp}) to boolean)r+)	rzr|r�rer�r��boolr�r�)	rUrVrr�r�r�r�r�r5r?r?r@�
handle_bridge�s4�

��z%NetworkStateInterpreter.handle_bridgecCs|�|�dSrBr�r�r?r?r@�handle_infiniband@sz)NetworkStateInterpreter.handle_infinibandcCszg}g}d|vr|d}t|�tks|g}|D]}|�|�qd|vr9|d}t|t�s/|g}|D]}|�|�q1||fS)Nr�r�)r��list�appendr�)rUrVr"r��addrs�addr�paths�pathr?r?r@�
_parse_dnsDs
z"NetworkStateInterpreter._parse_dnsr�cCsX|j�d�}|�|�\}}d|vr||f|j|d<dS|d�|�|d�|�dS)Nr�r�r"r�)rzr|r�r��extend)rUrVr�r"r�r?r?r@�handle_nameserverUs�z)NetworkStateInterpreter.handle_nameservercCs0|j�d�}|�|�\}}||d�||d<dS)Nrr�r�)rzr|r�)rUrVr��_ifacer"r�r?r?r@�_handle_individual_nameserverbsz5NetworkStateInterpreter._handle_individual_nameserver�destinationcCs|jd�t|��dSr�)rzr��_normalize_router�r?r?r@�handle_routehsz$NetworkStateInterpreter.handle_routecC�|j|dd�dS)a�
        v2_command = {
          bond0: {
            'interfaces': ['interface0', 'interface1'],
            'parameters': {
               'mii-monitor-interval': 100,
               'mode': '802.3ad',
               'xmit_hash_policy': 'layer3+4'}},
          bond1: {
            'bond-slaves': ['interface2', 'interface7'],
            'parameters': {
                'mode': 1,
            }
          }
        }

        v1_command = {
            'type': 'bond'
            'name': 'bond0',
            'bond_interfaces': [interface0, interface1],
            'params': {
                'bond-mode': '802.3ad',
                'bond_miimon: 100,
                'bond_xmit_hash_policy': 'layer3+4',
            }
        }

        r7��cmd_typeN��_handle_bond_bridger�r?r?r@�handle_bondsmsz$NetworkStateInterpreter.handle_bondscCr�)a�
        v2_command = {
          br0: {
            'interfaces': ['interface0', 'interface1'],
            'forward-delay': 0,
            'stp': False,
            'maxwait': 0,
          }
        }

        v1_command = {
            'type': 'bridge'
            'name': 'br0',
            'bridge_interfaces': [interface0, interface1],
            'params': {
                'bridge_stp': 'off',
                'bridge_fd: 0,
                'bridge_maxwait': 0
            }
        }

        r8r�Nrr�r?r?r@�handle_bridges�sz&NetworkStateInterpreter.handle_bridgescCst�}|��D]�\}}ddi}|�di�}|�dd�}|s&t�d|t|��||d<|}|�d�}	|	r6|	}n|rF|rF|��}
t|
�}|rF|}||d	<|�d
d�}|rXd
|i|d<dD]}
|
|vrf||
||
<qZt|�|�	|�}t
|�d
kr}|�d|i�t�d|�|�|�qdS)a�
        ethernets:
          eno1:
            match:
              macaddress: 00:11:22:33:44:55
              driver: hv_netsvc
            wakeonlan: true
            dhcp4: true
            dhcp6: false
            addresses:
              - 192.168.14.2/24
              - 2001:1::1/64
            gateway4: 192.168.14.1
            gateway6: 2001:1::2
            nameservers:
              search: [foo.local, bar.local]
              addresses: [8.8.8.8, 8.8.4.4]
          lom:
            match:
              driver: ixgbe
            set-name: lom1
            dhcp6: true
            accept-ra: true
          switchports:
            match:
              name: enp2*
            mtu: 1280

        command = {
            'type': 'physical',
            'mac_address': 'c0:d6:9f:2c:e8:80',
            'name': 'eth0',
            'subnets': [
                {'type': 'dhcp4'}
             ]
        }
        r��physicalr �
macaddressNzHNetworkState Version2: missing "macaddress" info in config entry: %s: %sr�r$rl�driverr�)r!r r%r&rr�z!v2(ethernets) -> v1(physical):
%s)
r	rer|r=r��str�lowerrrA�_v2_to_v1_ipcfgrhr�r�)rUrV�
ifaces_by_mac�eth�cfg�phy_cmdr r�rl�set_name�lcase_mac_address�macrrOr�r?r?r@�handle_ethernets�sJ-��
�
�z(NetworkStateInterpreter.handle_ethernetscCs�|��D]<\}}d||�d�|�d�d�}d|vr|d|d<t|�|�|�}t|�dkr5|�d|i�t�d|�|�|�qd	S)
aq
        v2_vlans = {
            'eth0.123': {
                'id': 123,
                'link': 'eth0',
                'dhcp4': True,
            }
        }

        v1_command = {
            'type': 'vlan',
            'name': 'eth0.123',
            'vlan_link': 'eth0',
            'vlan_id': 123,
            'subnets': [{'type': 'dhcp4'}],
        }
        �vlan�id�link)r�rlr�r�r!rr�zv2(vlans) -> v1(vlan):
%sN)	rer|rAr	rhr�r=r�r�)rUrVrr�vlan_cmdr�r?r?r@�handle_vlanss�
�z$NetworkStateInterpreter.handle_vlanscCst�d�dS)NzOWifi configuration is only available to distros with netplan rendering support.r<r�r?r?r@�handle_wifis&s�z$NetworkStateInterpreter.handle_wifisc
Cs�t�d|�|��D]c\}}d|vr|�d�}|r|}d|vrm|�d��dg�}|�d��dg�}ddi}t|�dkrB|�d|i�t|�dkrO|�d	|i�|�|�|�d
i��d�}|rgt|�}	|	rg|	}|�||�q
dS)Nzv2_common: handling config:
%sr$r"r�rr��
nameserverrr�r r)	r=r�rer|rhr�r�rr�)
rUrr��dev_cfg�set_name_ifacer�r��name_cmdr��real_if_namer?r?r@r�,s2

���z"NetworkStateInterpreter._v2_commonc
s&tdd�t�|���D���|��D]~\}}tdd�|��D��}|�di�}|�dd�}|r3||d<d|d	||d
|�d�dt�fd
d�|��D��i}d|vrW|d|d<t|�|�|�}	t|	�dkrm|�d|	i�t	�
d|||�|dkr|�|�q|dkr�|�|�qt
dj|d���dS)z(Common handler for bond and bridge typescss�|]	\}}||fVqdSrBr?�r�r��vr?r?r@�	<genexpr>Ks�
�z>NetworkStateInterpreter._handle_bond_bridge.<locals>.<genexpr>css$�|]
\}}|tvr||fVqdSrB)�NETWORK_V2_KEY_FILTER)r�rO�valuer?r?r@rPs��
��
parameterszgratuitious-arpNr(r�rl�_interfacesrr�c3s �|]\}}�||fVqdSrBr?r��v2key_to_v1r?r@r`��r!rr�zv2(%s) -> v1(%s):
%sr8r7z Unknown command type: {cmd_type}r�)r�r9r|re�poprAr	rhr�r=r�r�r�r�r�)
rUrVr��	item_name�item_cfg�item_paramsr��
grat_value�v1_cmdr�r?r$r@rGsB���
���z+NetworkStateInterpreter._handle_bond_bridgec
Cs�dd�}g}|�d�rddi}||�di�|�|�|�|�d�r7ddi}d|_||�di�|�|�|�d	}d	}i}|�d
g�D]`}d|d�}d
|vrcd|vrb|d	urb|�d�}|�d|i�nd|vrw|d	urw|�d�}|�d|i�d|vr�|s�|�d��d
�}	|	r�|	|d<|�d��d�}
|
r�|
|d<|�|�|�|�qCg}|�dg�D]}|�t|�d�|�d�d���q�t|�r�t|�r�||dd<|S)z7Common ipconfig extraction from v2 to v1 subnets array.cSsd|vr|d|d<dSdS)Nzroute-metric�metricr?)�	overridesr�r?r?r@�_add_dhcp_overridesys�zDNetworkStateInterpreter._v2_to_v1_ipcfg.<locals>._add_dhcp_overridesrr�rrTrNr�static)r�r��:rr�rr"r�r��
dns_searchr��to�via)r�r�r)r|r�rwr�r�rh)
rUrr/r�r�rrr"r�rr�r�r�r?r?r@r	vs^



�
�

���z'NetworkStateInterpreter._v2_to_v1_ipcfg)r#r�)T)r;NrB)%rRrSrTr�r�r~r�rvrrw�setterr�rEr�r�r�r�r�rar�r�r�r�r�r�r�r�r�r�rrrrrr�rr	r?r?r?r@rD�sn��
�
�




#


6



4
@



^"

/rD)�	metaclasscCszt�|�}tdd�|��D��}|�d�dvr |�t|dd��dd�|�d	g�D�|d	<d
d�}dD]}|||�q3|S)
Ncss �|]\}}|r||fVqdSrBr?rr?r?r@r�r&z$_normalize_subnet.<locals>.<genexpr>r�)r0�static6)r��
ip_address��address_keyscS�g|]}t|��qSr?)r�)r��rr?r?r@r��s�z%_normalize_subnet.<locals>.<listcomp>r�cSs2||vrt||t�s||��||<dSdSdSrB)r�r��split)�snetrlr?r?r@�listify�s�z"_normalize_subnet.<locals>.listify)r2r�)rxryr�rer|r��_normalize_net_keys)r��
normal_subnetr?r�r?r?r@�_normalize_subnet�s 
��	

�rBr?cCs�dd�|��D�}d}|D]}|�|�r|}nq
|s-dd�|�|f}t�|�t|��t|�|��}t|�sFt�d|�td|�d���t|�}t	|�}|�d	�}	d
|vr|�
d
�\}
}}|
||<|rjt|�}
n8|rqt|�}
n1t�d|�td|�d���d|vr�t
|d�}
n|	r�|r�t|	�}
n|	r�|r�t|	�}
n|r�dnd
}
d|vr�t|d�t|
�kr�t�d|
|�|
|d<|r�d	|vr�|d	=|S|r�t|d�|d	<|S)a�Normalize dictionary network keys returning prefix and address keys.

    @param network: A dict of network-related definition containing prefix,
        netmask and address_keys.
    @param address_keys: A tuple of keys to search for representing the address
        or cidr. The first address_key discovered will be used for
        normalization.

    @returns: A dict containing normalized prefix and matching addr_key.
    cSs"i|]
\}}|s|dkr||�qS)rr?rr?r?r@�
<dictcomp>�s"z'_normalize_net_keys.<locals>.<dictcomp>Nz/No config network address keys [%s] found in %s�,z$Address %s is not a valid ip networkzAddress z is not a valid ip address�netmask�/r��@�z;Overwriting existing 'prefix' with '%s' in network info: %s)rer|�joinr=r�r�rrrr
�	partitionrr
r�r>r)r�r:�net�addr_keyrO�messager��ipv6�ipv4rE�	addr_part�_�maybe_prefixr�r?r?r@r@�sf
��





��r@c
Cs�tdd�|��D��}d|vr|d|d<|d=|�t|dd��|�d�}|rFz	t|�|d<W|StyE}ztd�|��|�d	}~ww|S)
a�normalize a route.
    return a dictionary with only:
       'type': 'route' (only present if it was present in input)
       'network': the network portion of the route as a string.
       'prefix': the network prefix for address as an integer.
       'metric': integer metric (only if present in input).
       'netmask': netmask (string) equivalent to prefix iff network is ipv4.
    css$�|]
\}}|dvr||fVqdS))�NNr?rr?r?r@r+s��
�z#_normalize_route.<locals>.<genexpr>r�r�)r�r�r9r-z(Route config metric {} is not an integerN)	r�rer�r@r|r�r��	TypeErrorr�)r��normal_router-r�r?r?r@r�!s2
���
�����r�cCs|sg}dd�|D�S)NcSr;r?)rB)r��sr?r?r@r�Fsz&_normalize_subnets.<locals>.<listcomp>r?)r�r?r?r@r�Csr�T�
net_configr�cCsfd}|�d�}|�d�}|dkr|}|r(|dur(t|||d�}|j|d�|j}|s1td|����|S)zfParses the config, returns NetworkState object

    :param net_config: curtin network config dict
    Nrrr�)rrr#r�zpNo valid network_state object created from network config. Did you specify the correct version? Network config:
)r|rDr�rr�)rWr�r#rGrrrHr?r?r@�parse_net_config_dataIs$	

���rX)r?)TN)1rxr]�logging�typingrrrr�	cloudinitrr�
cloudinit.netrr	r
rrr
rrr�cloudinit.net.rendererr�	getLoggerrRr=r�r�r r9r�__annotations__r�rArIrP�	ExceptionrQrar�rbrvrDrBr@r�r�r�rXr?r?r?r@�<module>s�
,
����"
VP
L"����