Update package documentation and PyPi overview

Author: vitalk

docs/features.rst

@@ -139,6 +139,26 @@ other headless browsers).
             assert res.code == 200
 
 
+``request_ctx`` - request context
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The request context which contains all request relevant information.
+
+.. hint::
+
+    The request context has been pushed implicitly any time the ``app``
+    fixture is applied and is kept around during test execution, so it's easy
+    to introspect the data:
+
+    .. code:: python
+
+        from flask import request, url_for
+
+        def test_request_headers(client):
+            res = client.get(url_for('ping'), headers=[('X-Something', '42')])
+            assert request.headers['X-Something'] == '42'
+
+
 Content negotiation
 ~~~~~~~~~~~~~~~~~~~
 

setup.py

@@ -17,6 +17,7 @@
 - ``config`` - you application config,
 - ``live_server`` - runs an application in the background (useful for tests
   with `Selenium <http://www.seleniumhq.org>`_ and other headless browsers),
+- ``request_ctx`` - the request context,
 - ``accept_json``, ``accept_jsonp``, ``accept_any`` - accept headers
   suitable to use as parameters in ``client``.