Example code

Author: dahlia

README.rst

@@ -3,7 +3,27 @@ Nirum HTTP transport for Python
 
 This package provides an HTTP transport for nirum-python_.
 
-.. _nirum-python: https://github.com/spoqa/nirum-python
+.. code-block:: python
+
+   from youtservice import YourService_Client
+   from nirum_http import HttpTransport
+
+   transport = HttpTransport('https://service-host/')
+   client = YourService_Client(transport)
+
+Since ``HttpTransport`` utilizes requests_ library under the hood, it can take
+a `session object`_ as well:
 
+.. code-block:: python
+
+   from requests import Session
+
+   session = Session()
+   session.auth = ('user', 'password')
+   transport = HttpTransport('https://service-host/', session=session)
+
+.. _nirum-python: https://github.com/spoqa/nirum-python
+.. _requests: http://python-requests.org/
+.. _session object: http://docs.python-requests.org/en/master/user/advanced/#session-objects
 
 .. include:: CHANGES.rst