Refactored traits and added simple pagination

src/V2/BulkEndpoint.php

@@ -3,8 +3,6 @@
 namespace GW2Treasures\GW2Api\V2;
 
 use GuzzleHttp\Client;
-use GuzzleHttp\Message\RequestInterface;
-use GuzzleHttp\Message\ResponseInterface;
 use GuzzleHttp\Pool;
 
 trait BulkEndpoint {
@@ -92,23 +90,4 @@ public function all() {
             return $this->many( $ids );
         }
     }
-
-    /**
-     * @return Client
-     */
-    protected abstract function getClient();
-
-    /**
-     * Creates a new Request to this Endpoint.
-     *
-     * @param string[] $query
-     * @param null     $url
-     * @param string   $method
-     * @param array    $options
-     * @return \GuzzleHttp\Message\Request|\GuzzleHttp\Message\RequestInterface
-     */
-    protected abstract function createRequest( array $query = [], $url = null, $method = 'GET', $options = [] );
-
-    protected abstract function request( RequestInterface $request );
-    protected abstract function getResponseAsJson( ResponseInterface $response );
 }

src/V2/EndpointTrait.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace GW2Treasures\GW2Api\V2;
+
+use GuzzleHttp\Client;
+use GuzzleHttp\Message\RequestInterface;
+use GuzzleHttp\Message\ResponseInterface;
+
+trait EndpointTrait {
+
+    /**
+     * @return Client
+     */
+    protected abstract function getClient();
+
+    /**
+     * Creates a new Request to this Endpoint.
+     *
+     * @param string[] $query
+     * @param null     $url
+     * @param string   $method
+     * @param array    $options
+     * @return \GuzzleHttp\Message\Request|\GuzzleHttp\Message\RequestInterface
+     */
+    protected abstract function createRequest( array $query = [], $url = null, $method = 'GET', $options = [] );
+
+    protected abstract function request( RequestInterface $request );
+
+    protected abstract function getResponseAsJson( ResponseInterface $response );
+}

src/V2/Interfaces/IPaginatedEndpoint.php

@@ -15,5 +15,15 @@ function maxPageSize();
      *
      * @return array
      */
-    public function all();
+    function all();
+
+
+    /**
+     * Get a single page.
+     *
+     * @param int $index
+     * @param int $size
+     * @return mixed
+     */
+    function page( $index, $size = null );
 }

src/V2/LocalizedEndpoint.php

@@ -3,6 +3,7 @@
 namespace GW2Treasures\GW2Api\V2;
 
 trait LocalizedEndpoint {
+    use EndpointTrait;
 
     /** @var string $language */
     protected $language = 'en';

src/V2/PaginatedEndpoint.php

@@ -2,7 +2,11 @@
 
 namespace GW2Treasures\GW2Api\V2;
 
+use OutOfRangeException;
+
 trait PaginatedEndpoint {
+    use EndpointTrait;
+
     /**
      * Max page size of this endpoint.
      *
@@ -22,4 +26,29 @@ protected function maxPageSize() {
     public function all() {
         // TODO: implement
     }
+
+    /**
+     * Get a single page.
+     *
+     * @param int $index
+     * @param int $size
+     * @return mixed
+     */
+    public function page( $index, $size = null ) {
+        if( is_null( $size )) {
+            $size = $this->maxPageSize();
+        }
+
+        if( $size > $this->maxPageSize() || $size <= 0 ) {
+            throw new OutOfRangeException('$size has to be between 0 and ' . $this->maxPageSize() . ', was ' . $size );
+        }
+
+        if( $index < 0 ) {
+            throw new OutOfRangeException('$index has to be 0 or greater');
+        }
+
+        $request = $this->createRequest(['page' => $index, 'page_size' => $size ]);
+        $response = $this->request( $request );
+        return $this->getResponseAsJson( $response );
+    }
 }

tests/BasicTest.php

@@ -12,6 +12,13 @@ public function testQuaggans() {
         $q2 = $quagganEndpoint->many( $quagganEndpoint->ids() );
     }
 
+    public function testPagination() {
+        $quaggans = $this->api()->quaggans()->page(2, 2);
+
+        $this->assertEquals( 'bowl', $quaggans[0]->id );
+        $this->assertEquals( 'box', $quaggans[1]->id );
+    }
+
     public function testWorlds() {
         $anvilRock = $this->api()->worlds()->get(1001);
         $this->assertEquals("Anvil Rock", $anvilRock->name);