tasklib ======= .. image:: https://travis-ci.org/robgolding/tasklib.png?branch=develop :target: http://travis-ci.org/robgolding/tasklib .. image:: https://coveralls.io/repos/robgolding/tasklib/badge.png?branch=develop :target: https://coveralls.io/r/robgolding/tasklib?branch=develop tasklib is a Python library for interacting with taskwarrior_ databases, using a queryset API similar to that of Django's ORM. Requirements ------------ * Python 3.5 or above * taskwarrior_ v2.4.x or above. Older versions of taskwarrior are untested and may not work. Installation ------------ Install via pip:: pip install tasklib Usage ----- tasklib has a similar API to that of Django's ORM:: >>> from tasklib import TaskWarrior >>> tw = TaskWarrior('~/.task') >>> tasks = tw.tasks.pending() >>> tasks ['Tidy the house', 'Learn German'] >>> tasks.filter(tags__contain='chores') ['Tidy the house'] >>> type(tasks[0]) >>> tasks[0].done() >>> tasks = tw.tasks.pending() >>> tasks ['Learn German'] >>> tasks[0]['tags'] = ['languages'] >>> tasks[0].save() For more advanced usage, see the documentation_. .. _taskwarrior: http://taskwarrior.org .. _documentation: http://tasklib.readthedocs.org/en/latest/