/ 
App-TimeTracker-2.020
River stage two • 10 direct dependents • 10 total dependents
/ App::TimeTracker::Command::RT

NAME

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

VERSION

version 2.020

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 as well as time-left 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 and/or stop.

update_time_worked

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

update_time_left

If set, updates the time left property on this task also in RT using the time worked tracker value.

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:

  • set or append the ticket subject in the task 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)

  • updates the status of the ticket in RT (if set_status/start is set in config)

stop

If <update_time_worked> is set in config, adds the time worked on this task to the ticket. If <update_time_left> is set in config, reduces the time left on this task to the ticket. If <set_status/stop> is set in config, updates the status of 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.