add support for flight price analysis

Author: tsolakoua

README.rst

@@ -325,6 +325,10 @@ List of supported endpoints
     # Returns a single activity from a given id
     amadeus.shopping.activity('4615').get()
 
+    # Returns itinerary price metrics
+    amadeus.analytics.itinerary_price_metrics.get(originIataCode='MAD', destinationIataCode='CDG',
+                                                departureDate='2021-03-21')
+
 Development & Contributing
 --------------------------
 

amadeus/analytics/__init__.py

@@ -0,0 +1,3 @@
+from ._itinerary_price_metrics import ItineraryPriceMetrics
+
+__all__ = ['ItineraryPriceMetrics']

amadeus/analytics/_itinerary_price_metrics.py

@@ -0,0 +1,29 @@
+from amadeus.client.decorator import Decorator
+
+
+class ItineraryPriceMetrics(Decorator, object):
+
+    def get(self, **params):
+        '''
+        Returns itinerary price metrics by search criteria
+
+        .. code-block:: python
+
+            amadeus.analytics.itinerary_price_metrics.get(
+                                            originIataCode='MAD',
+                                            destinationIataCode='CDG',
+                                            departureDate='2021-03-21')
+
+        :param originIataCode: IATA code of the origin city, for
+            example ``"BOS"`` for Boston.
+
+        :param destinationIataCode: IATA code of the destination city,
+            for example ``"ATH"`` for Athens.
+
+        :param departureDate: scheduled departure date of the flight,
+            local to the departure airport, format YYYY-MM-DD
+
+        :rtype: amadeus.Response
+        :raises amadeus.ResponseError: if the request could not be completed
+        '''
+        return self.client.get('/v1/analytics/itinerary-price-metrics', **params)

amadeus/namespaces/_analytics.py

@@ -0,0 +1,8 @@
+from amadeus.client.decorator import Decorator
+from amadeus.analytics._itinerary_price_metrics import ItineraryPriceMetrics
+
+
+class Analytics(Decorator, object):
+    def __init__(self, client):
+        Decorator.__init__(self, client)
+        self.itinerary_price_metrics = ItineraryPriceMetrics(client)

amadeus/namespaces/core.py

@@ -7,6 +7,7 @@
 from amadeus.namespaces._booking import Booking
 from amadeus.namespaces._safety import Safety
 from amadeus.namespaces._schedule import Schedule
+from amadeus.namespaces._analytics import Analytics
 
 
 class Core(object):
@@ -20,3 +21,4 @@ def __init__(self):
         self.booking = Booking(self)
         self.safety = Safety(self)
         self.schedule = Schedule(self)
+        self.analytics = Analytics(self)

docs/index.rst

@@ -197,4 +197,10 @@ Schedule/Flights
 ================
 
 .. autoclass:: amadeus.schedule.flights
+  :members: get
+
+Analytics/ItineraryPriceMetrics
+================
+
+.. autoclass:: amadeus.analytics.itinerary_price_metrics
   :members: get

specs/namespaces/namespaces_spec.py

@@ -77,6 +77,9 @@
         expect(client.schedule).not_to(be_none)
         expect(client.schedule.flights).not_to(be_none)
 
+        expect(client.analytics).not_to(be_none)
+        expect(client.analytics.itinerary_price_metrics).not_to(be_none)
+
     with it('should define all expected .get methods'):
         client = self.client
         expect(client.reference_data.urls.checkin_links.get).not_to(be_none)
@@ -130,6 +133,8 @@
 
         expect(client.schedule.flights.get).not_to(be_none)
 
+        expect(client.analytics.itinerary_price_metrics.get).not_to(be_none)
+
     with it('should define all expected .delete methods'):
         client = self.client
         expect(client.booking.flight_order('123').delete).not_to(be_none)
@@ -458,3 +463,9 @@
             expect(self.client.get).to(have_been_called_with(
                 '/v1/shopping/activities/XXX', a='b'
             ))
+
+        with it('.analytics.itinerary_price_metrics().get'):
+            self.client.analytics.itinerary_price_metrics.get(a='b')
+            expect(self.client.get).to(have_been_called_with(
+                '/v1/analytics/itinerary-price-metrics', a='b'
+            ))