tornado/maint/vm
Ben Darnell 429e499158 Modernize freebsd vagrant config. 2014-08-31 23:33:15 -04:00
..
freebsd Modernize freebsd vagrant config. 2014-08-31 23:33:15 -04:00
ubuntu10.04 Remove more py25 testing configs 2013-01-13 21:59:48 -05:00
ubuntu12.04 Fix unix socket test on linux. 2014-04-27 12:58:40 -04:00
ubuntu14.04 Add an ubuntu 14.04 vagrant config; drop 12.10. 2014-07-19 11:18:24 -04:00
windows Add a script for setting up a windows VM for testing. 2013-02-02 22:40:53 -05:00
README
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)