Edgewall Software

Version 6 (modified by stodge@…, 14 years ago) ( diff )

Added line to set new ticket state to 'new'; this way it's easier to view it using an existing report (i.e. #1)

Trac Data Models

The main models that developers might be interested in are Ticket and WikiPage. The constructors each take the environment as the first parameter, and the ticket id or wiki page name next.

Ticket

Data Model - trac.ticket.model.Ticket

Example:

from trac.env import Environment
from trac.ticket.model import Ticket

env = Environment('/path/to/trac/env')

# Create a new ticket:
tkt = Ticket(env)
tkt['reporter'] = 'me'
tkt['summary'] = 'my new ticket'
tkt['description'] = 'some bogus description'
tkt['status'] = 'new'
tkt.insert()

# To read an existing ticket pass its id to the constructor:
tkt = Ticket(env, 1)
print tkt['priority']

# Update another ticket:
tkt = Ticket(env, 2)
tkt['status'] = 'closed'
tkt['resolution'] = 'fixed'
tkt.save_changes(author='me', comment='progammaticly closed a ticket')

# And finally deleting:
tkt = Ticket(env, 3)
tkt.delete()

For more examples, see trac.ticket.web_ui.

WikiPage

Data Model - trac.wiki.model.WikiPage

Example:

from trac.env import Environment
from trac.wiki.model import WikiPage

env = Environment('/path/to/trac/env')

# Read an existing or new WikiPage:
page = WikiPage(env, 'MyWikiPage')
# Check if this is a new page:
print page.exists
# Update the content:
page.text = 'page content goes here'
page.save(author='me', comment='I can edit the Wiki!', remote_addr='127.0.0.1')

# Read a specific page version:
page = WikiPage(env, 'TracFaq', 1)
print page.text

# Delete a page:
page = WikiPage(env, 'BadWikiPage')
page.delete()

# Or delete only a specific version of a page:
page = WikiPage(env, 'AnotherPage')
page.delete(version=5)

For more examples, see trac.wiki.web_ui.


See also: TracDev

Note: See TracWiki for help on using the wiki.