Skip to main content

Python implementation of Ditz (

Project description


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 extend PyDitz using plugins that you write—either simple standalone files (similar to the ditz ‘hook’ feature), or packages that use setuptools entrypoints.
  • 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.


To install and run it:
PyYAML, Jinja2, cerberus and six
To have nice terminal highlighting output:
Pygments (and colorama if you’re on Windows)
To mark up description and comment text in HTML output:
Markups (and the modules it needs to function)
To run the test suite:
Nose, Mock and Coverage
To build the documentation:
Sphinx, and the alabaster theme.


The usual incantation will install things:

pip install pyditz

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, you have two options:

  1. Define the environment variable DITZCMD to be ditz. This only takes effect at installation time. Of course, instead of ditz you can choose anything else more keyboard-friendly.
  2. Create your own shell alias.


The current documentation can be found online here. You can also look at an example of the HTML output.


PyDitz is distributed under the GNU Lesser General Public License, v2 or later.


Version 0.10.2 (2018-08-31)

  • bugfix: Resolve problems with cerberus update
  • bugfix: Resolve problems with markups update

Version 0.10.1 (2017-07-31)

  • bugfix: Crash when trying to create db

Version 0.10 (2016-11-27)

  • Improve startup operations
  • Allow abbreviation of issue names
  • Sort issues by last-modified time
  • Implement issue-claiming commands
  • Use cerberus for data validation

Version 0.9.1 (2016-03-24)

  • bugfix: Line wrapping problem in terminal
  • bugfix: Fix problems with version detection
  • Minor package improvements

Version 0.9 (2015-09-27)

  • bugfix: Bytes output if pygments is not installed
  • bugfix: Initialization command doesn’t work
  • Implement the ‘edit’ command
  • Implement command plugins
  • Add support for markup in HTML output
  • Allow per-project config file
  • New command to list all issues
  • Add project file to version control
  • Add validation schemas
  • Search more fields with grep

Version 0.8.1 (2015-08-18)

  • bugfix: Fix non-ASCII text in issue data
  • bugfix: HTML plugin load failure

Version 0.8 (2014-12-05)

  • bugfix: Grep arguments not handled correctly
  • Allow customization of HTML output
  • Allow issues to be specified by ID
  • Add progress time indicator to ‘show’ and HTML
  • Implement exporting directly to archive
  • Add section arg to config command
  • Add exporter plugin system
  • Add python 3 support
  • Improve the default HTML style
  • Move ~/.ditzrc to ~/.ditz/ditz.cfg
  • Relicense under LGPL

Version 0.7 (2014-09-28)

  • bugfix: Handle YAML comment char in strings
  • Add VCS support
  • Add unicode support
  • Add issue type column to HTML output
  • Add command to display configuration
  • Implement the ‘validate’ command
  • Add output highlighting
  • Add support for command aliases
  • Add pager support
  • Improve the documentation
  • Wire up the remaining program options
  • Improve configuration settings
  • Improve logging command output

Version 0.6.2 (2014-08-10)

  • bugfix: Name substitution not done in issue description

Version 0.6.1 (2014-08-09)

  • bugfix: Print message on successful unassignment
  • bugfix: Ignore unreleased releases when assigning issues

Version 0.6 (2014-03-28)

  • bugfix: Handle non-ASCII characters when writing output
  • Install as ‘ditz’ if required by user
  • Add HTML component column if multiple components in use
  • Don’t show HTML release column for unassigned issues
  • Print message on successful issue assignment

Version 0.5.2 (2013-12-20)

  • bugfix: Blank lines shouldn’t end a comment

Version 0.5.1 (2013-12-18)

  • bugfix: Prompt for component when creating issues
  • bugfix: Show issue status even if not closed

Version 0.5 (2013-12-12)

  • bugfix: Issue names not replaced in comment text
  • bugfix: Reconfigure clobbers existing file
  • Add sortable tables to HTML output
  • Write some user documentation
  • Add a user config file

Version 0.4 (2013-12-09)

  • Implement the ‘html’ command

Version 0.3 (2013-11-23)

  • bugfix: Multiple ‘issuedir’ keywords in init

Version 0.2 (2013-11-23)

  • bugfix: Fix up problems with blank comments

Version 0.1 (2013-11-23)

  • bugfix: Fix round-tripping of issue files
  • Implement all the ditz commands

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pyditz-0.10.2-py2.7.egg (138.2 kB) Copy SHA256 hash SHA256 Egg 2.7
pyditz-0.10.2-py2.py3-none-any.whl (74.6 kB) Copy SHA256 hash SHA256 Wheel 2.7
pyditz-0.10.2.tar.gz (128.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page