2010-06-21 22:38:08 +00:00
|
|
|
ICU Code Tools plugin
|
|
|
|
|
|
|
|
|
|
Copyright (C) 2010 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.
|
|
|
|
|
|
|
|
|
|
Requirements:
|
|
|
|
|
Trac (0.11 or 0.12+?)
|
|
|
|
|
Repository
|
|
|
|
|
|
|
|
|
|
Installing:
|
|
|
|
|
1. install the plugin - at least the ticketmanager and review portion.
|
2010-06-22 16:24:13 +00:00
|
|
|
|
|
|
|
|
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"
|
2010-06-21 22:38:08 +00:00
|
|
|
|
2010-06-22 16:24:13 +00:00
|
|
|
b. In trac.ini under '[components]' add:
|
2010-06-21 22:38:08 +00:00
|
|
|
icucodetools.review.reviewmodule = enabled
|
|
|
|
|
icucodetools.ticketmgr.ticketmanager = enabled
|
|
|
|
|
|
|
|
|
|
NOTE: DCUT and TKTLIST parts are not working yet.
|
2010-06-22 16:24:13 +00:00
|
|
|
Don't bother to enable them.
|
2010-06-21 22:38:08 +00:00
|
|
|
|
|
|
|
|
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.
|
2010-06-21 22:40:07 +00:00
|
|
|
|
|
|
|
|
FILING BUGS/FEATURE REQUESTS:
|
|
|
|
|
- Use ICU's trac repository at http://bugs.icu-project.org/trac
|
|
|
|
|
- Use the 'infrastructure' component and clearly identify the 'ICU Code Tools
|
|
|
|
|
for Trac' when you file the bug.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
