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
107
108
109
110
|
# 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.
"""Module defining utilities for testcase autogeneration."""
from string import Template
class Testcase(object):
"""Class containing a template string and a substitution method."""
def __init__(self, template_string):
"""Construct instance by storing template given by string.
:param template_string: Template string to generate test case code with.
See string.Template documentation for template string syntax.
Only the following placeholders are supported:
- cores_num - Number of cores as robot number, example: "${2}".
- cores_str - Number of physical cores to use, example: "2".
- frame_num - Framesize as a number, example: "${74}".
- frame_str - Framesize in upper case, example: "74B".
- tc_num - Start of testcase name, example: "tc04".
:type template_string: str
"""
self.template = Template(template_string)
def generate(self, num, frame_size, phy_cores):
"""Return string of test case code with placeholders filled.
Fail if there are placeholders left unfilled.
It is not required for all placeholders to be present in template.
:param num: Test case number. Example value: 4.
:param frame_size: Imix string or numeric frame size. Example: 74.
:param phy_cores: Number of physical cores to use. Example: 2.
:type num: int
:type frame_size: str or int
:type phy_cores: int or str
:returns: Filled template, usable as test case code.
:rtype: str
"""
try:
fsize = int(frame_size)
subst_dict = {
"frame_num": "${%d}" % fsize,
"frame_str": "%dB" % fsize
}
except ValueError: # Assuming an IMIX string.
subst_dict = {
"frame_num": str(frame_size),
"frame_str": "IMIX"
}
cores_str = str(phy_cores)
cores_num = int(cores_str)
subst_dict.update(
{
"cores_num": "${%d}" % cores_num,
"cores_str": phy_cores,
"tc_num": "tc{num:02d}".format(num=num)
})
return self.template.substitute(subst_dict)
@classmethod
def default(cls, suite_id):
"""Factory method for creating "default" testcase objects.
Testcase name will contain both frame size and core count.
Used for most performance tests, except TCP ones.
:param suite_id: Part of suite name to distinguish from other suites.
:type suite_id: str
:returns: Instance for generating testcase text of this type.
:rtype: Testcase
"""
template_string = r'''
| ${tc_num}-${frame_str}-${cores_str}c-''' + suite_id + r'''
| | [Tags] | ${frame_str} | ${cores_str}C
| | frame_size=${frame_num} | phy_cores=${cores_num}
'''
return cls(template_string)
@classmethod
def tcp(cls, suite_id):
"""Factory method for creating "tcp" testcase objects.
Testcase name will contain core count, but not frame size.
:param suite_id: Part of suite name to distinguish from other suites.
:type suite_id: str
:returns: Instance for generating testcase text of this type.
:rtype: Testcase
"""
# TODO: Choose a better frame size identifier for streamed protocols
# (TCP, QUIC, SCTP, ...) where DUT (not TG) decides frame size.
template_string = r'''
| ${tc_num}-IMIX-${cores_str}c-''' + suite_id + r'''
| | [Tags] | ${cores_str}C
| | phy_cores=${cores_num}
'''
return cls(template_string)
|
