aboutsummaryrefslogtreecommitdiffstats
path: root/resources/libraries/python/IPv4NodeAddress.py
blob: de96c189e59abf519823e7e06c95f334f3d2e991 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
# Copyright (c) 2018 Cisco and/or its affiliates.
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at:
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""Robot framework variable file.

Create dictionary variable nodes_ipv4_addr of IPv4 addresses from
available networks.
"""

from ipaddress import IPv4Network

from resources.libraries.python.topology import Topology

# Default list of IPv4 subnets
IPV4_NETWORKS = ['192.168.{}.0/24'.format(i) for i in range(1, 100)]


class IPv4NetworkGenerator(object):
    """IPv4 network generator.

    TODO: Conform to https://docs.python.org/2/library/stdtypes.html#typeiter
    """

    def __init__(self, networks):
        """Populate internal list of valid networks.

        :param networks: List of strings containing IPv4 subnet
            with prefix length.
        :type networks: list
        :raise RuntimeError: If no IPv4 networks are added.
        """
        self._networks = []
        for network in networks:
            net = IPv4Network(unicode(network))
            self._networks.append(net)
        if not self._networks:
            raise RuntimeError("No IPv4 networks")

    def next_network(self):
        """Pop and return network from internal list.

        :returns: Next network in form (IPv4Network, subnet).
        :raises StopIteration: If there are no more elements.
        """
        if self._networks:
            return self._networks.pop()
        else:
            raise StopIteration()


def get_variables(nodes, networks=IPV4_NETWORKS[:]):
    """Special robot framework method that returns dictionary nodes_ipv4_addr,
    mapping of node and interface name to IPv4 address.

    :param nodes: Nodes of the test topology.
    :param networks: List of available IPv4 networks.
    :type nodes: dict
    :type networks: list

    .. note::
       Robot framework calls it automatically.
    """
    topo = Topology()
    links = topo.get_links(nodes)

    if len(links) > len(networks):
        raise Exception('Not enough available IPv4 networks for topology.')

    ip4_n = IPv4NetworkGenerator(networks)

    nets = {}

    for link in links:
        ip4_net = ip4_n.next_network()
        net_hosts = ip4_net.hosts()
        port_idx = 0
        ports = {}
        for node in nodes.values():
            if_key = topo.get_interface_by_link_name(node, link)
            if_name = topo.get_interface_name(node, if_key)
            if if_name is not None:
                port = {'addr': str(next(net_hosts)),
                        'node': node['host'],
                        'if': if_name}
                port_idx += 1
                port_id = 'port{0}'.format(port_idx)
                ports.update({port_id: port})
        nets.update({link: {'net_addr': str(ip4_net.network_address),
                            'prefix': ip4_net.prefixlen,
                            'ports': ports}})

    return {'DICT__nodes_ipv4_addr': nets}