1.7 KiB
Testing
Dotbot testing code uses Vagrant to run all tests inside a virtual machine to have tests be completely isolated from the host machine. The test driver relies on the Sahara plugin to snapshot and roll back virtual machine state. The tests are deterministic, and each test is run in a virtual machine with fresh state, ensuring that tests that modify system state are easily repeatable.
Installing the Test environnement
Debian-based distributions
- Install the test requirements
sudo apt install vagrant virtualbox
- Install the Sahara Vagrant plugin
vagrant plugin install sahara
- Install Dotbot dependencies
git submodule update --init --recursive
macOS
-
Install the test requirements
-
Install the Sahara Vagrant plugin
vagrant plugin install sahara
- Install Dotbot dependencies
git submodule update --init --recursive
Running the Tests
Before running the tests, the virtual machine must be running. It can be
started by running vagrant up.
The test suite can be run by running ./test. Selected tests can be run by
passing paths to the tests as arguments to ./test.
Tests can be run with a specific Python version by running ./test --version <version> - for example, ./test --version 3.4.3.
When finished with testing, it is good to shut down the virtual machine by
running vagrant halt.