Home

AlluraSkel

AlluraSkel is a Paster template that stubs out a trivial Allura tool. Granted, it's not a very useful Allura tool, sort of a del.icio.us clone, and it's not really done yet, but it provides a pretty well-documented example without the size of the baseline tools.

Get the Code

If you already have pip, you can:

     :::bash
     pip install -e git://git.code.sf.net/p/skelallura/alluraskel#egg=AlluraSkel

and everything will be copacetic. Otherwise, you can download the source from the git repository:

    :::bash
    git clone git://git.code.sf.net/p/skelallura/alluraskel
    cd alluraskel
    python setup.py develop

Create the Skeleton

Once you've gotten the code, you activate it with Paster, then answer all of the questions. It will create a new directory wherever you happen to execute the command. A good place would be in a checked-out Allura development environment, as per the README.

    :::bash
    paster create -t allura_skel
    # answer the questions
    cd <new project name>
    python setup.py develop

Install the Tool

Allura will sort of be ready to use your tool immediately, but none of the MongoDB collections will get created, and your tool won't be installed on any projects. To do that, you'll want to run setup-app (though this will blow away all of your data):

    :::bash
    cd ~/src/forge/Allura
    paster setup-app development.ini

Now, your new tool will be installed into the test project, usually to be found at http://localhost:8000/p/test. Have fun!