d8318feba1
The python tools' test utilities handle printing test results, but the output is quite bare compared to an ordinary unittest run. Delegate printing the results to a unittest text runner, which gives us niceties like clear separation between each test's result and how long it took to run the test suite. Unfortunately it does not print info for skipped tests by default, but this can be handled later by a custom test result subclass. It also does not print the tool name; manually print a heading that includes the toolname so that the outputs of each tool's tests are distinguishable in the CI output. Signed-off-by: Alper Nebi Yasak <alpernebiyasak@gmail.com> Reviewed-by: Simon Glass <sjg@chromium.org>
148 lines
4.9 KiB
Python
Executable File
148 lines
4.9 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
# SPDX-License-Identifier: GPL-2.0+
|
|
|
|
# Copyright (c) 2016 Google, Inc
|
|
# Written by Simon Glass <sjg@chromium.org>
|
|
#
|
|
# Creates binary images from input files controlled by a description
|
|
#
|
|
|
|
"""See README for more information"""
|
|
|
|
import os
|
|
import site
|
|
import sys
|
|
import traceback
|
|
|
|
# Get the absolute path to this file at run-time
|
|
our_path = os.path.dirname(os.path.realpath(__file__))
|
|
our1_path = os.path.dirname(our_path)
|
|
our2_path = os.path.dirname(our1_path)
|
|
|
|
# Extract $(srctree) from Kbuild environment, or use relative paths below
|
|
srctree = os.environ.get('srctree', our2_path)
|
|
|
|
#
|
|
# Do not pollute source tree with cache files:
|
|
# https://stackoverflow.com/a/60024195/2511795
|
|
# https://bugs.python.org/issue33499
|
|
#
|
|
sys.pycache_prefix = os.path.relpath(our_path, srctree)
|
|
|
|
# Bring in the patman and dtoc libraries (but don't override the first path
|
|
# in PYTHONPATH)
|
|
sys.path.insert(2, our1_path)
|
|
|
|
from binman import bintool
|
|
from patman import test_util
|
|
|
|
# Bring in the libfdt module
|
|
sys.path.insert(2, 'scripts/dtc/pylibfdt')
|
|
sys.path.insert(2, os.path.join(srctree, 'scripts/dtc/pylibfdt'))
|
|
sys.path.insert(2, os.path.join(srctree, 'build-sandbox/scripts/dtc/pylibfdt'))
|
|
sys.path.insert(2, os.path.join(srctree, 'build-sandbox_spl/scripts/dtc/pylibfdt'))
|
|
|
|
from binman import cmdline
|
|
from binman import control
|
|
from patman import test_util
|
|
|
|
def RunTests(debug, verbosity, processes, test_preserve_dirs, args, toolpath):
|
|
"""Run the functional tests and any embedded doctests
|
|
|
|
Args:
|
|
debug: True to enable debugging, which shows a full stack trace on error
|
|
verbosity: Verbosity level to use
|
|
test_preserve_dirs: True to preserve the input directory used by tests
|
|
so that it can be examined afterwards (only useful for debugging
|
|
tests). If a single test is selected (in args[0]) it also preserves
|
|
the output directory for this test. Both directories are displayed
|
|
on the command line.
|
|
processes: Number of processes to use to run tests (None=same as #CPUs)
|
|
args: List of positional args provided to binman. This can hold a test
|
|
name to execute (as in 'binman test testSections', for example)
|
|
toolpath: List of paths to use for tools
|
|
"""
|
|
from binman import bintool_test
|
|
from binman import cbfs_util_test
|
|
from binman import elf_test
|
|
from binman import entry_test
|
|
from binman import fdt_test
|
|
from binman import fip_util_test
|
|
from binman import ftest
|
|
from binman import image_test
|
|
import doctest
|
|
|
|
test_name = args and args[0] or None
|
|
|
|
# Run the entry tests first ,since these need to be the first to import the
|
|
# 'entry' module.
|
|
result = test_util.run_test_suites(
|
|
'binman', debug, verbosity, test_preserve_dirs, processes, test_name,
|
|
toolpath,
|
|
[bintool_test.TestBintool, entry_test.TestEntry, ftest.TestFunctional,
|
|
fdt_test.TestFdt, elf_test.TestElf, image_test.TestImage,
|
|
cbfs_util_test.TestCbfs, fip_util_test.TestFip])
|
|
|
|
return (0 if result.wasSuccessful() else 1)
|
|
|
|
def RunTestCoverage(toolpath):
|
|
"""Run the tests and check that we get 100% coverage"""
|
|
glob_list = control.GetEntryModules(False)
|
|
all_set = set([os.path.splitext(os.path.basename(item))[0]
|
|
for item in glob_list if '_testing' not in item])
|
|
extra_args = ''
|
|
if toolpath:
|
|
for path in toolpath:
|
|
extra_args += ' --toolpath %s' % path
|
|
test_util.run_test_coverage('tools/binman/binman', None,
|
|
['*test*', '*main.py', 'tools/patman/*', 'tools/dtoc/*'],
|
|
args.build_dir, all_set, extra_args or None)
|
|
|
|
def RunBinman(args):
|
|
"""Main entry point to binman once arguments are parsed
|
|
|
|
Args:
|
|
args: Command line arguments Namespace object
|
|
"""
|
|
ret_code = 0
|
|
|
|
if not args.debug:
|
|
sys.tracebacklimit = 0
|
|
|
|
# Provide a default toolpath in the hope of finding a mkimage built from
|
|
# current source
|
|
if not args.toolpath:
|
|
args.toolpath = ['./tools', 'build-sandbox/tools']
|
|
|
|
if args.cmd == 'test':
|
|
if args.test_coverage:
|
|
RunTestCoverage(args.toolpath)
|
|
else:
|
|
ret_code = RunTests(args.debug, args.verbosity, args.processes,
|
|
args.test_preserve_dirs, args.tests,
|
|
args.toolpath)
|
|
|
|
elif args.cmd == 'bintool-docs':
|
|
control.write_bintool_docs(bintool.Bintool.get_tool_list())
|
|
|
|
elif args.cmd == 'entry-docs':
|
|
control.WriteEntryDocs(control.GetEntryModules())
|
|
|
|
else:
|
|
try:
|
|
ret_code = control.Binman(args)
|
|
except Exception as e:
|
|
print('binman: %s' % e, file=sys.stderr)
|
|
if args.debug:
|
|
print()
|
|
traceback.print_exc()
|
|
ret_code = 1
|
|
return ret_code
|
|
|
|
|
|
if __name__ == "__main__":
|
|
args = cmdline.ParseArgs(sys.argv[1:])
|
|
|
|
ret_code = RunBinman(args)
|
|
sys.exit(ret_code)
|