hostconnect 0.1.7

data/CHANGELOG

@@ -0,0 +1,8 @@
+v0.1.7 Updated copyright information
+v0.1.6 Correct handling of prices
+v0.1.5 Fixed floating point bug
+v0.1.4 Additional features
+v0.1.3 Bugfixes
+v0.1.2 Minor revision
+v0.1.1 Minor revision
+v0.1.0 Test release

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2007-2010 Bjørn Arild Mæland
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,16 @@
+# Library for connecting to hostConnect
+
+## Notes
+* All variables passing in/out of hostConnect via XML are written in CapitalCamelCase.
+  We, however, use snake_case for all parameters/attributes.
+* Variables that are to be defined zero or more times, should be passed in as an array.
+  For example ":opt => ['LONAC????????????', 'MAN??????????????']"
+* For requests that return multiple results (i.e OptionInfo), we supply a size method to
+  display the number of results.
+
+## Dev docs
+* hostConnect API doc: http://www.tourplan.com/support/Connector/hostConnect_2_04_170.html
+* Builder: http://builder.rubyforge.org/
+
+## License
+Copyright (c) 2007-2010 Bjørn Arild Mæland. See MIT-LICENSE for details.

data/Rakefile

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+require 'rubygems'
+require 'rake'
+require 'spec/rake/spectask'
+require 'rake/rdoctask'
+require 'echoe'
+
+PROJECT = 'hostconnect'
+
+Echoe.new(PROJECT) do |p|
+  p.author = "Bjørn Arild Mæland"
+  p.summary = "Library for interfacing with Tourplan's hostConnect software,
+which is a web service interface for tour booking."
+  p.url = "http://www.github.com/Chrononaut/hostconnect/"
+  p.dependencies = ["activesupport", "hpricot", "builder", "rtf"]
+  p.ignore_pattern = FileList[".gitignore"]
+  p.include_rakefile = true
+end
+
+task :default => 'spec'
+
+desc "Run specifications"
+Spec::Rake::SpecTask.new('spec') do |t|
+  t.spec_opts = ["--format", "specdoc", "--colour"]
+  t.spec_files = FileList[(ENV['FILES'] || 'spec/**/*_spec.rb')]
+  unless ENV["NO_RCOV"]
+    #t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec']
+  end
+end
+
+desc "Create spec docs"
+Spec::Rake::SpecTask.new('spec_docs') do |t|
+  t.spec_opts = ["--format", "html:spec_docs.html"]
+  t.spec_files = FileList[(ENV['FILES'] || 'spec/**/*_spec.rb')]
+end
+
+DOCUMENTED_FILES = FileList['README.markdown', 'MIT-LICENSE', 'lib/**/*.rb']
+
+desc "Generate Documentation"
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title = "HostConnect"
+  rdoc.options << '--line-numbers' << '--inline-source' << '--main' << 'README.markdown'
+  rdoc.rdoc_files.include(*DOCUMENTED_FILES)
+end

data/hostconnect.gemspec

@@ -0,0 +1,44 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{hostconnect}
+  s.version = "0.1.7"
+  s.authors = ["Bjørn Arild Mæland"]
+  s.date = %q{2008-12-02}
+  s.description = %q{Library for interfacing with Tourplan's hostConnect software, which is a web service interface for tour booking.}
+  s.email = %q{bjorn.maeland@gmail.com}
+  s.extra_rdoc_files = ["README.markdown", "CHANGELOG", "lib/hostconnect.rb", "lib/hostconnect/builders/agent_info_builder.rb", "lib/hostconnect/builders/pax_details_builder.rb", "lib/hostconnect/builders/record_booking_payment_builder.rb", "lib/hostconnect/builders/add_service_builder.rb", "lib/hostconnect/builders/room_config_builder.rb", "lib/hostconnect/builders/get_booking_builder.rb", "lib/hostconnect/builders/get_services_builder.rb", "lib/hostconnect/builders/get_system_settings_builder.rb", "lib/hostconnect/builders/get_locations_builder.rb", "lib/hostconnect/builders/new_booking_info_builder.rb", "lib/hostconnect/builders/suppler_info_builder.rb", "lib/hostconnect/builders/list_bookings_builder.rb", "lib/hostconnect/builders/option_info_builder.rb", "lib/hostconnect/builders/get_booking_payment_summary_builder.rb", "lib/hostconnect/builders/service_line_note_builder.rb", "lib/hostconnect/builders/ping_builder.rb", "lib/hostconnect/coercion.rb", "lib/hostconnect/core_extensions/string.rb", "lib/hostconnect/core_extensions/symbol.rb", "lib/hostconnect/translation.rb", "lib/hostconnect/responses/agent_info.rb", "lib/hostconnect/responses/get_services.rb", "lib/hostconnect/responses/list_bookings.rb", "lib/hostconnect/responses/get_locations.rb", "lib/hostconnect/responses/get_booking.rb", "lib/hostconnect/responses/record_booking_payment.rb", "lib/hostconnect/responses/option_info.rb", "lib/hostconnect/responses/get_booking_payment_summary.rb", "lib/hostconnect/responses/add_service.rb", "lib/hostconnect/responses/supplier_info.rb", "lib/hostconnect/responses/get_system_settings.rb", "lib/hostconnect/responses/ping.rb", "lib/hostconnect/rtf_document.rb", "lib/hostconnect/builder.rb", "lib/hostconnect/client.rb", "lib/hostconnect/response.rb"]
+  s.files = ["Rakefile", "README.markdown", "CHANGELOG", "hostconnect.gemspec", "lib/hostconnect.rb", "lib/hostconnect/builders/agent_info_builder.rb", "lib/hostconnect/builders/pax_details_builder.rb", "lib/hostconnect/builders/record_booking_payment_builder.rb", "lib/hostconnect/builders/add_service_builder.rb", "lib/hostconnect/builders/room_config_builder.rb", "lib/hostconnect/builders/get_booking_builder.rb", "lib/hostconnect/builders/get_services_builder.rb", "lib/hostconnect/builders/get_system_settings_builder.rb", "lib/hostconnect/builders/get_locations_builder.rb", "lib/hostconnect/builders/new_booking_info_builder.rb", "lib/hostconnect/builders/suppler_info_builder.rb", "lib/hostconnect/builders/list_bookings_builder.rb", "lib/hostconnect/builders/option_info_builder.rb", "lib/hostconnect/builders/get_booking_payment_summary_builder.rb", "lib/hostconnect/builders/service_line_note_builder.rb", "lib/hostconnect/builders/ping_builder.rb", "lib/hostconnect/coercion.rb", "lib/hostconnect/core_extensions/string.rb", "lib/hostconnect/core_extensions/symbol.rb", "lib/hostconnect/translation.rb", "lib/hostconnect/responses/agent_info.rb", "lib/hostconnect/responses/get_services.rb", "lib/hostconnect/responses/list_bookings.rb", "lib/hostconnect/responses/get_locations.rb", "lib/hostconnect/responses/get_booking.rb", "lib/hostconnect/responses/record_booking_payment.rb", "lib/hostconnect/responses/option_info.rb", "lib/hostconnect/responses/get_booking_payment_summary.rb", "lib/hostconnect/responses/add_service.rb", "lib/hostconnect/responses/supplier_info.rb", "lib/hostconnect/responses/get_system_settings.rb", "lib/hostconnect/responses/ping.rb", "lib/hostconnect/rtf_document.rb", "lib/hostconnect/builder.rb", "lib/hostconnect/client.rb", "lib/hostconnect/response.rb", "MIT-LICENSE", "spec/builders/new_booking_info_builder_spec.rb", "spec/builders/ping_builder_spec.rb", "spec/builders/get_locations_builder_spec.rb", "spec/builders/add_service_builder_spec.rb", "spec/builders/room_config_builder_spec.rb", "spec/builders/option_info_builder_spec.rb", "spec/builders/agent_info_builder_spec.rb", "spec/builders/pax_details_builder_spec.rb", "spec/spec_helper.rb", "spec/fixtures/requests/ping.xml", "spec/fixtures/requests/agent_info.xml", "spec/fixtures/requests/option_info/hotel_search_total_stay_price.xml", "spec/fixtures/requests/option_info/option_number.xml", "spec/fixtures/requests/option_info/hotel_search.xml", "spec/fixtures/requests/get_locations.xml", "spec/fixtures/requests/add_service_request/hotel_booking.xml", "spec/fixtures/responses/ping.xml", "spec/fixtures/responses/agent_info.xml", "spec/fixtures/responses/agent_info_error.xml", "spec/fixtures/responses/get_booking.xml", "spec/fixtures/responses/option_info/tours.xml", "spec/fixtures/responses/option_info/hotel_search_with_stay_price.xml", "spec/fixtures/responses/option_info/option_number.xml", "spec/fixtures/responses/option_info/hotel_price.xml", "spec/fixtures/responses/option_info/hotel_search.xml", "spec/fixtures/responses/get_system_settings.xml", "spec/fixtures/responses/add_service.xml", "spec/fixtures/responses/get_locations.xml", "spec/client_spec.rb", "spec/core_extensions_spec.rb", "spec/responses/get_booking_spec.rb", "spec/responses/get_system_settings_spec.rb", "spec/responses/agent_info_spec.rb", "spec/responses/option_info_spec.rb", "spec/responses/add_service_spec.rb", "spec/responses/ping_spec.rb", "spec/responses/get_locations_spec.rb", "spec/translation_spec.rb", "spec/coercion_spec.rb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://www.github.com/bmaland/hostconnect/}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Hostconnect", "--main", "README.markdown"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{hostconnect}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Library for interfacing with Tourplan's hostConnect software, which is a web service interface for tour booking.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+      s.add_runtime_dependency(%q<hpricot>, [">= 0"])
+      s.add_runtime_dependency(%q<builder>, [">= 0"])
+      s.add_runtime_dependency(%q<rtf>, [">= 0"])
+      s.add_development_dependency(%q<echoe>, [">= 0"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<hpricot>, [">= 0"])
+      s.add_dependency(%q<builder>, [">= 0"])
+      s.add_dependency(%q<rtf>, [">= 0"])
+      s.add_dependency(%q<echoe>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<hpricot>, [">= 0"])
+    s.add_dependency(%q<builder>, [">= 0"])
+    s.add_dependency(%q<rtf>, [">= 0"])
+    s.add_dependency(%q<echoe>, [">= 0"])
+  end
+end

data/lib/hostconnect/builder.rb

@@ -0,0 +1,50 @@
+module HostConnect
+  # Abstract class which all the different builder-classes inherit from. The builders are
+  # used to produce valid XML requests, which are to be sent to the HostConnect server.
+  class AbstractBuilder
+    # String representation of self
+    def to_s
+      to_xml.target!
+    end
+
+    # Send xml to server. Returns a new object.
+    def submit
+      obj = ActiveSupport::Inflector.constantize(self.class.to_s.gsub(/Builder/, ''))
+      obj.new(Client.post_xml_request(to_s))
+    end
+
+    protected
+    # Returns a bare xml-builder object, containing just dtd, xml version and encoding
+    def bare
+      x = Builder::XmlMarkup.new(:indent => 2)
+      x.instruct!
+      x.declare! :DOCTYPE, :Request, :SYSTEM, HostConnect.config.dtd
+      x
+    end
+
+    private
+    def initialize(options = {})
+      @options = options
+      check_for_valid_options
+      set_attrs
+    end
+
+    def check_for_valid_options
+      @options.each_key do |k|
+        raise("No such option: #{k}") unless @valid_options.include?(k)
+      end
+    end
+
+    def set_attrs
+      @options.each do |k,v|
+        instance_variable_set("@#{k}", v)
+      end
+
+      # It should be possible to set all options after the objects creation,
+      # from it's accessors
+      unless @valid_options.blank?
+        @valid_options.each { |k| self.class.class_eval "attr_accessor :#{k}" }
+      end
+    end
+  end
+end

data/lib/hostconnect/builders/add_service_builder.rb

@@ -0,0 +1,60 @@
+module HostConnect
+  # A booking is built up service by service. Each AddService request adds one
+  # service to a (new or existing) booking. Note that for a service to be added
+  # to an existing booking the agent adding the service must be the same as the
+  # agent who made the original booking.
+  class AddServiceBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password, :new_booking_info, :opt, :date_from,
+                         :scu_qty, :room_configs, :email, :pu_time, :pu_remark,
+                         :do_time, :do_remark, :remarks, :ud_text1, :ud_text2,
+                         :ud_text3, :ud_text4, :ud_text5, :agent_ref,
+                         :service_line_notes ].freeze
+      super(options)
+    end
+
+    def to_xml
+      x = bare
+      x.Request {
+        x.AddServiceRequest { |i|
+          x.AgentID @agent_id
+          x.Password @password
+
+          if @new_booking_info
+            i << @new_booking_info.to_xml.target!
+          end
+
+          if @room_configs
+            # Stack the room configs onto the request
+            x.RoomConfigs { |i|
+              @room_configs.each { |room| i << room.to_xml.target! }
+            }
+          end
+
+          if @service_line_notes
+            x.ServiceLineNotes { |i|
+              @service_line_notes.each { |note| i << note.to_xml.target! }
+            }
+          end
+
+          x.Opt @opt if @opt
+          x.DateFrom @date_from if @date_from
+          x.SCUqty @scu_qty if @scu_qty
+          x.Email @email if @email
+          x.AgentRef @agent_ref if @agent_ref
+          x.puTime @pu_time if @pu_time
+          x.puRemark @pu_remark if @pu_remark
+          x.doTime @do_time if @do_time
+          x.doRemark @do_remark if @do_remark
+          x.Remarks @remarks if @remarks
+          x.UDText1 @ud_text1 if @ud_text1
+          x.UDText2 @ud_text2 if @ud_text2
+          x.UDText3 @ud_text3 if @ud_text3
+          x.UDText4 Coercion.to_hc(@ud_text4) unless @ud_text4.nil?
+          x.UDText5 @ud_text5 if @ud_text5
+        }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/agent_info_builder.rb

@@ -0,0 +1,19 @@
+module HostConnect
+  # The AgentInfo request returns information about the specified agent (and as with other
+  # requests that require AgentID and Password an error is reported if the
+  # AgentID / Password combination is invalid).
+  class AgentInfoBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password ].freeze
+      super(options)
+    end
+    
+    def to_xml
+      x = bare
+      x.Request {
+        x.AgentInfoRequest { x.AgentID @agent_id; x.Password @password }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/get_booking_builder.rb

@@ -0,0 +1,24 @@
+module HostConnect
+  # This request retrieves a booking. Note that for a booking to be retrieved
+  # successfully the agent requesting the booking must be the same as the agent
+  # who made the booking.
+  class GetBookingBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password, :booking_id, :ref ].freeze
+      super(options)
+    end
+
+    def to_xml
+      x = bare
+      x.Request {
+        x.GetBookingRequest {
+          x.AgentID @agent_id
+          x.Password @password
+          x.BookingId @booking_id if @booking_id
+          x.Ref @ref if @ref
+        }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/get_booking_payment_summary_builder.rb

@@ -0,0 +1,20 @@
+module HostConnect
+  class GetBookingPaymentSummaryBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password, :booking_id ].freeze
+      super(options)
+    end
+
+    def to_xml
+      x = bare
+      x.Request {
+        x.GetBookingPaymentSummaryRequest {
+          x.AgentID @agent_id
+          x.Password @password
+          x.BookingId @booking_id
+        }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/get_locations_builder.rb

@@ -0,0 +1,18 @@
+module HostConnect
+  # The GetLocations request returns a list of all location codes and names used
+  # in the system. Note that each Opt option identifier contains a location code.
+  class GetLocationsBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password ].freeze
+      super(options)
+    end
+    
+    def to_xml
+      x = bare
+      x.Request {
+        x.GetLocationsRequest { x.AgentID @agent_id; x.Password @password }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/get_services_builder.rb

@@ -0,0 +1,18 @@
+module HostConnect
+  # The GetServices request returns a list of all service codes and names used
+  # in the system. Note that each Opt option identifier contains a service code.
+  class GetServicesBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password ].freeze
+      super(options)
+    end
+    
+    def to_xml
+      x = bare
+      x.Request {
+        x.GetServicesRequest { x.AgentID @agent_id; x.Password @password }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/get_system_settings_builder.rb

@@ -0,0 +1,18 @@
+module HostConnect
+  # The GetSystemSettings request returns information about the overall system
+  # settings.
+  class GetSystemSettingsBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password ].freeze
+      super(options)
+    end
+    
+    def to_xml
+      x = bare
+      x.Request {
+        x.GetSystemSettingsRequest { x.AgentID @agent_id; x.Password @password }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/list_bookings_builder.rb

@@ -0,0 +1,27 @@
+module HostConnect
+  # The ListBookings request returns header-level details of zero or
+  # more bookings made by the specifed agent, and that meet all of the
+  # criteria specified. If a sub-login is supplied then only details of
+  # bookings associated with that sub-login are returned.
+  class ListBookingsBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password, :travel_date_from, :travel_date_to,
+                         :entered_date_from, :entered_date_to, :name_contains,
+                         :agent_ref ].freeze
+      super(options)
+    end
+    
+    def to_xml
+      x = bare
+      x.Request {
+        x.ListBookingsRequest {
+          @valid_options.each do |opt|
+            val = eval "#{opt}"
+            eval "x.#{opt.camelize.requestify} #{opt}" unless val.blank?
+          end
+        }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/new_booking_info_builder.rb

@@ -0,0 +1,23 @@
+module HostConnect
+  class NewBookingInfoBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :name, :qb, :branch, :department,
+                         :sales_analysis1, :sales_analysis2, :sales_analysis3 ].freeze
+      super(options)
+    end
+
+    def to_xml
+      x = Builder::XmlMarkup.new(:indent => 2, :margin => 2)
+      x.NewBookingInfo {
+        x.Name @name
+        x.QB @qb
+        x.Branch @branch if @branch
+        x.Department @department if @department
+        x.SalesAnalysis1 @sales_analysis1 if @sales_analysis1
+        x.SalesAnalysis2 @sales_analysis2 if @sales_analysis2
+        x.SalesAnalysis3 @sales_analysis3 if @sales_analysis3
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/option_info_builder.rb

@@ -0,0 +1,49 @@
+module HostConnect
+  class OptionInfoBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password, :opt, :option_number, :info,
+        :date_from, :date_to, :scu_qty, :a_cache, :rate_convert, :room_configs,
+        :minimum_availability, :sort_field, :ascending, :index_first_option,
+        :maximum_options, :note_category, :location_code, :locality_description,
+        :class_description, :description, :supplier_name, :rate_per_scu ].freeze
+      super(options)
+    end
+    
+    def to_xml
+      x = bare
+      x.Request {
+        x.OptionInfoRequest {
+          # TODO: probably need to validate sanity of Info / RateConvert here,
+          # and raise exceptions if they are invalid
+          
+          # Has to substract from @valid_options instead of @options, because
+          # we have to guarantee the order of elements.
+          (@valid_options - [ :room_configs, :opt, :option_number ]).each do |opt|
+            # Requestify turns Id into ID
+            
+            # TODO: I guess this could be done with less eval usage.
+            # Basically, we build xml only for those options that are non-blank
+            val = eval "#{opt}"
+            eval "x.#{opt.camelize.requestify} #{opt}" unless val.blank?
+          end
+          
+          if @opt
+            @opt.each { |o| x.Opt o }
+          end
+          
+          if @option_number
+            @option_number.each { |o| x.OptionNumber o }
+          end
+          
+          if @room_configs
+            # Stack the room configs onto the request
+            x.RoomConfigs { |i|
+              @room_configs.each { |room| i << room.to_xml.target! }
+            }
+          end
+        }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/pax_details_builder.rb

@@ -0,0 +1,21 @@
+module HostConnect
+  class PaxDetailsBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :title, :forename, :surname, :date_of_birth, :pax_type,
+                         :pax_text1, :pax_text2, :pax_text3, :pax_text4,
+                         :pax_text5 ].freeze
+      super(options)
+    end
+
+    def to_xml
+      x = Builder::XmlMarkup.new(:indent => 2, :margin => 5)
+      x.PaxDetails {
+        @valid_options.each do |opt|
+          val = eval "#{opt}"
+          eval "x.#{opt.camelize} #{opt}" unless val.blank?
+        end
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/ping_builder.rb

@@ -0,0 +1,11 @@
+module HostConnect
+  # The Ping request is provided as a simple way of determining whether hostConnect is alive.
+  # No arguments needed.
+  class PingBuilder < AbstractBuilder
+    def to_xml
+      x = bare
+      x.Request { x.PingRequest }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/record_booking_payment_builder.rb

@@ -0,0 +1,25 @@
+module HostConnect
+  class RecordBookingPaymentBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password, :booking_id, :currency,
+                         :amount, :receipt_type ].freeze
+      super(options)
+    end
+
+    def to_xml
+      x = bare
+      amount = (@amount.to_f * 100).to_i # Format amount for HostConnect
+      x.Request {
+        x.RecordBookingPaymentRequest {
+          x.AgentID @agent_id
+          x.Password @password
+          x.BookingId @booking_id
+          x.Currency @currency
+          x.Amount amount
+          x.ReceiptType @receipt_type
+        }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/room_config_builder.rb

@@ -0,0 +1,25 @@
+module HostConnect
+  class RoomConfigBuilder < AbstractBuilder
+    # Room types: SG  (single), TW (twin), DB  (double), TR (triple), QD (quad)
+    def initialize(options = {})
+      @valid_options = [ :adults, :room_type, :pax_list ].freeze
+      super(options)
+    end
+
+    def to_xml
+      x = Builder::XmlMarkup.new(:indent => 2, :margin => 3)
+      x.RoomConfig {
+        x.Adults @adults if @adults
+        x.RoomType @room_type if @room_type
+
+        if @pax_list
+          # Stack the PaxDetails builder objects onto the request
+          x.PaxList { |i|
+            @pax_list.each { |pax| i << pax.to_xml.target! }
+          }
+        end
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/service_line_note_builder.rb

@@ -0,0 +1,17 @@
+module HostConnect
+  class ServiceLineNoteBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :note_category, :note_text ].freeze
+      super(options)
+    end
+
+    def to_xml
+      x = Builder::XmlMarkup.new(:indent => 2, :margin => 3)
+      x.ServiceLineNote {
+        x.NoteCategory @note_category
+        x.NoteText @note_text
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/builders/suppler_info_builder.rb

@@ -0,0 +1,27 @@
+module HostConnect
+  class SupplierInfoBuilder < AbstractBuilder
+    def initialize(options = {})
+      @valid_options = [ :agent_id, :password, :supplier_code, :supplier_id ].freeze
+      super(options)
+    end
+    
+    def to_xml
+      x = bare
+      x.Request {
+        x.SupplierInfoRequest {
+          x.AgentID @agent_id
+          x.Password @password
+          
+          if @supplier_code
+            @supplier_code.each { |s| x.SupplierCode s }
+          end
+          
+          if @supplier_id
+            @opt.each { |s| s.SupplierId s }
+          end
+        }
+      }
+      x
+    end
+  end
+end

data/lib/hostconnect/client.rb

@@ -0,0 +1,32 @@
+module HostConnect
+  # Has the responsibility for the http connections
+  class Client
+    class << self
+      # Posts a new xml request to the server, returning the response body
+      def post_xml_request(xml)
+        begin
+          HostConnect.logger.debug "Request sent to server:\n" << xml
+
+          req = Net::HTTP::Post.new(HostConnect.config.path)
+          req['Content-Type'] = 'text/xml'
+          req['Content-Length'] = xml.size.to_s
+          response = http_connection.request(req, xml)
+
+          HostConnect.logger.debug "Response:\n" << response.body
+        rescue Exception
+          error_description = "Error occured while sending data to HostConnect"
+          HostConnect.logger.fatal "Exception thrown: " + error_description
+          raise Exception, error_description
+        ensure
+          http_connection.finish if http_connection.started?
+        end
+        response.body
+      end
+
+      # Returns the http connection
+      def http_connection
+        @@http ||= Net::HTTP.new(HostConnect.config.host, HostConnect.config.port)
+      end
+    end
+  end
+end