# pyditz

Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!

Close

## Introduction

This package is intended to be a drop-in replacement for the Ditz distributed issue tracker. It provides a pyditz command-line program, which acts (mostly) the same way as ditz, and it adds several other nice things too:

• Whereas ditz, when typed on its own, runs the todo command, pyditz drops you into a command shell where you can run Ditz commands and get completion on command names, issue names and release names according to context.
• With pyditz, you don't have to run it from the same directory where the issue database is; it will look in parent directories for it.
• It keeps an intelligent cache of issues, so parsing of all the YAML files isn't necessary for each command. This greatly improves speed when you have lots of issues.
• You can use the database engine of PyDitz in Python programs to migrate bug databases to and from Ditz format, or create summary reports in your own favourite format. Me, I prefer reStructuredText and rst2pdf.

## Requirements

To install and run it:
PyYAML and Jinja2
To run the test suite:
Nose, Mock and Coverage
To build source distributions from the checked-out Mercurial repo:
hgtools
To build the documentation:
Sphinx and the napoleon extension

## Installation

The usual incantation will install things:

python setup.py install


This will install the ditz module and a console command called pyditz to invoke in a similar manner to the original ditz.

If you want to shadow the original completely, and have the ditz command run this instead, create a file called .ditzrc in your home directory and add these lines:

[install]
command = ditz


This only takes effect at installation time. Of course, instead of ditz you can choose anything else more keyboard-friendly.

## Documentation

The current documentation can be found online here.

# Recent activity

Glenn Hutchings pushed 8 commits to zondo/pyditz

6a765f8 - Update things for the next release.
5437c38 - Write location of index.html after generating.
125fd85 - Add -i and -c command options (not yet implemented).
cfe2bab - Bug fix: set return code in HTML command.
7e90a1f - Don't do implicit imports of submodules.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.