Fix CS

src/Crawler/ArtistEventCrawlerInterface.php

@@ -17,18 +17,18 @@
 interface ArtistEventCrawlerInterface
 {
     /**
-     * @throws CrawlException
-     *
      * @return int[]
+     *
+     * @throws CrawlException
      */
     public function getArtistYears(string $artist): array;
 
     /**
      * Get all events of an artist.
      *
-     * @throws CrawlException
-     *
      * @return Event[]
+     *
+     * @throws CrawlException
      */
     public function getEvents(string $artist, ?int $year, int $page = 1): array;
 

src/Crawler/EventListCrawlerInterface.php

@@ -22,9 +22,9 @@ interface EventListCrawlerInterface
      *
      * @param int $radius in KM
      *
-     * @throws CrawlException
-     *
      * @return Event[]
+     *
+     * @throws CrawlException
      */
     public function getEvents(GeoLocation $location, $radius = 100, int $page = 1): array;
 

src/Crawler/UserEventCrawlerInterface.php

@@ -17,18 +17,18 @@
 interface UserEventCrawlerInterface
 {
     /**
-     * @throws CrawlException
-     *
      * @return int[]
+     *
+     * @throws CrawlException
      */
     public function getUserYears(string $username): array;
 
     /**
      * Get all events of a user.
      *
-     * @throws CrawlException
-     *
      * @return Event[]
+     *
+     * @throws CrawlException
      */
     public function getEvents(string $username, ?int $year, int $page = 1): array;
 

src/Service/AlbumServiceInterface.php

@@ -46,20 +46,20 @@ public function getInfo(AlbumInfoBuilder $builder): AlbumInfo;
     /**
      * Get the tags applied by an individual user to an album on Last.fm.
      *
+     * @return AlbumInfo[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return AlbumInfo[]
      */
     public function getTags(AlbumTagsBuilder $builder): array;
 
     /**
      * Get the top tags applied to an album on Last.fm.
      *
+     * @return Tag[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Tag[]
      */
     public function getTopTags(AlbumTopTagsBuilder $builder): array;
 
@@ -74,10 +74,10 @@ public function removeTag(SessionInterface $session, string $artist, string $alb
     /**
      * Search for an album by name. Returns album matches sorted by relevance.
      *
+     * @return Album[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Album[]
      */
     public function search(string $album, int $limit = 50, int $page = 1): array;
 }

src/Service/ArtistServiceInterface.php

@@ -59,50 +59,50 @@ public function getInfo(ArtistInfoBuilder $builder): ?ArtistInfo;
     /**
      * Get all the artists similar to this artist.
      *
+     * @return Artist[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Artist[]
      */
     public function getSimilar(SimilarArtistBuilder $builder): array;
 
     /**
      * Get the tags applied by an individual user to an artist on Last.fm.
      *
+     * @return Tag[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Tag[]
      */
     public function getTags(ArtistTagsBuilder $builder): array;
 
     /**
      * Get the top albums for an artist on Last.fm, ordered by popularity.
      *
+     * @return Album[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Album[]
      */
     public function getTopAlbums(ArtistTopAlbumsBuilder $builder): array;
 
     /**
      * Get the top tags for an artist on Last.fm, ordered by popularity.
      *
+     * @return Tag[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Tag[]
      */
     public function getTopTags(ArtistTopTagsBuilder $builder): array;
 
     /**
      * Get the top tracks by an artist on Last.fm, ordered by popularity.
      *
+     * @return Song[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Song[]
      */
     public function getTopTracks(ArtistTopTracksBuilder $builder): array;
 
@@ -117,10 +117,10 @@ public function removeTag(SessionInterface $session, string $artist, string $tag
     /**
      * Search for an artist by name. Returns artist matches sorted by relevance.
      *
+     * @return Artist[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Artist[]
      */
     public function search(string $artist, int $limit = 50, int $page = 1): array;
 }

src/Service/ChartServiceInterface.php

@@ -22,30 +22,30 @@ interface ChartServiceInterface
     /**
      * Get the most popular artists on Last.fm.
      *
+     * @return ArtistInfo[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return ArtistInfo[]
      */
     public function getTopArtists(int $limit = 50, int $page = 1): array;
 
     /**
      * Get the most popular tags on Last.fm last week.
      *
+     * @return Tag[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Tag[]
      */
     public function getTopTags(int $limit = 50, int $page = 1): array;
 
     /**
      * Get the most popular tracks on Last.fm last week.
      *
+     * @return Song[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Song[]
      */
     public function getTopTracks(int $limit = 50, int $page = 1): array;
 }

src/Service/GeoServiceInterface.php

@@ -21,10 +21,10 @@ interface GeoServiceInterface
     /**
      * Get the most popular artists on Last.fm by country.
      *
+     * @return Artist[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Artist[]
      */
     public function getTopArtists(string $country, int $limit = 50, int $page = 1): array;
 
@@ -34,10 +34,10 @@ public function getTopArtists(string $country, int $limit = 50, int $page = 1):
      * @param string $location
      * @param int    $limit
      *
+     * @return Song[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Song[]
      */
     public function getTopTracks(string $country, string $location = null, $limit = 50, int $page = 1): array;
 }

src/Service/LibraryServiceInterface.php

@@ -20,10 +20,10 @@ interface LibraryServiceInterface
     /**
      * A paginated list of all the artists in a user's library, with play counts and tag counts.
      *
+     * @return AlbumInfo[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return AlbumInfo[]
      */
     public function getArtists(string $user, int $limit = 50, int $page = 1): array;
 }

src/Service/TagServiceInterface.php

@@ -35,60 +35,60 @@ public function getInfo(string $tag, string $lang = null): ?TagInfo;
     /**
      * Search for tags similar to this one. Returns tags ranked by similarity, based on listening data.
      *
+     * @return Tag[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Tag[]
      */
     public function getSimilar(string $tag): array;
 
     /**
      * Get the top albums tagged by this tag, ordered by tag count.
      *
+     * @return Album[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Album[]
      */
     public function getTopAlbums(string $tag, int $limit = 50, int $page = 1): array;
 
     /**
      * Get the top artists tagged by this tag, ordered by tag count.
      *
+     * @return Artist[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Artist[]
      */
     public function getTopArtists(string $tag, int $limit = 50, int $page = 1): array;
 
     /**
      * Fetches the top global tags on Last.fm, sorted by popularity (number of times used).
      *
+     * @return Tag[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Tag[]
      */
     public function getTopTags(): array;
 
     /**
      * Get the top tracks tagged by this tag, ordered by tag count.
      *
+     * @return Song[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Song[]
      */
     public function getTopTracks(string $tag, int $limit = 50, int $page = 1): array;
 
     /**
      * Get a list of available charts for this tag, expressed as date ranges which can be sent to the chart services.
      *
+     * @return Chart[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Chart[]
      */
     public function getWeeklyChartList(string $tag): array;
 }

src/Service/TrackServiceInterface.php

@@ -54,30 +54,30 @@ public function getInfo(TrackInfoBuilder $builder): ?SongInfo;
     /**
      * Get the similar tracks for this track on Last.fm, based on listening data.
      *
+     * @return SongInfo[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return SongInfo[]
      */
     public function getSimilar(SimilarTrackBuilder $builder): array;
 
     /**
      * Get the tags applied by an individual user to a track on Last.fm.
      *
+     * @return Tag[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Tag[]
      */
     public function getTags(TrackTagsBuilder $builder): array;
 
     /**
      * Get the top tags for this track on Last.fm, ordered by tag count.
      *
+     * @return Tag[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return Tag[]
      */
     public function getTopTags(TrackTopTagsBuilder $builder): array;
 
@@ -109,10 +109,10 @@ public function scrobble(SessionInterface $session, ScrobbeBuilder $builder): vo
     /**
      * Search for a track by track name. Returns track matches sorted by relevance.
      *
+     * @return SongInfo[]
+     *
      * @throws NotFoundException
      * @throws ApiException
-     *
-     * @return SongInfo[]
      */
     public function search(string $track, int $limit = 50, int $page = 1): array;