Deft: Easy Distributed Feature Tracking

Deft is a simple distributed feature tracker (aka issue tracker, task tracker, bug tracker) designed to work with a distributed version control system such as Git.

.. image:: https://github.com/npryce/deft/wiki/cfd.png

Principles

All features have a status (e.g. new, in-development,
ready-for-testing, ready-for-deployment)
Absolute prioritisation of features that have the same status
Store feature database alongside the code in VCS, not in another
tool
Store the feature database in plain-text files that play well
with VCS and diff/merge tools
Don't re-implement functionality that is already in the VCS

Getting Started

Install from PyPI_ using easy_install or pip. For example:

% pip install deft

After that you can use the deft command to create, manipulate and query Deft feature trackers. Use deft --help and/or read the Quickstart Guide_ to get started.

Support

You can join the Deft discussion group_.

Issues are tracked with Deft itself_. If you want to raise issues or feature requests:

Fork the repo & check it out locally
Follow the 'Developing Deft' steps
use the ./dev-deft command to create a new issue
commit the new issue
send a pull request

Yes... there should be a tool to make this process simpler and easy for a project's users to do.

Developing Deft

To work on the Deft code itself:

You need Python 2.7_ and virtualenv_ installed
Check out from GitHub_
Run make env to create a python environment for development
Run make to run all the tests.
The dev-deft script will run deft from the development
environment. Run dev-deft --help for help.