The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
App-TimeTracker-Command-Billing-1.000
River stage zero No dependents
/ App::TimeTracker::Command::Billing

NAME

App::TimeTracker::Command::Billing - Add a billing point as a tag to tasks

VERSION

version 1.000

DESCRIPTION

Add a billing point to each task. Could be based on the current date (eg '2019/Q4' or '2019/11') or on some project name.

CONFIGURATION

plugins

Add Billing to the list of plugins.

billing

add a hash named billing, containing the following keys:

required

Set to a true value if 'billing' should be a required command line option

default

Set to the method to calculate the default billing point. Currently there is only one method implemented, strftime

strftime

When using default = strftime, specify the DateTime::strftime format. Some examples:

  • %Y/%m -> 2019/12

  • %Y/Q%{quarter} -> 2019/Q4

NEW COMMANDS

no new commands

CHANGES TO OTHER COMMANDS

start, continue, append

--billing

    ~/perl/Your-Project$ tracker start --billing offer-42

Add a tag 'offer-42', which you can later use to filter all tasks belonging to an offer / sub-project etc

If you set up a default using strftime you can automatically add a billing tag for eg the current month or quarter. This is very helpful for mapping tasks to maintainance contracts.

  cat .tracker.json
  "billing":{
      "required":false,
      "default": "strftime",
      "strftime": "%Y/Q%{quarter}"
  }

  ~/perl/Your-Project$ tracker start
  Started working on Your-Project (2019/Q4) at 22:26:07

AUTHOR

Thomas Klausner <domm@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 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.