tornado/maint/vm/README

24 lines
931 B
Plaintext
Raw Normal View History

This directory contains virtual machine setup scripts for testing Tornado.
Requirements:
Vagrant (http://vagrantup.com) and VirtualBox (http://virtualbox.org).
Vagrant provides an easy download for Ubuntu images, base images for
other platforms are harder to find and can be built with
VeeWee (https://github.com/jedi4ever/veewee).
Usage:
cd to the appropriate directory and run `vagrant up`, then `vagrant ssh`.
From there, simply run `tox` to run the full test suite, or cd to /tornado
and test manually. Afterwards, use `vagrant suspend` or `vagrant destroy`
to clean up.
Notes:
Python distutils (and therefore tox) assume that if the platform
supports hard links, they can be used in the Tornado source directory.
VirtualBox's shared folder filesystem does not support hard links (or
symlinks), so we have to use NFS shared folders instead. (which has
the unfortunate side effect of requiring sudo on the host machine)