tasklib is a Python library for interacting with taskwarrior databases, using a queryset API similar to that of Django's ORM.
Supports Python 3.5 and above, with taskwarrior 2.1.x and above. Older versions of taskwarrior are untested and may not work.
- taskwarrior v2.1.x or above.
Install via pip:
pip install tasklib
tasklib has a similar API to that of Django's ORM:
>>> from tasklib import TaskWarrior >>> tw = TaskWarrior('/home/rob/.task') >>> tasks = tw.tasks.pending() >>> tasks ['Tidy the house', 'Learn German'] >>> tasks.filter(tags__contain='chores') ['Tidy the house'] >>> type(tasks[0]) <class 'tasklib.task.Task'> >>> tasks[0].done() >>> tasks = tw.tasks.pending() >>> tasks ['Learn German'] >>> tasks[0]['tags'] = ['languages'] >>> tasks[0].save()
For more advanced usage, see the documentation.