changes to support GetShow, GetShowEpisodes (#157)

Author: davidiola

page.go

@@ -94,6 +94,12 @@ type CategoryPage struct {
 	Categories []Category `json:"items"`
 }
 
+// SimpleEpisodePage contains EpisodePage returned by the Web API.
+type SimpleEpisodePage struct {
+	basePage
+	Episodes []EpisodePage `json:"items"`
+}
+
 // pageable is an internal interface for types that support paging
 // by embedding basePage.
 type pageable interface{ canPage() }

show.go

@@ -1,6 +1,7 @@
 package spotify
 
 import (
+	"net/url"
 	"strconv"
 	"strings"
 	"time"
@@ -20,7 +21,7 @@ type FullShow struct {
 	SimpleShow
 
 	// A list of the show’s episodes.
-	Episodes EpisodePage `json:"episode"`
+	Episodes SimpleEpisodePage `json:"episodes"`
 }
 
 // SimpleShow contains basic data about a show.
@@ -166,3 +167,69 @@ func (e *EpisodePage) ReleaseDateTime() time.Time {
 	year, _ := strconv.Atoi(e.ReleaseDate)
 	return time.Date(year, 1, 1, 0, 0, 0, 0, time.UTC)
 }
+
+// GetShow retrieves information about a specific show.
+// API reference: https://developer.spotify.com/documentation/web-api/reference/#endpoint-get-a-show
+func (c *Client) GetShow(id string) (*FullShow, error) {
+	return c.GetShowOpt(nil, id)
+}
+
+// GetShowOpt is like GetShow while supporting an optional market parameter.
+// API reference: https://developer.spotify.com/documentation/web-api/reference/#endpoint-get-a-show
+func (c *Client) GetShowOpt(opt *Options, id string) (*FullShow, error) {
+	spotifyURL := c.baseURL + "shows/" + id
+	if opt != nil {
+		v := url.Values{}
+		if opt.Country != nil {
+			v.Set("market", *opt.Country)
+		}
+		if params := v.Encode(); params != "" {
+			spotifyURL += "?" + params
+		}
+	}
+
+	var result FullShow
+
+	err := c.get(spotifyURL, &result)
+	if err != nil {
+		return nil, err
+	}
+
+	return &result, nil
+}
+
+// GetShowEpisodes retrieves paginated episode information about a specific show.
+// API reference: https://developer.spotify.com/documentation/web-api/reference/#endpoint-get-a-shows-episodes
+func (c *Client) GetShowEpisodes(id string) (*SimpleEpisodePage, error) {
+	return c.GetShowEpisodesOpt(nil, id)
+}
+
+// GetShowEpisodesOpt is like GetShowEpisodes while supporting optional market, limit, offset parameters.
+// API reference: https://developer.spotify.com/documentation/web-api/reference/#endpoint-get-a-shows-episodes
+func (c *Client) GetShowEpisodesOpt(opt *Options, id string) (*SimpleEpisodePage, error) {
+	spotifyURL := c.baseURL + "shows/" + id + "/episodes"
+	if opt != nil {
+		v := url.Values{}
+		if opt.Country != nil {
+			v.Set("market", *opt.Country)
+		}
+		if opt.Limit != nil {
+			v.Set("limit", strconv.Itoa(*opt.Limit))
+		}
+		if opt.Offset != nil {
+			v.Set("offset", strconv.Itoa(*opt.Offset))
+		}
+		if params := v.Encode(); params != "" {
+			spotifyURL += "?" + params
+		}
+	}
+
+	var result SimpleEpisodePage
+
+	err := c.get(spotifyURL, &result)
+	if err != nil {
+		return nil, err
+	}
+
+	return &result, nil
+}

show_test.go

@@ -0,0 +1,41 @@
+package spotify
+
+import (
+	"net/http"
+	"testing"
+)
+
+func TestGetShow(t *testing.T) {
+	c, s := testClientFile(http.StatusOK, "test_data/get_show.txt")
+	defer s.Close()
+
+	r, err := c.GetShow("1234")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if r.SimpleShow.Name != "Uncommon Core" {
+		t.Error("Invalid data:", r.Name)
+	}
+	if len(r.Episodes.Episodes) != 25 {
+		t.Error("Invalid data", len(r.Episodes.Episodes))
+	}
+}
+
+func TestGetShowEpisodes(t *testing.T) {
+	c, s := testClientFile(http.StatusOK, "test_data/get_show_episodes.txt")
+	defer s.Close()
+
+	r, err := c.GetShowEpisodes("1234")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if r.Total != 25 {
+		t.Error("Invalid data:", r.Total)
+	}
+	if r.Offset != 0 {
+		t.Error("Invalid data:", r.Offset)
+	}
+	if len(r.Episodes) != 25 {
+		t.Error("Invalid data", len(r.Episodes))
+	}
+}