wiki:TracTicketChangesetsPlugin

Version 17 (modified by Dennis McRitchie <dmcr@…>, 4 years ago) (diff)

Informing user of need for PYTHON_EGG_CACHE variable in some cases.

Ticket Changesets Plugin

Description

The TracTicketChangesetsPlugin hooks into changeset notifications and searches commit messages for ticket references. Referenced tickets are updated with the commit message, and all concerning changesets for a ticket are presented in a separate section on ticket pages, just above the change history section.

The source of this plugin is based on code distributed with Trac 0.12 (tracopt/ticket/commit_updater.py). The plugin works with multiple repositories. Language is translated if Babel is installed.

This plugin is not compatible with Trac 0.11 or older versions.

Bugs/Feature Requests

Existing bugs and feature requests for TracTicketChangesetsPlugin are here.

If you have any issues, create a new ticket.

Defects

#7301
Plugin does not work with not-integer revisons (Mercurial, Git and so on)
#9970
Only root may execute trac-admin commands
#11224
svnsync breaks log
#11937
Plugin does not load in Trac 1.0

Wishes

#7241
Support i18n and l10n
#7325
Check if #T9477 applies to this plugin
#7515
Add "reformat" comand to accept parameter style
#7877
more commands for ticket changes
#8026
Branch name added to ticket comment on commit
#8442
Support "Fixes #x,y" syntax
#8773
Show files and logs of change sets in the ticket
#9248
Implement a more verbose mode
#9265
Use repository user names when updating tickets
#10008
Eclipse MyLyn default Trac commit message format issue
#10855
No such changeset exception

The plugin currently does not reformat ticket-commit-messages produced by Trac 0.11 since I am not confident in how those are formatted. Please request this together with examples of old ticket-commit-messages, and I will add that capability to this plugin.

Download

Download the zipped source from here.

Source

You can check out TracTicketChangesetsPlugin from here using Subversion, or browse the source with Trac.

Example

The related changesets are presented just above the ordinary change history:

When several repositories contains changesets relating to a ticket, the content will gracefully be split into one sub-section for each repository.

The plugin can be configured to present the box as initially collapsed, or hidden completely when no changesets are related to the ticket. Revision ranges can be presented in compact form, for example [420-422] instead of [420] [421] [422].

The macros CommitMessage(repo, rev) and TicketChangesets(ticket) are provided to present a commit message for a given repository and revision, and all changesets that are related to a given ticket.

Console administration commands

Console administration commands are available for retrieving and re-synchronizing ticket-changesets relations, and reformatting existing ticket commit messages.

trac-admin /path/to/env ticket_changesets diff
Examine ticket commit messages before reformat.

Generate a diff-like output for analysis before reformatting. The database will not be changed. Before this operation, you may want to run

trac-admin $ENV repository resync "*"
trac-admin /path/to/env ticket_changesets get [ticketid]
Get a comma-separated list of related revisions (#7267).

List format:

#ticketid: rev/reponame,...
...

"/reponame" is left out for the default repository.

All tickets related to changesets are listed if ticketid is omitted, one ticket on each line. If no ticket-changesets relations exists in the database, "None" is displayed.

trac-admin /path/to/env ticket_changesets reformat (DANGEROUS!)
Reformat ticket commit messages.

Before this operation, you may want to run:

trac-admin $ENV repository resync "*"

and then analyse the output of

trac-admin $ENV ticket_changesets diff
trac-admin /path/to/env ticket_changesets resync
Re-synchronize ticket changesets with all repositories

Relations between tickets and changesets are re-built by examining all commit messages, in all repositories, for ticket references. Ticket comments are neither updated nor added due to new discoveries.

Before this operation, you may want to run:

trac-admin $ENV repository resync "*"

Installation instructions

  1. Install the plugin, even with locale support:
    cd TracTicketChangesetsPlugin
    python setup.py install
    
  2. Enable the plugin by the following in trac.ini:
    [components]
    ticketchangesets.* = enabled
    
  3. Add the section [ticket-changesets] to configure the behaviour:
    [ticket-changesets]
    check_perms = true
    collapsed = false
    commands.close = close closed closes fix fixed fixes
    commands.refs = addresses re refs references see ticket tickets
    compact = true
    hide_when_none = false
    notify = false
    resolution = fixed
    
    where:
    • check_perms: Check that the committer has permission to perform the requested operations on the referenced tickets. This requires that the user names be the same for Trac and repository operations.
    • collapsed: Show section on ticket page as initially collapsed.
    • commands.close: Commands that close tickets, as a space-separated list.
    • commands.refs: Commands that add a reference, as a space-separated list. If set to the special value <ALL>, all tickets referenced by the message will get a reference to the changeset.
    • compact: Make compact presentation of revision ranges, for example [1-3] instead of [1] [2] [3].
    • envelope: Require commands to be enclosed in an envelope. Must be empty or contain two characters. For example, if set to "[]", then commands must be in the form of [closes #4].
    • hide_when_none: Hide section on ticket page when no changesets relates to the ticket.
    • notify: Send ticket change notification when updating a ticket.
    • resolution: The resolution to set to a ticket closed by a commit message.
  4. The Trac environment needs to be upgraded:
    trac-admin /path/to/env upgrade
    
  5. Re-synchronize repositories (optional, but recommended before next step which will scan all existing commit messages):
    trac-admin /path/to/env repository resync "*"
    
  6. Build relations between tickets and changesets:
    trac-admin /path/to/env ticket_changesets resync
    
  7. Re-format existing ticket commit messages (DANGEROUS!)
    1. Produce a diff-like output for your analysis, which does not affect the database, before re-formatting existing commit messages:
      trac-admin /path/to/env ticket_changesets diff > out.diff
      
      Examine out.diff and assert that re-formatting is sensible before next step.
    2. Re-format (DANGEROUS!)
      trac-admin /path/to/env ticket_changesets reformat
      
  8. Setup hook-scripts (Windows example, does not differ from official instructions applicable to Trac 0.12):
    Note that you may have to set the environment variable PYTHON_EGG_CACHE to the same value as was used for the web server configuration before calling trac-admin, if you changed it from its default location. See http://trac.edgewall.org/wiki/TracPlugins for more information.
    1. post-commit.cmd
      :: Trac 0.12 post-commit hook script for Windows
      ::
      @SET REPOS=%1
      @SET REV=%2
      @trac-admin /path/to/env changeset added "%REPOS%" "%REV%"
      
    2. post-revprop-change.cmd
      :: Trac 0.12 post-revprop-change hook script for Windows
      ::
      @SET REPOS=%1
      @SET REV=%2
      @trac-admin /path/to/env changeset modified "%REPOS" "%REV%"
      

From here-on, tickets will be updated when referenced in a commit message, and the relation between tickets and revisions are automatically tracked.

About i18n/l10n support

The development version of this plugin is prepared for localization.
But English message texts are still the (POSIX) default. If this isn't your preferred language, you can do it yourself (see the l10n cookbook page for Trac plugins for more details).

You've done a new translation? Superb! Contributing your translation is highly appreciated.
You could send it to the plugin's maintainer or contribute to Trac plugin l10n project via Transifex (not yet).

Preparing the plugin from source requires no additional step for compiling message catalog files, that's part of a normal installation:

cd TracTicketChangesetsPlugin
python ./setup.py install

Recent Changes

[10743] by mrelbe on 2011-10-06 21:24:40
Patch supplied by mat (comment:15:ticket:7301)
"working patch, but it's far from being rock-solid"
[10742] by mrelbe on 2011-10-06 21:13:35
Branch trunk to apply patches supplied in #7301
[10004] by mrelbe on 2011-03-31 21:46:08
TracTicketChangesetsPlugin: Fixed a glitch regarding foldable headline of the changesets section on ticket pages.

Feedback

Are you using TracTicketChangesets plugin?
  • Yes, it's usefull. (mrelbe, dnedelchev)
  • No, it's useless.
  • No, I don't need it.
  • Yes, it helps.

  • You don't have permission to vote. You may need to login.

Author/Contributors

Author: mrelbe
Maintainer: mrelbe
Contributors:

Attachments (1)

Download all attachments as: .zip