tasklib is a Python library for interacting with taskwarrior databases, using a queryset API similar to that of Django's ORM.
Supports Python 2.7, and 3.4 - 3.8 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.