Added venue lookup endpoint

src/Client/Endpoint/LookupEndpoint.php

@@ -18,6 +18,7 @@
 use NklKst\TheSportsDb\Entity\Player\Player;
 use NklKst\TheSportsDb\Entity\Table\Table;
 use NklKst\TheSportsDb\Entity\Team;
+use NklKst\TheSportsDb\Entity\Venue;
 use NklKst\TheSportsDb\Filter\LookupFilter;
 
 /**
@@ -41,6 +42,7 @@ class LookupEndpoint extends AbstractEndpoint
     private const ENDPOINT_TEAM = 'lookupteam.php';
     private const ENDPOINT_TELEVISION = 'lookuptv.php';
     private const ENDPOINT_TIMELINE = 'lookuptimeline.php';
+    private const ENDPOINT_VENUE = 'lookupvenue.php';
 
     /**
      * Get player contracts.
@@ -300,4 +302,19 @@ public function timeline(int $eventID): array
 
         return $this->serializer->serializeTimeline($this->request());
     }
+
+    /**
+     * Get venue by ID.
+     *
+     * @throws Exception
+     */
+    public function venue(int $venueID): ?Venue
+    {
+        $this
+            ->setFilter((new LookupFilter())->setID($venueID))
+            ->requestBuilder->setEndpoint(self::ENDPOINT_VENUE)
+        ;
+
+        return $this->getSingleEntity($this->serializer->serializeVenues($this->request()));
+    }
 }

src/Serializer/VenueSerializer.php

@@ -16,6 +16,6 @@ protected function getEntityClass(): string
 
     protected function getValidJsonRootNames(): array
     {
-        return ['venues'];
+        return ['honours', 'venues'];
     }
 }

test/integration/LookupTest.php

@@ -19,6 +19,7 @@
 use NklKst\TheSportsDb\Entity\Table\Standing;
 use NklKst\TheSportsDb\Entity\Table\Table;
 use NklKst\TheSportsDb\Entity\Team;
+use NklKst\TheSportsDb\Entity\Venue;
 use NklKst\TheSportsDb\Util\TestUtils;
 use PHPUnit\Framework\TestCase;
 
@@ -81,6 +82,21 @@ public function testPlayer(): void
         TestUtils::assertThatAllPropertiesAreInitialized($player);
     }
 
+    /**
+     * Venue details by id (https://www.thesportsdb.com/api/v1/json/3/lookupvenue.php?id=16163).
+     *
+     * @throws Exception
+     */
+    public function testVenue(): void
+    {
+        $venue = $this->client->lookup()->venue(16163);
+
+        $this->assertInstanceOf(Venue::class, $venue);
+        $this->assertSame('Wembley Stadium', $venue->strVenue);
+
+        TestUtils::assertThatAllPropertiesAreInitialized($venue);
+    }
+
     /**
      * Event details by id (https://www.thesportsdb.com/api/v1/json/{PATREON_KEY}/lookupevent.php?id=441613).
      *

test/unit/Client/Endpoint/LookupEndpointTest.php

@@ -19,6 +19,7 @@
 use NklKst\TheSportsDb\Entity\Player\Player;
 use NklKst\TheSportsDb\Entity\Table\Table;
 use NklKst\TheSportsDb\Entity\Team;
+use NklKst\TheSportsDb\Entity\Venue;
 use NklKst\TheSportsDb\Filter\LookupFilter;
 use NklKst\TheSportsDb\Request\RequestBuilder;
 use NklKst\TheSportsDb\Serializer\Serializer;
@@ -539,4 +540,38 @@ public function testTimelineInstances(): void
         $this->assertNotEmpty($timeline);
         $this->assertContainsOnlyInstancesOf(Timeline::class, $timeline);
     }
+
+    /**
+     * @throws Exception
+     */
+    public function testVenueFilterVenue(): void
+    {
+        $this->endpoint->venue(1);
+
+        $this->assertEquals(
+            (new LookupFilter())->setID(1),
+            TestUtils::getHiddenProperty($this->endpoint, 'filter'))
+        ;
+    }
+
+    /**
+     * @throws Exception
+     */
+    public function testVenueEndpoint(): void
+    {
+        TestUtils::expectEndpoint($this->requestBuilderMock, 'lookupvenue.php');
+        $this->endpoint->venue(1);
+    }
+
+    /**
+     * @throws Exception
+     */
+    public function testVenueInstance(): void
+    {
+        $this->serializerStub->method('serializeVenues')->willReturn([new Venue()]);
+
+        $venue = $this->endpoint->venue(1);
+
+        $this->assertInstanceOf(Venue::class, $venue);
+    }
 }