Added way to parse pagination headers from GitHub.

Author: stloyd

lib/Github/HttpClient/HttpClient.php

@@ -56,6 +56,11 @@ class HttpClient implements HttpClientInterface
      */
     protected $browser;
 
+    /**
+     * @var array
+     */
+    private $lastResponse;
+
     /**
      * Instantiated a new http client
      *
@@ -101,6 +106,18 @@ public function setOption($name, $value)
         return $this;
     }
 
+    /**
+     * @return null|array
+     */
+    public function getPagination()
+    {
+        if (null === $this->lastResponse) {
+            return null;
+        }
+
+        return $this->lastResponse['pagination'];
+    }
+
     /**
      * {@inheritDoc}
      */
@@ -162,9 +179,9 @@ public function request($path, array $parameters = array(), $httpMethod = 'GET',
         ));
 
         // get encoded response
-        $response = $this->doRequest($url, $parameters, $httpMethod, $options);
+        $this->lastResponse = $this->doRequest($url, $parameters, $httpMethod, $options);
 
-        return $this->decodeResponse($response['response']);
+        return $this->decodeResponse($this->lastResponse['response']);
     }
 
     /**
@@ -186,11 +203,36 @@ protected function doRequest($url, array $parameters = array(), $httpMethod = 'G
         return array(
             'response'     => $response->getContent(),
             'headers'      => $response->getHeaders(),
+            'pagination'   => $this->decodePagination($response),
             'errorNumber'  => '',
             'errorMessage' => ''
         );
     }
 
+    /**
+     * @param MessageInterface $response
+     *
+     * @return array|null
+     */
+    protected function decodePagination(MessageInterface $response)
+    {
+        $header = $response->getHeader('Link');
+        if (empty($header)) {
+            return null;
+        }
+
+        $pagination = array();
+        foreach (explode("\n", $header) as $link) {
+            preg_match('/<(.*)>; rel="(.*)"/i', trim($link, ','), $match);
+
+            if (3 === count($match)) {
+                $pagination[$match[2]] = $match[1];
+            }
+        }
+
+        return $pagination;
+    }
+
     /**
      * {@inheritDoc}
      */