hotels_pro 0.2

data/lib/hotels_pro/underscorer.rb

@@ -0,0 +1,21 @@
+module HotelsPro
+  module Underscorer
+    # Detect nested hashes and underscore their keys
+    def underscore(object)
+      case object
+      when Hash
+        object.inject({}) do |hash, (k, v)|
+          hash[k.underscore] = underscore(v)
+          hash
+        end
+      when Array
+        object.inject([]) do |arr, element|
+          arr << underscore(element)
+          arr
+        end
+      else
+        object
+      end
+    end
+  end
+end

data/lib/hotels_pro/version.rb

@@ -0,0 +1,3 @@
+module HotelsPro
+  VERSION = "0.2"
+end

data/spec/api_params_helper.rb

@@ -0,0 +1,8 @@
+module ApiParamsHelper
+  def mock_api_object(attributes)
+    object = Object.new
+    object.extend HotelsPro::Api::ApiParams
+    object.stub(:attributes).and_return(attributes)
+    object
+  end
+end

data/spec/fixtures/allocate_hotel_code.json

@@ -0,0 +1 @@
+{"responseId":5752179,"hotelCode":"US6X5G","availableHotels":[{"processId":"HF-56017745","hotelCode":"US6X5G","availabilityStatus":"InstantConfirmation","totalPrice":335,"totalTax":0,"totalSalePrice":0,"currency":"USD","boardType":"Continental Breakfast","rooms":[{"roomCategory":"Double 1 Queen Bed","paxes":[{"paxType":"Adult","age":30}],"totalRoomRate":335,"ratesPerNight":[{"date":"2012-09-09","amount":112},{"date":"2012-09-10","amount":112},{"date":"2012-09-11","amount":111}]}]},{"processId":"HG-99198765","hotelCode":"US6X5G","availabilityStatus":"InstantConfirmation","totalPrice":392,"totalTax":0,"totalSalePrice":0,"currency":"USD","boardType":"Continental Breakfast","rooms":[{"roomCategory":"Double Two Queen Beds","paxes":[{"paxType":"Adult","age":30}],"totalRoomRate":392,"ratesPerNight":[{"date":"2012-09-09","amount":131},{"date":"2012-09-10","amount":131},{"date":"2012-09-11","amount":130}]}]}],"totalFound":2,"searchId":"VO-40164625"}

data/spec/fixtures/amend_hotel_booking.json

@@ -0,0 +1 @@
+{"responseId":5762113,"trackingId":"XI-HW-82431210","agencyReferenceNumber":"999","amendStatus":"Pending","note":"Your amendment request has been received. You will be contacted regarding amendment results by email or by message in our online system."}

data/spec/fixtures/cancel_hotel_booking.json

@@ -0,0 +1 @@
+{"responseId":5761559,"trackingId":"XI-HE-70838364","agencyReferenceNumber":"","bookingStatus":"Cancelled","note":"Booking has been cancelled successfully."}

data/spec/fixtures/get_available_hotel.json

@@ -0,0 +1 @@
+{"responseId":4214740,"availableHotels":[{"processId":"HM-99621850","hotelCode":"UKNZDJ","availabilityStatus":"InstantConfirmation","totalPrice":437,"totalTax":0,"totalSalePrice":0,"currency":"EUR","boardType":"English Breakfast","rooms":[{"roomCategory":"Triple Standard","paxes":[{"paxType":"Adult","age":30},{"paxType":"Adult","age":30},{"paxType":"Child","age":"6"}],"totalRoomRate":219,"ratesPerNight":[{"date":"2012-09-20","amount":0},{"date":"2012-09-21","amount":73},{"date":"2012-09-22","amount":73},{"date":"2012-09-23","amount":73}]},{"roomCategory":"Triple Standard","paxes":[{"paxType":"Adult","age":30},{"paxType":"Adult","age":30},{"paxType":"Child","age":"8"}],"totalRoomRate":218,"ratesPerNight":[{"date":"2012-09-20","amount":0},{"date":"2012-09-21","amount":73},{"date":"2012-09-22","amount":73},{"date":"2012-09-23","amount":72}]}]},{"processId":"HC-56363390","hotelCode":"UKSU69","availabilityStatus":"InstantConfirmation","totalPrice":471,"totalTax":0,"totalSalePrice":0,"currency":"EUR","boardType":"English Breakfast","rooms":[{"roomCategory":"Triple Standard","paxes":[{"paxType":"Adult","age":30},{"paxType":"Adult","age":30},{"paxType":"Child","age":"6"}],"totalRoomRate":235,"ratesPerNight":[{"date":"2012-09-20","amount":84},{"date":"2012-09-21","amount":0},{"date":"2012-09-22","amount":84},{"date":"2012-09-23","amount":67}]},{"roomCategory":"Triple Standard","paxes":[{"paxType":"Adult","age":30},{"paxType":"Adult","age":30},{"paxType":"Child","age":"8"}],"totalRoomRate":236,"ratesPerNight":[{"date":"2012-09-20","amount":84},{"date":"2012-09-21","amount":0},{"date":"2012-09-22","amount":84},{"date":"2012-09-23","amount":68}]}]}],"totalFound":2,"searchId":"SZ-91588250"}

data/spec/fixtures/get_balance.json

@@ -0,0 +1 @@
+{"responseId":5762226,"currency":"0.00","totalDeposit":"0.00","totalBookingAmount":"0.00","currentBalance":"0.00"}

data/spec/fixtures/get_hotel_booking_status.json

@@ -0,0 +1 @@
+{"responseId":5761428,"trackingId":"XI-HE-70838364","agencyReferenceNumber":null,"hotelBookingInfo":{"bookingStatus":5,"confirmationNumber":"TEST;0000000","hotelCode":"US2HZR","checkIn":"2012-10-04","checkOut":"2012-10-11","totalPrice":"528","currency":"EUR","totalSalePrice":0,"boardType":"Room Only","rooms":[{"roomCategory":"Double 1 Double Bed","paxes":[{"paxType":"Adult","age":30,"title":"Mr","firstName":"John","lastName":"Doe"},{"paxType":"Adult","age":30,"title":"Mrs","firstName":"Amanda","lastName":"Doe"}],"totalRoomRate":528,"ratesPerNight":[{"date":"2012-10-04","amount":75},{"date":"2012-10-05","amount":75},{"date":"2012-10-06","amount":75},{"date":"2012-10-07","amount":75},{"date":"2012-10-08","amount":75},{"date":"2012-10-09","amount":75},{"date":"2012-10-10","amount":78}]}],"cancellationPolicy":[{"cancellationDay":7,"feeType":"Night","feeAmount":"1","currency":null,"remarks":null},{"cancellationDay":0,"feeType":"Night","feeAmount":"1","currency":null,"remarks":null}],"agencyReferenceNumber":null,"comments":null}}

data/spec/fixtures/get_hotel_cancellation_policy.json

@@ -0,0 +1 @@
+{"responseId":5761637,"trackingId":"XI-HE-70838364","agencyReferenceNumber":"","cancellationPolicy":[{"cancellationDay":7,"feeType":"Night","feeAmount":"1","currency":null,"remarks":""},{"cancellationDay":0,"feeType":"Night","feeAmount":"1","currency":null,"remarks":""}]}

data/spec/fixtures/make_hotel_booking.json

@@ -0,0 +1 @@
+{"responseId":5756635,"trackingId":"XI-HE-70838364","hotelBookingInfo":{"bookingStatus":5,"confirmationNumber":"TEST;0000000","supplier":null,"hotelCode":"US2HZR","checkIn":"2012-10-04","checkOut":"2012-10-11","totalPrice":"528","currency":"EUR","totalSalePrice":0,"boardType":"Room Only","rooms":[{"roomCategory":"Double 1 Double Bed","paxes":[{"paxType":"Adult","age":30,"title":"Mr","firstName":"John","lastName":"Doe"},{"paxType":"Adult","age":30,"title":"Mrs","firstName":"Amanda","lastName":"Doe"}],"totalRoomRate":528,"ratesPerNight":[{"date":"2012-10-04","amount":75},{"date":"2012-10-05","amount":75},{"date":"2012-10-06","amount":75},{"date":"2012-10-07","amount":75},{"date":"2012-10-08","amount":75},{"date":"2012-10-09","amount":75},{"date":"2012-10-10","amount":78}]}],"cancellationPolicy":[{"cancellationDay":7,"feeType":"Amount","feeAmount":80,"currency":"EUR","remarks":"Guest must notify the Front Desk upon check-in if depature date has changed.Double rooms has one double bed."},{"cancellationDay":0,"feeType":"Amount","feeAmount":80,"currency":"EUR","remarks":""}],"agencyReferenceNumber":"","comments":""}}

data/spec/hotels_pro/api/api_method_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe HotelsPro::Api::ApiMethod do
+  let(:api_method) { HotelsPro::Api::ApiMethod.new }
+
+  it "should raise exception on error response" do
+    response = stub(:error? => true, :error => HotelsPro::ErrorResponse.new("Error occured."))
+    request  = stub(:perform => response)
+
+    api_method.stub(:request => request)
+
+    lambda { api_method.perform }.should raise_error(HotelsPro::ErrorResponse, "Error occured.")
+  end
+end

data/spec/hotels_pro/api/api_params_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe HotelsPro::Api::ApiParams do
+  include ApiParamsHelper
+
+  before do
+    @object = mock_api_object({ :param_one => "value1", :param_two => "value2", :param_three => nil, :param_four => [], :param_five => {} })
+  end
+
+  describe ".to_api_params" do
+    it "should stringify and camelize attribute name" do
+      @object.api_param_name(:param_one).should == "paramOne"
+    end
+
+    it "should only include attributes with non-empty values" do
+      @object.to_api_params.should == { "paramOne" => "value1", "paramTwo" => "value2" }
+    end
+
+    it "should try to call to_api_params on value" do
+      child_object = mock_api_object({ :param_one => "value1" })
+
+      @object.api_param_value(child_object).should == { "paramOne" => "value1" }
+    end
+
+    it "should try to call to_api_params on all elements of value if value is Array" do
+      child_object1 = mock_api_object({ :param_one => "value1" })
+      child_object2 = mock_api_object({ :param_two => "value2" })
+
+      @object.api_param_value([child_object1, child_object2]).should == [{ "paramOne" => "value1" }, { "paramTwo" => "value2" }]
+    end
+
+    it "should stringify attribute value if it does not respond to :to_api_params" do
+      @object.api_param_value(:value).should == "value"
+    end
+  end
+end

data/spec/hotels_pro/api/elements/pax_array_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe HotelsPro::Api::Elements::PaxArray do
+  it "should return array of Pax elemements as api params" do
+    pax_arr = HotelsPro::Api::Elements::PaxArray.new
+    pax1 = HotelsPro::Api::Elements::Pax.new
+    pax2 = HotelsPro::Api::Elements::Pax.new
+
+    pax_arr.paxes << pax1
+    pax_arr.paxes << pax2
+
+    pax_arr.to_api_params.should == [pax1.to_api_params, pax2.to_api_params]
+  end
+end

data/spec/hotels_pro/api/methods/allocate_hotel_code_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe HotelsPro::Api::Methods::AllocateHotelCode do
+  include RequestHelper
+
+  it "should build correct api params hash" do
+    method = HotelsPro::Api::Methods::AllocateHotelCode.new(
+      :search_id => "VO-40164625",
+      :hotel_code => "US6X5G"
+    )
+
+    method.to_api_params.should == {
+      "searchId" => "VO-40164625",
+      "hotelCode" => "US6X5G"
+    }
+  end
+
+  it "should return result when performed" do
+    HotelsPro::Stubs.allocate_hotel_code.response(fixture("allocate_hotel_code"))
+
+    method = HotelsPro::Api::Methods::AllocateHotelCode.new(
+      :search_id => "VO-40164625",
+      :hotel_code => "US6X5G"
+    )
+
+    result = method.perform
+
+    result.should be_instance_of HotelsPro::Api::Methods::AllocateHotelCode::Result
+    result.response_id.should == 5752179
+    result.total_found.should == 2
+    result.search_id.should == "VO-40164625"
+    result.hotel_code.should == "US6X5G"
+  end
+end

data/spec/hotels_pro/api/methods/amend_hotel_booking_spec.rb

@@ -0,0 +1,79 @@
+require 'spec_helper'
+
+describe HotelsPro::Api::Methods::AmendHotelBooking do
+  include RequestHelper
+
+  it "should build correct api params hash" do
+    method = HotelsPro::Api::Methods::AmendHotelBooking.new(
+      :tracking_id => "XI-HW-82431210",
+      :check_in => Date.parse("2012-10-05"),
+      :check_out => Date.parse("2012-10-12"),
+      :lead_traveller_info => HotelsPro::Api::Elements::LeadTraveller.new(
+        :pax_info => HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult", :title => "Mr", :first_name => "John", :last_name => "Doe"),
+        :nationality => "US"
+      ),
+      :rooms => [
+        HotelsPro::Api::Elements::PaxArray.new(
+          :paxes => [
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult", :title => "Mr", :first_name => "John", :last_name => "Doe"),
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult", :age => 30, :title => "Mrs", :first_name => "Amanda", :last_name => "Doe")
+          ]
+        )
+      ],
+      :preferences => "nonSmoking",
+      :note => "I don't like french fries"
+    )
+
+    method.to_api_params.should == {
+      "trackingId" => "XI-HW-82431210",
+      "checkIn" => "2012-10-05",
+      "checkOut" => "2012-10-12",
+      "leadTravellerInfo" => {
+        "paxInfo" => {
+          "paxType" => "Adult",
+          "title" => "Mr",
+          "firstName" => "John",
+          "lastName" => "Doe"
+        },
+        "nationality" => "US"
+      },
+      "rooms" => [
+        [{ "paxType" => "Adult", "title" => "Mr", "firstName" => "John", "lastName" => "Doe" }, { "paxType" => "Adult", "age" => "30", "title" => "Mrs", "firstName" => "Amanda", "lastName" => "Doe" }]
+      ],
+      "preferences" => "nonSmoking",
+      "note" => "I don't like french fries"
+    }
+  end
+
+  it "should return result when performed" do
+    HotelsPro::Stubs.amend_hotel_booking.response(fixture('amend_hotel_booking'))
+
+    method = HotelsPro::Api::Methods::AmendHotelBooking.new(
+      :tracking_id => "XI-HW-82431210",
+      :check_in => Date.parse("2012-10-05"),
+      :check_out => Date.parse("2012-10-12"),
+      :lead_traveller_info => HotelsPro::Api::Elements::LeadTraveller.new(
+        :pax_info => HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult", :title => "Mr", :first_name => "John", :last_name => "Doe"),
+        :nationality => "US"
+      ),
+      :rooms => [
+        HotelsPro::Api::Elements::PaxArray.new(
+          :paxes => [
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult", :title => "Mr", :first_name => "John", :last_name => "Doe"),
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult", :age => 30, :title => "Mrs", :first_name => "Amanda", :last_name => "Doe")
+          ]
+        )
+      ],
+      :preferences => "nonSmoking",
+      :note => "I don't like french fries"
+    )
+
+    result = method.perform
+
+    result.should be_instance_of HotelsPro::Api::Methods::AmendHotelBooking::Result
+    result.response_id.should == 5762113
+    result.tracking_id.should == "XI-HW-82431210"
+    result.amend_status.should == "Pending"
+    result.note.should == "Your amendment request has been received. You will be contacted regarding amendment results by email or by message in our online system."
+  end
+end

data/spec/hotels_pro/api/methods/cancel_hotel_booking_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe HotelsPro::Api::Methods::CancelHotelBooking do
+  include RequestHelper
+
+  it "should build correct api params hash" do
+    method = HotelsPro::Api::Methods::CancelHotelBooking.new(
+      :tracking_id => "XI-HE-70838364"
+    )
+
+    method.to_api_params.should == {
+      "trackingId" => "XI-HE-70838364"
+    }
+  end
+
+  it "should return result when performed" do
+    HotelsPro::Stubs.cancel_hotel_booking.response(fixture('cancel_hotel_booking'))
+
+    method = HotelsPro::Api::Methods::CancelHotelBooking.new(
+      :tracking_id => "XI-HE-70838364"
+    )
+
+    result = method.perform
+
+    result.should be_instance_of HotelsPro::Api::Methods::CancelHotelBooking::Result
+    result.response_id.should == 5761559
+    result.tracking_id.should == "XI-HE-70838364"
+    result.agency_reference_number.should be_empty
+    result.booking_status.should == "Cancelled"
+    result.note.should == "Booking has been cancelled successfully."
+  end
+end

data/spec/hotels_pro/api/methods/get_available_hotel_spec.rb

@@ -0,0 +1,83 @@
+require 'spec_helper'
+
+describe HotelsPro::Api::Methods::GetAvailableHotel do
+  include RequestHelper
+
+  it "should build correct api params hash" do
+    method = HotelsPro::Api::Methods::GetAvailableHotel.new(
+      :destination_id => "XXX",
+      :client_nationality => "US",
+      :currency => "EUR",
+      :check_in => Date.parse("2012-08-14"),
+      :check_out => Date.parse("2012-08-21"),
+      :rooms => [
+        HotelsPro::Api::Elements::PaxArray.new(
+          :paxes => [
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult"),
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult")
+          ]
+        ),
+        HotelsPro::Api::Elements::PaxArray.new(
+          :paxes => [
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult"),
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Child", :age => 10)
+          ]
+        )
+      ],
+      :filters => [
+        HotelsPro::Api::Elements::Filter.new(:filter_type => "hotelCode", :filter_value => "123"),
+        HotelsPro::Api::Elements::Filter.new(:filter_type => "limit", :filter_value => "10")
+      ]
+    )
+
+    method.to_api_params.should == {
+      "destinationId" => "XXX",
+      "clientNationality" => "US",
+      "currency" => "EUR",
+      "checkIn" => "2012-08-14",
+      "checkOut" => "2012-08-21",
+      "rooms" => [
+        [{ "paxType" => "Adult" }, { "paxType" => "Adult" }],
+        [{ "paxType" => "Adult" }, { "paxType" => "Child", "age" => "10" }]
+      ],
+      "filters" => [
+        { "filterType" => "hotelCode", "filterValue" => "123" },
+        { "filterType" => "limit", "filterValue" => "10" }
+      ],
+      "onRequest" => "true"
+    }
+  end
+
+  it "should return result when performed" do
+    HotelsPro::Stubs.get_available_hotel.response(fixture("get_available_hotel"))
+
+    method = HotelsPro::Api::Methods::GetAvailableHotel.new(
+      :destination_id => "XXX",
+      :client_nationality => "US",
+      :currency => "EUR",
+      :check_in => Date.parse("2012-08-14"),
+      :check_out => Date.parse("2012-08-21"),
+      :rooms => [
+        HotelsPro::Api::Elements::PaxArray.new(
+          :paxes => [
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult"),
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult")
+          ]
+        ),
+        HotelsPro::Api::Elements::PaxArray.new(
+          :paxes => [
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Adult"),
+            HotelsPro::Api::Elements::Pax.new(:pax_type => "Child", :age => 10)
+          ]
+        )
+      ]
+    )
+
+    result = method.perform
+
+    result.should be_instance_of HotelsPro::Api::Methods::GetAvailableHotel::Result
+    result.response_id.should == 4214740
+    result.total_found.should == 2
+    result.search_id.should == "SZ-91588250"
+  end
+end

data/spec/hotels_pro/api/methods/get_balance_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe HotelsPro::Api::Methods::GetBalance do
+  include RequestHelper
+
+  it "should build correct api params hash" do
+    method = HotelsPro::Api::Methods::GetBalance.new()
+
+    method.to_api_params.should == {}
+  end
+
+  it "should return result when performed" do
+    HotelsPro::Stubs.get_balance.response(fixture('get_balance'))
+
+    method = HotelsPro::Api::Methods::GetBalance.new()
+
+    result = method.perform
+
+    result.should be_instance_of HotelsPro::Api::Methods::GetBalance::Result
+    result.response_id.should == 5762226
+    result.currency.should == "0.00"
+    result.total_deposit.should == 0
+    result.total_booking_amount.should == 0
+    result.current_balance.should == 0
+  end
+end

data/spec/hotels_pro/api/methods/get_hotel_booking_status_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe HotelsPro::Api::Methods::GetHotelBookingStatus do
+  include RequestHelper
+
+  it "should build correct api params hash" do
+    method = HotelsPro::Api::Methods::GetHotelBookingStatus.new(
+      :tracking_id => "XI-HE-70838364"
+    )
+
+    method.to_api_params.should == {
+      "trackingId" => "XI-HE-70838364"
+    }
+  end
+
+  it "should return result when performed" do
+    HotelsPro::Stubs.get_hotel_booking_status.response(fixture('get_hotel_booking_status'))
+
+    method = HotelsPro::Api::Methods::GetHotelBookingStatus.new(
+      :tracking_id => "XI-HE-70838364"
+    )
+
+    result = method.perform
+
+    result.should be_instance_of HotelsPro::Api::Methods::GetHotelBookingStatus::Result
+    result.response_id.should == 5761428
+    result.tracking_id.should == "XI-HE-70838364"
+    result.hotel_booking_info.should be_instance_of HotelsPro::Api::Elements::BookInfo
+    result.hotel_booking_info.hotel_code.should == "US2HZR"
+  end
+end

data/spec/hotels_pro/api/methods/get_hotel_cancellation_policy_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe HotelsPro::Api::Methods::GetHotelCancellationPolicy do
+  include RequestHelper
+
+  it "should build correct api params hash" do
+    method = HotelsPro::Api::Methods::GetHotelCancellationPolicy.new(
+      :tracking_id => "XI-HE-70838364"
+    )
+
+    method.to_api_params.should == {
+      "trackingId" => "XI-HE-70838364"
+    }
+  end
+
+  it "should return result when performed" do
+    HotelsPro::Stubs.get_hotel_cancellation_policy.response(fixture('get_hotel_cancellation_policy'))
+
+    method = HotelsPro::Api::Methods::GetHotelCancellationPolicy.new(
+      :tracking_id => "XI-HE-70838364"
+    )
+
+    result = method.perform
+
+    result.should be_instance_of HotelsPro::Api::Methods::GetHotelCancellationPolicy::Result
+    result.response_id.should == 5761637
+    result.tracking_id.should == "XI-HE-70838364"
+    result.agency_reference_number.should be_empty
+    result.cancellation_policy.size.should == 2
+  end
+end