X-Git-Url: https://git.madduck.net/etc/taskwarrior.git/blobdiff_plain/76d7097c3dac17d7a22ba1b18e6ba09e2c6617b8..0ea1b0d359dc80d2bef66971b523a26515e90fee:/README.rst?ds=inline diff --git a/README.rst b/README.rst index feb5f70..b0a3e34 100644 --- a/README.rst +++ b/README.rst @@ -4,16 +4,16 @@ tasklib .. image:: https://travis-ci.org/robgolding63/tasklib.png :target: http://travis-ci.org/robgolding63/tasklib -A Python library for interacting with taskwarrior_ databases, using a queryset -API similar to that of Django's ORM. +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 and 3.3 with taskwarrior 2.2.0. Older versions of -taskwarrior are untested and probably won't work. +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. Requirements ------------ -* taskwarrior_ v2.2.0 +* taskwarrior_ v2.1.x or above. Installation ------------ @@ -25,7 +25,7 @@ Install via pip:: Usage ----- -.. source-code: +tasklib has a similar API to that of Django's ORM:: >>> from tasklib.task import TaskWarrior @@ -38,24 +38,13 @@ Usage >>> type(tasks[0]) >>> task[0].done() + >>> tasks = tw.tasks.pending() + >>> tasks + ['Learn German'] + >>> tasks[0]['tags'] = ['languages'] + >>> tasks[0].save() -Filtering Tasks ---------------- - -Tasks can be filtered using the ``TaskQuerySet`` API which emulates the -Django ORM:: - - >>> tw.tasks.filter(status='pending', tags__contain='work') - ['Upgrade Ubuntu Server'] - -Filter arguments are passed to the ``task`` command (``__`` is replaced by -a period); so the above example is equivalent to the following command:: - - $ task status:pending tags.contain=work +For more advanced usage, see the documentation_. .. _taskwarrior: http://taskwarrior.org - -Tasks can also be filtered using raw commands, like so:: - - >>> tw.tasks.filter('status:pending +work') - ['Upgrade Ubuntu Server'] +.. _documentation: http://tasklib.readthedocs.org/en/latest/