https://github.com/npryce/deft
Easy Distributed Feature Tracking
https://github.com/npryce/deft
Last synced: about 1 year ago
JSON representation
Easy Distributed Feature Tracking
- Host: GitHub
- URL: https://github.com/npryce/deft
- Owner: npryce
- License: gpl-3.0
- Created: 2011-05-26T23:31:47.000Z (about 15 years ago)
- Default Branch: master
- Last Pushed: 2011-08-20T00:00:23.000Z (almost 15 years ago)
- Last Synced: 2025-03-27T10:21:15.317Z (about 1 year ago)
- Language: Python
- Homepage:
- Size: 2.11 MB
- Stars: 63
- Watchers: 5
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
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.
.. _PyPI: http://pypi.python.org/pypi/Deft
.. _Quickstart Guide: https://github.com/npryce/deft/wiki/Quickstart-Guide
.. _Deft itself: https://github.com/npryce/deft/tree/master/tracker
.. _Python 2.7: http://www.python.org
.. _virtualenv: http://www.virtualenv.org
.. _GitHub: http://github.com/npryce/deft
.. _Deft discussion group: https://groups.google.com/group/deft-users