925 B
925 B
Testing Kaleidoscope
This is not yet proper documentation about running or writing tests, just some rough notes.
Kaleidoscope includes a simulator that can pretend (to a certain extent) to be a keyboard for the purpose of testing.
On most UNIX-like systems, you can run Kaleidoscope's simulator tests by running
make simulator-tests
Our simulator currently has some weird linking issues on macOS, so the easiest way to run tests on macOS is using Docker.
make docker-simulator-tests
During development, when you may be running your tests very frequently, it's sometimes useful to run a subset of tests.
You can control the directory that Kaleidoscope searches for test suites with the 'TEST_PATH' variable.
To only run tests in subdirectories of the 'tests/hid' directory, you'd write:
make simulator-tests TEST_PATH=tests/hid
or
make docker-simulator-tests TEST_PATH=tests/hid