amadeus 0.1.0 → 1.0.0.beta1

data/lib/amadeus/namespaces/reference_data/urls.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class ReferenceData
+      # A namespaced client for the
+      # +/v2/reference-data/urls+ endpoints
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.reference_data.urls
+      #
+      class Urls < Amadeus::Client::Decorator
+        # The namespace for the CheckinLinks APIs:
+        #
+        # @return [Amadeus::Namespaces::ReferenceData::Urls::CheckinLinks]
+        # @example
+        #   amadeus.reference_data.urls.checkin_links
+        #
+        def checkin_links
+          Amadeus::Namespaces::ReferenceData::Urls::CheckinLinks.new(client)
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/reference_data/urls/checkin_links.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class ReferenceData
+      class Urls
+        # A namespaced client for the
+        # +/v2/reference-data/urls/checkin-links+ endpoints
+        #
+        # Access via the +Amadeus::Client+ object
+        #
+        #   amadeus = Amadeus::Client.new
+        #   amadeus.reference_data.urls.checkin_links
+        #
+        class CheckinLinks < Amadeus::Client::Decorator
+          # Returns the checkin links for an airline, for the
+          # language of your choice
+          #
+          # @option params [String] :airline airline ID - required
+          # @option params [String] :language (en-GB) the locale for the links
+          # @return [Amadeus::Response] a parsed response
+          # @raise [Amadeus::Base] an exception if the call failed
+          # @example Find a the checkin links for Branson AirExpress
+          #   amadeus.reference_data.urls.checkin_links.get(airline: '1X')
+          #
+          def get(params = {})
+            client.get('/v2/reference-data/urls/checkin-links', params)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/shopping.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    # A namespaced client for the
+    # +/v1/shopping+ endpoints
+    #
+    # Access via the +Amadeus::Client+ object
+    #
+    #   amadeus = Amadeus::Client.new
+    #   amadeus.shopping
+    #
+    class Shopping < Amadeus::Client::Decorator
+      # The namespace for the FlightDestinations API:
+      #
+      # @return [Amadeus::Namespaces::Shopping::FlightDestinations]
+      # @example
+      #   amadeus.shopping.flight_destinations
+      #
+      def flight_destinations
+        Amadeus::Namespaces::Shopping::FlightDestinations.new(client)
+      end
+
+      # The namespace for the FlightOffers API:
+      #
+      # @return [Amadeus::Namespaces::Shopping::FlightOffers]
+      # @example
+      #   amadeus.shopping.flight_offers
+      #
+      def flight_offers
+        Amadeus::Namespaces::Shopping::FlightOffers.new(client)
+      end
+
+      # The namespace for the FlightDates API:
+      #
+      # @return [Amadeus::Namespaces::Shopping::FlightDates]
+      # @example
+      #   amadeus.shopping.flight_dates
+      #
+      def flight_dates
+        Amadeus::Namespaces::Shopping::FlightDates.new(client)
+      end
+
+      # The namespace for the HotelOffers API:
+      #
+      # @return [Amadeus::Namespaces::Shopping::HotelOffers]
+      # @example
+      #   amadeus.shopping.hotel_offers
+      #
+      def hotel_offers
+        Amadeus::Namespaces::Shopping::HotelOffers.new(client)
+      end
+
+      # The namespace for the Hotels API:
+      #
+      # @param [Number] hotel_id The ID for the hotel to find offers for
+      # @return [Amadeus::Namespaces::Shopping::Hotels]
+      # @example
+      #   amadeus.shopping.hotels
+      #
+      def hotels(hotel_id = nil)
+        Amadeus::Namespaces::Shopping::Hotel.new(client, hotel_id)
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/shopping/flight_dates.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Shopping
+      # A namespaced client for the
+      # +/v1/shopping/flight-dates+ endpoints
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.shopping.flight_dates
+      #
+      class FlightDates < Amadeus::Client::Decorator
+        # Find the cheapest flight dates from an origin to a destination.
+        #
+        # @option params [String] :origin City/Airport IATA code from which the
+        #   flight will depart. BOS, for example.
+        # @option params [String] :destination City/Airport IATA code to which
+        #   the flight is going. BOS, for example.
+        # @return [Amadeus::Response] a parsed response
+        # @raise [Amadeus::Base] an exception if the call failed
+        # @example Find the cheapest flight from London Heathrow to Paris
+        #   amadeus.shopping.flight_dates.get(origin: 'LHR',
+        #                                     destination: 'PAR')
+        #
+        def get(params = {})
+          client.get('/v1/shopping/flight-dates', params)
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/shopping/flight_destinations.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Shopping
+      # A namespaced client for the
+      # +/v1/shopping/flight-destinations+ endpoints
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.shopping.flight_destinations
+      #
+      class FlightDestinations < Amadeus::Client::Decorator
+        # Find the cheapest destinations where you can fly to.
+        #
+        # @option params [String] :origin City/Airport IATA code from which the
+        #   flight will depart. BOS, for example.
+        # @return [Amadeus::Response] a parsed response
+        # @raise [Amadeus::Base] an exception if the call failed
+        # @example Find the cheapest destination from London Heathrow
+        #   amadeus.shopping.flight_destinations.get(origin: 'LHR')
+        #
+        def get(params = {})
+          client.get('/v1/shopping/flight-destinations', params)
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/shopping/flight_offers.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Shopping
+      # A namespaced client for the
+      # +/v1/shopping/flight-offers+ endpoints
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.shopping.flight_offers
+      #
+      class FlightOffers < Amadeus::Client::Decorator
+        # Find the cheapest bookable flights.
+        #
+        # @option params [String] :origin City/Airport IATA code from which the
+        #   flight will depart. BOS, for example.
+        # @option params [String] :destination City/Airport IATA code to which
+        #   the traveler is going. PAR, for example
+        # @return [Amadeus::Response] a parsed response
+        # @raise [Amadeus::Base] an exception if the call failed
+        # @example Find the cheapest destination from London to Paris for Xmas
+        #   amadeus.shopping.flight_offers.get(
+        #     origin: 'LHR',
+        #     destination: 'LAX',
+        #     departureDate: '2017-12-24'
+        #   )
+        #
+        def get(params = {})
+          client.get('/v1/shopping/flight-offers', params)
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/shopping/hotel.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Shopping
+      # A namespaced client for the
+      # +/v1/shopping/hotels+ endpoints
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.shopping.hotels(123)
+      #
+      class Hotel < Amadeus::Client::Decorator
+        # the Hotel ID
+        attr_reader :hotel_id
+
+        # Initialize this namespaced client with an
+        # {Amadeus::Client} instance and a Hotel ID
+        #
+        # @param [Amadeus::Client] client
+        # @param [Number] hotel_id
+        #
+        def initialize(client, hotel_id)
+          super(client)
+          @hotel_id = hotel_id
+        end
+
+        # The namespace for the Hotels::Offers API:
+        #
+        # @param [Number] offer_id The ID for the offer to find details for
+        # @return [Amadeus::Namespaces::Shopping::Hotels::Offers]
+        # @example
+        #   amadeus.shopping.hotels('SMPARCOL').offers(234)
+        #
+        def offers(offer_id = nil)
+          Amadeus::Namespaces::Shopping::Hotel::Offer.new(
+            client, @hotel_id, offer_id
+          )
+        end
+
+        # The namespace for the Hotels::HotelOffers API:
+        #
+        # @return [Amadeus::Namespaces::Shopping::Hotels::HotelOffers]
+        # @example
+        #   amadeus.shopping.hotels('SMPARCOL').hotel_offers
+        #
+        def hotel_offers
+          Amadeus::Namespaces::Shopping::Hotel::HotelOffers.new(
+            client, @hotel_id
+          )
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/shopping/hotel/hotel_offers.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Shopping
+      class Hotel
+        # A namespaced client for the
+        # +/v1/shopping/hotels/:id/hotel-offers+ endpoints
+        #
+        # Access via the +Amadeus::Client+ object
+        #
+        #   amadeus = Amadeus::Client.new
+        #   amadeus.shopping.hotels.hotel_offers
+        #
+        class HotelOffers < Amadeus::Client::Decorator
+          # the Hotel ID
+          attr_reader :hotel_id
+
+          # Initialize this namespaced client with an
+          # {Amadeus::Client} instance and a Hotel ID
+          #
+          # @param [Amadeus::Client] client
+          # @param [Number] hotel_id
+          #
+          def initialize(client, hotel_id)
+            super(client)
+            @hotel_id = hotel_id
+          end
+
+          # Get one hotel and its available offers
+          #
+          # @return [Amadeus::Response] a parsed response
+          # @raise [Amadeus::Base] an exception if the call failed
+          # @example Search for hotels in London
+          #   amadeus.shopping.hotels('SMPARCOL').hotel_offers.get
+          #
+          def get(params = {})
+            client.get("/v1/shopping/hotels/#{@hotel_id}/hotel-offers", params)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/shopping/hotel/offer.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Shopping
+      class Hotel
+        # A namespaced client for the
+        # +/v1/shopping/hotels/:id/offers+ endpoints
+        #
+        # Access via the +Amadeus::Client+ object
+        #
+        #   amadeus = Amadeus::Client.new
+        #   amadeus.shopping.hotels.offers
+        #
+        class Offer < Amadeus::Client::Decorator
+          # the Hotel ID
+          attr_reader :hotel_id
+          # the Offer ID
+          attr_reader :offer_id
+
+          # Initialize this namespaced client with an
+          # {Amadeus::Client} instance, a Hotel ID, and an Offer ID
+          #
+          # @param [Amadeus::Client] client
+          # @param [Number] hotel_id
+          # @param [Number] offer_id
+          #
+          def initialize(client, hotel_id, offer_id)
+            super(client)
+            @hotel_id = hotel_id
+            @offer_id = offer_id
+          end
+
+          # Get room and rate details
+          #
+          # @return [Amadeus::Response] a parsed response
+          # @raise [Amadeus::Base] an exception if the call failed
+          # @example Search for hotels in London
+          #   amadeus.shopping.hotels('SMPARCOL')
+          #     .offers('AC7D4DA2C322A73AF0824318A4965DA2805A3FC2').get
+          #
+          def get(params = {})
+            @offer_id ||= begin
+              offer_id = params[:id] || params['id']
+              params.delete(:id)
+              params.delete('id')
+              offer_id
+            end
+
+            client.get(
+              "/v1/shopping/hotels/#{@hotel_id}/offers/#{@offer_id}", params
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/shopping/hotel_offers.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Shopping
+      # A namespaced client for the
+      # +/v1/shopping/hotel-offers+ endpoints
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.shopping.hotel_offers
+      #
+      class HotelOffers < Amadeus::Client::Decorator
+        # Search for hotels and retrieve availability and rates information
+        #
+        # @option params [String] :cityCode City IATA code
+        # @option params [Double] :latitude latitude of geographic location to
+        #   search around. Example: 52.5238
+        # @option params [Double] :longitude Longitude of geographic location to
+        #   search around. Example: 13.3835
+        # @option params [String] :hotels Comma separated list of Amadeus hotel
+        #   codes to request. Example: RTPAR001
+        # @return [Amadeus::Response] a parsed response
+        # @raise [Amadeus::Base] an exception if the call failed
+        # @example Search for hotels in London
+        #   amadeus.shopping.hotel_offers.get(
+        #     cityCode: 'PAR'
+        #   )
+        #
+        def get(params = {})
+          client.get('/v1/shopping/hotel-offers', params)
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/travel.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    # A namespaced client for the
+    # +/v1/travel+ endpoints
+    #
+    # Access via the +Amadeus::Client+ object
+    #
+    #   amadeus = Amadeus::Client.new
+    #   amadeus.travel
+    #
+    class Travel < Amadeus::Client::Decorator
+      # The namespace for the travel Analytics APIs:
+      #
+      # @return [Amadeus::Namespaces::Travel::Analytics]
+      # @example
+      #   amadeus.travel.analytics.air_traffics
+      #   amadeus.travel.analytics.fare_searches
+      #
+      def analytics
+        Amadeus::Namespaces::Travel::Analytics.new(client)
+      end
+    end
+  end
+end