X-Git-Url: https://git.madduck.net/etc/taskwarrior.git/blobdiff_plain/e17985e0d4a7ce2eb83c580c71e2f7c1af7f093b..2a86715582836a3225790b8fc7b964dcc12db6f6:/README.rst

diff --git a/README.rst b/README.rst
index 6cf60d6..ee748c2 100644
--- a/README.rst
+++ b/README.rst
@@ -20,15 +20,35 @@ Usage
 
 .. source-code:
 
-    >>> 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])
     <class 'tasklib.task.Task'>
     >>> task[0].done()
 
+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
 
 .. _taskwarrior: http://taskwarrior.org
+
+Tasks can also be filtered using raw commands, like so::
+
+    >>> tw.tasks.filter('status:pending +work')
+    ['Upgrade Ubuntu Server']