Skip to main content

Create entries in tickspot's tick from Gtimelog journal.

Project description

Synchronize gTimeLog to Tick

https://github.com/minddistrict/gtimelog2tick/actions/workflows/build.yml/badge.svg

This script will read your timelog.txt file populated by gtimelog and will submit work log entries to Tick, via Tick API.

It is based on https://github.com/ProgrammersOfVilnius/gtimelog2jira.

Installation

Installation with pipx

pipx install gtimelog2tick

Usage

In order to synchronize your most recent entries to Tick, simply run:

gtimelog2tick

By default, this command will synchronize entries created 7 days ago up to now.

You can control what time period you want to synchronize using the --since and/or --until parameters:

gtimelog2tick --since 2023-12-01 --until 2023-12-24

If you want to test things, without creating work log entries in Tick, you can use the --dry-run flag:

gtimelog2tick --dry-run

This way nothing will be sent to Tick, the script will instead show what it would do.

Configuration

By default, gtimelog2tick reads configuration from the ~/.gtimelog/gtimelogrc file. Configuration file example:

[gtimelog2tick]
subscription_id = 234234
token = a343jk34s
user_id = 12323
email = user@example.com
timelog = ~/.gtimelog/timelog.txt
ticklog = ~/.gtimelog/tick.log
projects =
  FOO
  BAR
  BAZ

Use the Subscription ID as value for the subscription_id field and the API Token for the token field. Both can be looked up at your personal profile page in the web UI.

The value for user_id can be found in the URL of the personal profile page. It is the number between users/ and /edit.

Use your actual email address as otherwise requests might be refused.

timelog is the path where the gtimelog time log file is stored. The default should be okay. ticklog: this file is used to write a line for each action which is done via the Tick API. When using --dry-run, this file is also filled.

projects option should list all project prefixes for upload. These prefixes will be used to identify tick projects. If the script for an entry does not find a matching tick project, it will skip that entry. Caution: This option can be empty or omitted to upload all projects.

Change log

0.2.2 (2023-12-21)

  • Do not break if a day only contains a single line.

  • Render a better error message if an entry cannot be parsed.

0.2.1 (2023-12-11)

  • Streamline command line arguments and documentation.

0.2 (2023-12-11)

  • Prefer exact matches in case of multiple ones.

  • Fetch all projects, not just the first 100.

  • If the config option projects is empty, upload all possible entries.

  • Improve formatting to have always a precision of 2 for floats.

  • No longer ignore entries with negative time.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gtimelog2tick-0.2.2.tar.gz (27.1 kB view details)

Uploaded Source

Built Distribution

gtimelog2tick-0.2.2-py3-none-any.whl (20.3 kB view details)

Uploaded Python 3

File details

Details for the file gtimelog2tick-0.2.2.tar.gz.

File metadata

  • Download URL: gtimelog2tick-0.2.2.tar.gz
  • Upload date:
  • Size: 27.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for gtimelog2tick-0.2.2.tar.gz
Algorithm Hash digest
SHA256 736f9ae7c5632851e25efe08eec690766584b796e95367dce3bc43b248ffb711
MD5 2082725f93d4405d3329e506d1e0b77c
BLAKE2b-256 7a5972b427268abf30a2f3539b63351de0cd6d30e1b8b16a632a902048a2c341

See more details on using hashes here.

File details

Details for the file gtimelog2tick-0.2.2-py3-none-any.whl.

File metadata

File hashes

Hashes for gtimelog2tick-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 68a336292cb0826714a27de05cb960e570c3c217171971094f10ee45939d0200
MD5 697c9cc79a1eab6ff6839d11ed7a7053
BLAKE2b-256 d50a5f96bd14f5d461aa13d2fed5c47699d6941a6196e5b896eb9ebf2b03c7ab

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page