lce 0.0.1

data/spec/fixtures/quotes/request/empty_quote

@@ -0,0 +1,15 @@
+HTTP/1.1 500 Internal Server Error
+Server: nginx/1.6.0
+Date: Tue, 12 Aug 2014 12:59:10 GMT
+Content-Type: application/json
+Content-Length: 471
+Connection: keep-alive
+
+{
+  "status":"failure",
+  "error":{
+    "type":"internal",
+    "message":"quote[shipper] is missing, quote[shipper][country] is missing, quote[shipper][postal_code] is missing, quote[shipper][city] is missing, quote[recipient] is missing, quote[recipient][country] is missing, quote[recipient][is_a_company] is missing, quote[recipient][postal_code] is missing, quote[recipient][city] is missing, quote[parcels] is missing"
+  },
+  "self":"https://test.lce.io/v1/quotes"
+}

data/spec/fixtures/quotes/request/missing_params

@@ -0,0 +1,15 @@
+HTTP/1.1 500 Internal Server Error
+Server: nginx/1.6.0
+Date: Wed, 13 Aug 2014 12:47:00 GMT
+Content-Type: application/json
+Content-Length: 156
+Connection: keep-alive
+
+{
+  "status":"failure",
+  "error":{
+    "type":"internal",
+    "message":"quote[recipient][city] is missing"
+  },
+  "self":"https://test.lce.io/v1/quotes"
+}

data/spec/lce/client_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe Lce::Client do
+  describe "#http_adapter" do
+    it "uses default faraday's adapter as a default" do
+      expect(subject.http_adapter).to be(Faraday.default_adapter)
+
+    end
+  end
+  describe "#host" do
+    it 'returns the correct host for the staging environment' do
+      expect(subject.host).to eql('https://test.lce.io')
+    end
+
+    it 'returns the correct host for the production environment' do
+      Lce.configuration.environment = :production
+      expect(subject.host).to eql('https://api.lce.io')
+    end
+  end
+  describe "#api version" do
+    it 'returns a string of the API version' do
+      expect(subject.api_version).to eql('v1')
+    end
+    it 'needs a valid version' do
+      Lce.configuration.api_version = 'api_version'      
+      expect { subject.api_version }.to raise_error(Lce::Client::Errors::VersionError)
+    end    
+  end  
+  describe "#path" do
+    it 'returns a root path as default' do
+      expect(subject.send(:path).to_s).to eql('/')
+    end
+    context 'with a resource' do
+      it 'returns a path with aversion and a resource' do
+        Lce.configuration.api_version = 1
+        expect(subject.send(:path, :quotes).to_s).to eql('/v1/quotes')
+      end
+
+    end
+  end    
+end

data/spec/lce/offer_spec.rb

@@ -0,0 +1,85 @@
+require 'spec_helper'
+
+describe Lce::Offer do
+  before do
+    Lce.configure do |config|
+      config.environment = :staging
+      config.login = 'login'
+      config.password = 'password'
+      config.logger.level = Logger::FATAL
+    end              
+  end
+  describe ".find" do 
+    let(:id) {'ff75b691-a2e0-46b0-9909-d529b2dbb90c'}
+    it 'returns an offer' do
+      stub_request(:get, "https://login:password@test.lce.io/v1/offers/#{id}")
+        .to_return(fixture('offers/find/found'))
+      expect(Lce::Offer.find(id).id).to eql(id)    
+    end
+    context 'inexistant offer' do 
+      let(:id) {'ff75b691-a2e0-46b0-9909-d529b2dbb90d'}
+      it 'raise an exception' do
+        stub_request(:get, "https://login:password@test.lce.io/v1/offers/#{id}")
+          .to_return(fixture('offers/find/not_found'))
+        expect{Lce::Offer.find(id).id}.to raise_error(Lce::Client::Errors::LceError, 'Offer not found')
+      end    
+    end
+  end    
+  describe "#place_order" do 
+    let(:id) {'ff75b691-a2e0-46b0-9909-d529b2dbb90c'}
+    let(:params) {
+      {
+        shipper: {name: "Firstname Lastname", street: "street", phone: "+33699999999", email: "support@lce.io"},
+        recipient: {name: "Firstname Lastname", street: "street", phone: "+33699999999", email: "support@lce.io"},
+        parcels: []
+      }
+    }    
+    let(:request_params) {
+      params.merge(offer_id: id)
+    }       
+    it 'places an order for this offer' do
+      stub_request(:get, "https://login:password@test.lce.io/v1/offers/#{id}")
+        .to_return(fixture('offers/find/found'))
+        
+      stub_request(:post, "https://login:password@test.lce.io/v1/orders")
+        .with(:body => {order: request_params})
+        .to_return(fixture('orders/place/created'))
+      offer = Lce::Offer.find(id)
+      order = offer.place_order(params)
+      expect(order).to be_a(Lce::Order)
+    end
+  end    
+
+  describe "#available_delivery_locations" do 
+    let(:params) {
+      {
+        street: "37 Avenue Jean Médecin",
+        city: "Nice"        
+      }
+    }       
+    context 'when the product doesn\'t support preset delivery locations' do 
+      let(:id) {'ff75b691-a2e0-46b0-9909-d529b2dbb90c'}
+      it 'returns an empty array' do
+        stub_request(:get, "https://login:password@test.lce.io/v1/offers/#{id}")
+          .to_return(fixture('offers/find/found'))    
+      
+        offer = Lce::Offer.find(id)
+        expect(offer.available_delivery_locations(params).count).to eql(0)
+      end
+    end
+    context 'when the product support preset delivery locations' do
+      let(:id) {'563aeac0-4a88-4269-b9b7-48964a8678f0'}
+      let(:quote_id) {'cd8d1a03-bfec-4115-87ef-8f8ba91a7199'}
+      
+      it 'looks for available delivery locations for delivery in shop' do
+        stub_request(:get, "https://login:password@test.lce.io/v1/quotes/#{quote_id}")
+          .to_return(fixture('quotes/find/found'))    
+        stub_request(:get, "https://login:password@test.lce.io/v1/offers/#{id}/available_delivery_locations?location%5Bcity%5D=Nice&location%5Bstreet%5D=37%20Avenue%20Jean%20M%C3%A9decin")
+          .to_return(fixture('offers/available_delivery_locations/found'))      
+        offer = Lce::Quote.find(quote_id).offers.select{|o| o.id == id}.first
+        expect(offer.available_delivery_locations(params).count).to eql(23)
+      end
+    end    
+  end   
+  
+end

data/spec/lce/order_spec.rb

@@ -0,0 +1,136 @@
+require 'spec_helper'
+
+describe Lce::Order do
+  before do
+    Lce.configure do |config|
+      config.environment = :staging
+      config.login = 'login'
+      config.password = 'password'
+      config.logger.level = Logger::FATAL
+    end              
+  end
+
+  describe '.place' do 
+    context "with invalid parameters" do    
+      it "raises an error on an empty order" do
+        stub_request(:post, "https://login:password@test.lce.io/v1/orders")
+          .with(:body => '{"order":{}}')
+          .to_return(fixture('orders/place/empty_params'))
+          
+        expect{ Lce::Order.place({})}.to raise_error(Lce::Client::Errors::LceError)
+      end
+
+      it "raises an error with missing params" do
+        params = {
+          shipper: {name: "Firstname Lastname", street: "street", phone: "+33699999999", email: "support@lce.io"},
+          recipient: {name: "Firstname Lastname", street: "street", phone: "+33699999999", email: "support@lce.io"},
+          parcels: []
+        }      
+      
+        stub_request(:post, "https://login:password@test.lce.io/v1/orders")
+          .with(:body => {order: params})
+          .to_return(fixture('orders/place/missing_params'))
+          
+        expect{ Lce::Order.place(params)}.to raise_error(Lce::Client::Errors::LceError, 'order[offer_id] is missing')
+      end
+    end
+    context "with valid parameters" do
+      let(:params) {
+        {
+          offer_id: "ff75b691-a2e0-46b0-9909-d529b2dbb90c",
+          shipper: {name: "Firstname Lastname", street: "street", phone: "+33699999999", email: "support@lce.io"},
+          recipient: {name: "Firstname Lastname", street: "street", phone: "+33699999999", email: "support@lce.io"},
+          parcels: []
+        }
+      }
+      it "creates an order" do
+        stub_request(:post, "https://login:password@test.lce.io/v1/orders")
+          .with(:body => {order: params})
+          .to_return(fixture('orders/place/created'))
+        expect(Lce::Order.place(params)).to be_a(Lce::Order)
+      end
+    end               
+  end
+  
+  describe ".find" do 
+    let(:id) {'8c43a2e1-a7ff-49fd-807e-3877d6dadc28'}
+    it 'returns an order' do
+      stub_request(:get, "https://login:password@test.lce.io/v1/orders/#{id}")
+        .to_return(fixture('orders/find/found'))
+      expect(Lce::Order.find(id).id).to eql(id)    
+    end
+    context 'inexistant order' do 
+      let(:id) {'8c43a2e1-a7ff-49fd-807e-3877d6dadc29'}
+      it 'raises an error' do
+        stub_request(:get, "https://login:password@test.lce.io/v1/orders/#{id}")
+          .to_return(fixture('orders/find/not_found'))
+        expect{Lce::Order.find(id).id}.to raise_error(Lce::Client::Errors::LceError, 'Order not found')
+      end    
+    end
+  end  
+  describe ".all" do 
+    before do 
+      stub_request(:get, "https://login:password@test.lce.io/v1/orders")
+        .to_return(fixture('orders/all/page_1'))            
+    end
+    it 'returns all orders' do
+      expect(Lce::Order.all.size).to eql(1)    
+    end
+    
+    it 'returns order object' do
+      expect(Lce::Order.all.first).to be_a(Lce::Order)    
+    end
+    
+    it 'returns a paginated array' do
+      expect(Lce::Order.all).to be_a(PaginatedArray)
+    end    
+    it 'returns total count' do
+      expect(Lce::Order.all.total_count).to eql(1)
+    end    
+    it 'returns current_page' do
+      expect(Lce::Order.all.current_page).to eql(1)
+    end    
+    it 'returns page size' do
+      expect(Lce::Order.all.per_page).to eql(25)
+    end    
+
+  end 
+  
+  describe "#labels" do 
+    let(:id) {'8c43a2e1-a7ff-49fd-807e-3877d6dadc28'}
+    it 'returns the labels for this order' do
+      stub_request(:get, "https://login:password@test.lce.io/v1/orders/#{id}")
+        .to_return(fixture('orders/find/found'))
+      stub_request(:get, "https://login:password@test.lce.io/v1/orders/#{id}/labels.pdf")
+        .to_return(fixture('orders/labels/response'))                
+        
+      order = Lce::Order.find(id)
+      labels_file = File.read('spec/fixtures/orders/labels/labels.pdf', {mode: 'rb' })
+      expect(order.labels).to eql(labels_file)
+    end      
+  end    
+
+  describe "#tracking" do 
+    let(:id) {'8c43a2e1-a7ff-49fd-807e-3877d6dadc28'}
+    it 'returns the tracking for this order' do
+      stub_request(:get, "https://login:password@test.lce.io/v1/orders/#{id}")
+        .to_return(fixture('orders/find/found'))
+      stub_request(:get, "https://login:password@test.lce.io/v1/orders/#{id}/tracking")
+        .to_return(fixture('orders/tracking'))                       
+        
+      tracking_events_by_parcel = [{
+        "parcel_index"=>0,
+        "events"=> [{
+          "code"=>"shipment_created",
+          "happened_at"=>"2014-08-19T16:41:00+02:00",
+          "label"=>{"fr"=>"Expédition créée", "en"=>"Shipment created"},
+          "location"=>{"name"=>"Web Services"}
+        }]
+      }]      
+                  
+      order = Lce::Order.find(id)
+      expect(order.tracking).to eql(tracking_events_by_parcel)
+    end      
+  end  
+    
+end

data/spec/lce/quote_spec.rb

@@ -0,0 +1,111 @@
+require 'spec_helper'
+
+describe Lce::Quote do
+  before do
+    Lce.configure do |config|
+      config.environment = :staging
+      config.login = 'login'
+      config.password = 'password'
+      config.logger.level = Logger::FATAL
+    end              
+  end
+  describe ".request" do  
+    context "with invalid parameters" do
+      it "raises an error on an empty quote" do
+      
+        stub_request(:post, "https://login:password@test.lce.io/v1/quotes")
+          .with(:body => '{"quote":{}}')
+          .to_return(fixture('quotes/request/empty_quote'))
+          
+        expect{ Lce::Quote.request({})}.to raise_error(Lce::Client::Errors::LceError)
+      end
+
+      it "raises an error with missing params" do
+        
+        params = {
+          shipper: {country: 'FR', postal_code: '31300', city: 'Toulouse'},
+          recipient: {country: 'FR', postal_code: '06000', is_a_company: true},
+          parcels: [{length: 15, width: 15, height: 15, weight: 2}]
+        }
+        
+        stub_request(:post, "https://login:password@test.lce.io/v1/quotes")
+          .with(:body => {quote: params})
+          .to_return(fixture('quotes/request/missing_params'))
+          
+        expect{ Lce::Quote.request(params)}.to raise_error(Lce::Client::Errors::LceError, 'quote[recipient][city] is missing')
+      end
+    end  
+    context "with valid parameters" do
+      let(:params) {
+        {
+          shipper: {country: 'FR', postal_code: '31300', city: 'Toulouse'},
+          recipient: {country: 'FR', postal_code: '06000', city: 'Nice',is_a_company: true},
+          parcels: [{length: 15, width: 15, height: 15, weight: 2}]
+        }
+      }
+      it "creates a quote" do
+        stub_request(:post, "https://login:password@test.lce.io/v1/quotes")
+          .with(:body => {quote: params})
+          .to_return(fixture('quotes/request/created'))
+        expect(Lce::Quote.request(params)).to be_a(Lce::Quote)
+      end
+    end    
+  end
+  describe ".find" do 
+    let(:id) {'cd8d1a03-bfec-4115-87ef-8f8ba91a7199'}
+    it 'returns a quote' do
+      stub_request(:get, "https://login:password@test.lce.io/v1/quotes/#{id}")
+        .to_return(fixture('quotes/find/found'))
+      expect(Lce::Quote.find(id).id).to eql(id)    
+    end
+    context 'inexistant quote' do 
+      let(:id) {'cd8d1a03-bfec-4115-87ef-8f8ba91a7198'}
+      it 'returns a quote' do
+        stub_request(:get, "https://login:password@test.lce.io/v1/quotes/#{id}")
+          .to_return(fixture('quotes/find/not_found'))
+        expect{Lce::Quote.find(id).id}.to raise_error(Lce::Client::Errors::LceError, 'Quote not found')
+      end    
+    end
+  end  
+  describe ".all" do 
+    before do 
+      stub_request(:get, "https://login:password@test.lce.io/v1/quotes")
+        .to_return(fixture('quotes/all/page_1'))            
+    end
+    it 'returns all quotes' do
+      expect(Lce::Quote.all.size).to eql(25)    
+    end
+    
+    it 'returns quote object' do
+      expect(Lce::Quote.all.first).to be_a(Lce::Quote)    
+    end
+    
+    it 'returns a paginated array' do
+      expect(Lce::Quote.all).to be_a(PaginatedArray)
+    end    
+    it 'returns total count' do
+      expect(Lce::Quote.all.total_count).to eql(29)
+    end    
+    it 'returns current_page' do
+      expect(Lce::Quote.all.current_page).to eql(1)
+    end    
+    it 'returns page size' do
+      expect(Lce::Quote.all.per_page).to eql(25)
+    end    
+    context 'with a second page' do
+      before do 
+        stub_request(:get, "https://login:password@test.lce.io/v1/quotes?page=2")
+          .to_return(fixture('quotes/all/page_2'))            
+      end
+      it 'returns all quotes' do
+        expect(Lce::Quote.all(2).size).to eql(4)    
+      end
+      it 'returns total count' do
+        expect(Lce::Quote.all(2).total_count).to eql(29)
+      end    
+      it 'returns current_page' do
+        expect(Lce::Quote.all(2).current_page).to eql(2)
+      end    
+    end
+  end    
+end

data/spec/lce_spec.rb

@@ -0,0 +1,109 @@
+require 'spec_helper'
+
+describe Lce do
+  describe ".configure" do
+   
+    it 'has a configuration' do
+      Lce.reset
+      expect(Lce.configuration).to be_a(Lce::Configuration)
+    end
+   
+    it 'has a default environment' do
+      Lce.reset
+      expect(Lce.configuration.environment).to be :staging
+    end
+
+    it 'raises an exception when an environment is not supported'  do
+      expect { Lce.configuration.environment = :jungle }.to raise_error
+    end
+
+    it 'doesn\'t have a default login'do
+      Lce.reset
+      expect(Lce.configuration.login).to be_nil
+    end
+
+    it 'has a default application name' do
+      Lce.reset
+      expect(Lce.configuration.application).to eql 'ruby-lce'
+    end
+
+    it 'uses the gem\'s version as its default' do
+      Lce.reset
+      expect(Lce.configuration.version).to be Lce::VERSION
+    end
+
+    
+    it 'doesn\'t have a default password' do
+      Lce.reset    
+      expect(Lce.configuration.password).to be_nil
+    end
+
+    context 'when configuration is overridden locally' do
+      before do
+        Lce.configure do |config|
+          config.environment = :production
+          config.login = 'login'
+          config.password = 'password'
+          config.application = 'My Great App'
+          config.version = 'E.32.R526'          
+        end         
+      end
+      
+      it 'can override default values' do
+        expect(Lce.configuration.environment).to be :production
+      end
+
+      it 'can set a login' do
+        expect(Lce.configuration.login).to eq('login')
+      end
+      
+      it 'can set a password' do
+        expect(Lce.configuration.password).to eq('password')
+      end
+
+      it 'customizes app name but retains the gem\'s name' do
+        expect(Lce.configuration.application).to eq("My Great App (ruby-lce)")
+      end      
+
+      it 'customizes app version but retains the gem\'s version' do
+        expect(Lce.configuration.version).to eq("E.32.R526 (#{Lce::VERSION})")
+      end      
+
+    end      
+  end
+  describe '.check' do 
+    context 'without authentication' do
+      before do
+        Lce.configure do |config|
+          config.environment = :staging
+          config.login = nil
+          config.password = nil
+          config.logger.level = Logger::FATAL
+        end             
+      end
+      it 'raises an AccessDenied exception when not authenticated properly' do
+        stub_request(:get, "https://test.lce.io/").to_return(fixture('access_denied'))
+        expect {Lce.check}.to raise_error Lce::Client::Errors::AccessDenied
+      end
+    end
+    context 'with authentication' do
+      before do
+        Lce.configure do |config|
+          config.environment = :staging
+          config.login = 'login'
+          config.password = 'password'
+          config.logger.level = Logger::FATAL
+        end              
+      end
+      it 'raises an AccountDisabled exception when account is disabled' do
+        stub_request(:get, "https://login:password@test.lce.io/").to_return(fixture('account_disabled'))
+        expect {Lce.check}.to raise_error Lce::Client::Errors::AccountDisabled
+      end    
+      it 'return a description of the service' do    
+        stub_request(:get, "https://login:password@test.lce.io/").to_return(fixture('check'))
+        expect(Lce.check.host).to eql('test.lce.io')
+      end    
+    end    
+
+  end
+end