This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Test Fabric scripts on VirtualBox VMs

Project Description

Fabtest is a set of utilities and base TestCases that aid testing Fabric scripts against VirtualBox VMs. License is MIT.

VM is rolled back to initial state before each test so tests can do anything with target system; Fabric commands can be run from Python.

Installation

pip install fabtest

VMs

In order to run tests you’ll need VirtualBox 4.x and an OS image. Image should have ssh server installed.

Example VMs (they can be imported to VirtualBox via File->Import Appliance):

Due to bugs in VirtualBox it is better to convert imported .vmdk disk images to .vdi images, e.g.:

VBoxManage clonehd Ubuntu-10.10-disk1.vmdk Ubuntu-10.10-disk.vdi --format VDI

Then detach (and remove) vmdk disk from the VM and attach the vdi image.

After you get the image, make sure it is not running and execute the fabtest-preparevm script (pass your VM name or uid to it):

fabtest-preparevm Lenny

This command configures port forwarding (127.0.0.1:2222 to guest 22 port, 127.0.0.1:8888 to guest 80 port) and takes ‘fabtest-initial’ snapshot used for test rollbacks (it is taken from booted machine in order to speedup tests).

Writing tests

Subclass fabtest.VirtualBoxTest or fabtest.FabTest and use fabtest.fab for fabric commands execution:

from fabric.api import run
from fabtest import FabTest, fab

def whoami():
    return run('whoami')

class MyTestCase(FabTest):
    def test_root_login(self):
        output = fab(whoami)
        self.assertEqual(output, 'root')

Look at source code (and example/runtests.py) for more.

CHANGES

0.1.5 (2012-04-19)

  • Improved workaround for a VirtualBox bug.

0.1.4 (2012-04-19)

  • Workaround for a VirtualBox bug under Windows.

0.1.3 (2012-04-14)

  • Packaging fixes.

0.1.1 (2012-03-02)

  • Better exception handling (the original traceback is preserved).

0.1 (2012-03-01)

  • Fabric >= 1.4 is supported (and required);
  • more reliable virtualbox snapshot handling;
  • fab function now wraps fabric’s execute and returns single value, not a list of values.

0.0.8 (2011-03-22)

  • Many tweaks & bug fixes.

0.0.1 (2011-02-16)

Initial experimental release (extracted from django-fab-deploy).

Release History

Release History

This version
History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

History Node

0.0.8

History Node

0.0.7

History Node

0.0.6

History Node

0.0.5

History Node

0.0.4

History Node

0.0.3

History Node

0.0.2

History Node

0.0.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
fabtest-0.1.5.tar.gz (6.4 kB) Copy SHA256 Checksum SHA256 Source May 11, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting