#! /usr/bin/env python3 import os import subprocess import sys import sysconfig import platform import argparse import inspect import json import re from glob import glob import multiprocessing from multiprocessing.pool import ThreadPool import threading import tempfile # Maximum time to run a PC-based test, in seconds. TEST_TIMEOUT = float(os.environ.get('MICROPY_TEST_TIMEOUT', 30)) # See stackoverflow.com/questions/2632199: __file__ nor sys.argv[0] # are guaranteed to always work, this one should though. BASEPATH = os.path.dirname(os.path.abspath(inspect.getsourcefile(lambda: None))) def base_path(*p): return os.path.abspath(os.path.join(BASEPATH, *p)).replace("\\", "/") # Tests require at least CPython 3.3. If your default python3 executable # is of lower version, you can point MICROPY_CPYTHON3 environment var # to the correct executable. if os.name == "nt": CPYTHON3 = os.getenv("MICROPY_CPYTHON3", "python") MICROPYTHON = os.getenv( "MICROPY_MICROPYTHON", base_path("../ports/windows/build-standard/micropython.exe") ) # mpy-cross is only needed if --via-mpy command-line arg is passed MPYCROSS = os.getenv("MICROPY_MPYCROSS", base_path("../mpy-cross/build/mpy-cross.exe")) else: CPYTHON3 = os.getenv("MICROPY_CPYTHON3", "python3") MICROPYTHON = os.getenv( "MICROPY_MICROPYTHON", base_path("../ports/unix/build-standard/micropython") ) # mpy-cross is only needed if --via-mpy command-line arg is passed MPYCROSS = os.getenv("MICROPY_MPYCROSS", base_path("../mpy-cross/build/mpy-cross")) # Use CPython options to not save .pyc files, to only access the core standard library # (not site packages which may clash with u-module names), and improve start up time. CPYTHON3_CMD = [CPYTHON3, "-BS"] # File with the test results. RESULTS_FILE = "_results.json" # For diff'ing test output DIFF = os.getenv("MICROPY_DIFF", "diff -u") # Set PYTHONIOENCODING so that CPython will use utf-8 on systems which set another encoding in the locale os.environ["PYTHONIOENCODING"] = "utf-8" # Code to allow a target MicroPython to import an .mpy from RAM # Note: the module is named `__injected_test` but it needs to have `__name__` set to # `__main__` so that the test sees itself as the main module, eg so unittest works. injected_import_hook_code = """\ import sys, os, io, vfs class __File(io.IOBase): def __init__(self): module = sys.modules['__injected_test'] module.__name__ = '__main__' sys.modules['__main__'] = module self.off = 0 def ioctl(self, request, arg): if request == 4: # MP_STREAM_CLOSE return 0 return -1 def readinto(self, buf): buf[:] = memoryview(__buf)[self.off:self.off + len(buf)] self.off += len(buf) return len(buf) class __FS: def mount(self, readonly, mkfs): pass def umount(self): pass def chdir(self, path): pass def getcwd(self): return "" def stat(self, path): if path == '__injected_test.mpy': return tuple(0 for _ in range(10)) else: raise OSError(-2) # ENOENT def open(self, path, mode): return __File() vfs.mount(__FS(), '/__vfstest') os.chdir('/__vfstest') {import_prologue} __import__('__injected_test') """ # Platforms associated with the unix port, values of `sys.platform`. PC_PLATFORMS = ("darwin", "linux", "win32") # Tests to skip on specific targets. # These are tests that are difficult to detect that they should not be run on the given target. platform_tests_to_skip = { "esp8266": ( "misc/rge_sm.py", # incorrect values due to object representation C ), "minimal": ( "basics/class_inplace_op.py", # all special methods not supported "basics/subclass_native_init.py", # native subclassing corner cases not support "micropython/opt_level.py", # don't assume line numbers are stored ), "nrf": ( "basics/io_buffered_writer.py", "basics/io_bytesio_cow.py", "basics/io_bytesio_ext.py", "basics/io_bytesio_ext2.py", "basics/io_iobase.py", "basics/io_stringio1.py", "basics/io_stringio_base.py", "basics/io_stringio_with.py", "basics/io_write_ext.py", "basics/memoryview1.py", # no item assignment for memoryview "extmod/random_basic.py", # unimplemented: random.seed "micropython/opt_level.py", # no support for line numbers "misc/non_compliant.py", # no item assignment for bytearray ), "renesas-ra": ( "extmod/time_time_ns.py", # RA fsp rtc function doesn't support nano sec info ), "rp2": ( # Skip thread tests that require more that 2 threads. "thread/stress_heap.py", "thread/thread_lock2.py", "thread/thread_lock3.py", "thread/thread_shared2.py", ), "qemu": ( # Skip tests that require Cortex-M4. "inlineasm/thumb/asmfpaddsub.py", "inlineasm/thumb/asmfpcmp.py", "inlineasm/thumb/asmfpldrstr.py", "inlineasm/thumb/asmfpmuldiv.py", "inlineasm/thumb/asmfpsqrt.py", ), "webassembly": ( "basics/string_format_modulo.py", # can't print nulls to stdout "basics/string_strip.py", # can't print nulls to stdout "extmod/asyncio_basic2.py", "extmod/asyncio_cancel_self.py", "extmod/asyncio_current_task.py", "extmod/asyncio_exception.py", "extmod/asyncio_gather_finished_early.py", "extmod/asyncio_get_event_loop.py", "extmod/asyncio_heaplock.py", "extmod/asyncio_loop_stop.py", "extmod/asyncio_new_event_loop.py", "extmod/asyncio_threadsafeflag.py", "extmod/asyncio_wait_for_fwd.py", "extmod/asyncio_event_queue.py", "extmod/asyncio_iterator_event.py", "extmod/asyncio_wait_for_linked_task.py", "extmod/binascii_a2b_base64.py", "extmod/deflate_compress_memory_error.py", # tries to allocate unlimited memory "extmod/re_stack_overflow.py", "extmod/time_res.py", "extmod/vfs_posix.py", "extmod/vfs_posix_enoent.py", "extmod/vfs_posix_paths.py", "extmod/vfs_userfs.py", "micropython/emg_exc.py", "micropython/extreme_exc.py", "micropython/heapalloc_exc_compressed_emg_exc.py", ), "WiPy": ( "misc/print_exception.py", # requires error reporting full ), "zephyr": ( # Skip thread tests that require more than 4 threads. "thread/stress_heap.py", "thread/thread_lock3.py", ), } def rm_f(fname): if os.path.exists(fname): os.remove(fname) # unescape wanted regex chars and escape unwanted ones def convert_regex_escapes(line): cs = [] escape = False for c in str(line, "utf8"): if escape: escape = False cs.append(c) elif c == "\\": escape = True elif c in ("(", ")", "[", "]", "{", "}", ".", "*", "+", "^", "$"): cs.append("\\" + c) else: cs.append(c) # accept carriage-return(s) before final newline if cs[-1] == "\n": cs[-1] = "\r*\n" return bytes("".join(cs), "utf8") def get_test_instance(test_instance, baudrate, user, password): if test_instance.startswith("port:"): _, port = test_instance.split(":", 1) elif test_instance == "unix": return None elif test_instance == "webassembly": return PyboardNodeRunner() elif test_instance.startswith("a") and test_instance[1:].isdigit(): port = "/dev/ttyACM" + test_instance[1:] elif test_instance.startswith("u") and test_instance[1:].isdigit(): port = "/dev/ttyUSB" + test_instance[1:] elif test_instance.startswith("c") and test_instance[1:].isdigit(): port = "COM" + test_instance[1:] else: # Assume it's a device path. port = test_instance global pyboard sys.path.append(base_path("../tools")) import pyboard pyb = pyboard.Pyboard(port, baudrate, user, password) pyboard.Pyboard.run_script_on_remote_target = run_script_on_remote_target pyb.enter_raw_repl() return pyb def detect_inline_asm_arch(pyb, args): for arch in ("rv32", "thumb", "xtensa"): output = run_feature_check(pyb, args, "inlineasm_{}.py".format(arch)) if output.strip() == arch.encode(): return arch return None def detect_test_platform(pyb, args): # Run a script to detect various bits of information about the target test instance. output = run_feature_check(pyb, args, "target_info.py") if output.endswith(b"CRASH"): raise ValueError("cannot detect platform: {}".format(output)) platform, arch = str(output, "ascii").strip().split() if arch == "None": arch = None inlineasm_arch = detect_inline_asm_arch(pyb, args) args.platform = platform args.arch = arch if arch and not args.mpy_cross_flags: args.mpy_cross_flags = "-march=" + arch args.inlineasm_arch = inlineasm_arch print("platform={}".format(platform), end="") if arch: print(" arch={}".format(arch), end="") if inlineasm_arch: print(" inlineasm={}".format(inlineasm_arch), end="") print() def prepare_script_for_target(args, *, script_text=None, force_plain=False): if force_plain or (not args.via_mpy and args.emit == "bytecode"): # A plain test to run as-is, no processing needed. pass elif args.via_mpy: tempname = tempfile.mktemp(dir="") mpy_filename = tempname + ".mpy" script_filename = tempname + ".py" with open(script_filename, "wb") as f: f.write(script_text) try: subprocess.check_output( [MPYCROSS] + args.mpy_cross_flags.split() + ["-o", mpy_filename, "-X", "emit=" + args.emit, script_filename], stderr=subprocess.STDOUT, ) except subprocess.CalledProcessError as er: return True, b"mpy-cross crash\n" + er.output with open(mpy_filename, "rb") as f: script_text = b"__buf=" + bytes(repr(f.read()), "ascii") + b"\n" rm_f(mpy_filename) rm_f(script_filename) script_text += bytes(injected_import_hook_code, "ascii") else: print("error: using emit={} must go via .mpy".format(args.emit)) sys.exit(1) return False, script_text def run_script_on_remote_target(pyb, args, test_file, is_special): with open(test_file, "rb") as f: script = f.read() # If the test is not a special test, prepend it with a print to indicate that it started. # If the print does not execute this means that the test did not even start, eg it was # too large for the target. prepend_start_test = not is_special if prepend_start_test: if script.startswith(b"#"): script = b"print('START TEST')" + script else: script = b"print('START TEST')\n" + script had_crash, script = prepare_script_for_target(args, script_text=script, force_plain=is_special) if had_crash: return True, script try: had_crash = False pyb.enter_raw_repl() output_mupy = pyb.exec_(script) except pyboard.PyboardError as e: had_crash = True if not is_special and e.args[0] == "exception": if prepend_start_test and e.args[1] == b"" and b"MemoryError" in e.args[2]: output_mupy = b"SKIP-TOO-LARGE\n" else: output_mupy = e.args[1] + e.args[2] + b"CRASH" else: output_mupy = bytes(e.args[0], "ascii") + b"\nCRASH" if prepend_start_test: if output_mupy.startswith(b"START TEST\r\n"): output_mupy = output_mupy.removeprefix(b"START TEST\r\n") else: had_crash = True return had_crash, output_mupy special_tests = [ base_path(file) for file in ( "micropython/meminfo.py", "basics/bytes_compare3.py", "basics/builtin_help.py", "misc/sys_settrace_cov.py", "thread/thread_exc2.py", "ports/esp32/partition_ota.py", ) ] def run_micropython(pyb, args, test_file, test_file_abspath, is_special=False): had_crash = False if pyb is None: # run on PC if ( test_file_abspath.startswith((base_path("cmdline/"), base_path("feature_check/"))) or test_file_abspath in special_tests ): # special handling for tests of the unix cmdline program is_special = True if is_special: # check for any cmdline options needed for this test args = [MICROPYTHON] with open(test_file, "rb") as f: line = f.readline() if line.startswith(b"# cmdline:"): # subprocess.check_output on Windows only accepts strings, not bytes args += [str(c, "utf-8") for c in line[10:].strip().split()] # run the test, possibly with redirected input try: if os.path.basename(test_file).startswith("repl_"): # Need to use a PTY to test command line editing try: import pty except ImportError: # in case pty module is not available, like on Windows return b"SKIP\n" import select # Even though these might have the pty module, it's unlikely to function. if sys.platform in ["win32", "msys", "cygwin"]: return b"SKIP\n" def get(required=False): rv = b"" while True: ready = select.select([master], [], [], 0.02) if ready[0] == [master]: rv += os.read(master, 1024) else: if not required or rv: return rv def send_get(what): # Detect {\x00} pattern and convert to ctrl-key codes. ctrl_code = lambda m: bytes([int(m.group(1))]) what = re.sub(rb'{\\x(\d\d)}', ctrl_code, what) os.write(master, what) return get() with open(test_file, "rb") as f: # instead of: output_mupy = subprocess.check_output(args, stdin=f) master, slave = pty.openpty() p = subprocess.Popen( args, stdin=slave, stdout=slave, stderr=subprocess.STDOUT, bufsize=0 ) banner = get(True) output_mupy = banner + b"".join(send_get(line) for line in f) send_get(b"\x04") # exit the REPL, so coverage info is saved # At this point the process might have exited already, but trying to # kill it 'again' normally doesn't result in exceptions as Python and/or # the OS seem to try to handle this nicely. When running Linux on WSL # though, the situation differs and calling Popen.kill after the process # terminated results in a ProcessLookupError. Just catch that one here # since we just want the process to be gone and that's the case. try: p.kill() except ProcessLookupError: pass os.close(master) os.close(slave) else: output_mupy = subprocess.check_output( args + [test_file], stderr=subprocess.STDOUT ) except subprocess.CalledProcessError: return b"CRASH" else: # a standard test run on PC # create system command cmdlist = [os.path.abspath(MICROPYTHON), "-X", "emit=" + args.emit] if args.heapsize is not None: cmdlist.extend(["-X", "heapsize=" + args.heapsize]) if sys.platform == "darwin": cmdlist.extend(["-X", "realtime"]) cwd = os.path.dirname(test_file) # if running via .mpy, first compile the .py file if args.via_mpy: mpy_filename = tempfile.mktemp(dir=cwd, suffix=".mpy") subprocess.check_output( [MPYCROSS] + args.mpy_cross_flags.split() + ["-o", mpy_filename, "-X", "emit=" + args.emit, test_file] ) mpy_modname = os.path.splitext(os.path.basename(mpy_filename))[0] cmdlist.extend(["-m", mpy_modname]) else: cmdlist.append(test_file_abspath) # run the actual test try: output_mupy = subprocess.check_output( cmdlist, stderr=subprocess.STDOUT, timeout=TEST_TIMEOUT, cwd=cwd ) except subprocess.CalledProcessError as er: had_crash = True output_mupy = er.output + b"CRASH" except subprocess.TimeoutExpired as er: had_crash = True output_mupy = (er.output or b"") + b"TIMEOUT" # clean up if we had an intermediate .mpy file if args.via_mpy: rm_f(mpy_filename) else: # run via pyboard interface had_crash, output_mupy = pyb.run_script_on_remote_target( args, test_file_abspath, is_special ) # canonical form for all ports/platforms is to use \n for end-of-line output_mupy = output_mupy.replace(b"\r\n", b"\n") # don't try to convert the output if we should skip this test if had_crash or output_mupy in (b"SKIP\n", b"SKIP-TOO-LARGE\n", b"CRASH"): return output_mupy # skipped special tests will output "SKIP" surrounded by other interpreter debug output if is_special and not had_crash and b"\nSKIP\n" in output_mupy: return b"SKIP\n" if is_special or test_file_abspath in special_tests: # convert parts of the output that are not stable across runs with open(test_file + ".exp", "rb") as f: lines_exp = [] for line in f.readlines(): if line == b"########\n": line = (line,) else: line = (line, re.compile(convert_regex_escapes(line))) lines_exp.append(line) lines_mupy = [line + b"\n" for line in output_mupy.split(b"\n")] if output_mupy.endswith(b"\n"): lines_mupy = lines_mupy[:-1] # remove erroneous last empty line i_mupy = 0 for i in range(len(lines_exp)): if lines_exp[i][0] == b"########\n": # 8x #'s means match 0 or more whole lines line_exp = lines_exp[i + 1] skip = 0 while i_mupy + skip < len(lines_mupy) and not line_exp[1].match( lines_mupy[i_mupy + skip] ): skip += 1 if i_mupy + skip >= len(lines_mupy): lines_mupy[i_mupy] = b"######## FAIL\n" break del lines_mupy[i_mupy : i_mupy + skip] lines_mupy.insert(i_mupy, b"########\n") i_mupy += 1 else: # a regex if lines_exp[i][1].match(lines_mupy[i_mupy]): lines_mupy[i_mupy] = lines_exp[i][0] else: # print("don't match: %r %s" % (lines_exp[i][1], lines_mupy[i_mupy])) # DEBUG pass i_mupy += 1 if i_mupy >= len(lines_mupy): break output_mupy = b"".join(lines_mupy) return output_mupy def run_feature_check(pyb, args, test_file): if pyb is not None and test_file.startswith("repl_"): # REPL feature tests will not run via pyboard because they require prompt interactivity return b"" test_file_path = base_path("feature_check", test_file) return run_micropython(pyb, args, test_file_path, test_file_path, is_special=True) class TestError(Exception): pass class ThreadSafeCounter: def __init__(self, start=0): self._value = start self._lock = threading.Lock() def increment(self): self.add(1) def add(self, to_add): with self._lock: self._value += to_add def append(self, arg): self.add([arg]) @property def value(self): return self._value class PyboardNodeRunner: def __init__(self): mjs = os.getenv("MICROPY_MICROPYTHON_MJS") if mjs is None: mjs = base_path("../ports/webassembly/build-standard/micropython.mjs") else: mjs = os.path.abspath(mjs) self.micropython_mjs = mjs def close(self): pass def run_script_on_remote_target(self, args, test_file, is_special): cwd = os.path.dirname(test_file) # Create system command list. cmdlist = ["node"] if test_file.endswith(".py"): # Run a Python script indirectly via "node micropython.mjs ". cmdlist.append(self.micropython_mjs) if args.heapsize is not None: cmdlist.extend(["-X", "heapsize=" + args.heapsize]) cmdlist.append(test_file) else: # Run a js/mjs script directly with Node, passing in the path to micropython.mjs. cmdlist.append(test_file) cmdlist.append(self.micropython_mjs) # Run the script. try: had_crash = False output_mupy = subprocess.check_output( cmdlist, stderr=subprocess.STDOUT, timeout=TEST_TIMEOUT, cwd=cwd ) except subprocess.CalledProcessError as er: had_crash = True output_mupy = er.output + b"CRASH" except subprocess.TimeoutExpired as er: had_crash = True output_mupy = (er.output or b"") + b"TIMEOUT" # Return the results. return had_crash, output_mupy def run_tests(pyb, tests, args, result_dir, num_threads=1): testcase_count = ThreadSafeCounter() test_results = ThreadSafeCounter([]) skip_tests = set() skip_native = False skip_int_big = False skip_bytearray = False skip_set_type = False skip_slice = False skip_async = False skip_const = False skip_revops = False skip_io_module = False skip_fstring = False skip_endian = False skip_inlineasm = False has_complex = True has_coverage = False upy_float_precision = 32 if True: # Even if we run completely different tests in a different directory, # we need to access feature_checks from the same directory as the # run-tests.py script itself so use base_path. # Check if micropython.native is supported, and skip such tests if it's not output = run_feature_check(pyb, args, "native_check.py") if output != b"native\n": skip_native = True # Check if arbitrary-precision integers are supported, and skip such tests if it's not output = run_feature_check(pyb, args, "int_big.py") if output != b"1000000000000000000000000000000000000000000000\n": skip_int_big = True # Check if bytearray is supported, and skip such tests if it's not output = run_feature_check(pyb, args, "bytearray.py") if output != b"bytearray\n": skip_bytearray = True # Check if set type (and set literals) is supported, and skip such tests if it's not output = run_feature_check(pyb, args, "set_check.py") if output != b"{1}\n": skip_set_type = True # Check if slice is supported, and skip such tests if it's not output = run_feature_check(pyb, args, "slice.py") if output != b"slice\n": skip_slice = True # Check if async/await keywords are supported, and skip such tests if it's not output = run_feature_check(pyb, args, "async_check.py") if output != b"async\n": skip_async = True # Check if const keyword (MicroPython extension) is supported, and skip such tests if it's not output = run_feature_check(pyb, args, "const.py") if output != b"1\n": skip_const = True # Check if __rOP__ special methods are supported, and skip such tests if it's not output = run_feature_check(pyb, args, "reverse_ops.py") if output == b"TypeError\n": skip_revops = True # Check if io module exists, and skip such tests if it doesn't output = run_feature_check(pyb, args, "io_module.py") if output != b"io\n": skip_io_module = True # Check if fstring feature is enabled, and skip such tests if it doesn't output = run_feature_check(pyb, args, "fstring.py") if output != b"a=1\n": skip_fstring = True if args.inlineasm_arch == "thumb": # Check if @micropython.asm_thumb supports Thumb2 instructions, and skip such tests if it doesn't output = run_feature_check(pyb, args, "inlineasm_thumb2.py") if output != b"thumb2\n": skip_tests.add("inlineasm/thumb/asmbcc.py") skip_tests.add("inlineasm/thumb/asmbitops.py") skip_tests.add("inlineasm/thumb/asmconst.py") skip_tests.add("inlineasm/thumb/asmdiv.py") skip_tests.add("inlineasm/thumb/asmfpaddsub.py") skip_tests.add("inlineasm/thumb/asmfpcmp.py") skip_tests.add("inlineasm/thumb/asmfpldrstr.py") skip_tests.add("inlineasm/thumb/asmfpmuldiv.py") skip_tests.add("inlineasm/thumb/asmfpsqrt.py") skip_tests.add("inlineasm/thumb/asmit.py") skip_tests.add("inlineasm/thumb/asmspecialregs.py") # Check if emacs repl is supported, and skip such tests if it's not t = run_feature_check(pyb, args, "repl_emacs_check.py") if "True" not in str(t, "ascii"): skip_tests.add("cmdline/repl_emacs_keys.py") # Check if words movement in repl is supported, and skip such tests if it's not t = run_feature_check(pyb, args, "repl_words_move_check.py") if "True" not in str(t, "ascii"): skip_tests.add("cmdline/repl_words_move.py") upy_byteorder = run_feature_check(pyb, args, "byteorder.py") upy_float_precision = run_feature_check(pyb, args, "float.py") try: upy_float_precision = int(upy_float_precision) except ValueError: upy_float_precision = 0 has_complex = run_feature_check(pyb, args, "complex.py") == b"complex\n" has_coverage = run_feature_check(pyb, args, "coverage.py") == b"coverage\n" cpy_byteorder = subprocess.check_output( CPYTHON3_CMD + [base_path("feature_check/byteorder.py")] ) skip_endian = upy_byteorder != cpy_byteorder skip_inlineasm = args.inlineasm_arch is None # These tests don't test slice explicitly but rather use it to perform the test misc_slice_tests = ( "builtin_range", "bytearray1", "class_super", "containment", "errno1", "fun_str", "generator1", "globals_del", "memoryview1", "memoryview_gc", "object1", "python34", "string_format_modulo", "struct_endian", ) # Some tests shouldn't be run on GitHub Actions if os.getenv("GITHUB_ACTIONS") == "true": skip_tests.add("thread/stress_schedule.py") # has reliability issues if os.getenv("RUNNER_OS") == "Windows" and os.getenv("CI_BUILD_CONFIGURATION") == "Debug": # fails with stack overflow on Debug builds skip_tests.add("misc/sys_settrace_features.py") if upy_float_precision == 0: skip_tests.add("extmod/uctypes_le_float.py") skip_tests.add("extmod/uctypes_native_float.py") skip_tests.add("extmod/uctypes_sizeof_float.py") skip_tests.add("extmod/json_dumps_float.py") skip_tests.add("extmod/json_loads_float.py") skip_tests.add("extmod/random_extra_float.py") skip_tests.add("misc/rge_sm.py") if upy_float_precision < 32: skip_tests.add( "float/float2int_intbig.py" ) # requires fp32, there's float2int_fp30_intbig.py instead skip_tests.add( "float/string_format.py" ) # requires fp32, there's string_format_fp30.py instead skip_tests.add("float/bytes_construct.py") # requires fp32 skip_tests.add("float/bytearray_construct.py") # requires fp32 skip_tests.add("float/float_format_ints_power10.py") # requires fp32 if upy_float_precision < 64: skip_tests.add("float/float_divmod.py") # tested by float/float_divmod_relaxed.py instead skip_tests.add("float/float2int_doubleprec_intbig.py") skip_tests.add("float/float_format_ints_doubleprec.py") skip_tests.add("float/float_parse_doubleprec.py") if not has_complex: skip_tests.add("float/complex1.py") skip_tests.add("float/complex1_intbig.py") skip_tests.add("float/complex_reverse_op.py") skip_tests.add("float/complex_special_methods.py") skip_tests.add("float/int_big_float.py") skip_tests.add("float/true_value.py") skip_tests.add("float/types.py") skip_tests.add("float/complex_dunder.py") if not has_coverage: skip_tests.add("cmdline/cmd_parsetree.py") skip_tests.add("cmdline/repl_sys_ps1_ps2.py") skip_tests.add("extmod/ssl_poll.py") # Skip thread mutation tests on targets that don't have the GIL. if args.platform in PC_PLATFORMS + ("rp2",): for t in tests: if t.startswith("thread/mutate_"): skip_tests.add(t) # Some tests shouldn't be run on pyboard if args.platform not in PC_PLATFORMS: skip_tests.add("basics/exception_chain.py") # warning is not printed skip_tests.add("micropython/meminfo.py") # output is very different to PC output # Skip platform-specific tests. skip_tests.update(platform_tests_to_skip.get(args.platform, ())) # Some tests are known to fail on 64-bit machines if pyb is None and platform.architecture()[0] == "64bit": pass # Some tests use unsupported features on Windows if os.name == "nt": if not sysconfig.get_platform().startswith("mingw"): # Works but CPython uses '\' path separator skip_tests.add("import/import_file.py") # Some tests are known to fail with native emitter # Remove them from the below when they work if args.emit == "native": skip_tests.add("basics/gen_yield_from_close.py") # require raise_varargs skip_tests.update( {"basics/%s.py" % t for t in "try_reraise try_reraise2".split()} ) # require raise_varargs skip_tests.add("basics/annotate_var.py") # requires checking for unbound local skip_tests.add("basics/del_deref.py") # requires checking for unbound local skip_tests.add("basics/del_local.py") # requires checking for unbound local skip_tests.add("basics/exception_chain.py") # raise from is not supported skip_tests.add("basics/scope_implicit.py") # requires checking for unbound local skip_tests.add("basics/sys_tracebacklimit.py") # requires traceback info skip_tests.add("basics/try_finally_return2.py") # requires raise_varargs skip_tests.add("basics/unboundlocal.py") # requires checking for unbound local skip_tests.add("misc/features.py") # requires raise_varargs skip_tests.add( "misc/print_exception.py" ) # because native doesn't have proper traceback info skip_tests.add("misc/sys_exc_info.py") # sys.exc_info() is not supported for native skip_tests.add("misc/sys_settrace_features.py") # sys.settrace() not supported skip_tests.add("misc/sys_settrace_generator.py") # sys.settrace() not supported skip_tests.add("misc/sys_settrace_loop.py") # sys.settrace() not supported skip_tests.add( "micropython/emg_exc.py" ) # because native doesn't have proper traceback info skip_tests.add( "micropython/heapalloc_traceback.py" ) # because native doesn't have proper traceback info skip_tests.add( "micropython/opt_level_lineno.py" ) # native doesn't have proper traceback info skip_tests.add("micropython/schedule.py") # native code doesn't check pending events skip_tests.add("stress/bytecode_limit.py") # bytecode specific test skip_tests.add("extmod/asyncio_event_queue.py") # native can't run schedule skip_tests.add("extmod/asyncio_iterator_event.py") # native can't run schedule def run_one_test(test_file): test_file = test_file.replace("\\", "/") test_file_abspath = os.path.abspath(test_file).replace("\\", "/") if args.filters: # Default verdict is the opposite of the first action verdict = "include" if args.filters[0][0] == "exclude" else "exclude" for action, pat in args.filters: if pat.search(test_file): verdict = action if verdict == "exclude": return test_basename = test_file.replace("..", "_").replace("./", "").replace("/", "_") test_name = os.path.splitext(os.path.basename(test_file))[0] is_native = test_name.startswith("native_") or test_name.startswith("viper_") is_endian = test_name.endswith("_endian") is_int_big = test_name.startswith("int_big") or test_name.endswith("_intbig") is_bytearray = test_name.startswith("bytearray") or test_name.endswith("_bytearray") is_set_type = test_name.startswith(("set_", "frozenset")) or test_name.endswith("_set") is_slice = test_name.find("slice") != -1 or test_name in misc_slice_tests is_async = test_name.startswith(("async_", "asyncio_")) is_const = test_name.startswith("const") is_io_module = test_name.startswith("io_") is_fstring = test_name.startswith("string_fstring") is_inlineasm = test_name.startswith("asm") skip_it = test_file in skip_tests skip_it |= skip_native and is_native skip_it |= skip_endian and is_endian skip_it |= skip_int_big and is_int_big skip_it |= skip_bytearray and is_bytearray skip_it |= skip_set_type and is_set_type skip_it |= skip_slice and is_slice skip_it |= skip_async and is_async skip_it |= skip_const and is_const skip_it |= skip_revops and "reverse_op" in test_name skip_it |= skip_io_module and is_io_module skip_it |= skip_fstring and is_fstring skip_it |= skip_inlineasm and is_inlineasm if skip_it: print("skip ", test_file) test_results.append((test_file, "skip", "")) return # Run the test on the MicroPython target. output_mupy = run_micropython(pyb, args, test_file, test_file_abspath) # Check if the target requested to skip this test. if output_mupy == b"SKIP\n": if pyb is not None and hasattr(pyb, "read_until"): # Running on a target over a serial connection, and the target requested # to skip the test. It does this via a SystemExit which triggers a soft # reset. Wait for the soft reset to finish, so we don't interrupt the # start-up code (eg boot.py) when preparing to run the next test. pyb.read_until(1, b"raw REPL; CTRL-B to exit\r\n") print("skip ", test_file) test_results.append((test_file, "skip", "")) return elif output_mupy == b"SKIP-TOO-LARGE\n": print("lrge ", test_file) test_results.append((test_file, "skip", "too large")) return # Look at the output of the test to see if unittest was used. uses_unittest = False output_mupy_lines = output_mupy.splitlines() if any( line == b"ImportError: no module named 'unittest'" for line in output_mupy_lines[-3:] ): raise TestError( ( "error: test {} requires unittest".format(test_file), "(eg run `mpremote mip install unittest` to install it)", ) ) elif ( len(output_mupy_lines) > 4 and output_mupy_lines[-4] == b"-" * 70 and output_mupy_lines[-2] == b"" ): # look for unittest summary unittest_ran_match = re.match(rb"Ran (\d+) tests$", output_mupy_lines[-3]) unittest_result_match = re.match( b"(" rb"(OK)( \(skipped=(\d+)\))?" b"|" rb"(FAILED) \(failures=(\d+), errors=(\d+)\)" b")$", output_mupy_lines[-1], ) uses_unittest = unittest_ran_match and unittest_result_match # Determine the expected output. if uses_unittest: # Expected output is result of running unittest. output_expected = None else: test_file_expected = test_file + ".exp" if os.path.isfile(test_file_expected): # Expected output given by a file, so read that in. with open(test_file_expected, "rb") as f: output_expected = f.read() else: # Run CPython to work out expected output. try: output_expected = subprocess.check_output( CPYTHON3_CMD + [test_file_abspath], cwd=os.path.dirname(test_file), stderr=subprocess.STDOUT, ) except subprocess.CalledProcessError as er: output_expected = b"CPYTHON3 CRASH:\n" + er.output # Canonical form for all host platforms is to use \n for end-of-line. output_expected = output_expected.replace(b"\r\n", b"\n") # Work out if test passed or not. test_passed = False extra_info = "" if uses_unittest: test_passed = unittest_result_match.group(2) == b"OK" num_test_cases = int(unittest_ran_match.group(1)) extra_info = "unittest: {} ran".format(num_test_cases) if test_passed and unittest_result_match.group(4) is not None: num_skipped = int(unittest_result_match.group(4)) num_test_cases -= num_skipped extra_info += ", {} skipped".format(num_skipped) elif not test_passed: num_failures = int(unittest_result_match.group(6)) num_errors = int(unittest_result_match.group(7)) extra_info += ", {} failures, {} errors".format(num_failures, num_errors) extra_info = "(" + extra_info + ")" testcase_count.add(num_test_cases) else: testcase_count.add(len(output_expected.splitlines())) test_passed = output_expected == output_mupy filename_expected = os.path.join(result_dir, test_basename + ".exp") filename_mupy = os.path.join(result_dir, test_basename + ".out") # Print test summary, update counters, and save .exp/.out files if needed. if test_passed: print("pass ", test_file, extra_info) test_results.append((test_file, "pass", "")) rm_f(filename_expected) rm_f(filename_mupy) else: print("FAIL ", test_file, extra_info) if output_expected is not None: with open(filename_expected, "wb") as f: f.write(output_expected) else: rm_f(filename_expected) # in case left over from previous failed run with open(filename_mupy, "wb") as f: f.write(output_mupy) test_results.append((test_file, "fail", "")) # Print a note if this looks like it might have been a misfired unittest if not uses_unittest and not test_passed: with open(test_file, "r") as f: if any(re.match("^import.+unittest", l) for l in f.readlines()): print( "NOTE: {} may be a unittest that doesn't run unittest.main()".format( test_file ) ) if pyb: num_threads = 1 try: if num_threads > 1: pool = ThreadPool(num_threads) pool.map(run_one_test, tests) else: for test in tests: run_one_test(test) except TestError as er: for line in er.args[0]: print(line) sys.exit(1) # Return test results. return test_results.value, testcase_count.value # Print a summary of the results and save them to a JSON file. # Returns True if everything succeeded, False otherwise. def create_test_report(args, test_results, testcase_count=None): passed_tests = list(r for r in test_results if r[1] == "pass") skipped_tests = list(r for r in test_results if r[1] == "skip" and r[2] != "too large") skipped_tests_too_large = list( r for r in test_results if r[1] == "skip" and r[2] == "too large" ) failed_tests = list(r for r in test_results if r[1] == "fail") num_tests_performed = len(passed_tests) + len(failed_tests) testcase_count_info = "" if testcase_count is not None: testcase_count_info = " ({} individual testcases)".format(testcase_count) print("{} tests performed{}".format(num_tests_performed, testcase_count_info)) print("{} tests passed".format(len(passed_tests))) if len(skipped_tests) > 0: print( "{} tests skipped: {}".format( len(skipped_tests), " ".join(test[0] for test in skipped_tests) ) ) if len(skipped_tests_too_large) > 0: print( "{} tests skipped because they are too large: {}".format( len(skipped_tests_too_large), " ".join(test[0] for test in skipped_tests_too_large) ) ) if len(failed_tests) > 0: print( "{} tests failed: {}".format( len(failed_tests), " ".join(test[0] for test in failed_tests) ) ) # Serialize regex added by append_filter. def to_json(obj): if isinstance(obj, re.Pattern): return obj.pattern return obj with open(os.path.join(args.result_dir, RESULTS_FILE), "w") as f: json.dump( { # The arguments passed on the command-line. "args": vars(args), # A list of all results of the form [(test, result, reason), ...]. "results": list(test for test in test_results), # A list of failed tests. This is deprecated, use the "results" above instead. "failed_tests": [test[0] for test in failed_tests], }, f, default=to_json, ) # Return True only if all tests succeeded. return len(failed_tests) == 0 class append_filter(argparse.Action): def __init__(self, option_strings, dest, **kwargs): super().__init__(option_strings, dest, default=[], **kwargs) def __call__(self, parser, args, value, option): if not hasattr(args, self.dest): args.filters = [] if option.startswith(("-e", "--e")): option = "exclude" else: option = "include" args.filters.append((option, re.compile(value))) def main(): global injected_import_hook_code cmd_parser = argparse.ArgumentParser( formatter_class=argparse.RawDescriptionHelpFormatter, description="""Run and manage tests for MicroPython. By default the tests are run against the unix port of MicroPython. To run it against something else, use the -t option. See below for details. Tests are discovered by scanning test directories for .py files or using the specified test files. If test files nor directories are specified, the script expects to be ran in the tests directory (where this file is located) and the builtin tests suitable for the target platform are ran. When running tests, run-tests.py compares the MicroPython output of the test with the output produced by running the test through CPython unless a .exp file is found, in which case it is used as comparison. If a test fails, run-tests.py produces a pair of .out and .exp files in the result directory with the MicroPython output and the expectations, respectively. """, epilog="""\ The -t option accepts the following for the test instance: - unix - use the unix port of MicroPython, specified by the MICROPY_MICROPYTHON environment variable (which defaults to the standard variant of either the unix or windows ports, depending on the host platform) - webassembly - use the webassembly port of MicroPython, specified by the MICROPY_MICROPYTHON_MJS environment variable (which defaults to the standard variant of the webassembly port) - port: - connect to and use the given serial port device - a - connect to and use /dev/ttyACM - u - connect to and use /dev/ttyUSB - c - connect to and use COM - exec: - execute a command and attach to its stdin/stdout - execpty: - execute a command and attach to the printed /dev/pts/ device - ... - connect to the given IPv4 address - anything else specifies a serial port Options -i and -e can be multiple and processed in the order given. Regex "search" (vs "match") operation is used. An action (include/exclude) of the last matching regex is used: run-tests.py -i async - exclude all, then include tests containing "async" anywhere run-tests.py -e '/big.+int' - include all, then exclude by regex run-tests.py -e async -i async_foo - include all, exclude async, yet still include async_foo """, ) cmd_parser.add_argument( "-t", "--test-instance", default="unix", help="the MicroPython instance to test" ) cmd_parser.add_argument( "-b", "--baudrate", default=115200, help="the baud rate of the serial device" ) cmd_parser.add_argument("-u", "--user", default="micro", help="the telnet login username") cmd_parser.add_argument("-p", "--password", default="python", help="the telnet login password") cmd_parser.add_argument( "-d", "--test-dirs", nargs="*", help="input test directories (if no files given)" ) cmd_parser.add_argument( "-r", "--result-dir", default=base_path("results"), help="directory for test results" ) cmd_parser.add_argument( "-e", "--exclude", action=append_filter, metavar="REGEX", dest="filters", help="exclude test by regex on path/name.py", ) cmd_parser.add_argument( "-i", "--include", action=append_filter, metavar="REGEX", dest="filters", help="include test by regex on path/name.py", ) cmd_parser.add_argument( "--emit", default="bytecode", help="MicroPython emitter to use (bytecode or native)" ) cmd_parser.add_argument("--heapsize", help="heapsize to use (use default if not specified)") cmd_parser.add_argument( "--via-mpy", action="store_true", help="compile .py files to .mpy first" ) cmd_parser.add_argument("--mpy-cross-flags", default="", help="flags to pass to mpy-cross") cmd_parser.add_argument( "--keep-path", action="store_true", help="do not clear MICROPYPATH when running tests" ) cmd_parser.add_argument( "-j", "--jobs", default=multiprocessing.cpu_count(), metavar="N", type=int, help="Number of tests to run simultaneously", ) cmd_parser.add_argument("files", nargs="*", help="input test files") cmd_parser.add_argument( "--print-failures", action="store_true", help="print the diff of expected vs. actual output for failed tests and exit", ) cmd_parser.add_argument( "--clean-failures", action="store_true", help="delete the .exp and .out files from failed tests and exit", ) cmd_parser.add_argument( "--run-failures", action="store_true", help="re-run only the failed tests", ) cmd_parser.add_argument( "--begin", metavar="PROLOGUE", default=None, help="prologue python file to execute before module import", ) args = cmd_parser.parse_args() prologue = "" if args.begin: with open(args.begin, "rt") as source: prologue = source.read() injected_import_hook_code = injected_import_hook_code.replace("{import_prologue}", prologue) if args.print_failures: for out in glob(os.path.join(args.result_dir, "*.out")): testbase = out[:-4] print() print("FAILURE {0}".format(testbase)) if os.path.exists(testbase + ".exp"): # Show diff of expected and actual output. os.system("{0} {1}.exp {1}.out".format(DIFF, testbase)) else: # No expected output, just show the actual output (eg from a unittest). with open(out) as f: for line in f: print(line, end="") sys.exit(0) if args.clean_failures: for f in glob(os.path.join(args.result_dir, "*.exp")) + glob( os.path.join(args.result_dir, "*.out") ): os.remove(f) rm_f(os.path.join(args.result_dir, RESULTS_FILE)) sys.exit(0) # Get the test instance to run on. pyb = get_test_instance(args.test_instance, args.baudrate, args.user, args.password) # Automatically detect the platform. detect_test_platform(pyb, args) if args.run_failures and (any(args.files) or args.test_dirs is not None): raise ValueError( "--run-failures cannot be used together with files or --test-dirs arguments" ) if args.run_failures: results_file = os.path.join(args.result_dir, RESULTS_FILE) if os.path.exists(results_file): with open(results_file, "r") as f: tests = list(test[0] for test in json.load(f)["results"] if test[1] == "fail") else: tests = [] elif len(args.files) == 0: test_extensions = ("*.py",) if args.platform == "webassembly": test_extensions += ("*.js", "*.mjs") if args.test_dirs is None: test_dirs = ( "basics", "micropython", "misc", "extmod", ) if args.inlineasm_arch is not None: test_dirs += ("inlineasm/{}".format(args.inlineasm_arch),) if args.platform == "pyboard": # run pyboard tests test_dirs += ("float", "stress", "ports/stm32") elif args.platform == "mimxrt": test_dirs += ("float", "stress") elif args.platform == "renesas-ra": test_dirs += ("float", "ports/renesas-ra") elif args.platform == "rp2": test_dirs += ("float", "stress", "thread", "ports/rp2") elif args.platform == "esp32": test_dirs += ("float", "stress", "thread") elif args.platform in ("esp8266", "minimal", "samd", "nrf"): test_dirs += ("float",) elif args.platform == "WiPy": # run WiPy tests test_dirs += ("ports/cc3200",) elif args.platform in PC_PLATFORMS: # run PC tests test_dirs += ( "float", "import", "io", "stress", "unicode", "cmdline", "ports/unix", ) elif args.platform == "qemu": test_dirs += ( "float", "ports/qemu", ) elif args.platform == "webassembly": test_dirs += ("float", "ports/webassembly") else: # run tests from these directories test_dirs = args.test_dirs tests = sorted( test_file for test_files in ( glob(os.path.join(dir, ext)) for dir in test_dirs for ext in test_extensions ) for test_file in test_files ) else: # tests explicitly given tests = args.files if not args.keep_path: # Clear search path to make sure tests use only builtin modules, those in # extmod, and a path to unittest in case it's needed. os.environ["MICROPYPATH"] = ( ".frozen" + os.pathsep + base_path("../extmod") + os.pathsep + base_path("../lib/micropython-lib/python-stdlib/unittest") ) try: os.makedirs(args.result_dir, exist_ok=True) test_results, testcase_count = run_tests(pyb, tests, args, args.result_dir, args.jobs) res = create_test_report(args, test_results, testcase_count) finally: if pyb: pyb.close() if not res: sys.exit(1) if __name__ == "__main__": main()