Edgewall Software

Version 4 (modified by figaro, 9 years ago) ( diff )

Updated link

Extension Point : ITicketManipulator

InterfaceITicketManipulatorSince0.10
Moduletrac.ticketSourceapi.py​

The ITicketManipulator can manipulate and validate tickets before saving.

Purpose

The Trac ticketing system is extendable by plugins. These plugins might add additional fields or introduce new restrictions on existing fields. They might want to automatically manage some fields. Any such ticket manipulations or validations can be added by implementing the ITicketManipulator interface.

Usage

Implementing the interface follows the standard guidelines found in TracDev/ComponentArchitecture and of course TracDev/PluginDevelopment.

The validate_ticket method is called when a user creates or modifies a ticket. Returning a list of messages rejects the (changed) ticket, returning [] accepts it.

Note that the validate_ticket method can also be used to manipulate the ticket's fields before they are saved.

Note that the previous values of a changed ticket can be accessed in ticket._old. (See #10495.)

The prepare_ticket method should always be implemented as an empty dummy method for compatibility reasons: 

    def prepare_ticket(self, req, ticket, fields, actions):
        pass

Examples

One might want to maintain a wiki page with the MostFrequentDuplicates. One could take this idea further and implement a minimal example ITicketManipulator implementation that warns about tickets already listed there: 

import re
from trac.core import Component, implements
from trac.ticket.api import ITicketManipulator

class MostFrequentDuplicates(Component):
    implements(ITicketManipulator)

    def prepare_ticket(self, req, ticket, fields, actions):
        pass

    def validate_ticket(self, req, ticket):
        for id, summary in self.mostfrequentduplicates:
            if summary == ticket['summary'] and int(id) != ticket['id']:
                return [(None, "Duplicate of ticket #%s" % id)]
        return []
        
    _page_name = 'MostFrequentDuplicates'
    _duplicate_re = re.compile(r" - #(\d*): '''(.*)'''")

    @cached
    def mostfrequentduplicates(self, db):
        """List of (id, summary) values."""
        from trac.wiki.model import WikiPage
        duplicates = []
        content = WikiPage(self.env, MostFrequentDuplicates._page_name, db=db).text
        for line in content.split('\n'):
            m = re.match(MostFrequentDuplicates._duplicate_re, line)
            if m:
                duplicates.append(m.groups())
        return duplicates

Available Implementations

Additional Information and References

Note: See TracWiki for help on using the wiki.