aboutsummaryrefslogtreecommitdiffstats
path: root/GPL/traffic_profiles/trex/TrafficStreamsJsonClass.py
blob: 9ba3c31658066f485353e66da359e07be1584699 (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
103
104
105
106
# Copyright (c) 2024 Cisco and/or its affiliates.
#
# SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
#
# Licensed under the Apache License 2.0 or
# GNU General Public License v2.0 or later;  you may not use this file
# except in compliance with one of these Licenses. You
# may obtain a copy of the Licenses at:
#
#     http://www.apache.org/licenses/LICENSE-2.0
#     https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
#
# Note: If this file is linked with Scapy, which is GPLv2+, your use of it
# must be under GPLv2+.  If at any point in the future it is no longer linked
# with Scapy (or other GPLv2+ licensed software), you are free to choose
# Apache 2.
#
# 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.

"""Base class for stream profiles for T-rex traffic generator.
"""

import json
import os

from trex.stl.api import *

CP = os.path.join(os.path.abspath(os.sep), "etc")


class TrafficStreamsJsonClass:
    """Base class for stream profiles for T-rex traffic generator."""

    def __init__(self):
        # Default value of frame size, it will be overwritten by the value of
        # "framesize" parameter of "get_streams" method.
        self.framesize = 64

    def define_packets(self):
        """Define the packets to be sent from the traffic generator.

        This method MUST return:

            return pkt, vm

        :returns: Packets to be sent from the traffic generator.
        :rtype: tuple
        """
        raise NotImplementedError

    def create_streams(self):
        """Create traffic streams.

        Implement your own traffic streams.

        :returns: Traffic streams.
        :rtype: list
        """
        pkt_streams = []
        lat_streams = []

        with open(os.path.join(CP, "packet-profile.json")) as packets_json:
            packets_data = json.load(packets_json)

        for profile in packets_data["profiles"]:
            for i, stream in enumerate(profile["streams"]):
                self.stream_data = stream
                pkt, vm = self.define_packets()
                packet = STLPktBuilder(pkt=pkt, vm=vm)
                pkt_streams.append(
                    STLStream(
                        packet=packet,
                        mode=STLTXCont(pps=9000)
                    )
                )
                lat_streams.append(
                    STLStream(
                        packet=packet,
                        flow_stats=STLFlowLatencyStats(pg_id=i),
                        mode=STLTXCont(pps=9000)
                    )
                )

        streams = []
        streams.extend(pkt_streams)
        streams.extend(lat_streams)
        return streams

    def get_streams(self, **kwargs):
        """Get traffic streams created by "create_streams" method.

        If needed, add your own parameters.

        :param kwargs: Key-value pairs used by "create_streams" method while
        creating streams.
        :returns: Traffic streams.
        :rtype: list
        """
        self.framesize = kwargs["framesize"]
        self.rate = kwargs["rate"]

        return self.create_streams()