Dependency Graph for milestone $milestone
})
Dependency Graph for Ticket #$tkt.id
})
trac-mastertickets-3.0.2+20111224/ 0000755 0001750 0001750 00000000000 11677657652 014377 5 ustar wmb wmb trac-mastertickets-3.0.2+20111224/.gitignore 0000644 0001750 0001750 00000000034 11675460244 016347 0 ustar wmb wmb *.pyc
*.egg-info
dist
build
trac-mastertickets-3.0.2+20111224/setup.py 0000644 0001750 0001750 00000002730 11675460244 016076 0 ustar wmb wmb #!/usr/bin/env python
# -*- coding: iso-8859-1 -*-
import os
from setuptools import setup
setup(
name = 'TracMasterTickets',
version = '3.0.2',
packages = ['mastertickets'],
package_data = { 'mastertickets': ['templates/*.html', 'htdocs/*.js', 'htdocs/*.css' ] },
author = 'Noah Kantrowitz',
author_email = 'noah@coderanger.net',
description = 'Provides support for ticket dependencies and master tickets.',
long_description = open(os.path.join(os.path.dirname(__file__), 'README')).read(),
license = 'BSD',
keywords = 'trac plugin ticket dependencies master',
url = 'http://github.com/coderanger/trac-mastertickets',
classifiers = [
'Framework :: Trac',
#'Development Status :: 1 - Planning',
# 'Development Status :: 2 - Pre-Alpha',
# 'Development Status :: 3 - Alpha',
# 'Development Status :: 4 - Beta',
'Development Status :: 5 - Production/Stable',
# 'Development Status :: 6 - Mature',
# 'Development Status :: 7 - Inactive',
'Environment :: Web Environment',
'License :: OSI Approved :: BSD License',
'Natural Language :: English',
'Operating System :: OS Independent',
'Programming Language :: Python',
],
install_requires = ['Trac>=0.12'],
entry_points = {
'trac.plugins': [
'mastertickets.web_ui = mastertickets.web_ui',
'mastertickets.api = mastertickets.api',
]
}
)
trac-mastertickets-3.0.2+20111224/README 0000644 0001750 0001750 00000007074 11675460244 015252 0 ustar wmb wmb Notes
=====
Adds basic ticket dependencies for Trac.
Note: MasterTickets 3.0 requires Trac 0.12 or higher.
What is it?
-----------
This plugin adds "blocking" 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.
What is it not?
---------------
* It does not provide ticket-hiding for sub-tasks of a top-level ticket.
* There is no orthogonal 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).
Configuration
=============
To use this plugin you must configure two custom fields named ``blocking``
and ``blocked_by``.
All other configuration options go in the ``[mastertickets]`` section.
``dot_path`` : *optional, default: dot*
Path to the dot executable. This is only used for the dependency graph.
``use_gs`` : *optional, default: False*
If enabled, use ghostscript to produce a nicer dependency graph.
``gs_path`` : *optional, default: gs*
Path to the ghostscript executable.
``closed_color`` : *optional, default: green*
Color of closed tickets
``opened_color`` : *optional, default: red*
Color of opened tickets
``graph_direction`` : *optional, default: TD*
Direction of the dependency graph (TD = Top Down, DT = Down Top, LR = Left Right, RL = Right Left)
To enable the plugin::
[components]
mastertickets.* = enabled
[ticket-custom]
blocking = text
blocking.label = Blocking
blockedby = text
blockedby.label = Blocked By
Custom fields
-------------
While the two field names must be ``blocking`` and ``blocked_by``, you are
free to use any text for the field labels.
Example
=======
To use a locally-built graphviz::
[mastertickets]
dot_path = /usr/local/bin/dot
[components]
mastertickets.* = enabled
[ticket-custom]
blocking = text
blocking.label = Blocking
blockedby = text
blockedby.label = Blocked By
Example reports
--------------
To only show the tickets that are currently not blocked by other non-closed
tickets, use this SQL (eg in a new report):
SELECT p.value AS __color__,
id AS ticket, summary, component, version, milestone, t.type AS type,
owner, status,
time AS created,
changetime AS _changetime, description AS _description,
reporter AS _reporter,
(SELECT COUNT(*) FROM mastertickets m, ticket t2 WHERE t.id=m.dest AND m.source=t2.id AND t2.status <> 'closed') AS _blocked
FROM ticket t
LEFT JOIN enum p ON p.name = t.priority AND p.type = 'priority'
WHERE status <> 'closed' AND _blocked = 0
ORDER BY CAST(p.value AS integer), milestone, t.type, time
Basically it is the default report, with an aditional, hidden field (the sub query),
named _blocked. The value of this field is checked to be zero.
Using this method, other reports can be modified as well, eg to show the number of tickets
blocking a ticket and/or the number of tickets that the ticked is blocking itself.
trac-mastertickets-3.0.2+20111224/mastertickets/ 0000755 0001750 0001750 00000000000 11675460244 017244 5 ustar wmb wmb trac-mastertickets-3.0.2+20111224/mastertickets/__init__.py 0000644 0001750 0001750 00000000000 11675460244 021343 0 ustar wmb wmb trac-mastertickets-3.0.2+20111224/mastertickets/templates/ 0000755 0001750 0001750 00000000000 11675460244 021242 5 ustar wmb wmb trac-mastertickets-3.0.2+20111224/mastertickets/templates/depgraph.html 0000644 0001750 0001750 00000002532 11675460244 023724 0 ustar wmb wmb