X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=resources%2Flibraries%2Fpython%2Fautogen%2FRegenerator.py;h=7271fbcf379d21bdcb2b95a40ff54c46f78d631d;hp=64bcea917d75935be797e5873cc0210b1278ee4d;hb=d68951ac245150eeefa6e0f4156e4c1b5c9e9325;hpb=d1589ad74e515757fb12cf8a5f976282924afe13 diff --git a/resources/libraries/python/autogen/Regenerator.py b/resources/libraries/python/autogen/Regenerator.py index 64bcea917d..7271fbcf37 100644 --- a/resources/libraries/python/autogen/Regenerator.py +++ b/resources/libraries/python/autogen/Regenerator.py @@ -1,4 +1,4 @@ -# Copyright (c) 2018 Cisco and/or its affiliates. +# Copyright (c) 2019 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: @@ -13,158 +13,353 @@ """Module defining utilities for test directory regeneration.""" +import sys + from glob import glob +from io import open from os import getcwd -from .DefaultTestcase import DefaultTestcase +from resources.libraries.python.Constants import Constants +from resources.libraries.python.autogen.Testcase import Testcase -class Regenerator(object): - """Class containing file generating methods.""" - def __init__(self, testcase_class=DefaultTestcase): - """Initialize Testcase class to use. +PROTOCOL_TO_MIN_FRAME_SIZE = { + u"ip4": 64, + u"ip6": 78, + u"ethip4vxlan": 114, # What is the real minimum for latency stream? + u"dot1qip4vxlan": 118 +} +MIN_FRAME_SIZE_VALUES = list(PROTOCOL_TO_MIN_FRAME_SIZE.values()) + + +def replace_defensively( + whole, to_replace, replace_with, how_many, msg, in_filename): + """Replace substrings while checking the number of occurrences. + + Return edited copy of the text. Assuming "whole" is really a string, + or something else with .replace not affecting it. + + :param whole: The text to perform replacements on. + :param to_replace: Substring occurrences of which to replace. + :param replace_with: Substring to replace occurrences with. + :param how_many: Number of occurrences to expect. + :param msg: Error message to raise. + :param in_filename: File name in which the error occurred. + :type whole: str + :type to_replace: str + :type replace_with: str + :type how_many: int + :type msg: str + :type in_filename: str + :return: The whole text after replacements are done. + :rtype: str + :raise ValueError: If number of occurrences does not match. + """ + found = whole.count(to_replace) + if found != how_many: + raise ValueError(f"{in_filename}: {msg}") + return whole.replace(to_replace, replace_with) + + +def get_iface_and_suite_id(filename): + """Get interface and suite ID. + + Interface ID is the part of suite name + which should be replaced for other NIC. + Suite ID is the part os suite name + which si appended to test case names. + + :param filename: Suite file. + :type filename: str + :returns: Interface ID, Suite ID. + :rtype: (str, str) + """ + dash_split = filename.split(u"-", 1) + if len(dash_split[0]) <= 4: + # It was something like "2n1l", we need one more split. + dash_split = dash_split[1].split(u"-", 1) + return dash_split[0], dash_split[1].split(u".", 1)[0] + + +def add_default_testcases(testcase, iface, suite_id, file_out, tc_kwargs_list): + """Add default testcases to file. + + :param testcase: Testcase class. + :param iface: Interface. + :param suite_id: Suite ID. + :param file_out: File to write testcases to. + :param tc_kwargs_list: Key-value pairs used to construct testcases. + :type testcase: Testcase + :type iface: str + :type suite_id: str + :type file_out: file + :type tc_kwargs_list: dict + """ + # We bump tc number in any case, so that future enables/disables + # do not affect the numbering of other test cases. + for num, kwargs in enumerate(tc_kwargs_list, start=1): + # TODO: Is there a better way to disable some combinations? + emit = True + if kwargs[u"frame_size"] == 9000: + if u"vic1227" in iface: + # Not supported in HW. + emit = False + if u"vic1385" in iface: + # Not supported in HW. + emit = False + if u"ipsec" in suite_id: + # IPsec code does not support chained buffers. + # Tracked by Jira ticket VPP-1207. + emit = False + if u"-16vm2t-" in suite_id or u"-16dcr2t-" in suite_id: + if kwargs[u"phy_cores"] > 3: + # CSIT lab only has 28 (physical) core processors, + # so these test would fail when attempting to assign cores. + emit = False + if u"-24vm1t-" in suite_id or u"-24dcr1t-" in suite_id: + if kwargs[u"phy_cores"] > 3: + # CSIT lab only has 28 (physical) core processors, + # so these test would fail when attempting to assign cores. + emit = False + if u"soak" in suite_id: + # Soak test take too long, do not risk other than tc01. + if kwargs[u"phy_cores"] != 1: + emit = False + if kwargs[u"frame_size"] not in MIN_FRAME_SIZE_VALUES: + emit = False + if emit: + file_out.write(testcase.generate(num=num, **kwargs)) + + +def add_tcp_testcases(testcase, file_out, tc_kwargs_list): + """Add TCP testcases to file. + + :param testcase: Testcase class. + :param file_out: File to write testcases to. + :param tc_kwargs_list: Key-value pairs used to construct testcases. + :type testcase: Testcase + :type file_out: file + :type tc_kwargs_list: dict + """ + for num, kwargs in enumerate(tc_kwargs_list, start=1): + file_out.write(testcase.generate(num=num, **kwargs)) - TODO: See the type doc for testcase_class? - It implies the design is wrong. Fix it. - Easiest: Hardcode Regenerator to use DefaultTestcase only. - :param testcase_class: Subclass of DefaultTestcase for generation. - Default: DefaultTestcase - :type testcase_class: subclass of DefaultTestcase accepting suite_id +def write_default_files(in_filename, in_prolog, kwargs_list): + """Using given filename and prolog, write all generated suites. + + :param in_filename: Template filename to derive real filenames from. + :param in_prolog: Template content to derive real content from. + :param kwargs_list: List of kwargs for add_default_testcase. + :type in_filename: str + :type in_prolog: str + :type kwargs_list: list of dict + """ + for suite_type in Constants.PERF_TYPE_TO_KEYWORD: + tmp_filename = replace_defensively( + in_filename, u"ndrpdr", suite_type, 1, + u"File name should contain suite type once.", in_filename + ) + tmp_prolog = replace_defensively( + in_prolog, u"ndrpdr".upper(), suite_type.upper(), 1, + u"Suite type should appear once in uppercase (as tag).", + in_filename + ) + tmp_prolog = replace_defensively( + tmp_prolog, + u"Find NDR and PDR intervals using optimized search", + Constants.PERF_TYPE_TO_KEYWORD[suite_type], 1, + u"Main search keyword should appear once in suite.", + in_filename + ) + tmp_prolog = replace_defensively( + tmp_prolog, + Constants.PERF_TYPE_TO_SUITE_DOC_VER[u"ndrpdr"], + Constants.PERF_TYPE_TO_SUITE_DOC_VER[suite_type], + 1, u"Exact suite type doc not found.", in_filename + ) + tmp_prolog = replace_defensively( + tmp_prolog, + Constants.PERF_TYPE_TO_TEMPLATE_DOC_VER[u"ndrpdr"], + Constants.PERF_TYPE_TO_TEMPLATE_DOC_VER[suite_type], + 1, u"Exact template type doc not found.", in_filename + ) + _, suite_id = get_iface_and_suite_id(tmp_filename) + testcase = Testcase.default(suite_id) + for nic_name in Constants.NIC_NAME_TO_CODE: + out_filename = replace_defensively( + tmp_filename, u"10ge2p1x710", + Constants.NIC_NAME_TO_CODE[nic_name], 1, + u"File name should contain NIC code once.", in_filename + ) + out_prolog = replace_defensively( + tmp_prolog, u"Intel-X710", nic_name, 2, + u"NIC name should appear twice (tag and variable).", + in_filename + ) + if out_prolog.count(u"HW_") == 2: + # TODO CSIT-1481: Crypto HW should be read + # from topology file instead. + if nic_name in Constants.NIC_NAME_TO_CRYPTO_HW: + out_prolog = replace_defensively( + out_prolog, u"HW_DH895xcc", + Constants.NIC_NAME_TO_CRYPTO_HW[nic_name], 1, + u"HW crypto name should appear.", in_filename + ) + iface, suite_id = get_iface_and_suite_id(out_filename) + with open(out_filename, "wt") as file_out: + file_out.write(out_prolog) + add_default_testcases( + testcase, iface, suite_id, file_out, kwargs_list + ) + + +def write_reconf_files(in_filename, in_prolog, kwargs_list): + """Using given filename and prolog, write all generated reconf suites. + + Use this for suite type reconf, as its local template + is incompatible with mrr/ndrpdr/soak local template, + while test cases are compatible. + + :param in_filename: Template filename to derive real filenames from. + :param in_prolog: Template content to derive real content from. + :param kwargs_list: List of kwargs for add_testcase. + :type in_filename: str + :type in_prolog: str + :type kwargs_list: list of dict + """ + _, suite_id = get_iface_and_suite_id(in_filename) + testcase = Testcase.default(suite_id) + for nic_name in Constants.NIC_NAME_TO_CODE: + out_filename = replace_defensively( + in_filename, u"10ge2p1x710", + Constants.NIC_NAME_TO_CODE[nic_name], 1, + u"File name should contain NIC code once.", in_filename + ) + out_prolog = replace_defensively( + in_prolog, u"Intel-X710", nic_name, 2, + u"NIC name should appear twice (tag and variable).", + in_filename + ) + if out_prolog.count(u"HW_") == 2: + # TODO CSIT-1481: Crypto HW should be read + # from topology file instead. + if nic_name in list(Constants.NIC_NAME_TO_CRYPTO_HW.keys()): + out_prolog = replace_defensively( + out_prolog, u"HW_DH895xcc", + Constants.NIC_NAME_TO_CRYPTO_HW[nic_name], 1, + u"HW crypto name should appear.", in_filename + ) + iface, suite_id = get_iface_and_suite_id(out_filename) + with open(out_filename, "wt") as file_out: + file_out.write(out_prolog) + add_default_testcases( + testcase, iface, suite_id, file_out, kwargs_list + ) + + +def write_tcp_files(in_filename, in_prolog, kwargs_list): + """Using given filename and prolog, write all generated tcp suites. + + :param in_filename: Template filename to derive real filenames from. + :param in_prolog: Template content to derive real content from. + :param kwargs_list: List of kwargs for add_default_testcase. + :type in_filename: str + :type in_prolog: str + :type kwargs_list: list of dict + """ + # TODO: Generate rps from cps? There are subtle differences. + _, suite_id = get_iface_and_suite_id(in_filename) + testcase = Testcase.tcp(suite_id) + for nic_name in Constants.NIC_NAME_TO_CODE: + out_filename = replace_defensively( + in_filename, u"10ge2p1x710", + Constants.NIC_NAME_TO_CODE[nic_name], 1, + u"File name should contain NIC code once.", in_filename + ) + out_prolog = replace_defensively( + in_prolog, u"Intel-X710", nic_name, 2, + u"NIC name should appear twice (tag and variable).", + in_filename + ) + with open(out_filename, "wt") as file_out: + file_out.write(out_prolog) + add_tcp_testcases(testcase, file_out, kwargs_list) + + +class Regenerator: + """Class containing file generating methods.""" + + def __init__(self, quiet=True): + """Initialize the instance. + + :param quiet: Reduce log prints (to stderr) when True (default). + :type quiet: boolean """ - self.testcase_class = testcase_class + self.quiet = quiet - def regenerate_glob(self, pattern, protocol="ip4", tc_kwargs_list=None): + def regenerate_glob(self, pattern, protocol=u"ip4"): """Regenerate files matching glob pattern based on arguments. In the current working directory, find all files matching - the glob pattern. Use testcase template (from init) to regenerate - test cases, autonumbering them, taking arguments from list. - If the list is None, use default list, which depends on ip6 usage. + the glob pattern. Use testcase template according to suffix + to regenerate test cases, auto-numbering them, + taking arguments from list. + + Log-like prints are emitted to sys.stderr. :param pattern: Glob pattern to select files. Example: *-ndrpdr.robot - :param is_ip6: Flag determining minimal frame size. Default: False - :param tc_kwargs_list: Arguments defining the testcases. Default: None - When None, default list is used. - List item is a dict, argument names are keys. - The initialized testcase_class should accept those, and "num". - DefaultTestcase accepts "framesize" and "phy_cores". + :param protocol: String determining minimal frame size. Default: "ip4" :type pattern: str - :type is_ip6: boolean - :type tc_kwargs_list: list of tuple or None + :type protocol: str + :raises RuntimeError: If invalid source suite is encountered. """ + if not self.quiet: + print(f"Regenerator starts at {getcwd()}", file=sys.stderr) - protocol_to_min_framesize = { - "ip4": 64, - "ip6": 78, - "vxlan+ip4": 114 # What is the real minimum for latency stream? - } - min_framesize_values = protocol_to_min_framesize.values() - - def get_iface_and_suite_id(filename): - """Get interface and suite ID. - - :param filename: Suite file. - :type filename: str - :returns: Interface ID, Suite ID. - :rtype: tuple - """ - dash_split = filename.split("-", 1) - if len(dash_split[0]) <= 4: - # It was something like "2n1l", we need one more split. - dash_split = dash_split[1].split("-", 1) - return dash_split[0], dash_split[1].split(".", 1)[0] - - def add_testcase(testcase, iface, suite_id, file_out, num, **kwargs): - """Add testcase to file. - - :param testcase: Testcase class. - :param iface: Interface. - :param suite_id: Suite ID. - :param file_out: File to write testcases to. - :param num: Testcase number. - :param kwargs: Key-value pairs used to construct testcase. - :type testcase: Testcase - :type iface: str - :type suite_id: str - :type file_out: file - :type num: int - :type kwargs: dict - :returns: Next testcase number. - :rtype: int - """ - # TODO: Is there a better way to disable some combinations? - emit = True - if kwargs["framesize"] == 9000: - if "vic1227" in iface: - # Not supported in HW. - emit = False - if "avf" in suite_id: - # Not supported by AVF driver. - # https://git.fd.io/vpp/tree/src/plugins/avf/README.md - emit = False - if "-16vm-" in suite_id or "-16dcr-" in suite_id: - if kwargs["phy_cores"] > 3: - # CSIT lab only has 28 (physical) core processors, - # so these test would fail when attempting to assign cores. - emit = False - if "soak" in suite_id: - # Soak test take too long, do not risk other than tc01. - if kwargs["phy_cores"] != 1: - emit = False - if kwargs["framesize"] not in min_framesize_values: - emit = False - if emit: - file_out.write(testcase.generate(num=num, **kwargs)) - # We bump tc number in any case, so that future enables/disables - # do not affect the numbering of other test cases. - return num + 1 - - def add_testcases(testcase, iface, suite_id, file_out, tc_kwargs_list): - """Add testcases to file. - - :param testcase: Testcase class. - :param iface: Interface. - :param suite_id: Suite ID. - :param file_out: File to write testcases to. - :param tc_kwargs_list: Key-value pairs used to construct testcases. - :type testcase: Testcase - :type iface: str - :type suite_id: str - :type file_out: file - :type tc_kwargs_list: dict - """ - num = 1 - for tc_kwargs in tc_kwargs_list: - num = add_testcase(testcase, iface, suite_id, file_out, num, - **tc_kwargs) - - print "Regenerator starts at {cwd}".format(cwd=getcwd()) - min_framesize = protocol_to_min_framesize[protocol] - kwargs_list = tc_kwargs_list if tc_kwargs_list else [ - {"framesize": min_framesize, "phy_cores": 1}, - {"framesize": min_framesize, "phy_cores": 2}, - {"framesize": min_framesize, "phy_cores": 4}, - {"framesize": 1518, "phy_cores": 1}, - {"framesize": 1518, "phy_cores": 2}, - {"framesize": 1518, "phy_cores": 4}, - {"framesize": 9000, "phy_cores": 1}, - {"framesize": 9000, "phy_cores": 2}, - {"framesize": 9000, "phy_cores": 4}, - {"framesize": "IMIX_v4_1", "phy_cores": 1}, - {"framesize": "IMIX_v4_1", "phy_cores": 2}, - {"framesize": "IMIX_v4_1", "phy_cores": 4} + min_frame_size = PROTOCOL_TO_MIN_FRAME_SIZE[protocol] + default_kwargs_list = [ + {u"frame_size": min_frame_size, u"phy_cores": 1}, + {u"frame_size": min_frame_size, u"phy_cores": 2}, + {u"frame_size": min_frame_size, u"phy_cores": 4}, + {u"frame_size": 1518, u"phy_cores": 1}, + {u"frame_size": 1518, u"phy_cores": 2}, + {u"frame_size": 1518, u"phy_cores": 4}, + {u"frame_size": 9000, u"phy_cores": 1}, + {u"frame_size": 9000, u"phy_cores": 2}, + {u"frame_size": 9000, u"phy_cores": 4}, + {u"frame_size": u"IMIX_v4_1", u"phy_cores": 1}, + {u"frame_size": u"IMIX_v4_1", u"phy_cores": 2}, + {u"frame_size": u"IMIX_v4_1", u"phy_cores": 4} + ] + tcp_kwargs_list = [ + {u"phy_cores": i, u"frame_size": 0} for i in (1, 2, 4) ] - for filename in glob(pattern): - print "Regenerating filename:", filename - with open(filename, "r") as file_in: - text = file_in.read() - text_prolog = "".join(text.partition("*** Test Cases ***")[:-1]) - iface, suite_id = get_iface_and_suite_id(filename) - testcase = self.testcase_class(suite_id) - with open(filename, "w") as file_out: - file_out.write(text_prolog) - add_testcases(testcase, iface, suite_id, file_out, kwargs_list) - print "Regenerator ends." - print # To make autogen check output more readable. + for in_filename in glob(pattern): + if not self.quiet: + print( + u"Regenerating in_filename:", in_filename, file=sys.stderr + ) + iface, _ = get_iface_and_suite_id(in_filename) + if not iface.endswith(u"10ge2p1x710"): + raise RuntimeError( + f"Error in {in_filename}: non-primary NIC found." + ) + with open(in_filename, "rt") as file_in: + in_prolog = u"".join( + file_in.read().partition("*** Test Cases ***")[:-1] + ) + if in_filename.endswith(u"-ndrpdr.robot"): + write_default_files(in_filename, in_prolog, default_kwargs_list) + elif in_filename.endswith(u"-reconf.robot"): + write_reconf_files(in_filename, in_prolog, default_kwargs_list) + elif in_filename[-10:] in (u"-cps.robot", u"-rps.robot"): + write_tcp_files(in_filename, in_prolog, tcp_kwargs_list) + else: + raise RuntimeError( + f"Error in {in_filename}: non-primary suite type found." + ) + if not self.quiet: + print(u"Regenerator ends.", file=sys.stderr) + print(file=sys.stderr) # To make autogen check output more readable.