amadeus 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 116bbcff741bb5fab5803f00b10308532d62a2f4b14b68f46907fac8a8da2c28
-  data.tar.gz: deb8b9c78e5b04d33416ff206f69aeb7fe7864d021672cfd6a4568d8c4ec99a8
+  metadata.gz: 77b263da6fa9f3a99fca139c2bd0857dc81ffbde4e80901e18becd1a2f109e77
+  data.tar.gz: cf75057bd42b724f96ff1aeae897965cc9cae19f609f717835986669c595e137
 SHA512:
-  metadata.gz: f2079ed0e6473ec1f8e1084bd8c6b1d6e7d27a13a201f92a99ec0daf8cd5396db55400f377d8a4a5a05ef4921eb5412f6eb8a0c299c6384bf543e4c5b4860fa4
-  data.tar.gz: bced7a7488c3048c5f181155dd3e57a5bfe1c6903be9694d4479d5c8c2efec3719ee905d00b00051bae3f94dd5232a2adcea2bede43869a16b90d8f053154113
+  metadata.gz: c30c255a1508a6143d1b857d0149a86e63060117a62a4112acc28087be932f1ec4e86977490ae01cb63d1bb96f9eb5abe8a0d3f0ac0cc674c991042424f262f7
+  data.tar.gz: 8b79e44597f7e3b822a1d2d316ad997fceff08f6e42b89ec0401a52eca203cf6402a8dd6becfeeab88060026f314ad55a3316b36c18fe7b22251af52d16e3eb0

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.0.0 - 2018-04-19
+
+The first stable version of the Amadeus for Developers ruby SDK
+
+## 1.0.0.beta7 - 2018-04-19
+
+Fix the Flight Most Traveled Destinations endpoint (air_traffic/traveled)
+
 ## 1.0.0.beta6 - 2018-04-05
 
 Adds easier to read error messages

data/README.md

@@ -26,7 +26,7 @@ gem 'amadeus'
 
 ## Getting Started
 
-To send make your first API call you will need to [register for an Amadeus
+To make your first API call you will need to [register for an Amadeus
 Developer Account](https://developers.amadeus.com/create-account) and set up
 your first application.
 
@@ -185,7 +185,10 @@ amadeus.shopping.flight_destinations.get(origin: 'MAD')
 amadeus.shopping.flight_offers.get(origin: 'MAD', destination: 'OPO', departureDate: '2018-07-08')
 
 # Flight Check-in Links
-amadeus.reference_data.urls.checkin_links.get({ airline: '1X' })
+amadeus.reference_data.urls.checkin_links.get({ airline: 'BA' })
+
+# Airline Code Lookup
+amadeus.reference_data.airlines.get({ IATAcode: 'U2' })
 
 # Airport & City Search (autocomplete)
 # Find all the cities and airports starting by the keyword 'Lon'
@@ -203,7 +206,17 @@ amadeus.reference_data.locations.airports.get(longitude: 49.0000, latitude: 2.55
 amadeus.travel.analytics.fare_searches.get(origin: 'NCE', sourceCountry: 'FR', period: '2017-08')
 
 # Flight Most Traveled Destinations
-ramadeus.travel.analytics.air_traffic.traveled.get(origin: 'NCE', period: '2017-08')
+amadeus.travel.analytics.air_traffic.traveled.get(origin: 'NCE', period: '2017-08')
+
+# Flight Most Booked Destinations
+amadeus.travel.analytics.air_traffic.booked.get(origin: 'NCE', period: '2017-08')
+
+# Flight Busiest Period
+amadeus.travel.analytics.air_traffic.busiest_period.get(
+  city: 'NCE', 
+  period: '2017',
+  direction = Amadeus::Direction::ARRIVING
+)
 
 # Hotel Search API
 # Get list of hotels by cityCode

data/amadeus.gemspec

@@ -1,4 +1,3 @@
-
 lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'amadeus/version'

data/lib/amadeus.rb

@@ -2,6 +2,7 @@
 
 require 'amadeus/version'
 require 'amadeus/client/location'
+require 'amadeus/client/direction'
 require 'amadeus/client/response'
 require 'amadeus/client/decorator'
 require 'amadeus/client/access_token'
@@ -11,6 +12,7 @@ require 'amadeus/client'
 require 'amadeus/namespaces/travel'
 require 'amadeus/namespaces/shopping'
 require 'amadeus/namespaces/reference_data'
+require 'amadeus/namespaces/reference_data/airlines'
 require 'amadeus/namespaces/reference_data/urls'
 require 'amadeus/namespaces/reference_data/urls/checkin_links'
 require 'amadeus/namespaces/reference_data/location'
@@ -27,6 +29,8 @@ require 'amadeus/namespaces/travel/analytics'
 require 'amadeus/namespaces/travel/analytics/fare_searches'
 require 'amadeus/namespaces/travel/analytics/air_traffic'
 require 'amadeus/namespaces/travel/analytics/air_traffic/traveled'
+require 'amadeus/namespaces/travel/analytics/air_traffic/booked'
+require 'amadeus/namespaces/travel/analytics/air_traffic/busiest_period'
 
 # The namespace for the files used to make API
 # calls to the Amadeus travel APIs

data/lib/amadeus/client/direction.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Amadeus
+  # A list of directions, as used in Busiest Travel Period
+  module Direction
+    # Airport
+    ARRIVING = 'ARRIVING'.freeze
+    # City
+    DEPARTING = 'DEPARTING'.freeze
+  end
+end

data/lib/amadeus/namespaces/reference_data.rb

@@ -42,6 +42,17 @@ module Amadeus
       def location(location_id)
         Amadeus::Namespaces::ReferenceData::Location.new(client, location_id)
       end
+
+      # The namespace for the Airline Code APIs - accessing a specific airline
+      #
+      # @param [Number] airline_id The IATA ID for the airline
+      # @return [Amadeus::Namespaces::ReferenceData::Airlines]
+      # @example
+      #   amadeus.reference_data.airlines('U2')
+      #
+      def airlines
+        Amadeus::Namespaces::ReferenceData::Airlines.new(client)
+      end
     end
   end
 end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class ReferenceData
+      # A namespaced client for the
+      # +/v1/reference-data/airlines+ endpoints
+      #
+      # Access via the +Amadeus::Client+ object
+      #
+      #   amadeus = Amadeus::Client.new
+      #   amadeus.reference_data.airlines
+      #
+      class Airlines < Amadeus::Client::Decorator
+        # Returns the airline name for a given IATA code
+        # @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 what is the name of airline code 'U2'
+        #   amadeus.reference_data.airlines.get(IATACode: 'U2')
+        #
+        def get(params = {})
+          client.get('/v1/reference-data/airlines', params)
+        end
+      end
+    end
+  end
+end

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

@@ -21,7 +21,7 @@ module Amadeus
           # @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')
+          #   amadeus.reference_data.urls.checkin_links.get(airline: 'BA')
           #
           def get(params = {})
             client.get('/v2/reference-data/urls/checkin-links', params)

data/lib/amadeus/namespaces/travel/analytics/air_traffic.rb

@@ -19,12 +19,34 @@ module Amadeus
           #   [Amadeus::Namespaces::Travel::Analytics::AirTraffic::Traveled]
           # @example
           #   amadeus.travel.analytics.air_traffic.traveled
-          #
           def traveled
             Amadeus::Namespaces::Travel::Analytics::AirTraffic::Traveled.new(
               client
             )
           end
+
+          # The namespace for the Booked API:
+          #
+          # @return
+          #   [Amadeus::Namespaces::Travel::Analytics::AirTraffic::Booked]
+          # @example
+          #   amadeus.travel.analytics.air_traffic.booked
+          def booked
+            Amadeus::Namespaces::Travel::Analytics::AirTraffic::Booked.new(
+              client
+            )
+          end
+
+          # The namespace for the Busiest Period API:
+          #
+          # @return
+          # [Amadeus::Namespaces::Travel::Analytics::AirTraffic::BusiestPeriod]
+          # @example
+          # amadeus.travel.analytics.air_traffic.busiest_period
+          def busiest_period
+            Amadeus::Namespaces::Travel::Analytics::AirTraffic::BusiestPeriod
+              .new(client)
+          end
         end
       end
     end

data/lib/amadeus/namespaces/travel/analytics/air_traffic/booked.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Travel
+      class Analytics
+        class AirTraffic
+          # A namespaced client for the
+          # +/v1/travel/analytics/air-traffic/booked+ endpoints
+          #
+          # Access via the +Amadeus::Client+ object
+          #
+          #   amadeus = Amadeus::Client.new
+          #   amadeus.travel.analytics.air_traffic.booked
+          #
+          class Booked < Amadeus::Client::Decorator
+            # Returns a list of air traffic reports, based on bookings.
+            #
+            # @option params [String] :origin IATA code of the origin city -
+            #   e.g. BOS for Boston - required
+            # @option params [String] :query period when consumers
+            # are travelling
+            #   in YYYY-MM format
+            # @return [Amadeus::Response] a parsed response
+            # @raise [Amadeus::Base] an exception if the call failed
+            # @example Find the air traffic from LHR in January 2011
+            #   amadeus.travel.analytics.air_traffic.booked.get(
+            #     origin: 'LHR',
+            #     period: '2017-03'
+            #   )
+            #
+            def get(params = {})
+              client.get('/v1/travel/analytics/air-traffic/booked', params)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/namespaces/travel/analytics/air_traffic/busiest_period.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Amadeus
+  module Namespaces
+    class Travel
+      class Analytics
+        class AirTraffic
+          # A namespaced client for the
+          # +/v1/travel/analytics/air-traffic/busiest-period+ endpoints
+          #
+          # Access via the +Amadeus::Client+ object
+          #
+          #   amadeus = Amadeus::Client.new
+          #   amadeus.travel.analytics.air_traffic.busiest_period
+          #
+          class BusiestPeriod < Amadeus::Client::Decorator
+            # Returns the months of the selected year, ordered from busiest
+            # to least busy.
+            #
+            # @option params [String] :city IATA code of the origin city -
+            #   e.g. BOS for Boston - required
+            # @option params [String] :period period when consumers
+            #   are travelling in YYYY format
+            # @option params [String] :direction to select between
+            # arrivals and departures (default: arrivals)
+            # @return [Amadeus::Response] a parsed response
+            # @raise [Amadeus::Base] an exception if the call failed
+            # @example What was the busiest travel period in 2017
+            #   amadeus.travel.analytics.air_traffic.busiest_period.get(
+            #     city: 'MAD',
+            #     period: '2017',
+            #     direction: Amadeus::Direction::ARRIVING
+            #   )
+            #
+            def get(params = {})
+              client.get('/v1/travel/analytics/air-traffic/busiest-period',
+                         params)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/amadeus/version.rb

@@ -2,5 +2,5 @@
 
 module Amadeus
   # The current client version
-  VERSION = '1.0.0'.freeze
+  VERSION = '1.1.0'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: amadeus
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Amadeus
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-04-20 00:00:00.000000000 Z
+date: 2018-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: awesome_print
@@ -197,6 +197,7 @@ files:
 - lib/amadeus/client.rb
 - lib/amadeus/client/access_token.rb
 - lib/amadeus/client/decorator.rb
+- lib/amadeus/client/direction.rb
 - lib/amadeus/client/errors.rb
 - lib/amadeus/client/http.rb
 - lib/amadeus/client/location.rb
@@ -208,6 +209,7 @@ files:
 - lib/amadeus/client/validator.rb
 - lib/amadeus/namespaces/core.rb
 - lib/amadeus/namespaces/reference_data.rb
+- lib/amadeus/namespaces/reference_data/airlines.rb
 - lib/amadeus/namespaces/reference_data/location.rb
 - lib/amadeus/namespaces/reference_data/locations.rb
 - lib/amadeus/namespaces/reference_data/locations/airports.rb
@@ -224,6 +226,8 @@ files:
 - lib/amadeus/namespaces/travel.rb
 - lib/amadeus/namespaces/travel/analytics.rb
 - lib/amadeus/namespaces/travel/analytics/air_traffic.rb
+- lib/amadeus/namespaces/travel/analytics/air_traffic/booked.rb
+- lib/amadeus/namespaces/travel/analytics/air_traffic/busiest_period.rb
 - lib/amadeus/namespaces/travel/analytics/air_traffic/traveled.rb
 - lib/amadeus/namespaces/travel/analytics/fare_searches.rb
 - lib/amadeus/version.rb
@@ -247,7 +251,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: Amadeus travel APIs