tornado/maint/vm
Ben Darnell 67d69340a2 Fix zope.interface/py25 dependencies for other tox.ini files 2012-05-27 21:35:27 -07:00
..
freebsd Update vagrant configs for vagrant 1.0 2012-04-23 01:12:09 -07:00
ubuntu10.04 Fix zope.interface/py25 dependencies for other tox.ini files 2012-05-27 21:35:27 -07:00
ubuntu12.04 Fix zope.interface/py25 dependencies for other tox.ini files 2012-05-27 21:35:27 -07:00
README Add configs for testing on Vagrant-managed VMs. 2011-10-07 01:08:14 -07:00
shared-setup.sh Install more python versions in the linux VM so we can test epoll.c too. 2011-12-30 00:49:19 -08:00

README

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 10.04 (aka lucid64); 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)