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.009

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

  • Add RT to the list of plugins.

  • 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

New Options:

--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.