https://github.com/domm/app-timetracker-billing

Add a billing point to tasks
https://github.com/domm/app-timetracker-billing

hacktoberfest timetracker

Last synced: 8 months ago
JSON representation

Add a billing point to tasks

• Host: GitHub
• URL: https://github.com/domm/app-timetracker-billing
• Owner: domm
• Created: 2019-12-01T22:13:03.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2021-06-18T07:04:03.000Z (almost 5 years ago)
• Last Synced: 2025-10-22T07:08:35.520Z (8 months ago)
• Topics: hacktoberfest, timetracker
• Language: Perl
• Homepage:
• Size: 8.79 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes

Awesome Lists containing this project

README

          
# NAME

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

# VERSION

version 1.001

# 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

### prefix

If set, add this prefix to the billing point when storing it as tag. Useful to discern regular tags from billing point pseudo tags.

### 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](https://metacpan.org/pod/DateTime%3A%3Astrftime) 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 

# COPYRIGHT AND LICENSE

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