pytunia

pytunia is a platform for source code quality testing/continuous integration based on the dirt package.

In addition to testing compilation on various platform (a la buildbot), it can perform functional tests (scripted in Python), static tests, or any other task describable in a Python module. The provided tasks assume SVN as the VCS and scons as the build system, but these are easily modified for your application.

These tasks are run on a grid of slave nodes, which need not share any resources, have zero state, and run no client-side software.

Results of all tests are stored in a CouchDB database and available to users via a web interface.

Getting Started

Dependencies

• dirt (http://github.com/mastbaum/dirt)
• kanso (http://kansojs.org)

Installation

1. Get pytunia: $ git clone http://github.com/mastbaum/pytunia
2. Modify settings.py as necessary
3. Create the web application: $ cd pytunia/web && kanso push pytunia & cd ..
4. Add some slave nodes: $ dirt updatenodes <node1.yoursite.com> <foo.bar.net> ...
5. Start the server: $ dirt serve

Viewing results

To see test output, go to the URL printed out after step 3. By default, this is http://localhost:5984/pytunia/_design/pytunia/_rewrite.

Note: this is the base URL for the entire site. Using mod_rewrite to clip this down to /your-project is recommended.

Adding revisions

pytunia deals with revisions (records) and the set of tests to be run for each (tasks). POSTing of record documents and the associated task documents should be done in a post-commit hook on your version control system. A post-commit hook for SVN is provided in bin. The format for the pytunia document types are as follows.

Record (revision)

{
    "_id": "[revision name or number]",
    "type": "record",
    "description": "[commit message]",
    "created": [creation time (seconds since epoch)]
}

Example:

{
    "_id": "r123",
    "type": "record",
    "description": "this is revision one two three",
    "created": 1315347385
}

build and cppcheck Tasks

{
    "_id": [unique uuid],
    "type": "task",
    "name": "cppcheck",
    "created": [creation time (seconds since epoch)],
    "kwargs": {
        "revnumber": [SVN revision number to check out],
        "svn_url": [SVN repository URL]
    },
    "platform": "[target platform (build only)]"
    "record_id": "[associated record id]"
}

Example:

{
    "_id": "8bc2d24cadd9ac26fbe2279fad28b680",
    "type": "task",
    "name": "cppcheck",
    "created": 1315347385,
    "platform": "linux",
    "kwargs": {
        "revnumber": 601,
        "svn_url": "https://www.snolab.ca/snoplus/svn/sasquatch/dev/rat"
    },
    "platform": "linux"
    "record_id": "r123"
}