Allow artist and album endpoints to filter by wishlist

src/MusicCatalogue.Api/Controllers/AlbumsController.cs

@@ -18,6 +18,11 @@ public AlbumsController(IMusicCatalogueFactory factory)
             _factory = factory;
         }
 
+        /// <summary>
+        /// Return album details given an ID
+        /// </summary>
+        /// <param name="id"></param>
+        /// <returns></returns>
         [HttpGet]
         [Route("{id}")]
         public async Task<ActionResult<Album>> GetAlbumByIdAsync(int id)
@@ -32,11 +37,28 @@ public async Task<ActionResult<Album>> GetAlbumByIdAsync(int id)
             return album;
         }
 
+        /// <summary>
+        /// Return a list of albums for the specified artist, filtering for items that are on/not on
+        /// the wishlist based on the arguments
+        /// </summary>
+        /// <param name="artistId"></param>
+        /// <param name="wishlist"></param>
+        /// <returns></returns>
         [HttpGet]
-        [Route("artist/{artistId}")]
-        public async Task<ActionResult<IEnumerable<Album>>> GetAlbumsByArtistAsync(int artistId)
+        [Route("artist/{artistId}/{wishlist}")]
+        public async Task<ActionResult<IEnumerable<Album>>> GetAlbumsByArtistAsync(int artistId, bool wishlist)
         {
-            List<Album> albums = await _factory.Albums.ListAsync(x => x.ArtistId == artistId);
+            List<Album> albums;
+
+            // Get the albums matching the specified criteria - the wish list flag is either null, false or true
+            if (wishlist)
+            {
+                albums = await _factory.Albums.ListAsync(x => (x.ArtistId == artistId) && (x.IsWishListItem == true));
+            }
+            else
+            {
+                albums = await _factory.Albums.ListAsync(x => (x.ArtistId == artistId) && (x.IsWishListItem != true));
+            }
 
             if (!albums.Any())
             {
@@ -47,7 +69,7 @@ public async Task<ActionResult<IEnumerable<Album>>> GetAlbumsByArtistAsync(int a
         }
 
         /// <summary>
-        /// 
+        /// Update an album from a template contained in the request body
         /// </summary>
         /// <param name="template"></param>
         /// <returns></returns>
@@ -75,6 +97,11 @@ public async Task<ActionResult<Album>> UpdateAlbumAsync([FromBody] Album templat
             return album;
         }
 
+        /// <summary>
+        /// Delete an album and its tracks given an album ID
+        /// </summary>
+        /// <param name="id"></param>
+        /// <returns></returns>
         [HttpDelete]
         [Route("{id}")]
         public async Task<IActionResult> DeleteAlbum(int id)

src/MusicCatalogue.Api/Controllers/ArtistsController.cs

@@ -18,13 +18,31 @@ public ArtistsController(IMusicCatalogueFactory factory)
             _factory = factory;
         }
 
+        /// <summary>
+        /// Return a list of all the artists in the catalogue
+        /// </summary>
+        /// <returns></returns>
         [HttpGet]
-        [Route("")]
-        public async Task<ActionResult<List<Artist>>> GetArtistsAsync()
+        [Route("{wishlist:bool}")]
+        public async Task<ActionResult<List<Artist>>> GetArtistsAsync(bool wishlist)
         {
             // Get a list of all artists in the catalogue
             List<Artist> artists = await _factory.Artists.ListAsync(x => true);
 
+            // The artist list includes the albums by that artist, so where an artist has any albums
+            // filter them according to the wish list filter
+            foreach (var artist in artists)
+            {
+                if ((artist.Albums != null) && artist.Albums.Any())
+                {
+                    var filtered = artist.Albums.Where(x => (x.IsWishListItem ?? false) == wishlist).ToList();
+                    artist.Albums = filtered;
+                }
+            }
+
+            // Remove any artists with no albums
+            artists.RemoveAll(x => (x.Albums == null) || ((x.Albums != null) && !x.Albums.Any()));
+
             // If there are no artists, return a no content response
             if (!artists.Any())
             {
@@ -37,8 +55,13 @@ public async Task<ActionResult<List<Artist>>> GetArtistsAsync()
             return artists;
         }
 
+        /// <summary>
+        /// Return artist details given an artist ID
+        /// </summary>
+        /// <param name="id"></param>
+        /// <returns></returns>
         [HttpGet]
-        [Route("{id}")]
+        [Route("{id:int}")]
         public async Task<ActionResult<Artist>> GetArtistByIdAsync(int id)
         {
             var artist = await _factory.Artists.GetAsync(x => x.Id == id);