feat(docs): add example docs

README.rst

@@ -6,12 +6,12 @@
 
 |Build Status| |PyPI| |Coverage Status| |Documentation Status| |Stability| |Quality| |Versions|
 
-grappa-http
------------
+About
+-----
 
-`grappa`_ plugin for HTTP assertions.
+HTTP assertions plugin for `grappa`_.
 
-To get started, take a look to the `documentation`_ and `tutorial`_.
+To get started, take a look to the `documentation`_, `tutorial`_ and `examples`_.
 
 Features
 --------
@@ -48,6 +48,7 @@ Or install the latest sources from Github:
 .. _`grappa`: https://grappa.readthedocs.io
 .. _`documentation`: http://grappa-http.readthedocs.io
 .. _`tutorial`: http://grappa-http.readthedocs.io/en/latest/tutorial.html
+.. _`examples`: http://grappa-http.readthedocs.io/en/latest/examples.html
 
 .. |Build Status| image:: https://travis-ci.org/grappa-python/grappa-http.svg?branch=master
    :target: https://travis-ci.org/grappa-python/grappa-http

docs/examples.rst

@@ -0,0 +1,14 @@
+Examples
+========
+
+Basic response assertion
+------------------------
+
+.. code-block:: python
+
+
+    res = requests.get('http://httpbin.org/status/204')
+    res | should.be.response.status(204)
+
+    # Or alternatively using the string notation
+    res | should.be.response.status('No Content')

docs/index.rst

@@ -6,6 +6,7 @@ Contents
 
    intro
    tutorial
+   examples
    operators
    api
    contributing

grappa_http/operators/status.py

@@ -47,6 +47,7 @@ def _match(self, res, status):
 
         self.subject = res.status_code
         if isinstance(status, str):
-            self.subject = res.status
+            status = status.lower()
+            self.subject = res.status.lower()
 
         return self.subject == status, []