add travel recommendations support

Author: tsolakoua

README.rst

@@ -310,6 +310,9 @@ List of supported endpoints
     # Get the result of the process by jobId
     amadeus.travel.trip_parser_jobs.result(response.data['id']).get()
 
+    # Travel Recommendations
+    amadeus.reference_data.recommended_locations.get(cityCodes='PAR', travelerCountryCode='FR')
+
 Development & Contributing
 --------------------------
 

amadeus/namespaces/_reference_data.py

@@ -3,6 +3,7 @@
 from amadeus.reference_data._location import Location
 from amadeus.reference_data._locations import Locations
 from amadeus.reference_data._airlines import Airlines
+from amadeus.reference_data._recommended_locations import RecommendedLocations
 
 
 class ReferenceData(Decorator, object):
@@ -11,6 +12,7 @@ def __init__(self, client):
         self.urls = Urls(client)
         self.locations = Locations(client)
         self.airlines = Airlines(client)
+        self.recommended_locations = RecommendedLocations(client)
 
     def location(self, location_id):
         return Location(self.client, location_id)

amadeus/reference_data/__init__.py

@@ -1,5 +1,6 @@
 from ._location import Location
 from ._locations import Locations
 from ._airlines import Airlines
+from ._recommended_locations import RecommendedLocations
 
-__all__ = ['Location', 'Locations', 'Airlines']
+__all__ = ['Location', 'Locations', 'Airlines', 'RecommendedLocations']

amadeus/reference_data/_recommended_locations.py

@@ -0,0 +1,29 @@
+from amadeus.client.decorator import Decorator
+
+
+class RecommendedLocations(Decorator, object):
+    def __init__(self, client):
+        Decorator.__init__(self, client)
+
+    def get(self, **params):
+        '''
+        Returns a list of destination recommendations
+
+        .. code-block:: python
+
+
+            client.reference_data.recommended_locations.get(
+                cityCodes='PAR'
+                travelerCountryCode='FR'
+            )
+
+        :param cityCodes: city used by the algorithm to recommend new destinations
+            For example: ``PAR``
+        :param travelerCountryCode: origin country following IATA standard
+            For example: ``FR``
+
+        :rtype: amadeus.Response
+        :raises amadeus.ResponseError: if the request could not be completed
+        '''
+        return self.client.get(
+            '/v1/reference-data/recommended-locations', **params)

specs/namespaces/namespaces_spec.py

@@ -86,6 +86,7 @@
             ).not_to(be_none)
         expect(client.reference_data.locations.point_of_interest(
             '9CB40CB5D0').get).not_to(be_none)
+        expect(client.reference_data.recommended_locations.get).not_to(be_none)
 
         expect(client.travel.analytics.air_traffic.traveled.get).not_to(be_none)
         expect(client.travel.analytics.air_traffic.booked.get).not_to(be_none)
@@ -186,6 +187,12 @@
                 '/v1/reference-data/locations/pois/XXX', a='b'
             ))
 
+        with it('.reference_data.recommended_locations.get'):
+            self.client.reference_data.recommended_locations.get(a='b')
+            expect(self.client.get).to(have_been_called_with(
+                '/v1/reference-data/recommended-locations', a='b'
+            ))
+
         with it('.travel.analytics.air_traffic.traveled.get'):
             self.client.travel.analytics.air_traffic.traveled.get(a='b')
             expect(self.client.get).to(have_been_called_with(