Merge pull request #25 from anthonyroux/sdk-updates_12NOV18

Redesign of the Flight Most Searched Destinations API

Author: anthonyroux

.github/CONTRIBUTING.md

@@ -3,7 +3,7 @@
 To run the project locally, clone the repository, and then create a virtual environment and install the dependencies.
 ```sh
 git clone https://github.com/amadeus4dev/amadeus-python.git
-cd amadeus-ruby
+cd amadeus-python
 ```
 
 First, ensure you have a version of every Python we support installed. Your versions may differ.

CHANGELOG.rst

@@ -1,6 +1,38 @@
 Changelog
 =========
 
+2.0.0 - 2018-10-14
+-------------------- 
+
+`Flight Most Searched Destinations <https://developers.amadeus.com/self-service/category/203/api-doc/6>`_: Redesign of the API - Split the previous endpoint in 2 endpoints:
+
+- 1st endpoint to find the most searched destinations
+- 2nd endpoint to have more data about a dedicated origin & destination
+
+`Flight Most Booked Destinations <https://developers.amadeus.com/self-service/category/203/api-doc/27>`_:
+
+- Rename origin to originCityCode
+
+`Flight Most Traveled Destinations <https://developers.amadeus.com/self-service/category/203/api-doc/7>`_:
+
+- Rename origin in originCityCode
+
+`Flight Check-in Links <https://developers.amadeus.com/self-service/category/203/api-doc/8>`_:
+
+- Rename airline to airlineCode
+
+`Airport & City Search <https://developers.amadeus.com/self-service/category/203/api-doc/10>`_:
+
+- Remove parameter onlyMajor
+
+`Airport Nearest Relevant <https://developers.amadeus.com/self-service/category/203/api-doc/9>`_:
+
+- Add radius as parameter
+
+`Airline Code Lookup <https://developers.amadeus.com/self-service/category/203/api-doc/26>`_:
+
+- Regroup parameters *IATACode* and *ICAOCode* under the same name *airlineCodes*
+
 1.1.0 - 2018-08-01
 --------------------
 

README.rst

@@ -209,10 +209,10 @@ List of supported endpoints
     amadeus.shopping.flight_offers.get(origin='MAD', destination='NYC', departureDate='2019-08-01')
     
     # Flight Checkin Links
-    amadeus.reference_data.urls.checkin_links.get(airline='BA')
+    amadeus.reference_data.urls.checkin_links.get(airlineCode='BA')
 
     # Airline Code Lookup
-    amadeus.reference_data.airlines.get(IATACode='U2')
+    amadeus.reference_data.airlines.get(airlineCodes='U2')
 
     # Airport and City Search (autocomplete)
     # Find all the cities and airports starting by 'LON'
@@ -224,16 +224,16 @@ List of supported endpoints
     amadeus.reference_data.locations.airports.get(longitude=49.000, latitude=2.55)
 
     # Flight Most Searched Destinations
-    amadeus.travel.analytics.fare_searches.get(origin='MAD', sourceCountry='SP', period='2017-08')
+    amadeus.travel.analytics.fare_searches.get(originCityCode='MAD', sourceCountry='SP', period='2017-08')
 
     # Flight Most Booked Destinations
-    amadeus.travel.analytics.air_traffic.booked.get(origin='MAD', period='2017-08')
+    amadeus.travel.analytics.air_traffic.booked.get(originCityCode='MAD', period='2017-08')
 
     # Flight Most Traveled Destinations
-    amadeus.travel.analytics.air_traffic.traveled.get(origin='MAD', period='2017-01')
+    amadeus.travel.analytics.air_traffic.traveled.get(originCityCode='MAD', period='2017-01')
 
     # Flight Busiest Travel Period
-    amadeus.travel.analytics.air_traffic.busiest_period.get(origin='MAD', period='2017', direction='ARRIVING')
+    amadeus.travel.analytics.air_traffic.busiest_period.get(cityCode='MAD', period='2017', direction='ARRIVING')
 
     # Hotel Search API
     # Get list of Hotels by city code

amadeus/reference_data/_airlines.py

@@ -8,9 +8,11 @@ def get(self, **params):
 
         .. code-block:: python
 
-            amadeus.reference_data.airlines.get(IATACode='U2')
+            amadeus.reference_data.airlines.get(airlineCodes='U2')
 
-        :param IATACode: the IATA code for the airline, e.g. ``"1X"``
+        :param airlineCodes: the IATA or ICAO code for the airline, e.g.
+        :``"AF"`` (Air France IATA code)
+        :or ``"AFR"`` (Air France ICAO code)
 
         :rtype: amadeus.Response
         :raises amadeus.ResponseError: if the request could not be completed

amadeus/reference_data/urls/_checkin_links.py

@@ -9,9 +9,9 @@ def get(self, **params):
 
         .. code-block:: python
 
-            amadeus.reference_data.urls.checkin_links.get(airline='1X')
+            amadeus.reference_data.urls.checkin_links.get(airlineCode='BA')
 
-        :param airline: the IATA code for the airline, e.g. ``"1X"``
+        :param airlineCode: the IATA code for the airline, e.g. ``"BA"``
         :param language: the locale for the links, for example ``"en-GB"``
 
         :rtype: amadeus.Response

amadeus/travel/_analytics.py

@@ -1,10 +1,8 @@
 from amadeus.client.decorator import Decorator
 from .analytics._air_traffic import AirTraffic
-from .analytics._fare_searches import FareSearches
 
 
 class Analytics(Decorator, object):
     def __init__(self, client):
         Decorator.__init__(self, client)
-        self.fare_searches = FareSearches(client)
         self.air_traffic = AirTraffic(client)

amadeus/travel/analytics/__init__.py

@@ -1,5 +1,4 @@
-from ._fare_searches import FareSearches
 from ._air_traffic import AirTraffic
 
 
-__all__ = ['FareSearches', 'AirTraffic']
+__all__ = ['AirTraffic']

amadeus/travel/analytics/_air_traffic.py

@@ -1,6 +1,8 @@
 from amadeus.client.decorator import Decorator
 from .air_traffic._traveled import Traveled
 from .air_traffic._booked import Booked
+from .air_traffic._searched import Searched
+from .air_traffic._searched_by_destination import SearchedByDestination
 from .air_traffic._busiest_period import BusiestPeriod
 
 
@@ -9,4 +11,6 @@ def __init__(self, client):
         Decorator.__init__(self, client)
         self.booked = Booked(client)
         self.traveled = Traveled(client)
+        self.searched = Searched(client)
+        self.searched_by_destination = SearchedByDestination(client)
         self.busiest_period = BusiestPeriod(client)

amadeus/travel/analytics/_fare_searches.py

@@ -1,6 +1,9 @@
 from ._traveled import Traveled
+from ._searched import Searched
+from ._searched_by_destination import SearchedByDestination
 from ._booked import Booked
 from ._busiest_period import BusiestPeriod
 
 
-__all__ = ['Traveled', 'Booked', 'BusiestPeriod']
+__all__ = ['Searched', 'SearchedByDestination',
+           'Traveled', 'Booked', 'BusiestPeriod']