Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!



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.


pip install fabtest


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 ( to guest 22 port, 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/ for more.

Recent activity

Mikhail Korobov

Commits by Mikhail Korobov were pushed to kmike/fabtest

e9257d6 - It turns out the cause of errors was a recent VirtualBox version, not Windows OS so the fix is changed not to be windows-specific.

Commits by denis were pushed to kmike/fabtest

fbacb26 - Fix for win platform due to bug when VBoxManage unable to execute 'snapshot {{VM_name}} showvminfo {{snapshot_name}}' command while previous VM lauch is still shutdowning. Intersection ...
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.