Merge pull request #24 from unsplash/feature/featured-collections

Add featured collections method.

README.md

@@ -604,6 +604,26 @@ unsplash.collections.listCuratedCollections(1, 10)
 ```
 ---
 
+### collections.listFeaturedCollections(page, perPage)
+Get a single page from the list of featured collections.
+
+__Arguments__
+
+| Argument | Type | Opt/Required |
+|---|---|---|
+|__`page`__|_number_|Optional|
+|__`perPage`__|_number_|Optional|
+
+__Example__
+```js
+unsplash.collections.listFeaturedCollections(1, 10)
+  .then(toJson)
+  .then(json => {
+    // Your code
+  });
+```
+---
+
 ### collections.getCollection(id)
 Retrieve a single collection. To view a user’s private collections, the `read_collections` scope is required.
 

src/methods/collections.js

@@ -31,6 +31,20 @@ export default function collections(): Object {
       });
     },
 
+    listFeaturedCollections: (page: number = 1, perPage: number = 10) => {
+      const url = "/collections/featured";
+      const query = {
+        page,
+        per_page: perPage
+      };
+
+      return this.request({
+        url: url,
+        method: "GET",
+        query
+      });
+    },
+
     getCollection: collection.bind(this, false),
 
     getCuratedCollection: collection.bind(this, true),

test/unsplash-test.js

@@ -602,6 +602,23 @@ describe("Unsplash", () => {
       });
     });
 
+    describe("listFeaturedCollections", () => {
+      it("should make a GET request to /collections/featured", () => {
+        let spy = spyOn(unsplash, "request");
+        unsplash.collections.listFeaturedCollections(2, 15);
+
+        expect(spy.calls.length).toEqual(1);
+        expect(spy.calls[0].arguments).toEqual([{
+          method: "GET",
+          url: "/collections/featured",
+          query: {
+            page: 2,
+            per_page: 15
+          }
+        }]);
+      });
+    });
+
     describe("getCollection", () => {
       it("should make a GET request to /collections/{id}", () => {
         let spy = spyOn(unsplash, "request");