feat: added round resource

docs/03-supported-endpoints.md

@@ -661,22 +661,17 @@ $response = $api->rivals()->getAllByTeamId(1);
 ### Rounds
 
 - [Official documentation](https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/rounds)
-- Cache default max age: `1 day`
 
 #### `getAll`
 
 ```php
-getAll(int $page = 1, int $perPage = 25, string $order = 'asc'): RoundCollection
+getAll(): RoundCollection
 ```
 
 Get all rounds:
 
 ```php
-$rounds = $sportMonksFootball->rounds()->getAll();
-
-foreach ($rounds->getData() as $round) {
-    echo $round->getName();
-}
+$response = $api->rounds()->getAll();
 ```
 
 #### `getById`
@@ -688,8 +683,7 @@ getById(int $id): RoundItem
 Get round by id:
 
 ```php
-$round = $sportMonksFootball->rounds()->getById(1);
-echo $round->getData()->getName();
+$response = $api->rounds()->getById(1);
 ```
 
 #### `getAllBySeasonId`
@@ -701,27 +695,19 @@ getAllBySeasonId(int $seasonId): RoundCollection
 Get all rounds by season id:
 
 ```php
-$rounds = $sportMonksFootball->rounds()->getAllBySeasonId(1);
-
-foreach ($rounds->getData() as $round) {
-    echo $round->getName();
-}
+$response = $api->rounds()->getAllBySeasonId(1);
 ```
 
 #### `getAllBySearchQuery`
 
 ```php
-getAllBySearchQuery(string $query, int $page = 1, int $perPage = 25, string $order = 'asc'): RoundCollection
+getAllBySearchQuery(string $query): RoundCollection
 ```
 
 Get all rounds by search query:
 
 ```php
-$rounds = $sportMonksFootball->rounds()->getAllBySearchQuery('30');
-
-foreach ($rounds->getData() as $round) {
-    echo $round->getName();
-}
+$response = $api->rounds()->getAllBySearchQuery('30');
 ```
 
 ### Schedules

src/Resource/RoundResource.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace ProgrammatorDev\SportMonksFootball\Resource;
+
+use ProgrammatorDev\SportMonksFootball\Entity\Response\RoundCollection;
+use ProgrammatorDev\SportMonksFootball\Entity\Response\RoundItem;
+use ProgrammatorDev\SportMonksFootball\Resource\Util\PaginationTrait;
+use ProgrammatorDev\Validator\Exception\ValidationException;
+use Psr\Http\Client\ClientExceptionInterface;
+
+class RoundResource extends Resource
+{
+    use PaginationTrait;
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAll(): RoundCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: '/v3/football/rounds'
+        );
+
+        return new RoundCollection($data);
+    }
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getById(int $id): RoundItem
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: $this->api->buildPath('/v3/football/rounds/{id}', [
+                'id' => $id
+            ])
+        );
+
+        return new RoundItem($data);
+    }
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAllBySeasonId(int $seasonId): RoundCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: $this->api->buildPath('/v3/football/rounds/seasons/{seasonId}', [
+                'seasonId' => $seasonId
+            ])
+        );
+
+        return new RoundCollection($data);
+    }
+
+    /**
+     * @throws ValidationException
+     * @throws ClientExceptionInterface
+     */
+    public function getAllBySearchQuery(string $query): RoundCollection
+    {
+        $this->validateQuery($query, 'query');
+
+        $data = $this->api->request(
+            method: 'GET',
+            path: $this->api->buildPath('/v3/football/rounds/search/{query}', [
+                'query' => $query
+            ])
+        );
+
+        return new RoundCollection($data);
+    }
+}

src/SportMonksFootball.php

@@ -42,6 +42,7 @@
 use ProgrammatorDev\SportMonksFootball\Resource\RefereeResource;
 use ProgrammatorDev\SportMonksFootball\Resource\RegionResource;
 use ProgrammatorDev\SportMonksFootball\Resource\RivalResource;
+use ProgrammatorDev\SportMonksFootball\Resource\RoundResource;
 
 class SportMonksFootball extends Api
 {
@@ -138,11 +139,11 @@ public function rivals(): RivalResource
         return new RivalResource($this);
     }
 
-//    public function rounds(): RoundEndpoint
-//    {
-//        return new RoundEndpoint($this);
-//    }
-//
+    public function rounds(): RoundResource
+    {
+        return new RoundResource($this);
+    }
+
 //    public function schedules(): ScheduleEndpoint
 //    {
 //        return new ScheduleEndpoint($this);

tests/Integration/RoundResourceTest.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace ProgrammatorDev\SportMonksFootball\Test\Integration;
+
+use ProgrammatorDev\SportMonksFootball\Entity\Response\RoundCollection;
+use ProgrammatorDev\SportMonksFootball\Entity\Response\RoundItem;
+use ProgrammatorDev\SportMonksFootball\Test\AbstractTest;
+use ProgrammatorDev\SportMonksFootball\Test\MockResponse;
+use ProgrammatorDev\SportMonksFootball\Test\Util\TestCollectionResponseTrait;
+use ProgrammatorDev\SportMonksFootball\Test\Util\TestItemResponseTrait;
+use ProgrammatorDev\SportMonksFootball\Test\Util\TestValidationExceptionTrait;
+
+class RoundResourceTest extends AbstractTest
+{
+    use TestItemResponseTrait;
+    use TestCollectionResponseTrait;
+    use TestValidationExceptionTrait;
+
+    public static function provideItemResponseData(): \Generator
+    {
+        yield 'get by id' => [
+            RoundItem::class,
+            MockResponse::ROUND_ITEM_DATA,
+            'rounds',
+            'getById',
+            [1]
+        ];
+    }
+
+    public static function provideCollectionResponseData(): \Generator
+    {
+        yield 'get all' => [
+            RoundCollection::class,
+            MockResponse::ROUND_COLLECTION_DATA,
+            'rounds',
+            'getAll'
+        ];
+        yield 'get all by season id' => [
+            RoundCollection::class,
+            MockResponse::ROUND_COLLECTION_DATA,
+            'rounds',
+            'getAllBySeasonId',
+            [1]
+        ];
+        yield 'get all by search query' => [
+            RoundCollection::class,
+            MockResponse::ROUND_COLLECTION_DATA,
+            'rounds',
+            'getAllBySearchQuery',
+            ['test']
+        ];
+    }
+
+    public static function provideValidationExceptionData(): \Generator
+    {
+        yield 'get all by search query, blank query' => [
+            'rounds',
+            'getAllBySearchQuery',
+            ['']
+        ];
+    }
+}

tests/Integration/SportMonksFootballTest.php

@@ -18,6 +18,7 @@
 use ProgrammatorDev\SportMonksFootball\Resource\RefereeResource;
 use ProgrammatorDev\SportMonksFootball\Resource\RegionResource;
 use ProgrammatorDev\SportMonksFootball\Resource\RivalResource;
+use ProgrammatorDev\SportMonksFootball\Resource\RoundResource;
 use ProgrammatorDev\SportMonksFootball\Test\AbstractTest;
 
 class SportMonksFootballTest extends AbstractTest
@@ -40,5 +41,6 @@ public function testMethods()
         $this->assertInstanceOf(RefereeResource::class, $this->api->referees());
         $this->assertInstanceOf(RegionResource::class, $this->api->regions());
         $this->assertInstanceOf(RivalResource::class, $this->api->rivals());
+        $this->assertInstanceOf(RoundResource::class, $this->api->rounds());
     }
 }