fake-sys directory

The tests require the fake-sys directory which comes from https://github.com/ddemidov/ev3dev-lang-fake-sys

If you have already cloned the ev3dev-lang-python repo but do not have the fake-sys directory use git submodule init to get it. If you have not already cloned the ev3dev-lang-python repo you can use the --recursive option when you git clone. Example:

$ git clone --recursive https://github.com/ev3dev/ev3dev-lang-python.git

Running Tests with CPython (default)

To run the API tests:

$ cd ev3dev-lang-python/
$ chmod -R g+rw ./tests/fake-sys/devices/**/*
$ python3 -W ignore::ResourceWarning tests/api_tests.py

To run the docs, docstring, etc tests:

$ sudo apt-get install python3-sphinx python3-sphinx-bootstrap-theme python3-recommonmark
$ cd ev3dev-lang-python/
$ sudo sphinx-build -nW -b html ./docs/ ./docs/_build/html

If on Windows, the chmod command can be ignored.

Running Tests with Micropython

This library also supports a subset of functionality on Micropython.

You can follow the instructions on the Micropython wiki or check out our installation script for Travis CI workers to get Micropython installed. If following the official instructions, make sure you install the relevant micropython-lib modules listed in the linked script as well.

Once Micropython is installed, you can run the tests with:

$ cd ev3dev-lang-python/
$ micropython tests/api_tests.py