# NAME App::TimeTracker::Command::RT - App::TimeTracker RT plugin # VERSION version 3.000 # DESCRIPTION This plugin takes a lot of hassle out of working with Best Practical's RequestTracker available for free from [http://bestpractical.com/rt/](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 # COPYRIGHT AND LICENSE This software is copyright (c) 2014 - 2019 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.