Merge pull request #27 from simivar/feature/implement-all-lor-ranked

 Implement all Lor Leaderboard v1 endpoints

Author: simivar

README.md

@@ -26,7 +26,7 @@ composer require simivar/riot-php symfony/http-client nyholm/psr7
 | League v4            | [docs](https://developer.riotgames.com/apis#league-v4)            | -      |
 | Lol Status v3        | [docs](https://developer.riotgames.com/apis#lol-status-v3)        | 100%   |
 | Lor Match v1         | [docs](https://developer.riotgames.com/apis#lor-match-v1)         | -      |
-| Lor Ranked v1        | [docs](https://developer.riotgames.com/apis#lor-ranked-v1)        | -      |
+| Lor Ranked v1        | [docs](https://developer.riotgames.com/apis#lor-ranked-v1)        | 100%   |
 | Match v4             | [docs](https://developer.riotgames.com/apis#match-v4)             | -      |
 | Spectator v4         | [docs](https://developer.riotgames.com/apis#spectator-v4)         | -      |
 | Summoner v4          | [docs](https://developer.riotgames.com/apis#summoner-v4)          | 100%   |

src/Riot/API.php

@@ -73,4 +73,13 @@ public function getLolStatusV3Api(): Version3\LolStatus
 
         return $this->apis['lolStatusV3'];
     }
+
+    public function getLorRankedV1Api(): Version1\LorRanked
+    {
+        if (!isset($this->apis['lorRankedV1'])) {
+            $this->apis['lorRankedV1'] = new Version1\LorRanked($this->riotConnection);
+        }
+
+        return $this->apis['lorRankedV1'];
+    }
 }

src/Riot/API/Version1/LorRanked.php

@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Riot\API\Version1;
+
+use JsonException;
+use Psr\Http\Client\ClientExceptionInterface;
+use Riot\API\AbstractApi;
+use Riot\DTO\LeaderboardDTO;
+use Riot\Exception as RiotException;
+
+final class LorRanked extends AbstractApi
+{
+    /**
+     * @throws JsonException
+     * @throws RiotException\BadGatewayException
+     * @throws RiotException\BadRequestException
+     * @throws RiotException\DataNotFoundException
+     * @throws RiotException\ForbiddenException
+     * @throws RiotException\GatewayTimeoutException
+     * @throws RiotException\InternalServerErrorException
+     * @throws RiotException\MethodNotAllowedException
+     * @throws RiotException\RateLimitExceededException
+     * @throws RiotException\ServiceUnavailableException
+     * @throws RiotException\UnauthorizedException
+     * @throws RiotException\UnsupportedMediaTypeException
+     * @throws ClientExceptionInterface
+     */
+    public function getLeaderboards(string $geoRegion): LeaderboardDTO
+    {
+        $response = $this->riotConnection->get(
+            $geoRegion,
+            'lor/ranked/v1/leaderboards',
+        );
+        $body = $response->getBody()->getContents();
+
+        return LeaderboardDTO::createFromArray(json_decode($body, true, 512, JSON_THROW_ON_ERROR));
+    }
+}

src/Riot/Collection/IncidentDTOCollection.php

@@ -19,6 +19,8 @@ public function getType(): string
 
     /**
      * @param array<array<string, mixed>> $data
+     *
+     * @return IncidentDTOCollection<IncidentDTO>
      */
     public static function createFromArray(array $data): self
     {

src/Riot/Collection/MessageDTOCollection.php

@@ -19,6 +19,8 @@ public function getType(): string
 
     /**
      * @param array<array<string, array|string>> $data
+     *
+     * @return MessageDTOCollection<MessageDTO>
      */
     public static function createFromArray(array $data): self
     {

src/Riot/Collection/PlayerDTOCollection.php

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Riot\Collection;
+
+use Ramsey\Collection\AbstractCollection;
+use Riot\DTO\PlayerDTO;
+
+final class PlayerDTOCollection extends AbstractCollection
+{
+    /**
+     * @codeCoverageIgnore
+     */
+    public function getType(): string
+    {
+        return PlayerDTO::class;
+    }
+
+    /**
+     * @param array<array<string, string|int>> $data
+     *
+     * @return PlayerDTOCollection<PlayerDTO>
+     */
+    public static function createFromArray(array $data): self
+    {
+        $collection = new self();
+        foreach ($data as $item) {
+            $collection->add(PlayerDTO::createFromArray($item));
+        }
+
+        return $collection;
+    }
+}

src/Riot/Collection/ServiceDTOCollection.php

@@ -19,6 +19,8 @@ public function getType(): string
 
     /**
      * @param array<array<string, array|string>> $data
+     *
+     * @return ServiceDTOCollection<ServiceDTO>
      */
     public static function createFromArray(array $data): self
     {

src/Riot/Collection/TranslationDTOCollection.php

@@ -19,6 +19,8 @@ public function getType(): string
 
     /**
      * @param array<array<string, string>> $data
+     *
+     * @return TranslationDTOCollection<TranslationDTO>
      */
     public static function createFromArray(array $data): self
     {

src/Riot/DTO/LeaderboardDTO.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Riot\DTO;
+
+use Riot\Collection\PlayerDTOCollection;
+
+final class LeaderboardDTO implements DTOInterface
+{
+    /** @var PlayerDTOCollection<PlayerDTO> */
+    private PlayerDTOCollection $players;
+
+    /**
+     * @param PlayerDTOCollection<PlayerDTO> $players
+     */
+    public function __construct(PlayerDTOCollection $players)
+    {
+        $this->players = $players;
+    }
+
+    public function getPlayers(): PlayerDTOCollection
+    {
+        return $this->players;
+    }
+
+    public static function createFromArray(array $data): self
+    {
+        return new self(
+            PlayerDTOCollection::createFromArray($data['players']),
+        );
+    }
+}

src/Riot/DTO/PlayerDTO.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Riot\DTO;
+
+final class PlayerDTO implements DTOInterface
+{
+    private string $name;
+
+    private int $rank;
+
+    private int $lp;
+
+    public function __construct(string $name, int $rank, int $lp)
+    {
+        $this->name = $name;
+        $this->rank = $rank;
+        $this->lp = $lp;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    public function getRank(): int
+    {
+        return $this->rank;
+    }
+
+    public function getLp(): int
+    {
+        return $this->lp;
+    }
+
+    public static function createFromArray(array $data): self
+    {
+        return new self(
+            $data['name'],
+            $data['rank'],
+            (int) $data['lp'],
+        );
+    }
+}