Merge pull request #479 from Avira/455-add-vagrant

Add a Vagrantfile with a custom box to the project.

Author: obestwalter

CHANGELOG

@@ -1,6 +1,8 @@
 2.x
 -----
 
+- #455: Add a Vagrantfile with a customized Arch Linux box for local testing
+
 - #454: Revert #407, empty commands is not treated as an error.
   Thanks Anthony Sottile (@asottile).
 

CONTRIBUTORS

@@ -41,3 +41,4 @@ Igor Duarte Cardoso
 Allan Feldman
 Josh Smeaton
 Paweł Adamczak
+Oliver Bestwalter

Vagrantfile

@@ -0,0 +1,34 @@
+<<-DOC
+Start a virtualbox image with
+    * all supported interpreters installed
+    * tox installed
+    * this folder mapped read/writable to /vagrant
+    * convenient way to ssh into the box
+
+This should work from Windows, macOS and Linux.
+
+To run tests in the box do:
+
+    $ cd </path/to/where/this/file/is>
+    $ vagrant up arch
+    $ vagrant ssh arch
+    $ tox
+
+Prerequisites: https://www.vagrantup.com/ and https://www.virtualbox.org/
+
+**NOTE** When sshing into vagrant all .pyc files in this folder will be removed
+automatically. This is necessary to avoid an ImportMismatchError in pytest.
+If you switch between Host and guests, running tests on both you have to
+remove all .pyc files in between runs.
+
+For now there is only an Arch Linux box provided. More to come.
+DOC
+
+Vagrant.configure("2") do |config|
+    config.vm.define :arch do |arch|
+        arch.vm.box = "obestwalter/bindlestiff-arch-linux"
+        arch.vm.provider "virtualbox" do |vb|
+            vb.memory = "2048"
+        end
+    end
+end