pinterest-ruby 1.0.0

data/spec/cassettes/Pinterest_Endpoints_Users/_unfollow_interest/should_perform_the_call_and_return_an_error.yml

@@ -0,0 +1,48 @@
+---
+http_interactions:
+- request:
+    method: delete
+    uri: https://api.pinterest.com/v1/me/following/interests/905661505034/
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.10.1
+      Authorization:
+      - Bearer AVP99QpzwII-f1I2p5gyHi8CiCeQFJkDr8dP-JpDs-LEtAAyegAAAAA
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 404
+      message: NOT FOUND
+    headers:
+      Age:
+      - '0'
+      Cache-Control:
+      - private
+      Content-Type:
+      - application/json
+      X-Pinterest-Rid:
+      - '397753110523'
+      Content-Length:
+      - '51'
+      Date:
+      - Thu, 12 Jan 2017 11:59:45 GMT
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: |-
+        {
+          "message": "404: Not Found",
+          "type": "http"
+        }
+    http_version: 
+  recorded_at: Thu, 12 Jan 2017 11:59:45 GMT
+recorded_with: VCR 3.0.3

data/spec/cassettes/Pinterest_Endpoints_Users/_unfollow_user/should_complain_for_invalid_users.yml

@@ -0,0 +1,56 @@
+---
+http_interactions:
+- request:
+    method: delete
+    uri: https://api.pinterest.com/v1/me/following/users/invalid-user/
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.10.1
+      Authorization:
+      - Bearer AVP99QpzwII-f1I2p5gyHi8CiCeQFJkDr8dP-JpDs-LEtAAyegAAAAA
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 404
+      message: NOT FOUND
+    headers:
+      Access-Control-Allow-Origin:
+      - "*"
+      Age:
+      - '0'
+      Cache-Control:
+      - private
+      Content-Type:
+      - application/json
+      Pinterest-Generated-By:
+      - None
+      Pinterest-Version:
+      - d67cb4f
+      X-Content-Type-Options:
+      - nosniff
+      X-Pinterest-Rid:
+      - '885832408482'
+      X-Ratelimit-Limit:
+      - '200'
+      X-Ratelimit-Remaining:
+      - '136'
+      Content-Length:
+      - '45'
+      Date:
+      - Thu, 12 Jan 2017 11:59:43 GMT
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"message": "User not found.", "type": "api"}'
+    http_version: 
+  recorded_at: Thu, 12 Jan 2017 11:59:44 GMT
+recorded_with: VCR 3.0.3

data/spec/cassettes/Pinterest_Endpoints_Users/_unfollow_user/should_perform_the_call_and_return_true.yml

@@ -0,0 +1,109 @@
+---
+http_interactions:
+- request:
+    method: delete
+    uri: https://api.pinterest.com/v1/me/following/users/testerfb11/
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.10.1
+      Authorization:
+      - Bearer AVP99QpzwII-f1I2p5gyHi8CiCeQFJkDr8dP-JpDs-LEtAAyegAAAAA
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Origin:
+      - "*"
+      Age:
+      - '0'
+      Cache-Control:
+      - private
+      Content-Type:
+      - application/json
+      Pinterest-Generated-By:
+      - None
+      Pinterest-Version:
+      - d67cb4f
+      X-Content-Type-Options:
+      - nosniff
+      X-Pinterest-Rid:
+      - '771241865003'
+      X-Ratelimit-Limit:
+      - '200'
+      X-Ratelimit-Remaining:
+      - '138'
+      Content-Length:
+      - '14'
+      Date:
+      - Thu, 12 Jan 2017 11:59:43 GMT
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"data": null}'
+    http_version: 
+  recorded_at: Thu, 12 Jan 2017 11:59:43 GMT
+- request:
+    method: delete
+    uri: https://api.pinterest.com/v1/me/following/users/testerfb11/
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.10.1
+      Authorization:
+      - Bearer AVP99QpzwII-f1I2p5gyHi8CiCeQFJkDr8dP-JpDs-LEtAAyegAAAAA
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Origin:
+      - "*"
+      Age:
+      - '0'
+      Cache-Control:
+      - private
+      Content-Type:
+      - application/json
+      Pinterest-Generated-By:
+      - None
+      Pinterest-Version:
+      - d67cb4f
+      X-Content-Type-Options:
+      - nosniff
+      X-Pinterest-Rid:
+      - '337944503106'
+      X-Ratelimit-Limit:
+      - '200'
+      X-Ratelimit-Remaining:
+      - '137'
+      Content-Length:
+      - '14'
+      Date:
+      - Thu, 12 Jan 2017 11:59:43 GMT
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"data": null}'
+    http_version: 
+  recorded_at: Thu, 12 Jan 2017 11:59:43 GMT
+recorded_with: VCR 3.0.3

data/spec/cassettes/Pinterest_Endpoints_Users/_user/should_complain_for_non_existent_users.yml

@@ -0,0 +1,56 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.pinterest.com/v1/users/invalid-user/?fields=id,username,first_name,last_name,bio,created_at,counts,image
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.10.1
+      Authorization:
+      - Bearer AVP99QpzwII-f1I2p5gyHi8CiCeQFJkDr8dP-JpDs-LEtAAyegAAAAA
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 404
+      message: NOT FOUND
+    headers:
+      Access-Control-Allow-Origin:
+      - "*"
+      Age:
+      - '0'
+      Cache-Control:
+      - private
+      Content-Type:
+      - application/json
+      Pinterest-Generated-By:
+      - None
+      Pinterest-Version:
+      - d67cb4f
+      X-Content-Type-Options:
+      - nosniff
+      X-Pinterest-Rid:
+      - '641548778231'
+      X-Ratelimit-Limit:
+      - '200'
+      X-Ratelimit-Remaining:
+      - '149'
+      Content-Length:
+      - '45'
+      Date:
+      - Thu, 12 Jan 2017 11:59:39 GMT
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"message": "User not found.", "type": "api"}'
+    http_version: 
+  recorded_at: Thu, 12 Jan 2017 11:59:39 GMT
+recorded_with: VCR 3.0.3

data/spec/cassettes/Pinterest_Endpoints_Users/_user/should_get_the_current_informations.yml

@@ -0,0 +1,60 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.pinterest.com/v1/users/testerfb11/?fields=id,username,first_name,last_name,bio,created_at,counts,image
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.10.1
+      Authorization:
+      - Bearer AVP99QpzwII-f1I2p5gyHi8CiCeQFJkDr8dP-JpDs-LEtAAyegAAAAA
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Origin:
+      - "*"
+      Age:
+      - '0'
+      Cache-Control:
+      - private
+      Content-Type:
+      - application/json
+      Pinterest-Generated-By:
+      - None
+      Pinterest-Version:
+      - d67cb4f
+      X-Content-Type-Options:
+      - nosniff
+      X-Pinterest-Rid:
+      - '957602188200'
+      X-Ratelimit-Limit:
+      - '200'
+      X-Ratelimit-Remaining:
+      - '151'
+      Content-Length:
+      - '347'
+      Date:
+      - Thu, 12 Jan 2017 11:59:38 GMT
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"data": {"username": "testerfb11", "bio": "", "first_name": "Tester",
+        "last_name": "tes", "created_at": "2014-10-10T18:52:41", "image": {"60x60":
+        {"url": "https://s.pinimg.com/images/user/default_60.png", "width": 60, "height":
+        60}}, "counts": {"pins": 1835, "following": 2, "followers": 6, "boards": 18,
+        "likes": 9}, "id": "332914734862997577"}}'
+    http_version: 
+  recorded_at: Thu, 12 Jan 2017 11:59:39 GMT
+recorded_with: VCR 3.0.3

data/spec/cassettes/Pinterest_Endpoints_Users/_user/should_restrict_to_requested_fields.yml

@@ -0,0 +1,56 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.pinterest.com/v1/users/testerfb11/?fields=username
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.10.1
+      Authorization:
+      - Bearer AVP99QpzwII-f1I2p5gyHi8CiCeQFJkDr8dP-JpDs-LEtAAyegAAAAA
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Origin:
+      - "*"
+      Age:
+      - '0'
+      Cache-Control:
+      - private
+      Content-Type:
+      - application/json
+      Pinterest-Generated-By:
+      - None
+      Pinterest-Version:
+      - d67cb4f
+      X-Content-Type-Options:
+      - nosniff
+      X-Pinterest-Rid:
+      - '663120046495'
+      X-Ratelimit-Limit:
+      - '200'
+      X-Ratelimit-Remaining:
+      - '150'
+      Content-Length:
+      - '64'
+      Date:
+      - Thu, 12 Jan 2017 11:59:39 GMT
+      Connection:
+      - keep-alive
+    body:
+      encoding: UTF-8
+      string: '{"data": {"username": "testerfb11", "id": "332914734862997577"}}'
+    http_version: 
+  recorded_at: Thu, 12 Jan 2017 11:59:39 GMT
+recorded_with: VCR 3.0.3

data/spec/pinterest/client_spec.rb

@@ -0,0 +1,70 @@
+#
+# This file is part of the pinterest-ruby gem. Copyright (C) 2017 and above Shogun <shogun@cowtech.it>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+
+require "spec_helper"
+
+describe Pinterest::Client, vcr: true do
+  context "#initialize" do
+    it "should save the attributes and run the default block to setup the connection" do
+      expect_any_instance_of(Pinterest::Client).to receive(:default_connection_setup).and_call_original
+      subject = Pinterest::Client.new(access_token: "A", client_id: "B", client_secret: "C", verbose: "D")
+
+      expect(subject.access_token).to eq("A")
+      expect(subject.client_id).to eq("B")
+      expect(subject.client_secret).to eq("C")
+      expect(subject.verbose).to eq("D")
+      expect(subject.connection).to be_a(Faraday::Connection)
+      expect(subject.connection.url_prefix.to_s).to eq(::Pinterest::Client::API_URL + "/")
+    end
+
+    it "should run the default block" do
+      a = 1
+
+      Pinterest::Client.new(access_token: "A", client_id: "B", client_secret: "C", verbose: "D") do
+        a = 2
+      end
+
+      expect(a).to eq(2)
+    end
+  end
+
+  context "#ensure_array (private)" do
+    it "should return an array" do
+      subject = Pinterest::Client.new
+      expect(subject.send(:ensure_array, [])).to eq([])
+      expect(subject.send(:ensure_array, "a")).to eq(["a"])
+      expect(subject.send(:ensure_array, nil, "b")).to eq(["b"])
+    end
+  end
+
+  context "#ensure_param (private)" do
+    it "should check if parameter is present" do
+      subject = Pinterest::Client.new
+      expect(subject.send(:ensure_param, "a")).to be_truthy
+      expect(subject.send(:ensure_param, "")).to be_falsey
+      expect(subject.send(:ensure_param, " ")).to be_falsey
+      expect(subject.send(:ensure_param, nil)).to be_falsey
+      expect { subject.send(:ensure_param, "", "MESSAGE") }.to raise_error(ArgumentError, "MESSAGE")
+    end
+  end
+
+  context "#cleanup_params (private)" do
+    it "should remove keys which are not set" do
+      expect(Pinterest::Client.new.send(:cleanup_params, {a: 1, b: 2, c: nil, d: ""})).to eq({a: 1, b: 2})
+    end
+  end
+
+  context "#perform_network_request (private)" do
+    it "should correctly handle malformed requests" do
+      expect { subject.send(:perform_network_request, url: "/foo") }.to raise_error(Pinterest::Errors::NotFoundError, "[404] Invalid response from the server.")
+    end
+  end
+
+  context "#versioned_url (private)" do
+    it "should prepend version path to a URL" do
+      expect(Pinterest::Client.new.send(:versioned_url, "abc")).to eq("/v1/abc")
+    end
+  end
+end

data/spec/pinterest/collection_spec.rb

@@ -0,0 +1,82 @@
+#
+# This file is part of the pinterest-ruby gem. Copyright (C) 2017 and above Shogun <shogun@cowtech.it>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+
+require "spec_helper"
+
+describe Pinterest::Collection do
+  context "#initialize" do
+    it "should save limit and cursor" do
+      subject = Pinterest::Collection.new({}, "CURSOR", "LIMIT")
+      expect(subject.current_cursor).to eq("CURSOR")
+      expect(subject.limit).to eq("LIMIT")
+    end
+
+    it "should save the next_cursor" do
+      expect(Pinterest::Collection.new({}, "CURSOR", "LIMIT").next_cursor).to be_nil
+      expect(Pinterest::Collection.new({"page" => {"cursor" => "NEXT"}}, "CURSOR", "LIMIT").next_cursor).to eq("NEXT")
+    end
+
+    it "should save the records by applying the creator" do
+      subject = Pinterest::Collection.new({"data" => ["12", "34", "56"]}, "CURSOR", "LIMIT") { |r| r.reverse }
+      expect(subject.records).to eq(["21", "43", "65"])
+    end
+
+    it "should complain if invalid raw_data is passed" do
+      expect { Pinterest::Collection.new(nil, nil, nil) }.to raise_error(ArgumentError)
+    end
+  end
+
+  context "[]" do
+    it "should act as an array" do
+      expect(Pinterest::Collection.new({"data" => ["12", "34", "56"]}, "CURSOR", "LIMIT")[1]).to eq("34")
+    end
+  end
+
+  context "#size" do
+    it "should act as an array" do
+      expect(Pinterest::Collection.new({"data" => ["12", "34", "56"]}, "CURSOR", "LIMIT").size).to eq(3)
+    end
+  end
+
+  context "#current_page" do
+    it "should return the current cursor" do
+      expect(Pinterest::Collection.new({"data" => ["12", "34", "56"]}, "CURSOR", "LIMIT").current_page).to eq("CURSOR")
+    end
+  end
+
+  context "#next_page" do
+    it "should return the current cursor" do
+      expect(Pinterest::Collection.new({"page" => {"cursor" => "NEXT"}}, "CURSOR", "LIMIT").next_page).to eq("NEXT")
+    end
+  end
+
+  context "#empty?" do
+    it "should return whether the collection is empty" do
+      expect(Pinterest::Collection.new({"data" => ["12", "34", "56"]}, "CURSOR", "LIMIT").empty?).to be_falsey
+      expect(Pinterest::Collection.new({}, "CURSOR", "LIMIT").empty?).to be_truthy
+    end
+  end
+
+  context "#next?" do
+    it "should return whether the collection has more data on the server" do
+      expect(Pinterest::Collection.new({}, "CURSOR", "LIMIT").next?).to be_falsey
+      expect(Pinterest::Collection.new({"page" => {"cursor" => "NEXT"}}, "CURSOR", "LIMIT").next_cursor).to be_truthy
+    end
+  end
+
+  context "#as_json" do
+    it "should serialize the collection" do
+      subject = Pinterest::Collection.new({"data" => ["12", "34", "56"], "page" => {"cursor" => "NEXT"}}, "CURSOR", "LIMIT")
+      allow_any_instance_of(Array).to receive(:as_json){ |obj| obj }
+
+      expect(subject.as_json).to eq({
+        records: ["12", "34", "56"],
+        limit: "LIMIT",
+        current_cursor: "CURSOR",
+        next_cursor: "NEXT"
+      })
+    end
+  end
+end

data/spec/pinterest/endpoints/authentication_spec.rb

@@ -0,0 +1,81 @@
+#
+# This file is part of the pinterest-ruby gem. Copyright (C) 2017 and above Shogun <shogun@cowtech.it>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+
+require "spec_helper"
+
+describe Pinterest::Endpoints::Authentication, vcr: true do
+  subject {
+    Pinterest::Client.new(client_id: $pinterest_client_id, client_secret: $pinterest_client_secret)
+  }
+
+  context "#authorization_state" do
+    it "should return a string" do
+      expect(subject.authorization_state).to match(/^[a-f0-9]+$/)
+    end
+  end
+
+  context "#authorization_url" do
+    before(:each) do
+      allow(subject).to receive(:authorization_state).and_return("STATE")
+    end
+
+    it "should complain when mandatory arguments are missing" do
+      expect { Pinterest::Client.new.authorization_url }.to raise_error(ArgumentError, "You must specify the client_id.")
+      expect { subject.authorization_url }.to raise_error(ArgumentError, "You must specify the callback_url.")
+      expect { subject.authorization_url(1) }.to raise_error(ArgumentError, "callback_url must be a valid HTTPS URL.")
+      expect { subject.authorization_url("ABC") }.to raise_error(ArgumentError, "callback_url must be a valid HTTPS URL.")
+      expect { subject.authorization_url("http://google.it") }.to raise_error(ArgumentError, "callback_url must be a valid HTTPS URL.")
+    end
+
+    it "should return a valid URL requesting all scopes" do
+      expect(subject.authorization_url("https://localhost")).to eq(
+        "https://api.pinterest.com/oauth?authorization_state=STATE&client_id=#{$pinterest_client_id}&redirect_uri=https%3A%2F%2Flocalhost&response_type=code&scope=read_public%2Cwrite_public%2Cread_relationships%2Cwrite_relationships"
+      )
+    end
+
+    it "should return a valid URL requesting specified scopes and removing invalid ones" do
+      expect(subject.authorization_url("https://localhost", ["a", "read_public"])).to eq(
+        "https://api.pinterest.com/oauth?authorization_state=STATE&client_id=#{$pinterest_client_id}&redirect_uri=https%3A%2F%2Flocalhost&response_type=code&scope=read_public"
+      )
+    end
+  end
+
+  context "#fetch_access_token" do
+    it "should complain when mandatory arguments are missing" do
+      expect { Pinterest::Client.new.fetch_access_token("A") }.to raise_error(ArgumentError, "You must specify the client_id.")
+      expect { Pinterest::Client.new(client_id: $pinterest_client_id).fetch_access_token("A") }.to raise_error(ArgumentError, "You must specify the client_secret.")
+      expect { subject.fetch_access_token(nil) }.to raise_error(ArgumentError, "You must specify the authorization_token.")
+    end
+
+    it "should make the call to Pinterest and return the authorization token, also saving it" do
+      expect(subject.access_token).to be_nil
+      expect(subject.fetch_access_token("9568cec6cc78aa05")).to eq("AVP99QpzwII-f1I2p5gyHi8CiCeQFJkDr8dP-JpDs-LEtAAyegAAAAA")
+      expect(subject.access_token).to eq("AVP99QpzwII-f1I2p5gyHi8CiCeQFJkDr8dP-JpDs-LEtAAyegAAAAA")
+    end
+  end
+
+  context "#verify_access_token" do
+    it "should verify the token" do
+      subject.access_token = "AVP99QpzwII-f1I2p5gyHi8CiCeQFJkDr8dP-JpDs-LEtAAyegAAAAA"
+
+      expect(subject.verify_access_token).to eq({
+        application_id: $pinterest_client_id,
+        created_at: DateTime.civil(2017, 01, 12, 11, 44, 40),
+        scopes: ["read_public", "write_public", "read_relationships", "write_relationships"],
+        user_id: "559853934835925315"
+      })
+    end
+
+    it "should complain when no access token is set" do
+      expect { Pinterest::Client.new.fetch_access_token("A") }.to raise_error(ArgumentError, "You must specify the client_id.")
+      expect { subject.verify_access_token }.to raise_error(ArgumentError, "You must set the access token first.")
+    end
+
+    it "should return an exception when using an invalid token" do
+      subject.access_token = "A"
+      expect { subject.verify_access_token }.to raise_error(Pinterest::Errors::AuthorizationError)
+    end
+  end
+end