ICU Code Tools plugin
Copyright (C) 2010-2014 IBM Corporation and Others. All Rights Reserved.
See license.html for the license file. This file is part of the
ICU project and is under the same license.
Docs: https://sites.google.com/site/icucodetools/home
Requirements:
Trac (0.11 or 0.12+?)
Repository
Installing:
1. install the plugin - at least the ticketmanager and review portion.
a. There is no source release at this time: I recommend
that you check out this code with svn
and in this directory, run:
"python setup.py develop"
b. In trac.ini under '[components]' add:
icucodetools.review.reviewmodule = enabled
icucodetools.ticketmgr.ticketmanager = enabled
NOTE: DCUT and TKTLIST parts are not working yet.
Don't bother to enable them.
2. in your trac.ini describe how your changesets describe a ticket.
Our changesets look like this: "ticket:1234: fixed the broken code"
We use this regex:
[icucodetools]
ticket_pattern = ^ticket:(\d+)
3. you may need to run trac-admin <environment> upgrade
4. Grant permission of ICUREVIEW_VIEW to whomever you want to
be able to review tickets.
5. Now, any ticket will have something in the top right corner which says:
"No commits" - no commits against this ticket
"Review 1 commits" - there is only one commit. Clicking this link
will just take you to that single changeset.
"Review n commits" - there are more than one commits against this
ticket.
Troubleshooting:
Q: My commits aren't being found!
A: Check the debug log. It will note commits with unparseable messages
Q: How do I resync the commits?
A: Until we implement trac 0.12 changeset listeners, you can do this:
0. back up your path/to/env/db/trac.db
1. $ sqlite3 path/to/env/db/trac.db
2. sqlite> delete from rev2ticket;
3. sqlite> update system set value='-1' where name='icu_tktmgr_youngest';
4. sqlite> .quit
Now the ticket manager will re-sync the first time you hit a ticket.
RESTRICT CHECKINS
See the comments at the top of icucodetools/traccheck.py.
note that /path/to/traccheck is the path to the installed "traccheck" script,
not the 'traccheck.py' source file.
FILING BUGS/FEATURE REQUESTS:
- See https://sites.google.com/site/icucodetools/home to file or view bugs.
