add support for tours and activities API

Author: tsolakoua

README.rst

@@ -316,6 +316,15 @@ List of supported endpoints
     # Retrieve status of a given flight
     amadeus.schedule.flights.get(carrierCode='AZ', flightNumber='319', scheduledDepartureDate='2021-03-13')
 
+    # Tours and Activities
+    # What are the popular activities in Madrid (based a geo location and a radius)
+    amadeus.shopping.activities.get(latitude=40.41436995, longitude=-3.69170868)
+    # What are the popular activities in Barcelona? (based on a square)
+    amadeus.shopping.activities.by_square.get(north=41.397158, west=2.160873,
+                                              south=41.394582, east=2.177181)
+    # Returns a single activity from a given id
+    amadeus.shopping.activity('4615').get()
+
 Development & Contributing
 --------------------------
 

amadeus/namespaces/_shopping.py

@@ -7,6 +7,8 @@
 from amadeus.shopping._hotel_offers_by_hotel import HotelOffersByHotel
 from amadeus.shopping._hotel_offer import HotelOffer
 from amadeus.shopping._seatmaps import Seatmaps
+from amadeus.shopping._activities import Activities
+from amadeus.shopping._activity import Activity
 
 
 class Shopping(Decorator, object):
@@ -19,10 +21,14 @@ def __init__(self, client):
         self.hotel_offers_by_hotel = HotelOffersByHotel(client)
         self.flight_offers_search = FlightOffersSearch(client)
         self.seatmaps = Seatmaps(client)
+        self.activities = Activities(client)
 
     def hotel_offer(self, offer_id):
         return HotelOffer(self.client, offer_id)
 
+    def activity(self, activity_id):
+        return Activity(self.client, activity_id)
+
 
 __all__ = ['FlightDates', 'FlightDestinations', 'FlightOffers',
            'FlightOffersSearch']

amadeus/shopping/__init__.py

@@ -5,7 +5,9 @@
 from ._hotel_offers import HotelOffers
 from ._hotel_offers_by_hotel import HotelOffersByHotel
 from ._hotel_offer import HotelOffer
+from ._activities import Activities
 
 __all__ = ['FlightOffers', 'FlightDates',
            'FlightDestinations', 'FlightOffersSearch',
-           'HotelOffers', 'HotelOffersByHotel', 'HotelOffer']
+           'HotelOffers', 'HotelOffersByHotel',
+           'HotelOffer', 'Activities']

amadeus/shopping/_activities.py

@@ -0,0 +1,32 @@
+from amadeus.client.decorator import Decorator
+from amadeus.shopping.activities._by_square \
+    import BySquare
+
+
+class Activities(Decorator, object):
+    def __init__(self, client):
+        Decorator.__init__(self, client)
+        self.by_square = BySquare(client)
+
+    def get(self, **params):
+        '''
+        Returns activities for a given location
+
+        .. code-block:: python
+
+
+            client.shopping.activities.get(
+                longitude=2.160873,
+                latitude=41.397158
+            )
+
+        :param latitude: latitude of geographic location to search around.
+            For example: ``41.397158``
+        :param longitude: longitude of geographic location to search around.
+            For example: ``2.160873``
+
+        :rtype: amadeus.Response
+        :raises amadeus.ResponseError: if the request could not be completed
+        '''
+        return self.client.get(
+            '/v1/shopping/activities', **params)

amadeus/shopping/_activity.py

@@ -0,0 +1,21 @@
+from amadeus.client.decorator import Decorator
+
+
+class Activity(Decorator, object):
+    def __init__(self, client, activity_id):
+        Decorator.__init__(self, client)
+        self.activity_id = activity_id
+
+    def get(self, **params):
+        '''
+        Returns a single activity from a given id.
+
+        .. code-block:: python
+
+            client.shopping.activities('4615').get()
+
+        :rtype: amadeus.Response
+        :raises amadeus.ResponseError: if the request could not be completed
+        '''
+        return self.client.get('/v1/shopping/activities/{0}'
+                               .format(self.activity_id), **params)

amadeus/shopping/activities/__init__.py

@@ -0,0 +1,2 @@
+from ._by_square import BySquare
+__all__ = ['BySquare']

amadeus/shopping/activities/_by_square.py

@@ -0,0 +1,33 @@
+from amadeus.client.decorator import Decorator
+
+
+class BySquare(Decorator, object):
+    def get(self, **params):
+        '''
+        Returns a list of activities
+            around a defined square (4 points).
+
+        .. code-block:: python
+
+
+            client.shopping.activities.by_square.get(
+                north=41.397158,
+                west=2.160873,
+                south=41.394582,
+                east=2.177181
+            )
+
+        :param north: latitude north of bounding box.
+            For example: ``41.397158``
+        :param west: longitude west of bounding box.
+            For example: ``2.160873``
+        :param south: latitude south of bounding box.
+            For example: ``41.394582``
+        :param east: longitude east of bounding box.
+            For example: ``2.177181``
+
+        :rtype: amadeus.Response
+        :raises amadeus.ResponseError: if the request could not be completed
+        '''
+        return self.client.get(
+            '/v1/shopping/activities/by-square', **params)

docs/index.rst

@@ -68,6 +68,18 @@ Shopping/FlightOffers
 .. autoclass:: amadeus.shopping.FlightOffersPrice
   :members: post
 
+Shopping/Activities
+===============
+
+.. autoclass:: amadeus.shopping.Activities
+  :members: get
+
+.. autoclass:: amadeus.shopping.activities.BySquare
+  :members: get
+
+.. autoclass:: amadeus.shopping.Activity
+  :members: get
+
 Travel/Analytics
 ================
 

specs/namespaces/namespaces_spec.py

@@ -48,6 +48,8 @@
         expect(client.shopping.hotel_offer).not_to(be_none)
         expect(client.shopping.hotel_offers_by_hotel).not_to(be_none)
 
+        expect(client.shopping.activities).not_to(be_none)
+
         expect(client.e_reputation.hotel_sentiments).not_to(be_none)
 
         expect(client.airport).not_to(be_none)
@@ -438,3 +440,21 @@
             expect(self.client.get).to(have_been_called_with(
                 '/v2/schedule/flights', a='b'
             ))
+        with it('.shopping.activities.get'):
+            self.client.shopping.activities.get(a='b')
+            expect(self.client.get).to(have_been_called_with(
+                '/v1/shopping/activities', a='b'
+            ))
+
+        with it('.shopping.activities.by_square.get'):
+            self.client.shopping.activities.by_square.get(
+                a='b')
+            expect(self.client.get).to(have_been_called_with(
+                '/v1/shopping/activities/by-square', a='b'
+            ))
+
+        with it('.shopping.activity().get'):
+            self.client.shopping.activity('XXX').get(a='b')
+            expect(self.client.get).to(have_been_called_with(
+                '/v1/shopping/activities/XXX', a='b'
+            ))