README.md

   1 Taskwarrior Shift All Recurrence Attributes Hook
   2 ------------------------------------------------
   3
   4 This is a hook for TaskWarrior (http://www.taskwarrior.org),
   5 which allow your recurrent tasks to inherit ``wait``, ``scheduled``
   6 and ``until`` attributes from the parent.
   7
   8 Install
   9 -------
  10
  11 ```
  12 git clone https://github.com/tbabej/taskwarrior-shift-all-recurrence-hook.git
  13 cp taskwarrior-shift-all-recurrence-hook/on-* ~/.task/hooks/
  14 ```
  15
  16 This hook leverages tasklib, so you need to install that too:
  17
  18 ```
  19 pip install tasklib
  20 ```
  21
  22 Use case
  23 --------
  24
  25 Consider you have a periodic task, which is valid only for the certain day,
  26 e.g. on every Sunday you go running.
  27
  28 ```
  29 $ task add due:sunday recur:weekly
  30 ```
  31
  32 However, TaskWarrior will display the task right away, and you want to
  33 showing up only during the weekend, so that it does not distract your task
  34 list during the work week.
  35
  36 If you try to add the recurrence again, this time with ``wait`` attribute,
  37 to hide the task until it is not relevant for you:
  38
  39 ```
  40 $ task add due:sunday recur:weekly wait:saturday
  41 ```
  42
  43 You will find out that TaskWarrior does not let tasks generated by this
  44 recurrence inherit the ``wait`` attribute, in the same manner as it does
  45 with the ``due`` attribute.
  46
  47 This hook solves that.