Skip to main content

rdial - Minimal time tracking for maximal benefit

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!

Metadata

Release files for rdial 1.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rdial 1.2.1
File Size Uploaded Provenance Actions
rdial-1.2.1.tar.gz 74.5 kB Without provenance Details for rdial-1.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for rdial 1.2.1
File Interpreter ABI Platform Actions
rdial-1.2.1-py3-none-any.whl Python 3 none any Details for rdial-1.2.1-py3-none-any.whl

Total release size: 105.7 kB

Release files / rdial-1.2.1.tar.gz

Download URL rdial-1.2.1.tar.gz
Size 74.5 kB
Tags Source
SHA-256 checksum
How to use checksums
861c381b654fbe19c4e393338cb75ec4bd686be8abb7600689c51ebc8801f424
BLAKE2b-256 checksum
How to use checksums
830b17cbd4cce823bb1b19b75f2446b123f8c8368610d2f879439e29ff13651c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.8.0 tqdm/4.17.1 CPython/3.7.3

Release files / rdial-1.2.1-py3-none-any.whl

Download URL rdial-1.2.1-py3-none-any.whl
Size 31.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f0a158280ac4a90c63a49cff69b6ff90e41357c46a2c5a258aa0479517942638
BLAKE2b-256 checksum
How to use checksums
9d2d3c859d6b390924b0a74b5dbba883604f93261f89df54ce9e36e44b399983
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.8.0 tqdm/4.17.1 CPython/3.7.3

Security for rdial 1.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page