Tempoggl

Tool for syncing of Jira Tempo entries into Toggl.

usage: tempoggl [-h] [--username USERNAME] [-y] [-v] [-j JIRA_URL]
                [-t TOGGL_TOKEN] [-m [KEY=ID [KEY=ID ...]]] [-V]
                YYYY-MM-DD

Sync time tracking entries from Jira Tempo app into Toggl. Prompt before
pushing any changes.

positional arguments:
  YYYY-MM-DD            sync all entries from this date

optional arguments:
  -h, --help            show this help message and exit
  --username USERNAME   jira username
  -y, --yes             answer yes when prompted
  -v, --verbose         print more information
  -j JIRA_URL, --jira-url JIRA_URL
                        root url for jira e.g. https://jira.example.com
  -t TOGGL_TOKEN, --toggl-api-token TOGGL_TOKEN
                        get from here https://toggl.com/app/profile
  -m [KEY=ID [KEY=ID ...]], --toggl-mapping [KEY=ID [KEY=ID ...]]
                        map jira project key to toggl project id. For example
                        "--toggl-mapping PROJ=456 ABCD=5432 MISC=9876"
  -V, --version         show program's version number and exit

Installation

$ pip3 install tempoggl

Usage

If tempoggl.cfg is sufficiently filled, sync all entries starting from 2019-03-09:

$ tempoggl 2019-03-09

Configuration

By default the config file is created at ~/.config/tempoggl/tempoggl.cfg

Jira project key is the capitalized project identifier which is prefixed for all Jira issues. Toggl project id can be found from https://toggl.com/app/projects. Open a project and inspect the URL: https://toggl.com/app/projects/.../edit/<project_id>

[general]
username: user.name@jira.com
jira_url: https://jira.example.com

[toggl_mapping]
# jira project key to toggl project id
PROJ: 123456

Development

• create venv
• pip install -r requirements-dev.txt
• see Makefile for development commands