README.textile

BugBox Module

Bugbox is a GIT based system to post bug resolutions as
an alternative to submitting patches.

Installing

Run the following shell commands:

git clone git://github.com/getfatday/bugbox.git
cd bugbox
./setup.py install

Creating a BugBox Repository

Run the following shell commands, replace GIT_DIR with your local path:

export GIT_DIR="/example/path/bugboxd.git"
git --bare init

Specify a url for external access:

git config bugbox.url "ssh://example.com/bugboxd.git"

Specify a ticketing system, multiple systems can be defined with this
pattern ticket.<system>:

git config ticket.bz.name BugZilla
git config ticket.bz.url http://bugzilla.example.com

Add GIT hooks:

cat > $GIT_DIR/hooks/pre-receive << EOF
#! /bin/bash

read oldrev newrev ref
bugbox hook pre-receive \$ref \$oldrev \$newrev
EOF

Running the Web Service

Creating the CherryPy config:

cat > /example/path/bugbox.cfg << EOF
[global]
bugbox.dir = "/example/path/bugboxd.git"
tree.bugbox = cherrypy.tree.mount(bugbox.web.root, "/", bugbox.web.root.config)
EOF

Running the CherryPy Daemon:

cherryd -c /example/path/bugbox.cfg -i bugbox.web

Mounting to an existing daemon tree:

[global]
...
tree.bugbox = cherrypy.tree.mount(bugbox.web.root, '/bugbox', bugbox.web.root.config)
...

Feedback

Shoot me an email with any feedback.