A tool that bootstraps your dotfiles
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Anish Athalye 9593510bd4 Merge branch 's1as3r/master' 3 weeks ago
tests Merge branch 's1as3r/master' 3 weeks ago
.editorconfig Add tests for more Python versions 6 years ago
.gitignore Support both `[]` and `?` glob patterns 2 years ago
README.md test: fix `pyenv` configuration in vagrant 2 years ago
Vagrantfile Merge branch 'kurtmckee/update-vm-os' 8 months ago
driver-lib.bash feat: Support recursive globbing with `**`. 2 years ago
test Add --debug flag to test driver 2 years ago
test-lib.bash feat: Support recursive globbing with `**`. 2 years ago



Dotbot testing code uses Vagrant to run all tests inside a virtual machine to have tests be completely isolated from the host machine. Specifically, you will need both:

Install Dotbot dependencies

Ensure you have updated the dotbot submodule dependencies, on the host machine:

git submodule sync --quiet --recursive
git submodule update --init --recursive

Install Vagrant

Debian-based distributions

sudo apt install vagrant virtualbox


You can download those directly from the above URLs, or via some MacOS package managers. e.g. using HomeBrew:

brew cask install virtualbox
brew cask install vagrant
# optional, adding menu-bar support:
brew cask install vagrant-manager

Running the Tests

Before running the tests, you must start and ssh into the VM:

vagrant up
vagrant ssh

All remaining commands are run inside the VM.

First, you must install a version of Python to test against, using:

pyenv install -s {version}

You can choose any version you like, e.g. 3.8.1. It isn't particularly important to test against all supported versions of Python in the VM, because they will be tested by CI. Once you've installed a specific version of Python, activate it with:

pyenv global {version}

The VM mounts your host's Dotbot directory in /dotbot as read-only, allowing you to make edits on your host machine. Run the entire test suite by:

cd /dotbot/test

Selected tests can be run by passing paths to the tests as arguments, e.g.:

./test tests/create.bash tests/defaults.bash

To debug tests, you can run the test driver with the --debug (or -d short form) flag, e.g. ./test --debug tests/link-if.bash. This will enable printing stdout/stderr.

When finished with testing, it is good to shut down the virtual machine by running vagrant halt.