Live HTTP functional/integration test framework with Twill
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Flunc: a functional test suite runner for web applications.


We recommend installing into a Virtualenv_.

You should be able to install flunc by using ``easy_install flunc``; or 
you can download the tarball, extract, and run ``python develop``.  

Writing tests

Flunc tests are Twill_ scripts.

There is a firefox extension that allows you to record tests directly
from within your browser. To install, visit


These tests are saved in an xml format. You can convert these tests
into a twill script by executing

 ``testgentotwill recorded.html > twillscript.twill``

Of course, you can still write tests manually.

Running tests

Run ``flunc --help`` for details on running the functional tests.

By default flunc will search ./ftests/ to find tests. You can change
this with the ``-p`` (``--path``) option.

Some examples:

 ``flunc all``

runs all tests listed in all.tsuite against http://localhost/

 ``flunc -t http://localhost:8080/some_portal all``

runs all tests listed in all.tsuite against localhost:8080/some_portal

 ``flunc -c all create_user``

runs create_user.twill using all.conf

 ``flunc -c all create_user login create_project destroy_project destroy_user``

specify an ad hoc suite creating and tearing down a user and project
on default host

Finding tests

Individual tests are contained in 


A suite of tests are contained in 


Suite configurations are contained in


Cleanup suites are run after a suite, and are in


More details are on the `Flunc homepage`_.

.. _Virtualenv:

.. _Twill:

.. _`Flunc homepage`: