aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/howto/usingurllib2.rst22
1 files changed, 14 insertions, 8 deletions
diff --git a/docs/howto/usingurllib2.rst b/docs/howto/usingurllib2.rst
index a31bcc9b..139bf717 100644
--- a/docs/howto/usingurllib2.rst
+++ b/docs/howto/usingurllib2.rst
@@ -4,25 +4,31 @@ Using urllib2
Python's standard library comes with some nice modules
you can use to test your api or even write a full client.
+Using the 'GET' method
+----------------------
+
Here's an example which does a 'GET' on the `model-resource` example
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()
+ >>> r.getcode() # Check if the response was ok
200
- # Or examin the response itself:
- >>> print r.read()
+ >>> print r.read() # Examin the response itself
[{"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::
+Using the 'POST' method
+-----------------------
+
+And here's an example which does a 'POST' to create a new instance. First let's encode
+the 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.::
- # 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'
+
+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()