TV Season: add translation

lib/Tmdb/Api/TvSeason.php

@@ -107,4 +107,21 @@ public function getChanges($tvshow_id, $season_number, array $parameters = [], a
     {
         return $this->get(sprintf('tv/%s/season/%s/changes', $tvshow_id, $season_number), $parameters, $headers);
     }
+
+    /**
+     * Look up a TV season's changes by season ID.
+     * This method is used in conjunction with the /tv/{id}/changes method.
+     *
+     * This method uses the season_id value found in the change entries.
+     *
+     * @param integer $tvshow_id
+     * @param integer $season_number
+     * @param array $parameters
+     * @param array $headers
+     * @return mixed
+     */
+    public function getTranslations($tvshow_id, $season_number, array $parameters = [], array $headers = [])
+    {
+        return $this->get(sprintf('tv/%s/season/%s/translations', $tvshow_id, $season_number), $parameters, $headers);
+    }
 }

lib/Tmdb/Factory/TvSeasonFactory.php

@@ -19,9 +19,9 @@
 use Tmdb\Factory\People\CastFactory;
 use Tmdb\Factory\People\CrewFactory;
 use Tmdb\HttpClient\HttpClient;
-use Tmdb\Model\AbstractModel;
 use Tmdb\Model\Common\ExternalIds;
 use Tmdb\Model\Common\GenericCollection;
+use Tmdb\Model\Common\Translation;
 use Tmdb\Model\Person\CastMember;
 use Tmdb\Model\Person\CrewMember;
 use Tmdb\Model\Tv\Season;
@@ -157,6 +157,15 @@ public function create(array $data = []): ?Season
             $tvSeason->setChanges($this->getChangesFactory()->createCollection($data['changes']));
         }
 
+        if (array_key_exists('translations', $data) && $data['translations'] !== null) {
+            $tvSeason->setTranslations(
+                $this->createGenericCollection(
+                    $data['translations']['translations'] ?? [],
+                    new Translation()
+                )
+            );
+        }
+
         return $this->hydrate($tvSeason, $data);
     }
 

lib/Tmdb/Model/Tv/Season.php

@@ -22,6 +22,7 @@
 use Tmdb\Model\Collection\Videos;
 use Tmdb\Model\Common\ExternalIds;
 use Tmdb\Model\Common\GenericCollection;
+use Tmdb\Model\Common\Translation;
 use Tmdb\Model\Image\PosterImage;
 
 /**
@@ -75,6 +76,10 @@ class Season extends AbstractModel
      * @var Changes
      */
     protected $changes;
+    /**
+     * @var GenericCollection|Translation[]
+     */
+    protected $translations;
     /**
      * @var DateTime
      */
@@ -115,6 +120,7 @@ public function __construct()
         $this->episodes = new GenericCollection();
         $this->videos = new Videos();
         $this->changes = new Changes();
+        $this->translations = new GenericCollection();
     }
 
     /**
@@ -319,7 +325,7 @@ public function setPosterImage($poster)
     }
 
     /**
-     * @return ?PosterImage
+     * @return PosterImage
      */
     public function getPosterImage()
     {
@@ -363,4 +369,23 @@ public function setChanges($changes)
 
         return $this;
     }
+
+    /**
+     * @return GenericCollection
+     */
+    public function getTranslations(): GenericCollection
+    {
+        return $this->translations;
+    }
+
+    /**
+     * @param GenericCollection $changes
+     * @return self
+     */
+    public function setTranslations($changes)
+    {
+        $this->translations = $changes;
+
+        return $this;
+    }
 }

lib/Tmdb/Repository/TvSeasonRepository.php

@@ -195,4 +195,29 @@ public function getVideos($tvShow, $season, array $parameters = [], array $heade
 
         return $season->getVideos();
     }
+
+    /**
+     * Get the videos that have been added to a TV season (trailers, teasers, etc...)
+     *
+     * @param $tvShow
+     * @param $season
+     * @param $parameters
+     * @param $headers
+     * @return Videos|Video[]
+     */
+    public function getTranslations($tvShow, $season, array $parameters = [], array $headers = [])
+    {
+        if ($tvShow instanceof Tv) {
+            $tvShow = $tvShow->getId();
+        }
+
+        if ($season instanceof Season) {
+            $season = $season->getSeasonNumber();
+        }
+
+        $data = $this->getApi()->getTranslations($tvShow, $season, $this->parseQueryParameters($parameters), $headers);
+        $season = $this->getFactory()->create(['translations' => $data]);
+
+        return $season->getTranslations();
+    }
 }

test/Tmdb/Tests/Api/TvSeasonTest.php

@@ -87,6 +87,17 @@ public function shouldGetSeasonChanges()
         $this->assertLastRequestIsWithPathAndMethod('/3/tv/' . self::TV_ID . '/season/' . self::SEASON_ID . '/changes');
     }
 
+    /**
+     * @test
+     */
+    public function shouldGetSeasonTranslations()
+    {
+        $api = $this->getApiWithMockedHttpAdapter();
+
+        $api->getTranslations(self::TV_ID, self::SEASON_ID);
+        $this->assertLastRequestIsWithPathAndMethod('/3/tv/' . self::TV_ID . '/season/' . self::SEASON_ID . '/translations');
+    }
+
     protected function getApiClass()
     {
         return 'Tmdb\Api\TvSeason';

test/Tmdb/Tests/Factory/TvSeasonFactoryTest.php

@@ -30,7 +30,7 @@ public function setUp(): void
          * @var TvSeasonFactory $factory
          */
         $factory = $this->getFactory();
-        $data    = $this->loadByFile('tv/season/all.json');
+        $data = $this->loadByFile('tv/season/all.json');
 
         /**
          * @var Season $this->season
@@ -52,6 +52,7 @@ public function shouldConstructTvSeason()
         $this->assertInstanceOf('Tmdb\Model\Collection\Images', $this->season->getImages());
         $this->assertInstanceOf('Tmdb\Model\Common\GenericCollection', $this->season->getEpisodes());
         $this->assertInstanceOf('Tmdb\Model\Image\PosterImage', $this->season->getPosterImage());
+        $this->assertInstanceOf('Tmdb\Model\Common\GenericCollection', $this->season->getTranslations());
     }
 
     /**
@@ -88,7 +89,10 @@ public function shouldBeFunctional()
         $this->assertEquals(3573, $this->season->getId());
         $this->assertEquals('/rCdISteF1GPvPsy0a5L0LDffjtP.jpg', $this->season->getPosterPath());
         $this->assertEquals(2, $this->season->getSeasonNumber());
-    }
+        $this->assertEquals("Sein Ruf eilt dem zum Meth-Dealer gewordenen Lehrer Walter voraus – das erregt die Aufmerksamkeit rivalisierender Kartelle und gefährdet seinen Schwager, einen Drogencop.",
+            $this->season->getTranslations()->filterLanguage('de')->getIterator()->current()->getData()['overview']
+        );
+}
 
     protected function getFactoryClass()
     {

test/Tmdb/Tests/Model/Tv/SeasonTest.php

@@ -35,6 +35,7 @@ public function shouldConstructTvSeason()
                 'getImages' => 'Tmdb\Model\Collection\Images',
                 'getEpisodes' => 'Tmdb\Model\Common\GenericCollection',
                 'getVideos' => 'Tmdb\Model\Collection\Videos',
+                'getTranslations' => 'Tmdb\Model\Common\GenericCollection',
             ]
         );
     }

test/Tmdb/Tests/Repository/TvSeasonRepositoryTest.php

@@ -69,6 +69,23 @@ public function shouldGetCredits()
         $this->assertLastRequestIsWithPathAndMethod('/3/tv/' . self::TV_ID . '/season/' . self::SEASON_NUMBER . '/credits');
     }
 
+    /**
+     * @test
+     */
+    public function shouldGetTranslations()
+    {
+        $repository = $this->getRepositoryWithMockedHttpAdapter();
+
+        $tv = new Tv();
+        $tv->setId(self::TV_ID);
+
+        $season = new Tv\Season();
+        $season->setSeasonNumber(self::SEASON_NUMBER);
+
+        $repository->getTranslations($tv, $season);
+        $this->assertLastRequestIsWithPathAndMethod('/3/tv/' . self::TV_ID . '/season/' . self::SEASON_NUMBER . '/translations');
+    }
+
     /**
      * @test
      */