X-Git-Url: https://git.madduck.net/etc/taskwarrior.git/blobdiff_plain/e17985e0d4a7ce2eb83c580c71e2f7c1af7f093b..17c10da870b0285156284ebcf06642db774f372e:/README.rst diff --git a/README.rst b/README.rst index 6cf60d6..c8053ef 100644 --- a/README.rst +++ b/README.rst @@ -1,12 +1,19 @@ tasklib ======= -A Python library for interacting with taskwarrior_ databases. +.. image:: https://travis-ci.org/robgolding63/tasklib.png + :target: http://travis-ci.org/robgolding63/tasklib + +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 2.2.x. +Older versions of taskwarrior are untested and may not work. Requirements ------------ -Before installing ``tasklib``, you'll need to install taskwarrior_. +* taskwarrior_ v2.1.x or v2.2.x Installation ------------ @@ -18,17 +25,26 @@ Install via pip:: Usage ----- -.. source-code: +tasklib has a similar API to that of Django's ORM:: - >>> from tasklib.task import TaskWarrior, PENDING + >>> from tasklib.task import TaskWarrior >>> tw = TaskWarrior('/home/rob/.task') - >>> tasks = tw.get_tasks(status=PENDING) + >>> tasks = tw.tasks.pending() >>> tasks ['Tidy the house', 'Learn German'] + >>> tasks.filter(tags__contain='chores') + ['Tidy the house'] >>> type(tasks[0]) >>> task[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/