Skip to main content

Simple time tracking for simple people

Project description

Development status Test state on master Coverage state on master Current PyPI release Supported Python versions Documentation Recent developments

rdial is a simple way to track the time you spend on tasks. It tracks the name of a task, its start time, its duration and optionally a message… nothing more.

rdial is released under the GPL v3 license.

Requirements

rdial’s mandatory dependencies outside of the standard library are:

It should work with Python version 3.6, or newer. If rdial doesn’t work with the version of Python you have installed, file an issue and I’ll endeavour to fix it.

The package has been tested on many UNIX-like systems, including Linux and OS X, but it may work fine on other systems too.

To run the tests you’ll need pytest. Once you have pytest installed you can run the tests with the following commands:

$ pytest tests

Database

The database is just a directory of simple CSV files, making it useful to use and abuse in other applications. A sample database could be a file named task.csv with the following contents:

start,delta,message
2011-05-04T08:00:00Z,PT01H00M00S,working on issue 4
2011-05-04T09:30:00Z,,

and a task2.csv file with the following contents:

start,delta,message
2011-05-04T09:15:00Z,PT00H15M00S,

The CSV files contain the following fields:

  1. Start time expressed in UTC

  2. Task duration

  3. An optional message associated with the event

The start time and duration fields are given as ISO 8601 formatted strings.

If a line does not contain a duration entry, then the task is considered to be running.

Interface

$ rdial start <task_name>
$ rdial stop
$ rdial report
+-------+----------------+
| task  | time           |
+-------+----------------+
| task  |        1:00:00 |
| task2 | 1 day, 0:15:00 |
+-------+----------------+

Contributors

I’d like to thank the following people who have contributed to rdial.

Patches

  • Nathan McGregor

Bug reports

  • Delphine Beauchemin

  • Henry Richards

  • James Gaffney

  • Ryan Sutton

  • Stephen Thorne

Ideas

  • Adam Baxter

  • Kevin Simmons

  • Thomas Gallagher

If I’ve forgotten to include your name I wholeheartedly apologise. Just drop me a mail and I’ll update the list!

Bugs

If you find any problems, bugs or just have a question about this package either file an issue or drop me a mail.

If you’ve found a bug please try to include a minimal testcase that reproduces the problem, or even better a patch that fixes it!

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

rdial-1.2.0.tar.gz (73.1 kB view details)

Uploaded Source

Built Distribution

rdial-1.2.0-py3-none-any.whl (31.2 kB view details)

Uploaded Python 3

File details

Details for the file rdial-1.2.0.tar.gz.

File metadata

  • Download URL: rdial-1.2.0.tar.gz
  • Upload date:
  • Size: 73.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.17.1 CPython/3.6.6

File hashes

Hashes for rdial-1.2.0.tar.gz
Algorithm Hash digest
SHA256 0af571d447872f666851a9b49b81c4c9f5caee85d79f93f5cbd7dfb22f93fdf3
MD5 06e71812883fe67818410ccea9c87dba
BLAKE2b-256 4a4a236a5102641d029d1aab7f3a5ffed31e3a2a29182ef5f25d924e213c2355

See more details on using hashes here.

File details

Details for the file rdial-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: rdial-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 31.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.17.1 CPython/3.6.6

File hashes

Hashes for rdial-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fbe8749695345459b8865fe30ab168618388730c58ba8fedd47386d3515b0602
MD5 fbce11f07e69b1b00a06954b5d1ad38c
BLAKE2b-256 5c06e4d9f7bf9973029c3333cdcd2be993e3a6be1d9c9693be1a4f0965ef640a

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