tasklib is a Python library for interacting with taskwarrior databases, using a queryset API similar to that of Django's ORM.
Supports Python 2.6, 2.7, 3.2, 3.3 and 3.4 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) <class 'tasklib.task.Task'> >>> tasks.done() >>> tasks = tw.tasks.pending() >>> tasks ['Learn German'] >>> tasks['tags'] = ['languages'] >>> tasks.save()
For more advanced usage, see the documentation.