Download > Subversion Integration

Subversion Integration

The Agilo for Scrum Subversion Integration, add some features to allow you to change the status of a ticket via the Subversion submit comment, as well as letting you change the remaining_time of a task. To configure it, you will have to activate the two hooks in the subversion repository. To do so, go to your subversion project root, and have a look inside the hooks folder. There you should find a set of sample scripts, you will have to bind agilo script agilo_svn_commit_hook.py to both the pre-commit and the post-commit hooks.

Examples on how to create these two scripts are provided in the comments of the agilo_svn_commit_hook.py script. The simplest possible examples could be the following:

<pre-commit>
#!/bin/sh
REPOS="$1"
TXN="$2"
# Make sure that the log message contains some text.
SVNLOOK=/usr/bin/svnlook
PYTHON_EGG_CACHE=/var/cache/python
TRAC_ENV="/var/lib/trac/test"
LOG=`$SVNLOOK log -t "$TXN" "$REPOS"`
/where/ever/is/agilo_svn_hook_commit.py -s pre -e "$TRAC_ENV" \
-l "$LOG" || exit 1

And the post commit hook:

<post-commit>
#!/bin/sh
REPOS="$1"
REV="$2"
TRAC_ENV='/var/lib/trac/test/'
/var/lib/svn/local/hooks/agilo_svn_hook_commit.py -s post \
-e "$TRAC_ENV" -r "$REV" || exit 1

For more info on how to configure and use Subversion hooks, refer to the Subversion books or online groups. The agilo scripts supports the following commands, some of which are included as a compatibility with the trac-post-commit-hook.py which is a part of the contrib distribution of subversion:

CLOSE COMMANDS  = 'close', 'closed', 'closes', 'fix', 'fixed', 'fixes'
REFER COMMANDS  = 'addresses', 're', 'references', 'refs', 'see'
REMAIN COMMANDS = 'remaining', 'still', 'rem_time', 'time', 'rem'

Commands can be concatenated using and or & and are in the form of:

This closes #34 and #35 and remaining #5:4h. See #43 for more details.

The above comment will do the following:

Closes the ticket #34 and #35, agilo will check the following to allow to close the tickets:
That the tickets have been accepted
That the owner of the ticket is the same as the committer
Set the remaining time of ticket #5 to 4h, checking that the owner of the ticket is the same as the committer
Add a reference to the ticket #43 that will be marked also in the destination ticket, linking it to the current committed changeset