The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

App::TimeTracker::Command::RT - App::TimeTracker RT plugin

VERSION

version 2.018

DESCRIPTION

This plugin takes a lot of hassle out of working with Best Practical's RequestTracker available for free from http://bestpractical.com/rt/.

It can set the description and tags of the current task based on data entered into RT, set the owner of the ticket and update the time-worked in RT. If you also use the Git plugin, this plugin will generate very nice branch names based on RT information.

CONFIGURATION

plugins

Add RT to the list of plugins.

rt

add a hash named rt, containing the following keys:

server [REQUIRED]

The server name RT is running on.

username [REQUIRED]

Username to connect with. As the password of this user might be distributed on a lot of computer, grant as little rights as needed.

password [REQUIRED]

Password to connect with.

timeout

Time in seconds to wait for an connection to be established. Default: 300 seconds (via RT::Client::REST)

set_owner_to

If set, set the owner of the current ticket to the specified value during start.

update_time_worked

If set, store the time worked on this task also in RT.

NEW COMMANDS

none

CHANGES TO OTHER COMMANDS

start, continue

--rt

    ~/perl/Your-Project$ tracker start --rt 1234

If --rt is set to a valid ticket number:

  • store the tickets subject in the tasks description ("Rev up FluxCompensator!!")

  • add the ticket number to the tasks tags ("RT1234")

  • if Git is also used, determine a save branch name from the ticket number and subject, and change into this branch ("RT1234_rev_up_fluxcompensator")

  • set the owner of the ticket in RT (if set_owner_to is set in config)

stop

If <update_time_worked> is set in config, add the time worked on this task to the ticket.

AUTHOR

Thomas Klausner <domm@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Thomas Klausner.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.