allow to set the requested page on all endpoints (#586)

* allow to set the requested page on all endpoints

At the moment it's not possible to request another page on all endpoints (search for example). With this change the requested `page` can be set the same way like the `per_page`.

* private per page property

* revert and private page

Author: Gummibeer

lib/Github/Api/AbstractApi.php

@@ -19,6 +19,13 @@ abstract class AbstractApi implements ApiInterface
      */
     protected $client;
 
+    /**
+     * The requested page (GitHub pagination).
+     *
+     * @var null|int
+     */
+    private $page;
+
     /**
      * Number of items per page (GitHub pagination).
      *
@@ -38,6 +45,24 @@ public function configure()
     {
     }
 
+    /**
+     * @return null|int
+     */
+    public function getPage()
+    {
+        return $this->page;
+    }
+
+    /**
+     * @param null|int $page
+     */
+    public function setPage($page)
+    {
+        $this->page = (null === $page ? $page : (int) $page);
+
+        return $this;
+    }
+
     /**
      * @return null|int
      */
@@ -67,6 +92,9 @@ public function setPerPage($perPage)
      */
     protected function get($path, array $parameters = array(), array $requestHeaders = array())
     {
+        if (null !== $this->page && !isset($parameters['page'])) {
+            $parameters['page'] = $this->page;
+        }
         if (null !== $this->perPage && !isset($parameters['per_page'])) {
             $parameters['per_page'] = $this->perPage;
         }