Add support for ticket dependencies to Trac
This plugin needs a major rewrite. Some severe defects have been reported in which the user's database was left in a bad state. Use at your own risk, and always make a database backup before installing!
What is it?
This plugin adds "blocks" and "blocked by" fields to each ticket, enabling you to express dependencies between tickets. It also provides a graphviz-based dependency-graph feature for those tickets having dependencies specified, allowing you to visually understand the dependency tree. The dependency graph is viewable by clicking 'depgraph' in the context (in the upper right corner) menu when viewing a ticket that blocks or is blocked by another ticket.
This plugin works on Trac 0.11 (no longer maintained), Trac 0.12 and Trac 1.0.
Shown in the image above is the following:
- "Depgraph" link at ticket #62 on middle top, yellow bullet.
- Blocks and blocked by extra fields at ticket #62.
- graphical representation and deeper relation to other tickets on the right.
- ticket statuses explanation in the lower left corner.
What is it not?
- It does not provide ticket-hiding for sub-tasks of a top-level ticket.
- There is no parent/child relationship possible, though this is now on the roadmap for an upcoming release, see #10964.
- You cannot view the descriptions of tickets depending on the current ticket.
- In fact, there are no explicit features that can assist you with sub-task management.
- It does not allow you to create a dependent ticket from the current ticket
- It does not include reporting features to show how tasks are interrelated, other than the dependency graph already described above.
Just put the ticket numbers that a given ticket is blocking in the Blocking field. Enter just the number, no leading #. Separate multiple numbers with commas.
Make sure you add the custom fields as shown below.
You need to install graphviz to use the dependency graphs. You do not need the GraphvizPlugin or anything else beyond the dot binary.
If you have any issues, create a new ticket.
Download the latest revision from here.
There is also a version on PyPi.
The easiest way to install this plugin is by using easy_install:
To enable, add the following to your trac.ini file:
[components] mastertickets.* = enabled [ticket-custom] blocking = text blocking.label = Blocking blockedby = text blockedby.label = Blocked By
Under the mastertickets section of the trac.ini file the following options are available:
- dot_path: Path to the dot executable, default = 'dot'.
- gs_path: Path to the ghostscript executable, default = 'gs'.
- use_gs: If enabled, use Ghostscript to produce nicer output (but the depgraph is no longer clickable), default = False.
To configure the plugin to use a graphviz/dot installation that is at another location, add the following to your trac.ini file:
[mastertickets] dot_path = /opt/local/bin/dot
Upgrade your installation
After installing or enabling this plugin, a new table is added to the database and Trac will need to be upgraded. Therefore run the following:
trac-admin /path/to/env upgrade
Known acceptable database versions
Sometimes Trac and/or plugins run into trouble with newer database versions, because they are fussier about error checking. Therefore this section lists versions that are known to work:
- 3.0.4: PostgreSQL 8.4, Trac 1.0.1, Python 2.7
- 15739 by rjollos on 2016-08-30 02:27:13
4.0.0dev: Revise r15731 to allow forward slash in milestone name
- 15731 by rjollos on 2016-08-28 00:08:10
4.0.0dev: Fix tracebacks for invalid path to depgraph
- 15320 by rjollos on 2016-02-16 15:45:36
4.0.0dev: Skip post_process_request during exception handling