Testing

A significant number of tests have been created in pytest.

  • The tests are located in the tests folder.

  • The tests/data folder contains folders with stubs that are used to verify the correct working of the minification modules.

  • Debugging the tests only works if –no-cov is specified for pytest.

Testing & Debugging createstubs.py

  • The tests\mocks folder contains mock-modules that allow the MicroPython code to be run in CPython. This is used by the unit tests that verify {ref}createstubs.py `` and its minified version.

  • In order to load / debug the test the Python path needs to include the cpython_core modules (Q&D).

  • Mocking cpython_core/os is missing the implementation attribute so that has been added (Q&D).

Platform Detection

In order to allow both simple usability on MicroPython and testability on full Python, createstubs does a runtime test to determine the actual platform it is running on while importing the module.

This is similar to using the if __name__ == "__main__": preamble:

if isMicroPython():
    main()

This allows pytest test running on full Python to import createstubs.py and run tests against individual methods, while allowing the script to run directly on import on a MicroPython board.

Note

Some tests are platform dependent and have been marked to only run on Linux or Windows.

Code Coverage

Code coverage is measured and reported in the coverage/index.html report. This report is not checked in to the repo, and therefore is only