Skip to main content

Simple time tracking for simple people

Project description

Test state on master Coverage state on master Current PyPI release Number of downloads from PyPI

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 dependencies outside of the standard library are:

It should work with any version of Python 3.5 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 module has been tested on many UNIX-like systems, including Linux and OS X, but it should 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 text files, making it very easy 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 format is a CSV file containing the following fields:

  1. Start time expressed in UTC

  2. Task duration

  3. 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 currently 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

  • James Gaffney

  • Ryan Sutton

  • Stephen Thorne

Ideas

  • Adam Baxter

  • Kevin Simmons

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 attempt to include a minimal testcase so I can reproduce the problem, or even better a patch!

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-0.16.0.tar.gz (66.2 kB view details)

Uploaded Source

Built Distribution

rdial-0.16.0-py2.py3-none-any.whl (22.1 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: rdial-0.16.0.tar.gz
  • Upload date:
  • Size: 66.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for rdial-0.16.0.tar.gz
Algorithm Hash digest
SHA256 e0f2f4a9de7fe198543f408d1c895e42eb00dd1fccb964d385bd6c7ee742167a
MD5 e05d792f1567a9ab470acc19f560ab76
BLAKE2b-256 3482d78d1b60d6e19e6d615cf961b591ab36d106aca90217173df44b38357898

See more details on using hashes here.

File details

Details for the file rdial-0.16.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for rdial-0.16.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 095bb29ab9aa082750b4dc051f1bbff120f589c21ca67265c517cdb999804b99
MD5 2a420d2674f6ea7b689cecb85b06aff4
BLAKE2b-256 7209de77f86b6d2bbe298b91a2a48a63e5cfa32f7051ce2674a6ce701f8c7db7

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