Merge pull request #37 from hbagdi/user-statistics

Add GET /users/:id/statistics
hbagdi · Oct 22, 2017 · cd8b3a5 · cd8b3a5
2 parents ea39a37 + 26f2aac
commit cd8b3a5
Show file tree

Hide file tree

Showing 3 changed files with 104 additions and 0 deletions.
diff --git a/unsplash/user.go b/unsplash/user.go
@@ -141,3 +141,47 @@ func (u *UserUpdateInfo) String() string {
 
 	return buf.String()
 }
+
+// UserStatistics represents statistics like downloads, views and likes of an unsplash user
+type UserStatistics struct {
+	Username  string `json:"username"`
+	Downloads struct {
+		Total      int `json:"total"`
+		Historical struct {
+			Change     int    `json:"change"`
+			Average    int    `json:"average"`
+			Resolution string `json:"resolution"`
+			Quantity   int    `json:"quantity"`
+			Values     []struct {
+				Date  string `json:"date"`
+				Value int    `json:"value"`
+			} `json:"values"`
+		} `json:"historical"`
+	} `json:"downloads"`
+	Views struct {
+		Total      int `json:"total"`
+		Historical struct {
+			Change     int    `json:"change"`
+			Average    int    `json:"average"`
+			Resolution string `json:"resolution"`
+			Quantity   int    `json:"quantity"`
+			Values     []struct {
+				Date  string `json:"date"`
+				Value int    `json:"value"`
+			} `json:"values"`
+		} `json:"historical"`
+	} `json:"views"`
+	Likes struct {
+		Total      int `json:"total"`
+		Historical struct {
+			Change     int    `json:"change"`
+			Average    int    `json:"average"`
+			Resolution string `json:"resolution"`
+			Quantity   int    `json:"quantity"`
+			Values     []struct {
+				Date  string `json:"date"`
+				Value int    `json:"value"`
+			} `json:"values"`
+		} `json:"historical"`
+	} `json:"likes"`
+}
diff --git a/unsplash/users_service.go b/unsplash/users_service.go
@@ -116,3 +116,32 @@ func (us *UsersService) Collections(username string, opt *ListOpt) (*[]Collectio
 	endpoint := fmt.Sprintf("%v/%v/%v", getEndpoint(users), username, getEndpoint(collections))
 	return s.getCollections(opt, endpoint)
 }
+
+// Statistics return a stats about a photo with id.
+func (us *UsersService) Statistics(username string, opt *StatsOpt) (*UserStatistics, *Response, error) {
+	if "" == username {
+		return nil, nil, &IllegalArgumentError{ErrString: "Photo ID cannot be null"}
+	}
+	if opt == nil {
+		opt = defaultStatsOpt
+	}
+	if !opt.Valid() {
+		return nil, nil, &InvalidStatsOptError{ErrString: "opt provided is not valid."}
+	}
+	endpoint := fmt.Sprintf("%v/%v/statistics", getEndpoint(users), username)
+	req, err := newRequest(GET, endpoint, opt, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+	cli := (service)(*us)
+	resp, err := cli.do(req)
+	if err != nil {
+		return nil, nil, err
+	}
+	var stats UserStatistics
+	err = json.Unmarshal(*resp.body, &stats)
+	if err != nil {
+		return nil, nil, err
+	}
+	return &stats, resp, nil
+}
diff --git a/unsplash/users_service_test.go b/unsplash/users_service_test.go
@@ -98,6 +98,37 @@ func TestUserPortfolio(T *testing.T) {
 	assert.Equal(true, ok)
 }
 
+func TestUserStatistics(T *testing.T) {
+	assert := assert.New(T)
+	log.SetOutput(ioutil.Discard)
+	unsplash := setup()
+	stats, resp, err := unsplash.Users.Statistics("lukechesser", nil)
+	assert.Nil(err)
+	assert.NotNil(stats)
+	assert.NotNil(resp)
+	assert.NotNil(30, stats.Downloads.Historical.Quantity)
+	log.Println(stats)
+
+	stats, resp, err = unsplash.Users.Statistics("lukechesser", &StatsOpt{Quantity: 10})
+	assert.Nil(err)
+	assert.NotNil(stats)
+	assert.NotNil(resp)
+	assert.NotNil(30, stats.Downloads.Historical.Quantity)
+	log.Println(stats)
+
+	stats, resp, err = unsplash.Users.Statistics("lukechesser", &StatsOpt{Resolution: "sd"})
+	assert.NotNil(err)
+	assert.Nil(resp)
+
+	stats, resp, err = unsplash.Users.Statistics("lukechesser", &StatsOpt{Quantity: 31})
+	assert.NotNil(err)
+	assert.Nil(resp)
+
+	stats, resp, err = unsplash.Users.Statistics("", nil)
+	assert.Nil(stats)
+	assert.Nil(resp)
+	assert.NotNil(err)
+}
 func TestLikedPhotos(T *testing.T) {
 	assert := assert.New(T)
 	log.SetOutput(ioutil.Discard)