Tempo logger
This is a tool to help with the repetitive task of opening Jira issues and
using the Tempo plugin to log worked hours every day.
It was designed under the assumption that you want to manage your logs keeping a
1-1 relationship between worked days and Jira tickets.
Installation
go get github.com/FcoManueel/tempo
Usage
The tempo
tool has two commands, tempo see
and tempo log
, explained below. All date formats are YYYY/MM/DD
. For usage help just type tempo
.
Notes:
The following examples implicitly use the environment variables $JIRA_URL
, $JIRA_PROJECT_KEY
,$JIRA_USERNAME
,$JIRA_TOKEN
, and$TEMPO_TOKEN
.
For information on how to provide that data through flags run tempo help
and look for "global options".
For information on how to generate the required tokens go to the last section of this readme.
Log
To log 8-hours of work for a given date:
tempo log 2021/01/31
You can send log
a second parameter indicating the amount of hours to log :
tempo log 2021/01/31 4
You can use today
instead of today's date, and week
to refer to this week's Mon—Fri.
tempo log today
tempo log week
Lastly, you can use +#
, -#
suffixes for relative dates.
tempo log today-1 // yesterday
tempo log today+1 // tomorrow
tempo log week-3 // three week ago
Example: Log 4 hours of work for each workday of last week
tempo log week-1 4
See
If you want to inspect a particular date for entries created by this tool:
tempo see 2021/02/08
Syntactic sugar supported by log
is supported by this command as well:
tempo see week-1
> https://foo.atlassian.net/browse/BAR-365 8h 2021/02/08 Monday
> https://foo.atlassian.net/browse/BAR-366 8h 2021/02/09 Tuesday
> https://foo.atlassian.net/browse/BAR-367 8h 2021/02/10 Wednesday
> https://foo.atlassian.net/browse/BAR-368 8h 2021/02/11 Thursday
> https://foo.atlassian.net/browse/BAR-369 8h 2021/02/12 Friday
Useful info
How to create a Jira Token
How to create a Tempo Token
- Go to the Tempo settings on your Jira domain (e.g. https://
<company>
.atlassian.net/plugins/servlet/ac/io.tempo.jira/tempo-app#!/configuration/api-integration ). If you have trouble finding them check the Tempo docs for more info).
- Click + New Token and assign it a name and durability.
- Choose your token privileges. Minimum required is
Worklogs
scope.
- Store the token locally before closing the modal.