Skip to main content

Painless chained recurrence for Taskwarrior.

Project description

Taskwarrior Chained Recurrence Hook

Painlessly adds chained recurrence to Taskwarrior. Requires Python >= 3.8.

recurring task illustration

In the illustration above, task 26ccff69 is automatically created when task 90e414dl is completed. With the new task having the equivalent due and wait attributes, relative to it's own entry attribute.

It's common to have due or wait fall on a day boundary such as 23:59 or 00:00, this is usually because a named date such as eod or sod was used when creating the original task. If this is the case, new tasks will be created with the due and wait attributes automatically falling on the equivalent day boundaries. If this sounds convoluted, the "Usage" section below has a simple example.

Install

$ pip install chained-recurrence
$ chained-recurrence install

Usage

Create tasks as you usually would, adding chained:on:

$ task add chained:on 'hair cut'

When this task's status is changed to complete, a new one will be created.

The wait and due attributes can also be used, their date and time values will be updated in relation to the current date and time:

$ task add chained:on wait:1d 'workout'
# previous command run at 2023-01-01T18:00:00

$ task 1 done
# previous command run at 2023-01-20T18:00:00, the new task has the following:
#   - wait: 2023-01-21T18:00:00

Compatibility with named dates:

$ task add chained:on wait:sod+1d due:eod+2d 'workout'
# previous command run at 2023-01-01T18:00:00

$ task 1 done
# previous command run at 2023-01-20T18:00:00, the new task has the following:
#   - wait: 2023-01-21T00:00:00
#   - due:  2023-01-22T23:59:59

Uninstall

$ chained-recurrence uninstall
$ pip uninstall chained-recurrence

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

chained-recurrence-0.0.10.tar.gz (5.5 kB view hashes)

Uploaded Source

Built Distribution

chained_recurrence-0.0.10-py3-none-any.whl (6.6 kB view hashes)

Uploaded Python 3

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