Added a simple example of how to use urllib and urllib2 to interact

with an api.

docs/contents.rst

@@ -4,6 +4,7 @@ Documentation
 .. toctree::
   :maxdepth: 2
   
+  howto
   library
   examples
   

docs/howto.rst

+How Tos, FAQs & Notes
+=====================
+
+.. toctree::
+  :maxdepth: 1
+  :glob:
+
+  howto/*

docs/howto/usingurllib2.rst

+Using urllib2
+=============
+
+Python's standard library comes with some nice modules
+you can use to test your api or even write a full client.
+
+Here's an example which does a 'GET' on the `model-resource` examle
+in the sandbox.::
+
+    import urllib2
+    >>> r = urllib2.urlopen('htpp://rest.ep.io/model-resource-example')
+    # You can check if the response was ok:
+    >>> r.getcode()
+    200
+    # Or examin the resonse itself:
+    >>> print r.read()
+    [{"url": "http://rest.ep.io/model-resource-example/1/", "baz": "sdf", "foo": true, "bar": 123}]
+
+And here's an example which does a 'POST' to create a new instance::
+
+    # First encode tha data we want to POST, we'll use urllib for encoding
+    # and the time module to send the current time as as a string value for our POST
+    >>> import urllib, time
+    >>> d = urllib.urlencode((('bar', 123), ('baz', time.asctime())))
+    # Now use the Request class and specify the 'Content-type'
+    >>> req = urllib2.Request('http://rest.ep.io/model-resource-example/', data=d, headers={'Content-Type':'application/x-www-form-urlencoded'})
+    >>> resp = urllib2.urlopen(req)
+    >>> resp.getcode()
+    201
+    >>> resp.read()
+    '{"url": "http://rest.ep.io/model-resource-example/4/", "baz": "Fri Dec 30 18:22:52 2011", "foo": false, "bar": 123}'
+
+That should get you started to write a client for your own api.

docs/index.rst

@@ -92,16 +92,7 @@ The following example exposes your `MyModel` model through an api. It will provi
         url(r'^(?P<pk>[^/]+)/$', InstanceModelView.as_view(resource=MyResource)),
     )
 
-How Tos, FAQs & Notes
----------------------
-
-.. toctree::
-  :maxdepth: 1
-
-  howto/setup
-  howto/usingcurl
-  howto/alternativeframeworks
-  howto/mixin
+.. include:: howto.rst
 
 .. include:: library.rst