sabre_dev_studio-flight 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3aef44f104778538aeb4cef85864b2ca9b91f8a0
+  data.tar.gz: 071fb30d493fcf0743d0f89dee455ff509abe73f
+SHA512:
+  metadata.gz: 46dc3d1c2b15205a1cabadd5ae4f7e978d389b5b425f3d103beaa94d558d208699b917d92e392fc70af91a54c5972b941a4cf6505af6aa30414b8b3c611cff56
+  data.tar.gz: e66af9d560f8c2589ac9d73c23c30d0ee15d23271062a5399f7beb0b9805e0be22e2a25e359ee51f459621262a9b432bb5433096dbf90d79b75b363f5ccbcdc3

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+scratch

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+source 'http://ctovm2419.dev.sabre.com:9292'
+
+# Specify your gem's dependencies in sabre_dev_studio-flight.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Sabre Corp
+
+MIT License
+
+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.md

@@ -0,0 +1,54 @@
+# SabreDevStudio::Flight
+
+Access the Travel Platform Services Flight API
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'sabre_dev_studio-flight'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install sabre_dev_studio-flight
+
+## Usage
+Once you've registered for your account at http://developer.sabre.com, grab your credentials and plug them into the `configure` block.
+
+    irb -r ./lib/sabre_dev_studio-flight.rb
+
+    SabreDevStudio.configure do |c|
+      c.user     = 'USER'
+      c.group    = 'GROUP'
+      c.domain   = 'DOMAIN'
+      c.password = 'PASSWORD'
+      c.uri      = 'https://api.test.sabre.com'
+    end
+    options = {
+      :origin        => 'LAS',
+      :departuredate => '2014-06-22',
+      :returndate    => '2014-06-23',
+      :theme         => 'MOUNTAINS'
+    }
+    fares = SabreDevStudio::Flight::Api.destination_air_shop(options)
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+See LICENSE.txt
+
+## Disclaimer of Warranty and Limitation of Liability
+
+This software and any compiled programs created using this software are furnished “as is” without warranty of any kind, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. No oral or written information or advice given by Sabre, its agents or employees shall create a warranty or in any way increase the scope of this warranty, and you may not rely on any such information or advice.
+Sabre does not warrant, guarantee, or make any representations regarding the use, or the results of the use, of this software, compiled programs created using this software, or written materials in terms of correctness, accuracy, reliability, currentness, or otherwise. The entire risk as to the results and performance of this software and any compiled applications created using this software is assumed by you. Neither Sabre nor anyone else who has been involved in the creation, production or delivery of this software shall be liable for any direct, indirect, consequential, or incidental damages (including damages for loss of business profits, business interruption, loss of business information, and the like) arising out of the use of or inability to use such product even if Sabre has been advised of the possibility of such damages.

data/Rakefile

@@ -0,0 +1,20 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'rdoc/task'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList['test/*test.rb']
+  t.verbose = true
+end
+
+desc 'Run tests'
+task :default => :test
+
+RDoc::Task.new do |rdoc|
+  rdoc.main     = 'README.md'
+  rdoc.title    = 'Sabre Dev Studio Flight Shop Gem'
+  rdoc.options << '--line-numbers --inline-source'
+  rdoc.rdoc_dir = 'doc'
+  rdoc.rdoc_files.include('README.md', 'lib/*.rb', 'lib/**')
+end

data/lib/sabre_dev_studio-flight/airports_at_cities_lookup.rb

@@ -0,0 +1,13 @@
+module SabreDevStudio
+  module Flight
+
+    ##
+    # Airports At Cities Lookup
+    #
+    # ==== Documentation:
+    # https://developer.sabre.com/docs/read/rest_apis/airports_at_cities_lookup
+    class AirportsAtCitiesLookup < SabreDevStudio::RequestObject
+    end
+
+  end
+end

data/lib/sabre_dev_studio-flight/api.rb

@@ -0,0 +1,209 @@
+require File.expand_path('../airports_at_cities_lookup', __FILE__)
+require File.expand_path('../city_pairs_lookup', __FILE__)
+require File.expand_path('../destination_finder', __FILE__)
+require File.expand_path('../fare_range', __FILE__)
+require File.expand_path('../instaflights_search', __FILE__)
+require File.expand_path('../lead_price_calendar', __FILE__)
+require File.expand_path('../low_fare_forecast', __FILE__)
+require File.expand_path('../multiairport_city_lookup', __FILE__)
+require File.expand_path('../theme_airport_lookup', __FILE__)
+require File.expand_path('../travel_seasonality', __FILE__)
+require File.expand_path('../travel_theme_lookup', __FILE__)
+
+module SabreDevStudio
+  module Flight
+    class Api
+      ##
+      # List of Air Shopping Themes
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/read/rest_apis/travel_theme_lookup
+      #
+      # ==== Example:
+      #    air_shopping_themes = SabreDevStudio::Flight::Api.travel_theme_lookup
+      def self.travel_theme_lookup
+        endpoint = '/v1/shop/themes'
+        SabreDevStudio::Flight::TravelThemeLookup.new(endpoint)
+      end
+      class << self; alias_method :air_shopping_themes, :travel_theme_lookup; end
+
+      ##
+      # Theme Airport Lookup
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/read/rest_apis/theme_airport_lookup
+      #
+      # ==== Example:
+      #    airports = SabreDevStudio::Flight::Api.theme_airport_lookup('BEACH')
+      def self.theme_airport_lookup(theme)
+        endpoint = "/v1/shop/themes/#{theme}"
+        SabreDevStudio::Flight::ThemeAirportLookup.new(endpoint)
+      end
+
+      ##
+      # Shop for a destination (from a list of generalized destinations) given a date range
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/read/rest_apis/destination_finder
+      #
+      # Note: Timezones are specific to the departure and arrival airports (but not specified).
+      #
+      # ==== Example:
+      #    options = {
+      #      :origin        => 'LAS',
+      #      :departuredate => '2014-06-22',
+      #      :returndate    => '2014-06-23',
+      #      :theme         => 'MOUNTAINS'
+      #    }
+      #    fares = SabreDevStudio::Flight::Api.destination_finder(options)
+      def self.destination_finder(options)
+        endpoint = '/v1/shop/flights/fares'
+        SabreDevStudio::Flight::DestinationFinder.new(endpoint, options)
+      end
+      class << self; alias_method :destination_air_shop, :destination_finder; end
+
+      ##
+      # Future Dates Lead Fare Search, aka "Calendar Lead"
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/read/rest_apis/lead_price_calendar
+      #
+      # Note: Timezones are specific to the departure and arrival airports (but not specified).
+      #
+      # ==== Example:
+      #    options = {
+      #      :origin        => 'ATL',
+      #      :destination   => 'LAS',
+      #      :lengthofstay  => 5
+      #    }
+      #    fares = SabreDevStudio::Flight::Api.lead_price_calendar(options)
+      def self.lead_price_calendar(options)
+        endpoint = '/v1/shop/flights/fares'
+        SabreDevStudio::Flight::LeadPriceCalendar.new(endpoint, options)
+      end
+      class << self; alias_method :future_dates_lead_fare_shop, :lead_price_calendar; end
+
+      ##
+      # Shop for a fare with an origin for a destination with departure and return dates
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/read/rest_apis/instaflights_search
+      #
+      # ==== Example:
+      #    options = {
+      #      :origin        => 'ATL',
+      #      :destination   => 'LAS',
+      #      :departuredate => '2014-06-22',
+      #      :returndate    => '2014-06-23',
+      #      :limit         => 10,
+      #      :sortby        => 'totalfare',
+      #      :order         => 'asc',
+      #      :sortby2       => 'departuretime',
+      #      :order2        => 'dsc'
+      #    }
+      #    itineraries = SabreDevStudio::Flight::Api.instaflights_search(options); nil
+      def self.instaflights_search(options)
+        endpoint = '/v1/shop/flights'
+        SabreDevStudio::Flight::InstaflightsSearch.new(endpoint, options)
+      end
+      class << self; alias_method :single_date_air_shop, :instaflights_search; end
+
+      ##
+      # Low Fare Forecast
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/rest_apis/low_fare_forecast
+      #
+      # ==== Example:
+      #    options = {
+      #      :origin        => 'JFK',
+      #      :destination   => 'LAX',
+      #      :departuredate => '2014-10-01',
+      #      :returndate    => '2014-10-05'
+      #    }
+      #    forecast = SabreDevStudio::Flight::Api.low_fare_forecast(options)
+      def self.low_fare_forecast(options)
+        endpoint = '/v1/forecast/flights/fares'
+        SabreDevStudio::Flight::LowFareForecast.new(endpoint, options)
+      end
+
+      ##
+      # Fare Range
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/read/rest_apis/fare_range
+      #
+      # ==== Example:
+      #    options = {
+      #      :origin                => 'JFK',
+      #      :destination           => 'LAX',
+      #      :earliestdeparturedate => '2014-06-01',
+      #      :latestdeparturedate   => '2014-06-01',
+      #      :lengthofstay          => 4
+      #    }
+      #    fare_range = SabreDevStudio::Flight::Api.fare_range(options)
+      def self.fare_range(options)
+        endpoint = '/v1/historical/flights/fares'
+        SabreDevStudio::Flight::FareRange.new(endpoint, options)
+      end
+
+      ##
+      # Travel Seasonality
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/read/rest_apis/travel_seasonality
+      #
+      # ==== Example:
+      #    travel_seasonality = SabreDevStudio::Flight::Api.travel_seasonality('DFW')
+      def self.travel_seasonality(destination)
+        endpoint = "/v1/historical/flights/#{destination}/seasonality"
+        SabreDevStudio::Flight::TravelSeasonality.new(endpoint)
+      end
+
+      ##
+      # City Pairs Lookup
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/read/rest_apis/city_pairs_lookup
+      #
+      # ==== Example:
+      #    options = {
+      #      :origincountry       => 'US',
+      #      :destinationcountry  => 'US'
+      #    }
+      #    city_pairs = SabreDevStudio::Flight::Api.city_pairs_lookup
+      def self.city_pairs_lookup(options)
+        endpoint = '/v1/lists/airports/supported/origins-destinations'
+        SabreDevStudio::Flight::CityPairsLookup.new(endpoint, options)
+      end
+
+      ##
+      # Multi-Airport City Lookup
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/read/rest_apis/multiairport_city_lookup
+      #
+      # ==== Example:
+      #    options = { :country => 'US' }
+      #    city_pairs = SabreDevStudio::Flight::Api.multiairport_city_lookup(options)
+      def self.multiairport_city_lookup(options)
+        endpoint = '/v1/lists/cities'
+        SabreDevStudio::Flight::MultiairportCityLookup.new(endpoint, options)
+      end
+
+      ##
+      # Airports At Cities Lookup
+      #
+      # ==== Documentation:
+      # https://developer.sabre.com/docs/read/rest_apis/airports_at_cities_lookup
+      #
+      # ==== Example:
+      #    options = { :city => 'NYC' }
+      #    city_pairs = SabreDevStudio::Flight::Api.airports_at_cities_lookup(options)
+      def self.airports_at_cities_lookup(options)
+        endpoint = '/v1/lists/airports'
+        SabreDevStudio::Flight::AirportsAtCitiesLookup.new(endpoint, options)
+      end
+    end
+  end
+end

data/lib/sabre_dev_studio-flight/city_pairs_lookup.rb

@@ -0,0 +1,13 @@
+module SabreDevStudio
+  module Flight
+
+    ##
+    # City Pairs Lookup
+    #
+    # ==== Documentation:
+    # https://developer.sabre.com/docs/read/rest_apis/city_pairs_lookup
+    class CityPairsLookup < SabreDevStudio::RequestObject
+    end
+
+  end
+end

data/lib/sabre_dev_studio-flight/destination_finder.rb

@@ -0,0 +1,13 @@
+module SabreDevStudio
+  module Flight
+
+    ##
+    # Shop for a destination (from a list of generalized destinations) given a date range
+    #
+    # ==== Documentation:
+    # https://developer.sabre.com/docs/read/rest_apis/destination_finder
+    class DestinationFinder < SabreDevStudio::RequestObject
+    end
+
+  end
+end

data/lib/sabre_dev_studio-flight/fare_range.rb

@@ -0,0 +1,13 @@
+module SabreDevStudio
+  module Flight
+
+    ##
+    # Fare Range
+    #
+    # ==== Documentation:
+    # https://developer.sabre.com/docs/read/rest_apis/fare_range
+    class FareRange < SabreDevStudio::RequestObject
+    end
+
+  end
+end

data/lib/sabre_dev_studio-flight/instaflights_search.rb

@@ -0,0 +1,13 @@
+module SabreDevStudio
+  module Flight
+
+    ##
+    # Shop for a fare with an origin for a destination with departure and return dates
+    #
+    # ==== Documentation:
+    # https://developer.sabre.com/docs/read/rest_apis/instaflights_search
+    class InstaflightsSearch < SabreDevStudio::RequestObject
+    end
+
+  end
+end

data/lib/sabre_dev_studio-flight/lead_price_calendar.rb

@@ -0,0 +1,13 @@
+module SabreDevStudio
+  module Flight
+
+    ##
+    # Future Dates Lead Fare Search, aka "Calendar Lead"
+    #
+    # ==== Documentation:
+    # https://developer.sabre.com/docs/read/rest_apis/lead_price_calendar
+    class LeadPriceCalendar < SabreDevStudio::RequestObject
+    end
+
+  end
+end

data/lib/sabre_dev_studio-flight/low_fare_forecast.rb

@@ -0,0 +1,13 @@
+module SabreDevStudio
+  module Flight
+
+    ##
+    # Low Fare Forecast
+    #
+    # ==== Documentation:
+    # https://developer.sabre.com/docs/rest_apis/low_fare_forecast
+    class LowFareForecast < SabreDevStudio::RequestObject
+    end
+
+  end
+end

data/lib/sabre_dev_studio-flight/multiairport_city_lookup.rb

@@ -0,0 +1,13 @@
+module SabreDevStudio
+  module Flight
+
+    ##
+    # Multi-Airport City Lookup
+    #
+    # ==== Documentation:
+    # https://developer.sabre.com/docs/read/rest_apis/multiairport_city_lookup
+    class MultiairportCityLookup < SabreDevStudio::RequestObject
+    end
+
+  end
+end

data/lib/sabre_dev_studio-flight/shop/streamlined_destinations.rb

@@ -0,0 +1,38 @@
+=begin
+
+   options = {
+     :origin        => 'LAS',
+     :departuredate => '2014-06-01',
+     :returndate    => '2014-06-05'
+   }
+   destinations = SabreDevStudio::Flight::Api.destination_air_shop(options); nil
+   streamlined_destinations = SabreDevStudio::Flight::Shop::StreamlinedDestinations.new(destinations.response); nil
+   pp streamlined_destinations; nil
+
+=end
+
+module SabreDevStudio
+  module Flight
+    module Shop
+      class StreamlinedDestinations
+        attr_reader :destinations
+
+        def initialize(bulky_destinations)
+          @destinations = Hash.new
+          streamline(bulky_destinations['FareInfo'])
+        end
+
+        private
+
+        def streamline(bulky_destinations)
+          destinations = {}
+          bulky_destinations.each do |dest|
+            destinations[dest['DestinationLocation']] = dest['LowestFare'].ceil
+          end
+          arr = destinations.sort_by {|k,v| v}
+          @destinations = Hash[*arr.flatten]
+        end
+      end
+    end
+  end
+end