link docs!
authorKenneth Reitz <me@kennethreitz.com>
Mon, 20 Aug 2012 14:52:09 +0000 (00:52 +1000)
committerKenneth Reitz <me@kennethreitz.com>
Mon, 20 Aug 2012 14:52:09 +0000 (00:52 +1000)
docs/user/advanced.rst

index d0e04254d7afa94a53c9f4f4ccb0081c2d5584d7..cd114ae68720a78c35a372be9a8b58a53c6b66fb 100644 (file)
@@ -534,13 +534,14 @@ GitHub uses these for `pagination <http://developer.github.com/v3/#pagination>`_
 
     >>> url = 'https://api.github.com/users/kennethreitz/repos?page=1&per_page=10'
     >>> r = requests.head(url=url)
-    >>> print r.headers['link']
-    ...
-    'x-ratelimit-remaining': '4995'
-    'x-ratelimit-limit': '5000'
-    ...
+    >>> r.headers['link']
+    '<https://api.github.com/users/kennethreitz/repos?page=2&per_page=10>; rel="next", <https://api.github.com/users/kennethreitz/repos?page=6&per_page=10>; rel="last"'
 
-Requests will automatically parse these link headers and make them easily consumable:
+Requests will automatically parse these link headers and make them easily consumable::
 
+    >>> r.links['next']
+    'https://api.github.com/users/kennethreitz/repos?page=2&per_page=10'
 
+    >>> r.links['last']
+    'https://api.github.com/users/kennethreitz/repos?page=6&per_page=10'