pactas_itero 0.2.0

data/spec/pactas_itero/api/invoices_spec.rb

@@ -0,0 +1,87 @@
+require 'spec_helper'
+
+describe PactasItero::Api::Invoices do
+  describe '.invoices' do
+    it 'requests the correct resource' do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_get('/api/v1/invoices').
+      to_return(
+      body: fixture('invoices.json'),
+      headers: { content_type: 'application/json; charset=utf-8'}
+      )
+
+      client.invoices
+
+      expect(request).to have_been_made
+    end
+
+    it 'returns an array of contracts' do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_get('/api/v1/invoices').
+      to_return(
+      body: fixture('invoices.json'),
+      headers: { content_type: 'application/json; charset=utf-8'}
+      )
+
+      invoices = client.invoices
+
+      expect(invoices).to be_a Array
+    end
+  end
+
+  describe '.invoices_from' do
+    it 'requests the correct resource' do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_get('/api/v1/invoices?from=54b67d9e995ec90bc8f37718').
+      to_return(
+      body: fixture('invoices.json'),
+      headers: { content_type: 'application/json; charset=utf-8'}
+      )
+
+      client.invoices_from('54b67d9e995ec90bc8f37718')
+
+      expect(request).to have_been_made
+    end
+
+    it 'requests the correct resource, if from parameter is nil' do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_get('/api/v1/invoices').
+      to_return(
+      body: fixture('invoices.json'),
+      headers: { content_type: 'application/json; charset=utf-8'}
+      )
+
+      client.invoices_from(nil)
+
+      expect(request).to have_been_made
+    end
+
+    it 'returns an array of contracts' do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_get('/api/v1/invoices?from=54b67d9e995ec90bc8f37718').
+      to_return(
+      body: fixture('invoices.json'),
+      headers: { content_type: 'application/json; charset=utf-8'}
+      )
+
+      invoices = client.invoices_from('54b67d9e995ec90bc8f37718')
+
+      expect(invoices).to be_a Array
+    end
+  end
+
+  describe '.invoice' do
+    it 'requests the correct resource' do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_get('/api/v1/invoices/54b67d9e995ec90bc8f37718').
+      to_return(
+      body: fixture('invoice.json'),
+      headers: { content_type: 'application/json; charset=utf-8'}
+      )
+
+      client.invoice('54b67d9e995ec90bc8f37718')
+
+      expect(request).to have_been_made
+    end
+  end
+end

data/spec/pactas_itero/api/oauth_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+describe PactasItero::Api::OAuth do
+
+  describe '#token' do
+    before do
+      stub_post("https://a_client_id:a_client_secret@sandbox.billwerk.com/oauth/token").with(
+        :body => { :grant_type => 'client_credentials' }
+      ).to_return(
+        :status => 200,
+        :body => fixture('bearer_token.json'),
+        :headers => {
+          :content_type => 'application/json; charset=utf-8'
+        }
+      )
+    end
+
+    it 'requests the correct resource' do
+      client = PactasItero::Client.new(client_id: 'a_client_id', client_secret: 'a_client_secret')
+
+      client.token
+
+      expect(a_post("https://a_client_id:a_client_secret@sandbox.billwerk.com/oauth/token").with(
+        :body => "grant_type=client_credentials",
+        :headers => {
+          'Content-Type'=>'application/x-www-form-urlencoded; charset=UTF-8'
+        }
+      )).to have_been_made
+    end
+
+    it 'returns the bearer token' do
+      client = PactasItero::Client.new(client_id: 'a_client_id', client_secret: 'a_client_secret')
+      bearer_token = client.token
+
+      expect(bearer_token.access_token).to eq('top_secret_access_token')
+      expect(bearer_token.token_type).to eq('bearer')
+      expect(bearer_token.expires).to eq(0)
+    end
+  end
+end

data/spec/pactas_itero/api/orders_spec.rb

@@ -0,0 +1,102 @@
+require 'spec_helper'
+
+describe PactasItero::Api::Orders do
+  describe ".create_order" do
+    it "requests the correct resource" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      post_data = {
+        ContractId: "5370e5ab9e40071fd01e01e0",
+        Cart: {
+          PlanVariantId: "525bf9089e40073a58590fd5"
+        }
+      }.to_json
+      request = stub_post('/api/v1/orders').
+        with(body: post_data).
+        to_return(
+          body: fixture('create_order_response.json'),
+          headers: { content_type: 'application/json; charset=utf-8'}
+        )
+
+      client.create_order(
+        contract_id: "5370e5ab9e40071fd01e01e0",
+        cart: {
+          plan_variant_id: "525bf9089e40073a58590fd5"
+        }
+      )
+
+      expect(request).to have_been_made
+    end
+
+    it 'returns the created order' do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      post_data = {
+        ContractId: "5370e5ab9e40071fd01e01e0",
+        Cart: {
+          PlanVariantId: "525bf9089e40073a58590fd5"
+        }
+      }.to_json
+      request = stub_post('/api/v1/orders').
+        with(body: post_data).
+        to_return(
+          body: fixture('create_order_response.json'),
+          headers: { content_type: 'application/json; charset=utf-8'}
+        )
+
+      order = client.create_order(
+        contract_id: "5370e5ab9e40071fd01e01e0",
+        cart: {
+          plan_variant_id: "525bf9089e40073a58590fd5"
+        }
+      )
+
+      expect(order.id).to eq '537dfcab9e400760b4cd6347'
+      expect(order.contract_id).to eq '5370e5ab9e40071fd01e01e0'
+    end
+  end
+
+  describe '.order' do
+    it 'requests the correct resource' do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_get('/api/v1/orders/5357bc4f1d8dd00fa0db6c31').
+      to_return(
+        body: fixture('order.json'),
+        headers: { content_type: 'application/json; charset=utf-8'}
+      )
+
+      client.order('5357bc4f1d8dd00fa0db6c31')
+
+      expect(request).to have_been_made
+    end
+  end
+
+  describe ".commit_order" do
+    it "requests the correct resource" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_post('/api/v1/orders/537dfcab9e400760b4cd6347/commit').
+        with(body: {}.to_json).
+        to_return(
+          body: fixture('commit_order_response.json'),
+          headers: { content_type: 'application/json; charset=utf-8'}
+        )
+
+      client.commit_order('537dfcab9e400760b4cd6347')
+
+      expect(request).to have_been_made
+    end
+
+    it 'returns the updated contract' do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_post('/api/v1/orders/537dfcab9e400760b4cd6347/commit').
+        with(body: {}.to_json).
+        to_return(
+          body: fixture('commit_order_response.json'),
+          headers: { content_type: 'application/json; charset=utf-8'}
+        )
+
+      contract = client.commit_order('537dfcab9e400760b4cd6347')
+
+      expect(contract.id).to eq '5370e5ab9e40071fd01e01e0'
+      expect(contract.current_phase.plan_variant_id).to eq '525bf9089e40073a58590fd5'
+    end
+  end
+end

data/spec/pactas_itero/api/rated_items_spec.rb

@@ -0,0 +1,74 @@
+require 'spec_helper'
+
+describe PactasItero::Api::RatedItems do
+  describe ".create_rated_item" do
+    it "requests the correct resource" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      post_data = {
+        PeriodStart: '2014-09-19T08:18:51.907Z',
+        PeriodEnd: '2014-09-19T08:19:51.907Z',
+        Quantity: 2,
+        Description: 'the description',
+        PricePerUnit: 123.45,
+        TaxPolicyId: 'tax-policy-id',
+      }.to_json
+      request = stub_post('/api/v1/contracts/contract-id/ratedItems').
+      with(body: post_data).
+      to_return(
+        body: fixture('create_rated_item.json'),
+        headers: { content_type: 'application/json; charset=utf-8'}
+      )
+
+      client.create_rated_item(
+        'contract-id',
+        2,
+        'the description',
+        123.45,
+        'tax-policy-id',
+        {
+          period_start: "2014-09-19T08:18:51.907Z",
+          period_end: "2014-09-19T08:19:51.907Z"
+        }
+      )
+
+      expect(request).to have_been_made
+    end
+
+    it 'returns the created rated item' do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      post_data = {
+        PeriodStart: '2014-09-19T08:18:51.907Z',
+        PeriodEnd: '2014-09-19T08:19:51.907Z',
+        Quantity: 2,
+        Description: 'the description',
+        PricePerUnit: 123.45,
+        TaxPolicyId: 'tax-policy-id',
+      }.to_json
+      request = stub_post('/api/v1/contracts/contract-id/ratedItems').
+      with(body: post_data).
+      to_return(
+        body: fixture('create_rated_item.json'),
+        headers: { content_type: 'application/json; charset=utf-8'}
+      )
+
+      rated_item = client.create_rated_item(
+        'contract-id',
+        2,
+        'the description',
+        123.45,
+        'tax-policy-id',
+        {
+          period_start: "2014-09-19T08:18:51.907Z",
+          period_end: "2014-09-19T08:19:51.907Z"
+        }
+      )
+
+      expect(rated_item.description).to eq 'the description'
+      expect(rated_item.period_end).to eq '2014-09-19T08:18:51.907Z'
+      expect(rated_item.period_start).to eq '2014-09-19T08:18:51.907Z'
+      expect(rated_item.price_per_unit).to eq 123.45
+      expect(rated_item.quantity).to eq 2
+      expect(rated_item.tax_policy_id).to eq 'tax-policy-id'
+    end
+  end
+end

data/spec/pactas_itero/client_spec.rb

@@ -0,0 +1,316 @@
+require 'spec_helper'
+require 'json'
+
+describe PactasItero::Client do
+
+  before do
+    PactasItero.reset!
+  end
+
+  describe "module configuration" do
+
+    before do
+      PactasItero.configure do |config|
+        PactasItero::Configurable.keys.each do |key|
+          config.send("#{key}=", "the #{key} value")
+        end
+      end
+    end
+
+    it "inherits the module configuration" do
+      client = PactasItero::Client.new
+
+      PactasItero::Configurable.keys.each do |key|
+        expect(client.instance_variable_get(:"@#{key}")).to eq("the #{key} value")
+      end
+    end
+
+    describe "with class level configuration" do
+
+      before do
+        @opts = {
+          #connection_options: {ssl: {verify: false}},
+          client_id:    "the_client_id",
+          client_secret: "the_client_secret"
+        }
+      end
+
+      it "overrides module configuration" do
+        client = PactasItero::Client.new(@opts)
+
+        expect(client.client_id).to eq("the_client_id")
+        expect(client.client_secret).to eq("the_client_secret")
+        expect(client.user_agent).to eq(PactasItero.user_agent)
+      end
+
+      it "can set configuration after initialization" do
+        client = PactasItero::Client.new
+        client.configure do |config|
+          @opts.each do |key, value|
+            config.send("#{key}=", value)
+          end
+        end
+
+        expect(client.client_id).to eq("the_client_id")
+        expect(client.client_secret).to eq("the_client_secret")
+        expect(client.user_agent).to eq(PactasItero.user_agent)
+      end
+    end
+  end
+
+  describe ".get" do
+    it "requests the given resource using get" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_get("/something?foo=bar")
+
+      client.get "/something", foo: "bar"
+
+      expect(request).to have_been_made
+    end
+
+    it "passes along request headers" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_get("/").
+        with(query: { foo: "bar" }, headers: { accept: "text/plain" })
+      client.get "/", foo: "bar", accept: "text/plain"
+
+      expect(request).to have_been_made
+    end
+  end
+
+  describe ".head" do
+    it "requests the given resource using head" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_head("/something?foo=bar")
+
+      client.head "/something", foo: "bar"
+
+      expect(request).to have_been_made
+    end
+
+    it "passes along request headers" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_head("/").
+        with(query: { foo: "bar" }, headers: { accept: "text/plain" })
+
+      client.head "/", foo: "bar", accept: "text/plain"
+
+      expect(request).to have_been_made
+    end
+  end
+
+  describe ".post" do
+    it "requests the given resource using post" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_post("/something").
+        with(body: { foo: "bar" }.to_json)
+
+      client.post "/something", foo: "bar"
+
+      expect(request).to have_been_made
+    end
+
+    it "passes along request headers" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      headers = { "X-Foo" => "bar" }
+      request = stub_post("/").
+        with(body: { foo: "bar" }.to_json, headers: headers)
+
+      client.post "/", foo: "bar", headers: headers
+
+      expect(request).to have_been_made
+    end
+  end
+
+  describe ".put" do
+    it "requests the given resource using put" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_put("/something").
+        with(body: { foo: "bar" }.to_json)
+
+      client.put "/something", foo: "bar"
+
+      expect(request).to have_been_made
+    end
+
+    it "passes along request headers" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      headers = { "X-Foo" => "bar" }
+      request = stub_put("/").
+        with(body: { foo: "bar" }.to_json, headers: headers)
+
+      client.put "/", foo: "bar", headers: headers
+
+      expect(request).to have_been_made
+    end
+  end
+
+  describe ".patch" do
+    it "requests the given resource using patch" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_patch("/something").
+        with(body: { foo: "bar" }.to_json)
+
+      client.patch "/something", foo: "bar"
+
+      expect(request).to have_been_made
+    end
+
+    it "passes along request headers" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      headers = { "X-Foo" => "bar" }
+      request = stub_patch("/").
+        with(body: { foo: "bar" }.to_json, headers: headers)
+
+      client.patch "/", foo: "bar", headers: headers
+
+      expect(request).to have_been_made
+    end
+  end
+
+  describe ".delete" do
+    it "requests the given resource using delete" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_delete("/something")
+
+      client.delete "/something"
+
+      expect(request).to have_been_made
+    end
+
+    it "passes along request headers" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      headers = { "X-Foo" => "bar" }
+      request = stub_delete("/").with(headers: headers)
+
+      client.delete "/", headers: headers
+
+      expect(request).to have_been_made
+    end
+  end
+
+  describe "when making requests" do
+
+    it 'uses the sandbox endpoint by default' do
+      client = PactasItero::Client.new
+
+      expect(client.api_endpoint).to eq "https://sandbox.billwerk.com/"
+    end
+
+    it "uses the production endpoint when production is set to true" do
+      client = PactasItero::Client.new(production: true)
+
+      expect(client.api_endpoint).to eq 'https://itero.pactas.com/'
+    end
+
+    it "sets a default user agent" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      request = stub_get("/").
+        with(headers: { user_agent: PactasItero::Default.user_agent })
+
+      client.get "/"
+
+      expect(request).to have_been_made
+    end
+
+    it "accepts a custom user agent" do
+      user_agent = "Mozilla/1.0 (Win3.1)"
+      client = PactasItero::Client.new(user_agent: user_agent, bearer_token: 'bt')
+      request = stub_get("/").with(headers: { user_agent: user_agent })
+
+      client.get "/"
+
+      expect(request).to have_been_made
+    end
+
+    it 'creates the correct auth headers with supplied bearer_token' do
+      token = 'the_bearer_token'
+      request = stub_get("/").with(headers: { authorization: "Bearer #{token}" })
+      client = PactasItero::Client.new(bearer_token: token)
+
+      client.get "/"
+
+      expect(request).to have_been_made
+    end
+
+    it 'creates the correct auth headers with supplied bearer_token' do
+      token = OpenStruct.new(access_token: 'the_bearer_token')
+      client = PactasItero::Client.new(bearer_token: token)
+
+      request = stub_get("/").with(headers: { authorization: "Bearer #{token.access_token}" })
+
+      client.get "/"
+
+      expect(request).to have_been_made
+    end
+  end
+
+  context "error handling" do
+    it "raises on 404" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      stub_get('/four_oh_four').to_return(status: 404)
+
+      expect { client.get('/four_oh_four') }.to raise_error PactasItero::NotFound
+    end
+
+    it "raises on 500" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      stub_get('/five_oh_oh').to_return(status: 500)
+
+      expect { client.get('/five_oh_oh') }.to raise_error PactasItero::InternalServerError
+    end
+
+    it "includes a message" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      stub_get('/with_message').to_return(
+        status: 422,
+        headers: { content_type: "application/json" },
+        body: { Message: "'Something' is not a valid ObjectId. Expected a 24 digit hex string." }.to_json
+      )
+
+      expect { client.get('/with_message') }.to raise_error(
+        PactasItero::UnprocessableEntity,
+        "GET https://sandbox.billwerk.com/with_message: " \
+          "422 - 'Something' is not a valid ObjectId. Expected a 24 digit hex string.",
+      )
+    end
+
+    it "raises a ClientError on unknown client errors" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      stub_get('/something').to_return(
+        status: 418,
+        headers: { content_type: "application/json" },
+        body: { message: "I'm a teapot" }.to_json
+      )
+
+      expect { client.get('/something') }.to raise_error PactasItero::ClientError
+    end
+
+    it "raises a ServerError on unknown server errors" do
+      client = PactasItero::Client.new(bearer_token: 'bt')
+      stub_get('/something').to_return(
+        status: 509,
+        headers: { content_type: "application/json" },
+        body: { message: "Bandwidth exceeded" }.to_json
+      )
+
+      expect { client.get('/something') }.to raise_error PactasItero::ServerError
+    end
+  end
+
+  describe '.sandbox_api_endpoint' do
+    it 'returns url of the sandbox endpoint' do
+      client = PactasItero::Client.new
+
+      expect(client.sandbox_api_endpoint).to eq "https://sandbox.billwerk.com"
+    end
+  end
+
+  describe '.production_api_endpoint' do
+    it 'returns url of the sandbox endpoint' do
+      client = PactasItero::Client.new
+
+      expect(client.production_api_endpoint).to eq 'https://itero.pactas.com'
+    end
+  end
+end

data/spec/pactas_itero_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe PactasItero do
+
+  it "sets defaults" do
+    PactasItero::Configurable.keys.each do |key|
+      expect(PactasItero.instance_variable_get(:"@#{key}")).to eq(PactasItero::Default.send(key))
+    end
+  end
+
+  describe ".client" do
+    it "creates an PactasItero::Client" do
+      expect(PactasItero.client).to be_kind_of PactasItero::Client
+    end
+
+    it "creates new client everytime" do
+      expect(PactasItero.client).to_not eq(PactasItero.client)
+    end
+  end
+
+  describe ".configure" do
+    PactasItero::Configurable.keys.each do |key|
+      it "sets the #{key.to_s.gsub('_', ' ')}" do
+        PactasItero.configure do |config|
+          config.send("#{key}=", key)
+        end
+        expect(PactasItero.instance_variable_get(:"@#{key}")).to eq(key)
+      end
+    end
+  end
+
+end