Testing

An overview of the test frameworks used by mycroft-core.

Unit Tests
Mycroft-core unit tests are located in mycroft-core/test/unittests
These are created using the unittest package from the Python standard library.
Test runner
A helper command is provided in mycroft-core/bin to enable quick and simple access to the test runner. It is assumed that this directory is on your $PATH .
If that is not the case, prepend all mycroft-* commands with the path to your mycroft-core/bin directory or run the tests manually.
Execute all tests
To execute all tests run:
mycroft-start unittest
Execute single test
To execute a single test file run:
mycroft-start singlueunittest path/to/test/file.py
The second argument points to the test file you wish to execute. Note that this is relative to your mycroft-core installation.
If I was working on the audio utilities, I might run:
mycroft-start singlueunittest test/unittests/audio/test_utils.py
Manually run tests
The mycroft-start helper commands are a convenience wrapper. They activate the Python virtual environment and run pytest.
The equivalent commands to run all tests would be:
cd ~/mycroft-core
source .venv/bin/activate
pytest
Integration Tests
The Mycroft integration test suite is called Voight Kampff. Currently this does explicitly cover mycroft-core, however Skills are tested, which indirectly tests a range of Mycroft's technologies.
For more detail on Voight Kampff see:
Integration Tests

Wake Word Plugins

Legacy Repo

Last modified 1yr ago