micropython/tests
Damien George 3c4bfd1dec py/objexcept: Support errno attribute on OSError exceptions.
This commit adds the errno attribute to exceptions, so code can retrieve
errno codes from an OSError using exc.errno.

The implementation here simply lets `errno` (and the existing `value`)
attributes work on any exception instance (they both alias args[0]).  This
is for efficiency and to keep code size down.  The pros and cons of this
are:

Pros:
- more compatible with CPython, less difference to document and learn
- OSError().errno will correctly return None, whereas the current way of
  doing it via OSError().args[0] will raise an IndexError
- it reduces code size on most bare-metal ports (because they already have
  the errno qstr)
- for Python code that uses exc.errno the generated bytecode is 2 bytes
  smaller and more efficient to execute (compared with exc.args[0]); so
  bytecode loaded to RAM saves 2 bytes RAM for each use of this attribute,
  and bytecode that is frozen saves 2 bytes flash/ROM for each use
- it's easier/shorter to type, and saves 2 bytes of space in .py files that
  use it (for each use)

Cons:
- increases code size by 4-8 bytes on minimal ports that don't already have
  the `errno` qstr
- all exceptions now have .errno and .value attributes (a cpydiff test is
  added to address this)

See also #2407.

Signed-off-by: Damien George <damien@micropython.org>
2021-04-23 22:03:46 +10:00
..
basics py/objexcept: Support errno attribute on OSError exceptions. 2021-04-23 22:03:46 +10:00
cmdline unix: Improve command line argument processing. 2021-04-07 12:41:25 +10:00
cpydiff py/objexcept: Support errno attribute on OSError exceptions. 2021-04-23 22:03:46 +10:00
esp32 tests: Rename run-tests to run-tests.py for consistency. 2021-03-12 19:56:09 +11:00
extmod extmod/re1.5: Check and report byte overflow errors in _compilecode. 2021-04-06 13:36:42 +10:00
feature_check tests/feature_check: Check for lack of pass result rather than failure. 2021-04-15 00:52:56 +10:00
float py: Fix handling of NaN in certain pow implementations. 2020-09-11 10:04:57 +10:00
import tests: Move .mpy import tests from import/ to micropython/ dir. 2020-07-26 22:04:31 +10:00
inlineasm tests: Format all Python code with black, except tests in basics subdir. 2020-03-30 13:21:58 +11:00
internal_bench tests: Format all Python code with black, except tests in basics subdir. 2020-03-30 13:21:58 +11:00
io extmod/vfs_posix_file: Allow closing an already closed file. 2021-02-11 22:54:41 +11:00
jni tests: Rename run-tests to run-tests.py for consistency. 2021-03-12 19:56:09 +11:00
micropython tests: Move native for test from pybnative to micropython. 2021-01-29 23:57:10 +11:00
misc tests/misc/sys_settrace_features.py: Fix running with non-dflt encoding. 2020-12-18 13:57:17 +11:00
multi_bluetooth tests/multi_bluetooth: Skip tests when BLE features are unsupported. 2021-03-12 20:08:20 +11:00
multi_net extmod/uasyncio: Add StreamReader.readexactly(n) method. 2020-07-25 23:10:05 +10:00
net_hosted tests: Rename run-tests to run-tests.py for consistency. 2021-03-12 19:56:09 +11:00
net_inet tests/net_inet: Add 'Strict-Transport-Security' to exp file. 2021-04-18 23:20:26 +10:00
perf_bench tests: Format all Python code with black, except tests in basics subdir. 2020-03-30 13:21:58 +11:00
pyb tests: Format all Python code with black, except tests in basics subdir. 2020-03-30 13:21:58 +11:00
pybnative tests: Move native for test from pybnative to micropython. 2021-01-29 23:57:10 +11:00
qemu-arm
stress tests: Format all Python code with black, except tests in basics subdir. 2020-03-30 13:21:58 +11:00
thread tests/thread/stress_schedule.py: Assign globals before running test. 2020-10-28 00:54:30 +11:00
unicode tests: Format all Python code with black, except tests in basics subdir. 2020-03-30 13:21:58 +11:00
unix py/mpprint: Fix length calculation for strings with precision-modifier. 2020-12-07 23:32:06 +11:00
wipy tests: Format all Python code with black, except tests in basics subdir. 2020-03-30 13:21:58 +11:00
README tests: Rename run-tests to run-tests.py for consistency. 2021-03-12 19:56:09 +11:00
run-internalbench.py tests: Rename run-tests to run-tests.py for consistency. 2021-03-12 19:56:09 +11:00
run-multitests.py tests/run-multitests.py: Add a -p flag to run permutations of instances. 2020-11-13 17:19:05 +11:00
run-natmodtests.py all: Rename "sys" module to "usys". 2020-09-04 00:10:24 +10:00
run-perfbench.py tests: Format all Python code with black, except tests in basics subdir. 2020-03-30 13:21:58 +11:00
run-tests-exp.py tests: Rename run-tests to run-tests.py for consistency. 2021-03-12 19:56:09 +11:00
run-tests-exp.sh tests: Rename run-tests to run-tests.py for consistency. 2021-03-12 19:56:09 +11:00
run-tests.py tests/feature_check: Check for lack of pass result rather than failure. 2021-04-15 00:52:56 +10:00

README

This directory contains tests for various functionality areas of MicroPython.
To run all stable tests, run "run-tests.py" 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.py 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.py script uses small scripts in the
feature_check directory to check whether each such feature is present,
and skips the relevant tests if not.

Tests are generally verified by running the test both in MicroPython and
in CPython and comparing the outputs. If the output differs the test fails
and the outputs are saved in a .out and a .exp file respectively.
For tests that cannot be run in CPython, for example because they use
the machine module, a .exp file can be provided next to the test's .py
file. A convenient way to generate that is to run the test, let it fail
(because CPython cannot run it) and then copy the .out file (but not
before checking it manually!)

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
module, should go in the import/ subdirectory.