diff options
| author | Tom Soulanille <soul@prama.com> | 2015-09-15 09:48:56 -0700 |
|---|---|---|
| committer | Paul Sokolovsky <pfalcon@users.sourceforge.net> | 2015-09-15 20:05:05 +0300 |
| commit | 04fffe6562e01522cc086b877080b0efb9481327 (patch) | |
| tree | 29f7a076147a3c327061e9a4f62f5613cd4d25b7 | |
| parent | 0d6b2341b8f8e2723d1856ea129b8116e294ff3f (diff) | |
| download | micropython-04fffe6562e01522cc086b877080b0efb9481327.tar.gz micropython-04fffe6562e01522cc086b877080b0efb9481327.zip | |
tests/README: Explain how tests get skipped
| -rw-r--r-- | tests/README | 16 |
1 files changed, 13 insertions, 3 deletions
diff --git a/tests/README b/tests/README index 0cb526c3b4..b028cd062a 100644 --- a/tests/README +++ b/tests/README @@ -1,7 +1,17 @@ This directory contains tests for various functionality areas of MicroPython. -To run all stable tests, run "run-tests" script in this directory. Note -that bytecode tests are not yet stable and should be run separately in -"bytecode" subdirectory. +To run all stable tests, run "run-tests" script in this directory. + +Tests of capabilities not supported on all platforms should be written +to check for the capability being present. If it is not, the test +should merely output 'SKIP' followed by the line terminator, and call +sys.exit() to raise SystemExit, instead of attempting to test the +missing capability. The testing framework (run-tests in this +directory, test_main.c in qemu_arm) recognizes this as a skipped test. + +There are a few features for which this mechanism cannot be used to +condition a test. The run-tests script uses small scripts in the +feature_check directory to check whether each such feature is present, +and skips the relevant tests if not. When creating new tests, anything that relies on float support should go in the float/ subdirectory. Anything that relies on import x, where x is not a built-in |