mbedtls/tests/scripts/generate_test_code.py

838 lines
28 KiB
Python
Raw Normal View History

#!/usr/bin/env python3
# Test suites code generator.
#
# Copyright (C) 2018, ARM Limited, All Rights Reserved
# SPDX-License-Identifier: Apache-2.0
#
# 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.
#
# This file is part of mbed TLS (https://tls.mbed.org)
2017-03-28 00:48:31 +00:00
"""
This script dynamically generates test suite code for Mbed TLS, by
taking following input files.
test_suite_xyz.function - Test suite functions file contains test
functions.
test_suite_xyz.data - Contains test case vectors.
2018-06-28 15:49:13 +00:00
main_test.function - Template to substitute generated test
functions, dispatch code, dependency
checking code etc.
platform .function - Platform specific initialization and
platform code.
helpers.function - Common/reusable data and functions.
2017-03-28 00:48:31 +00:00
"""
import io
2017-03-28 00:48:31 +00:00
import os
import re
import sys
2017-03-28 00:48:31 +00:00
import argparse
BEGIN_HEADER_REGEX = '/\*\s*BEGIN_HEADER\s*\*/'
END_HEADER_REGEX = '/\*\s*END_HEADER\s*\*/'
BEGIN_SUITE_HELPERS_REGEX = '/\*\s*BEGIN_SUITE_HELPERS\s*\*/'
END_SUITE_HELPERS_REGEX = '/\*\s*END_SUITE_HELPERS\s*\*/'
2017-03-28 00:48:31 +00:00
BEGIN_DEP_REGEX = 'BEGIN_DEPENDENCIES'
END_DEP_REGEX = 'END_DEPENDENCIES'
BEGIN_CASE_REGEX = '/\*\s*BEGIN_CASE\s*(.*?)\s*\*/'
END_CASE_REGEX = '/\*\s*END_CASE\s*\*/'
class GeneratorInputError(Exception):
"""
Exception to indicate error in the input files to this script.
This includes missing patterns, test function names and other
parsing errors.
"""
pass
class FileWrapper(io.FileIO):
2017-06-30 08:35:21 +00:00
"""
This class extends built-in io.FileIO class with attribute line_no,
that indicates line number for the line that is read.
2017-06-30 08:35:21 +00:00
"""
def __init__(self, file_name):
"""
Instantiate the base class and initialize the line number to 0.
:param file_name: File path to open.
2017-06-30 08:35:21 +00:00
"""
super(FileWrapper, self).__init__(file_name, 'r')
self.line_no = 0
def __next__(self):
2017-06-30 08:35:21 +00:00
"""
Python 2 iterator method. This method overrides base class's
next method and extends the next method to count the line
numbers as each line is read.
It works for both Python 2 and Python 3 by checking iterator
method name in the base iterator object.
:return: Line read from file.
2017-06-30 08:35:21 +00:00
"""
parent = super(FileWrapper, self)
if hasattr(parent, '__next__'):
line = parent.__next__() # Python 3
else:
line = parent.next() # Python 2
2017-06-30 08:35:21 +00:00
if line:
self.line_no += 1
# Convert byte array to string with correct encoding and
# strip any whitespaces added in the decoding process.
return line.decode(sys.getdefaultencoding()).strip() + "\n"
return None
# Python 3 iterator method
next = __next__
2017-06-30 08:35:21 +00:00
def split_dep(dep):
"""
Split NOT character '!' from dependency. Used by gen_deps()
:param dep: Dependency list
:return: string tuple. Ex: ('!', MACRO) for !MACRO and ('', MACRO) for
MACRO.
"""
2017-06-30 08:35:21 +00:00
return ('!', dep[1:]) if dep[0] == '!' else ('', dep)
2017-03-28 00:48:31 +00:00
def gen_deps(deps):
"""
Test suite data and functions specifies compile time dependencies.
This function generates C preprocessor code from the input
dependency list. Caller uses the generated preprocessor code to
wrap dependent code.
A dependency in the input list can have a leading '!' character
to negate a condition. '!' is separated from the dependency using
function split_dep() and proper preprocessor check is generated
accordingly.
2017-03-28 00:48:31 +00:00
:param deps: List of dependencies.
2018-06-28 15:49:13 +00:00
:return: if defined and endif code with macro annotations for
readability.
2017-03-28 00:48:31 +00:00
"""
2017-06-30 08:35:21 +00:00
dep_start = ''.join(['#if %sdefined(%s)\n' % split_dep(x) for x in deps])
dep_end = ''.join(['#endif /* %s */\n' % x for x in reversed(deps)])
2017-03-28 00:48:31 +00:00
return dep_start, dep_end
def gen_deps_one_line(deps):
"""
Similar to gen_deps() but generates dependency checks in one line.
Useful for generating code with #else block.
2017-03-28 00:48:31 +00:00
:param deps: List of dependencies.
:return: ifdef code
2017-03-28 00:48:31 +00:00
"""
2018-06-28 15:49:13 +00:00
defines = '#if ' if len(deps) else ''
defines += ' && '.join(['%sdefined(%s)' % split_dep(x) for x in deps])
2017-06-30 08:35:21 +00:00
return defines
2017-03-28 00:48:31 +00:00
2017-06-30 08:35:21 +00:00
def gen_function_wrapper(name, locals, args_dispatch):
2017-03-28 00:48:31 +00:00
"""
2018-06-28 15:49:13 +00:00
Creates test function wrapper code. A wrapper has the code to
unpack parameters from parameters[] array.
2017-03-28 00:48:31 +00:00
:param name: Test function name
:param locals: Local variables declaration code
2018-06-28 15:49:13 +00:00
:param args_dispatch: List of dispatch arguments.
Ex: ['(char *)params[0]', '*((int *)params[1])']
:return: Test function wrapper.
2017-03-28 00:48:31 +00:00
"""
# Then create the wrapper
wrapper = '''
void {name}_wrapper( void ** params )
{{
{unused_params}{locals}
2017-03-28 00:48:31 +00:00
{name}( {args} );
}}
'''.format(name=name,
2018-06-26 13:06:52 +00:00
unused_params='' if args_dispatch else ' (void)params;\n',
2017-06-30 08:35:21 +00:00
args=', '.join(args_dispatch),
locals=locals)
2017-03-28 00:48:31 +00:00
return wrapper
def gen_dispatch(name, deps):
"""
Test suite code template main_test.function defines a C function
array to contain test case functions. This function generates an
initializer entry for a function in that array. The entry is
composed of a compile time check for the test function
dependencies. At compile time the test function is assigned when
dependencies are met, else NULL is assigned.
2017-03-28 00:48:31 +00:00
:param name: Test function name
:param deps: List of dependencies
:return: Dispatch code.
2017-03-28 00:48:31 +00:00
"""
if len(deps):
ifdef = gen_deps_one_line(deps)
dispatch_code = '''
{ifdef}
{name}_wrapper,
#else
NULL,
#endif
'''.format(ifdef=ifdef, name=name)
else:
dispatch_code = '''
{name}_wrapper,
'''.format(name=name)
return dispatch_code
def parse_until_pattern(funcs_f, end_regex):
2017-03-28 00:48:31 +00:00
"""
Matches pattern end_regex to the lines read from the file object.
Returns the lines read until end pattern is matched.
:param funcs_f: file object for .functions file
:param end_regex: Pattern to stop parsing
:return: Lines read before the end pattern
2017-03-28 00:48:31 +00:00
"""
2017-06-30 08:35:21 +00:00
headers = '#line %d "%s"\n' % (funcs_f.line_no + 1, funcs_f.name)
2017-03-28 00:48:31 +00:00
for line in funcs_f:
if re.search(end_regex, line):
2017-03-28 00:48:31 +00:00
break
headers += line
else:
raise GeneratorInputError("file: %s - end pattern [%s] not found!" %
2018-06-28 15:49:13 +00:00
(funcs_f.name, end_regex))
2017-03-28 00:48:31 +00:00
2017-06-30 08:35:21 +00:00
return headers
2017-03-28 00:48:31 +00:00
2017-06-30 08:35:21 +00:00
def parse_suite_deps(funcs_f):
2017-03-28 00:48:31 +00:00
"""
Parses test suite dependencies specified at the top of a
.function file, that starts with pattern BEGIN_DEPENDENCIES
and end with END_DEPENDENCIES. Dependencies are specified
after pattern 'depends_on:' and are delimited by ':'.
:param funcs_f: file object for .functions file
:return: List of test suite dependencies.
2017-03-28 00:48:31 +00:00
"""
deps = []
for line in funcs_f:
m = re.search('depends_on\:(.*)', line.strip())
if m:
deps += [x.strip() for x in m.group(1).split(':')]
if re.search(END_DEP_REGEX, line):
break
else:
raise GeneratorInputError("file: %s - end dependency pattern [%s]"
2018-06-28 15:49:13 +00:00
" not found!" % (funcs_f.name, END_DEP_REGEX))
2017-03-28 00:48:31 +00:00
2017-06-30 08:35:21 +00:00
return deps
2017-03-28 00:48:31 +00:00
def parse_function_deps(line):
"""
Parses function dependencies, that are in the same line as
comment BEGIN_CASE. Dependencies are specified after pattern
'depends_on:' and are delimited by ':'.
:param line: Line from .functions file that has dependencies.
:return: List of dependencies.
2017-03-28 00:48:31 +00:00
"""
deps = []
m = re.search(BEGIN_CASE_REGEX, line)
dep_str = m.group(1)
if len(dep_str):
m = re.search('depends_on:(.*)', dep_str)
if m:
2017-06-30 08:35:21 +00:00
deps = [x.strip() for x in m.group(1).strip().split(':')]
2017-03-28 00:48:31 +00:00
return deps
def parse_function_signature(line):
"""
Parses test function signature for validation and generates
a dispatch wrapper function that translates input test vectors
read from the data file into test function arguments.
2018-06-28 15:49:13 +00:00
:param line: Line from .functions file that has a function
signature.
:return: function name, argument list, local variables for
wrapper function and argument dispatch code.
2017-03-28 00:48:31 +00:00
"""
args = []
locals = ''
2017-03-28 00:48:31 +00:00
args_dispatch = []
# Check if the test function returns void.
2017-03-28 00:48:31 +00:00
m = re.search('\s*void\s+(\w+)\s*\(', line, re.I)
if not m:
raise ValueError("Test function should return 'void'\n%s" % line)
name = m.group(1)
line = line[len(m.group(0)):]
arg_idx = 0
for arg in line[:line.find(')')].split(','):
arg = arg.strip()
if arg == '':
continue
if re.search('int\s+.*', arg.strip()):
args.append('int')
args_dispatch.append('*( (int *) params[%d] )' % arg_idx)
elif re.search('char\s*\*\s*.*', arg.strip()):
args.append('char*')
args_dispatch.append('(char *) params[%d]' % arg_idx)
elif re.search('data_t\s*\*\s*.*', arg.strip()):
2017-05-31 19:32:32 +00:00
args.append('hex')
# create a structure
2018-06-28 15:49:13 +00:00
pointer_initializer = '(uint8_t *) params[%d]' % arg_idx
len_initializer = '*( (uint32_t *) params[%d] )' % (arg_idx+1)
locals += """ data_t data%d = {%s, %s};
2018-06-28 15:49:13 +00:00
""" % (arg_idx, pointer_initializer, len_initializer)
args_dispatch.append('&data%d' % arg_idx)
arg_idx += 1
2017-03-28 00:48:31 +00:00
else:
2018-06-28 15:49:13 +00:00
raise ValueError("Test function arguments can only be 'int', "
"'char *' or 'data_t'\n%s" % line)
2017-03-28 00:48:31 +00:00
arg_idx += 1
2017-06-30 08:35:21 +00:00
return name, args, locals, args_dispatch
2017-03-28 00:48:31 +00:00
2017-06-30 08:35:21 +00:00
def parse_function_code(funcs_f, deps, suite_deps):
2017-03-28 00:48:31 +00:00
"""
2018-06-28 15:49:13 +00:00
Parses out a function from function file object and generates
function and dispatch code.
:param funcs_f: file object of the functions file.
:param deps: List of dependencies
:param suite_deps: List of test suite dependencies
:return: Function name, arguments, function code and dispatch code.
2017-03-28 00:48:31 +00:00
"""
2017-06-30 08:35:21 +00:00
code = '#line %d "%s"\n' % (funcs_f.line_no + 1, funcs_f.name)
2017-03-28 00:48:31 +00:00
for line in funcs_f:
# Check function signature
m = re.match('.*?\s+(\w+)\s*\(', line, re.I)
if m:
# check if we have full signature i.e. split in more lines
if not re.match('.*\)', line):
for lin in funcs_f:
line += lin
if re.search('.*?\)', line):
break
2017-06-30 08:35:21 +00:00
name, args, locals, args_dispatch = parse_function_signature(line)
2017-03-28 00:48:31 +00:00
code += line.replace(name, 'test_' + name)
name = 'test_' + name
break
else:
raise GeneratorInputError("file: %s - Test functions not found!" %
2018-06-28 15:49:13 +00:00
funcs_f.name)
2017-03-28 00:48:31 +00:00
for line in funcs_f:
if re.search(END_CASE_REGEX, line):
break
code += line
else:
raise GeneratorInputError("file: %s - end case pattern [%s] not "
2018-06-28 15:49:13 +00:00
"found!" % (funcs_f.name, END_CASE_REGEX))
2017-03-28 00:48:31 +00:00
# Add exit label if not present
if code.find('exit:') == -1:
s = code.rsplit('}', 1)
if len(s) == 2:
2017-06-30 08:35:21 +00:00
code = """exit:
2017-03-28 00:48:31 +00:00
;;
2017-06-30 08:35:21 +00:00
}""".join(s)
2017-03-28 00:48:31 +00:00
2017-06-30 08:35:21 +00:00
code += gen_function_wrapper(name, locals, args_dispatch)
2017-03-28 00:48:31 +00:00
ifdef, endif = gen_deps(deps)
dispatch_code = gen_dispatch(name, suite_deps + deps)
2017-06-30 08:35:21 +00:00
return name, args, ifdef + code + endif, dispatch_code
2017-03-28 00:48:31 +00:00
def parse_functions(funcs_f):
"""
Parses a test_suite_xxx.function file and returns information
for generating a C source file for the test suite.
:param funcs_f: file object of the functions file.
2018-06-28 15:49:13 +00:00
:return: List of test suite dependencies, test function dispatch
code, function code and a dict with function identifiers
and arguments info.
2017-03-28 00:48:31 +00:00
"""
suite_headers = ''
suite_helpers = ''
2017-03-28 00:48:31 +00:00
suite_deps = []
suite_functions = ''
func_info = {}
function_idx = 0
dispatch_code = ''
for line in funcs_f:
if re.search(BEGIN_HEADER_REGEX, line):
headers = parse_until_pattern(funcs_f, END_HEADER_REGEX)
2017-03-28 00:48:31 +00:00
suite_headers += headers
elif re.search(BEGIN_SUITE_HELPERS_REGEX, line):
helpers = parse_until_pattern(funcs_f, END_SUITE_HELPERS_REGEX)
suite_helpers += helpers
2017-03-28 00:48:31 +00:00
elif re.search(BEGIN_DEP_REGEX, line):
2017-06-30 08:35:21 +00:00
deps = parse_suite_deps(funcs_f)
2017-03-28 00:48:31 +00:00
suite_deps += deps
elif re.search(BEGIN_CASE_REGEX, line):
deps = parse_function_deps(line)
2018-06-28 15:49:13 +00:00
func_name, args, func_code, func_dispatch =\
parse_function_code(funcs_f, deps, suite_deps)
2017-03-28 00:48:31 +00:00
suite_functions += func_code
# Generate dispatch code and enumeration info
if func_name in func_info:
raise GeneratorInputError(
"file: %s - function %s re-declared at line %d" % \
(funcs_f.name, func_name, funcs_f.line_no))
2017-03-28 00:48:31 +00:00
func_info[func_name] = (function_idx, args)
dispatch_code += '/* Function Id: %d */\n' % function_idx
dispatch_code += func_dispatch
function_idx += 1
ifdef, endif = gen_deps(suite_deps)
func_code = ifdef + suite_headers + suite_helpers + suite_functions + endif
return suite_deps, dispatch_code, func_code, func_info
2017-03-28 00:48:31 +00:00
def escaped_split(str, ch):
"""
Split str on character ch but ignore escaped \{ch}
2018-06-28 15:49:13 +00:00
Since, return value is used to write back to the intermediate
data file, any escape characters in the input are retained in the
output.
2017-03-28 00:48:31 +00:00
:param str: String to split
:param ch: split character
:return: List of splits
2017-03-28 00:48:31 +00:00
"""
if len(ch) > 1:
raise ValueError('Expected split character. Found string!')
out = []
part = ''
escape = False
for i in range(len(str)):
if not escape and str[i] == ch:
out.append(part)
part = ''
else:
part += str[i]
2017-03-28 00:48:31 +00:00
escape = not escape and str[i] == '\\'
if len(part):
out.append(part)
return out
2017-07-03 12:58:20 +00:00
def parse_test_data(data_f, debug=False):
2017-03-28 00:48:31 +00:00
"""
Parses .data file for each test case name, test function name,
test dependencies and test arguments. This information is
correlated with the test functions file for generating an
intermediate data file replacing the strings for test function
names, dependencies and integer constant expressions with
identifiers. Mainly for optimising space for on-target
execution.
:param data_f: file object of the data file.
2018-06-28 15:49:13 +00:00
:return: Generator that yields test name, function name,
dependency list and function argument list.
2017-03-28 00:48:31 +00:00
"""
STATE_READ_NAME = 0
STATE_READ_ARGS = 1
state = STATE_READ_NAME
deps = []
2017-07-03 12:58:20 +00:00
name = ''
2017-03-28 00:48:31 +00:00
for line in data_f:
line = line.strip()
if len(line) and line[0] == '#': # Skip comments
continue
2017-07-03 12:58:20 +00:00
# Blank line indicates end of test
2017-03-28 00:48:31 +00:00
if len(line) == 0:
if state == STATE_READ_ARGS:
2018-06-28 15:49:13 +00:00
raise GeneratorInputError("[%s:%d] Newline before arguments. "
"Test function and arguments "
"missing for %s" %
(data_f.name, data_f.line_no, name))
2017-03-28 00:48:31 +00:00
continue
if state == STATE_READ_NAME:
# Read test name
name = line
state = STATE_READ_ARGS
elif state == STATE_READ_ARGS:
# Check dependencies
m = re.search('depends_on\:(.*)', line)
if m:
2018-06-28 15:49:13 +00:00
deps = [x.strip() for x in m.group(1).split(':') if len(
x.strip())]
2017-03-28 00:48:31 +00:00
else:
# Read test vectors
parts = escaped_split(line, ':')
function = parts[0]
args = parts[1:]
yield name, function, deps, args
deps = []
state = STATE_READ_NAME
if state == STATE_READ_ARGS:
2018-06-28 15:49:13 +00:00
raise GeneratorInputError("[%s:%d] Newline before arguments. "
"Test function and arguments missing for "
"%s" % (data_f.name, data_f.line_no, name))
2017-03-28 00:48:31 +00:00
def gen_dep_check(dep_id, dep):
"""
Generate code for checking dependency with the associated
identifier.
:param dep_id: Dependency identifier
:param dep: Dependency macro
:return: Dependency check code
2017-03-28 00:48:31 +00:00
"""
if dep_id < 0:
2018-06-28 15:49:13 +00:00
raise GeneratorInputError("Dependency Id should be a positive "
"integer.")
2017-07-03 12:58:20 +00:00
noT, dep = ('!', dep[1:]) if dep[0] == '!' else ('', dep)
if len(dep) == 0:
raise GeneratorInputError("Dependency should not be an empty string.")
2017-03-28 00:48:31 +00:00
dep_check = '''
case {id}:
{{
#if {noT}defined({macro})
ret = DEPENDENCY_SUPPORTED;
#else
ret = DEPENDENCY_NOT_SUPPORTED;
#endif
}}
break;'''.format(noT=noT, macro=dep, id=dep_id)
2017-03-28 00:48:31 +00:00
return dep_check
def gen_expression_check(exp_id, exp):
"""
Generates code for evaluating an integer expression using
associated expression Id.
:param exp_id: Expression Identifier
:param exp: Expression/Macro
:return: Expression check code
2017-03-28 00:48:31 +00:00
"""
if exp_id < 0:
2018-06-28 15:49:13 +00:00
raise GeneratorInputError("Expression Id should be a positive "
"integer.")
if len(exp) == 0:
raise GeneratorInputError("Expression should not be an empty string.")
2017-03-28 00:48:31 +00:00
exp_code = '''
case {exp_id}:
{{
*out_value = {expression};
}}
break;'''.format(exp_id=exp_id, expression=exp)
2017-03-28 00:48:31 +00:00
return exp_code
def write_deps(out_data_f, test_deps, unique_deps):
2017-07-03 12:58:20 +00:00
"""
Write dependencies to intermediate test data file, replacing
the string form with identifiers. Also, generates dependency
check code.
:param out_data_f: Output intermediate data file
:param test_deps: Dependencies
2018-06-28 15:49:13 +00:00
:param unique_deps: Mutable list to track unique dependencies
that are global to this re-entrant function.
:return: returns dependency check code.
2017-07-03 12:58:20 +00:00
"""
dep_check_code = ''
if len(test_deps):
out_data_f.write('depends_on')
for dep in test_deps:
if dep not in unique_deps:
unique_deps.append(dep)
dep_id = unique_deps.index(dep)
dep_check_code += gen_dep_check(dep_id, dep)
else:
dep_id = unique_deps.index(dep)
out_data_f.write(':' + str(dep_id))
out_data_f.write('\n')
return dep_check_code
2017-07-03 12:58:20 +00:00
def write_parameters(out_data_f, test_args, func_args, unique_expressions):
2017-03-28 00:48:31 +00:00
"""
Writes test parameters to the intermediate data file, replacing
the string form with identifiers. Also, generates expression
check code.
:param out_data_f: Output intermediate data file
:param test_args: Test parameters
:param func_args: Function arguments
2018-06-28 15:49:13 +00:00
:param unique_expressions: Mutable list to track unique
expressions that are global to this re-entrant function.
:return: Returns expression check code.
2017-03-28 00:48:31 +00:00
"""
expression_code = ''
for i in range(len(test_args)):
typ = func_args[i]
val = test_args[i]
2018-06-28 15:49:13 +00:00
# check if val is a non literal int val (i.e. an expression)
if typ == 'int' and not re.match('(\d+$)|((0x)?[0-9a-fA-F]+$)', val):
typ = 'exp'
if val not in unique_expressions:
unique_expressions.append(val)
2018-06-28 15:49:13 +00:00
# exp_id can be derived from len(). But for
# readability and consistency with case of existing
# let's use index().
exp_id = unique_expressions.index(val)
expression_code += gen_expression_check(exp_id, val)
val = exp_id
else:
val = unique_expressions.index(val)
out_data_f.write(':' + typ + ':' + str(val))
out_data_f.write('\n')
return expression_code
2017-03-28 00:48:31 +00:00
def gen_suite_deps_checks(suite_deps, dep_check_code, expression_code):
"""
Generates preprocessor checks for test suite dependencies.
2018-06-28 15:49:13 +00:00
:param suite_deps: Test suite dependencies read from the
.functions file.
:param dep_check_code: Dependency check code
:param expression_code: Expression check code
2018-06-28 15:49:13 +00:00
:return: Dependency and expression code guarded by test suite
dependencies.
"""
if len(suite_deps):
ifdef = gen_deps_one_line(suite_deps)
dep_check_code = '''
{ifdef}
{code}
#endif
'''.format(ifdef=ifdef, code=dep_check_code)
expression_code = '''
{ifdef}
{code}
#endif
'''.format(ifdef=ifdef, code=expression_code)
2017-03-28 00:48:31 +00:00
return dep_check_code, expression_code
def gen_from_test_data(data_f, out_data_f, func_info, suite_deps):
"""
This function reads test case name, dependencies and test vectors
from the .data file. This information is correlated with the test
functions file for generating an intermediate data file replacing
the strings for test function names, dependencies and integer
constant expressions with identifiers. Mainly for optimising
space for on-target execution.
It also generates test case dependency check code and expression
evaluation code.
:param data_f: Data file object
:param out_data_f:Output intermediate data file
2018-06-28 15:49:13 +00:00
:param func_info: Dict keyed by function and with function id
and arguments info
:param suite_deps: Test suite deps
:return: Returns dependency and expression check code
"""
unique_deps = []
unique_expressions = []
dep_check_code = ''
expression_code = ''
2018-06-28 15:49:13 +00:00
for test_name, function_name, test_deps, test_args in parse_test_data(
data_f):
out_data_f.write(test_name + '\n')
# Write deps
dep_check_code += write_deps(out_data_f, test_deps, unique_deps)
# Write test function name
test_function_name = 'test_' + function_name
if test_function_name not in func_info:
2018-06-28 15:49:13 +00:00
raise GeneratorInputError("Function %s not found!" %
test_function_name)
func_id, func_args = func_info[test_function_name]
out_data_f.write(str(func_id))
# Write parameters
if len(test_args) != len(func_args):
2018-06-28 15:49:13 +00:00
raise GeneratorInputError("Invalid number of arguments in test "
"%s. See function %s signature." % (
test_name, function_name))
expression_code += write_parameters(out_data_f, test_args, func_args,
unique_expressions)
# Write a newline as test case separator
out_data_f.write('\n')
2018-06-28 15:49:13 +00:00
dep_check_code, expression_code = gen_suite_deps_checks(
suite_deps, dep_check_code, expression_code)
return dep_check_code, expression_code
2018-06-28 15:49:13 +00:00
def generate_code(funcs_file, data_file, template_file, platform_file,
helpers_file, suites_dir, c_file, out_data_file):
2017-03-28 00:48:31 +00:00
"""
Generates C source code from test suite file, data file, common
helpers file and platform file.
2017-03-28 00:48:31 +00:00
:param funcs_file: Functions file object
:param data_file: Data file object
:param template_file: Template file object
:param platform_file: Platform file object
:param helpers_file: Helper functions file object
:param suites_dir: Test suites dir
:param c_file: Output C file object
:param out_data_file: Output intermediate data file object
2017-03-28 00:48:31 +00:00
:return:
"""
for name, path in [('Functions file', funcs_file),
('Data file', data_file),
('Template file', template_file),
('Platform file', platform_file),
('Helpers code file', helpers_file),
2017-03-28 00:48:31 +00:00
('Suites dir', suites_dir)]:
if not os.path.exists(path):
raise IOError("ERROR: %s [%s] not found!" % (name, path))
snippets = {'generator_script' : os.path.basename(__file__)}
# Read helpers
with open(helpers_file, 'r') as help_f, open(platform_file, 'r') as \
2018-06-28 15:49:13 +00:00
platform_f:
snippets['test_common_helper_file'] = helpers_file
2017-03-28 00:48:31 +00:00
snippets['test_common_helpers'] = help_f.read()
snippets['test_platform_file'] = platform_file
2018-06-28 15:49:13 +00:00
snippets['platform_code'] = platform_f.read().replace(
'DATA_FILE', out_data_file.replace('\\', '\\\\')) # escape '\'
2017-03-28 00:48:31 +00:00
# Function code
2018-06-28 15:49:13 +00:00
with FileWrapper(funcs_file) as funcs_f, FileWrapper(data_file) as \
data_f, open(out_data_file, 'w') as out_data_f:
suite_deps, dispatch_code, func_code, func_info = parse_functions(
funcs_f)
2017-03-28 00:48:31 +00:00
snippets['functions_code'] = func_code
snippets['dispatch_code'] = dispatch_code
2018-06-28 15:49:13 +00:00
dep_check_code, expression_code = gen_from_test_data(
data_f, out_data_f, func_info, suite_deps)
2017-03-28 00:48:31 +00:00
snippets['dep_check_code'] = dep_check_code
snippets['expression_code'] = expression_code
snippets['test_file'] = c_file
snippets['test_main_file'] = template_file
snippets['test_case_file'] = funcs_file
snippets['test_case_data_file'] = data_file
# Read Template
# Add functions
#
with open(template_file, 'r') as template_f, open(c_file, 'w') as c_f:
line_no = 1
for line in template_f.readlines():
2018-06-28 15:49:13 +00:00
# Update line number. +1 as #line directive sets next line number
snippets['line_no'] = line_no + 1
2017-03-28 00:48:31 +00:00
code = line.format(**snippets)
c_f.write(code)
line_no += 1
def check_cmd():
"""
Command line parser.
:return:
"""
2018-06-28 15:49:13 +00:00
parser = argparse.ArgumentParser(
description='Dynamically generate test suite code.')
2017-03-28 00:48:31 +00:00
parser.add_argument("-f", "--functions-file",
dest="funcs_file",
help="Functions file",
metavar="FUNCTIONS_FILE",
2017-03-28 00:48:31 +00:00
required=True)
parser.add_argument("-d", "--data-file",
dest="data_file",
help="Data file",
metavar="DATA_FILE",
2017-03-28 00:48:31 +00:00
required=True)
parser.add_argument("-t", "--template-file",
dest="template_file",
help="Template file",
metavar="TEMPLATE_FILE",
2017-03-28 00:48:31 +00:00
required=True)
parser.add_argument("-s", "--suites-dir",
dest="suites_dir",
help="Suites dir",
metavar="SUITES_DIR",
2017-03-28 00:48:31 +00:00
required=True)
parser.add_argument("--helpers-file",
dest="helpers_file",
help="Helpers file",
metavar="HELPERS_FILE",
2017-03-28 00:48:31 +00:00
required=True)
parser.add_argument("-p", "--platform-file",
dest="platform_file",
help="Platform code file",
metavar="PLATFORM_FILE",
required=True)
parser.add_argument("-o", "--out-dir",
dest="out_dir",
help="Dir where generated code and scripts are copied",
metavar="OUT_DIR",
required=True)
args = parser.parse_args()
data_file_name = os.path.basename(args.data_file)
data_name = os.path.splitext(data_file_name)[0]
out_c_file = os.path.join(args.out_dir, data_name + '.c')
out_data_file = os.path.join(args.out_dir, data_name + '.datax')
2017-03-28 00:48:31 +00:00
out_c_file_dir = os.path.dirname(out_c_file)
out_data_file_dir = os.path.dirname(out_data_file)
for d in [out_c_file_dir, out_data_file_dir]:
if not os.path.exists(d):
os.makedirs(d)
2018-06-28 15:49:13 +00:00
generate_code(args.funcs_file, args.data_file, args.template_file,
args.platform_file, args.helpers_file, args.suites_dir,
2018-06-28 15:49:13 +00:00
out_c_file, out_data_file)
2017-03-28 00:48:31 +00:00
if __name__ == "__main__":
try:
check_cmd()
except GeneratorInputError as e:
script_name = os.path.basename(sys.argv[0])
print("%s: input error: %s" % (script_name, str(e)))