= Add support for ticket dependencies to Trac = == Description == === 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 GraphvizPlugin-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 well on Trac 0.11. === What is it not? === * It is NOT a plugin for Trac 0.10, as explained below. * It does not provide ticket-hiding for sub-tasks of a top-level ticket. * There is no parent/child relationship possible * 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 * Although it would be cool. * 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). '''NOTE''': The 0.10 version of this plugin suffers from many systemic design flaws. The 0.11 version has been re-written from the ground up to avoid these, however I do not currently have the time to invest in a backport. Please do not file tickets against the 0.10 version, as I will close all of them as `wontfix`. '''NOTE 2''' The 0.11 version requires a [http://genshi.edgewall.org/wiki/Download version of Genshi] >=0.5. '''NOTE 3''' People seem to be misunderstanding this, so I will repeat it. '''DO NOT USE THE 0.10 VERSION, IT IS BROKEN'''. 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. == Bugs/Feature Requests == Existing bugs and feature requests for MasterTicketsPlugin are [report:9?COMPONENT=MasterTicketsPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=MasterTicketsPlugin&owner=coderanger new ticket]. == Download == Download the zipped source from [download:masterticketsplugin here]. == Source == You can check out MasterTicketsPlugin from [http://trac-hacks.org/svn/masterticketsplugin here] using Subversion, or [source:masterticketsplugin browse the source] with Trac. == Example == To enable: {{{ [components] mastertickets.* = enabled [ticket-custom] blocking = text blocking.label = Blocking blockedby = text blockedby.label = Blocked By }}} '''NOTE''' I had to upgrade the Trac environment after enabling this plugin {{{ trac-admin /path/to/env upgrade }}} == Configuration == === For the 0.11 version === Under the '''mastertickets''' section the following options are available: * dot_path (default='dot'): Path to the dot executable * gs_path (default='gs'): Path to the ghostscript executable * use_gs (default=False): If enabled, use ghostscript to produce nicer output To configure the plugin to use a graphviz/dot installation that is at another location: {{{ [mastertickets] dot_path=/opt/local/bin/dot }}} == Recent Changes == [[ChangeLog(masterticketsplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:coderanger] [[BR]] '''Contributors:'''