airportsdata 20240806__tar.gz → 20250204__tar.gz

{airportsdata-20240806/airportsdata.egg-info → airportsdata-20250204}/PKG-INFO

@@ -1,63 +1,44 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: airportsdata
-Version: 20240806
+Version: 20250204
 Summary: Extensive database of location and timezone data for nearly every airport and landing strip in the world.
 Author-email: Mike Borsetti <mike+airportsdata@borsetti.com>
 Maintainer-email: Mike Borsetti <mike+airportsdata@borsetti.com>
-License: The MIT License (MIT)
-        
-        Copyright (c) 2020- Mike Borsetti <mike@borsetti.com>
-        
-        This project includes data from https://github.com/mwgg/Airports Copyright
-        (c) 2014 mwgg
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
+License-Expression: MIT
 Project-URL: Documentation, https://github.com/mborsetti/airportsdata/blob/main/README.rst
 Project-URL: Repository, https://github.com/mborsetti/airportsdata/
 Project-URL: Database (csv), https://github.com/mborsetti/airportsdata/blob/main/airportsdata/airports.csv
 Project-URL: Changelog, https://github.com/mborsetti/airportsdata/blob/main/CHANGELOG.rst
 Project-URL: Issues, https://github.com/mborsetti/airportsdata/issues
+Project-URL: CI, https://github.com/mborsetti/airportsdata/actions
 Keywords: airports,aerodromes,ICAO,IATA
 Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Database
-Classifier: Intended Audience :: Developers
-Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
+Dynamic: license-file
 
 ========================
 airportsdata |downloads|
 ========================
 
-.. |ICAO| replace:: 28,226
+.. |ICAO| replace:: 28,274
 
-.. |IATA| replace:: 7,867
+.. |IATA| replace:: 7,865
 
-.. |LID| replace:: 12,604
+.. |LID| replace:: 12,610
 
 .. |pyversion| image:: https://img.shields.io/pypi/v/airportsdata.svg
     :target: https://pypi.org/project/airportsdata/
@@ -102,16 +83,16 @@ Each entry consists of the following data:
   entries);
 * ``iata``: IATA 3-letter Location Code (|IATA| entries) or an empty string [#]_;
 * ``name``: Official name (diacritized latin script);
-* ``city``: City (diacritized latin script), ideally using the local language;
+* ``city``: City (diacritized latin script), ideally using the local language or English;
 * ``subd``: Subdivision (e.g. state, province, region, etc.), ideally using the local-language or English names of
   `ISO 3166-2 <https://en.wikipedia.org/wiki/ISO_3166-2#Current_codes>`__;
 * ``country``: `ISO 3166-1 <https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes>`__ alpha-2 country code
   (plus ``XK`` for Kosovo);
 * ``elevation``: MSL elevation of the highest point of the landing area, in feet (warning: it is often wrong);
 * ``lat``: Latitude (decimal) of the `airport reference point
-  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 decimal digits);
+  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 or 6 decimal digits);
 * ``lon``: Longitude (decimal) of the `airport reference point
-  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 decimal digits);
+  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 or 6 decimal digits);
 * ``tz``: Timezone expressed as a `tz database name <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>`__
   (IANA-compliant);
 * ``lid``: U.S. FAA Location Identifier (|LID| entries), or an empty string.
@@ -120,8 +101,8 @@ Each entry consists of the following data:
    how the Pseudo-ICAO Identifier is generated for airports and seaplane bases without an ICAO 4-letter Location
    Indicator.
 
-.. [#] IATA Multi Airport Cities are not not airports and therfore not included, but we provide a database and a Python
-   function that returns the above data for all the airports of a IATA MAC. Please see documentation `here
+.. [#] IATA Multi Airport Cities (MAC) are not not airports and therfore not included, but we provide a database and a 
+   Python function that returns the above data for all the airports of a IATA MAC. Please see documentation `here
    <https://github.com/mborsetti/airportsdata/blob/main/README_IATA.rst>`__.
 
 Best efforts are placed to review all contributions for accuracy, but accuracy cannot be guaranteed nor should be
@@ -130,7 +111,10 @@ expected by users.
 Important notes:
 
 * Timezone was originally sourced from `TimeZoneDB <https://timezonedb.com>`__;
-* No historical data (closed airports are removed).
+* No historical data (closed airports are removed);
+* No heliports without a IATA code;
+* No sea bases without a IATA code;
+* No surface transportation stations, even if they have an official IATA code.
 
 Please report any issues you may find `here
 <https://github.com/mborsetti/airportsdata/blob/main/CONTRIBUTING.rst>`__.
@@ -138,7 +122,10 @@ Please report any issues you may find `here
 This project is a fork of https://github.com/mwgg/Airports. All new data submitted in this fork have been validated
 against national `Aeronautical Information Publications (AIP) or equivalent
 <https://github.com/mborsetti/airportsdata/blob/main/README_AIP.rst>`__ (or
-ARINC database) and `IATA <https://www.iata.org/en/publications/directories/code-search/>`__ before publishing.
+ARINC database) and `IATA <https://www.iata.org/en/publications/directories/code-search/>`__ or 
+`<https://www.ch-aviation.com/airports/{IATA}>`__  before publishing.
+ARINC database) and `IATA <https://www.iata.org/en/publications/directories/code-search/>`__ or
+`<https://www.ch-aviation.com/airports/{IATA}>`_  before publishing.
 
 Raw data
 ========
@@ -150,35 +137,41 @@ Python
 ======
 |pyversion| |support| |format| |status| |security| |CI| |coveralls| |issues|
 
-Install from `PyPi <https://pypi.org/project/airportsdata/>`__  using pip:
+Install from `PyPi <https://pypi.org/project/airportsdata/>`__  using ``uv`` (recommended):
+
+.. code-block:: bash
+
+  uv pip install --update airportsdata
+
+Or, using ``pip``:
 
 .. code-block:: bash
 
-  pip install -U airportsdata
+  pip install --update airportsdata
 
 Once installed, to load the data into a dict:
 
 .. code-block:: python
 
    import airportsdata
-   airports = airportsdata.load()  # key is the ICAO identifier (the default)
-   print(airports['KJFK'])
+   icao_airports = airportsdata.load()  # key is the ICAO identifier (the default)
+   print(icao_airports['KJFK'])
 
 or
 
 .. code-block:: python
 
    import airportsdata
-   airports = airportsdata.load('IATA')  # key is the IATA location code
-   print(airports['JFK'])
+   iata_airports = airportsdata.load('IATA')  # key is the IATA location code
+   print(iata_airports['JFK'])
 
 or
 
 .. code-block:: python
 
    import airportsdata
-   airports = airportsdata.load('LID')  # key is the FAA LID
-   print(airports['01AA'])
+   lid_airports = airportsdata.load('LID')  # key is the FAA LID
+   print(lid_airports['01AA'])
 
 Older Python versions are supported for 3 years after being obsoleted by a new major release (i.e. about 4 years
 since their original release).

{airportsdata-20240806 → airportsdata-20250204}/README.rst

@@ -2,11 +2,11 @@
 airportsdata |downloads|
 ========================
 
-.. |ICAO| replace:: 28,226
+.. |ICAO| replace:: 28,274
 
-.. |IATA| replace:: 7,867
+.. |IATA| replace:: 7,865
 
-.. |LID| replace:: 12,604
+.. |LID| replace:: 12,610
 
 .. |pyversion| image:: https://img.shields.io/pypi/v/airportsdata.svg
     :target: https://pypi.org/project/airportsdata/
@@ -51,16 +51,16 @@ Each entry consists of the following data:
   entries);
 * ``iata``: IATA 3-letter Location Code (|IATA| entries) or an empty string [#]_;
 * ``name``: Official name (diacritized latin script);
-* ``city``: City (diacritized latin script), ideally using the local language;
+* ``city``: City (diacritized latin script), ideally using the local language or English;
 * ``subd``: Subdivision (e.g. state, province, region, etc.), ideally using the local-language or English names of
   `ISO 3166-2 <https://en.wikipedia.org/wiki/ISO_3166-2#Current_codes>`__;
 * ``country``: `ISO 3166-1 <https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes>`__ alpha-2 country code
   (plus ``XK`` for Kosovo);
 * ``elevation``: MSL elevation of the highest point of the landing area, in feet (warning: it is often wrong);
 * ``lat``: Latitude (decimal) of the `airport reference point
-  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 decimal digits);
+  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 or 6 decimal digits);
 * ``lon``: Longitude (decimal) of the `airport reference point
-  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 decimal digits);
+  <https://en.wikipedia.org/wiki/Airport_reference_point>`__ (max 5 or 6 decimal digits);
 * ``tz``: Timezone expressed as a `tz database name <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>`__
   (IANA-compliant);
 * ``lid``: U.S. FAA Location Identifier (|LID| entries), or an empty string.
@@ -69,8 +69,8 @@ Each entry consists of the following data:
    how the Pseudo-ICAO Identifier is generated for airports and seaplane bases without an ICAO 4-letter Location
    Indicator.
 
-.. [#] IATA Multi Airport Cities are not not airports and therfore not included, but we provide a database and a Python
-   function that returns the above data for all the airports of a IATA MAC. Please see documentation `here
+.. [#] IATA Multi Airport Cities (MAC) are not not airports and therfore not included, but we provide a database and a 
+   Python function that returns the above data for all the airports of a IATA MAC. Please see documentation `here
    <https://github.com/mborsetti/airportsdata/blob/main/README_IATA.rst>`__.
 
 Best efforts are placed to review all contributions for accuracy, but accuracy cannot be guaranteed nor should be
@@ -79,7 +79,10 @@ expected by users.
 Important notes:
 
 * Timezone was originally sourced from `TimeZoneDB <https://timezonedb.com>`__;
-* No historical data (closed airports are removed).
+* No historical data (closed airports are removed);
+* No heliports without a IATA code;
+* No sea bases without a IATA code;
+* No surface transportation stations, even if they have an official IATA code.
 
 Please report any issues you may find `here
 <https://github.com/mborsetti/airportsdata/blob/main/CONTRIBUTING.rst>`__.
@@ -87,7 +90,10 @@ Please report any issues you may find `here
 This project is a fork of https://github.com/mwgg/Airports. All new data submitted in this fork have been validated
 against national `Aeronautical Information Publications (AIP) or equivalent
 <https://github.com/mborsetti/airportsdata/blob/main/README_AIP.rst>`__ (or
-ARINC database) and `IATA <https://www.iata.org/en/publications/directories/code-search/>`__ before publishing.
+ARINC database) and `IATA <https://www.iata.org/en/publications/directories/code-search/>`__ or 
+`<https://www.ch-aviation.com/airports/{IATA}>`__  before publishing.
+ARINC database) and `IATA <https://www.iata.org/en/publications/directories/code-search/>`__ or
+`<https://www.ch-aviation.com/airports/{IATA}>`_  before publishing.
 
 Raw data
 ========
@@ -99,35 +105,41 @@ Python
 ======
 |pyversion| |support| |format| |status| |security| |CI| |coveralls| |issues|
 
-Install from `PyPi <https://pypi.org/project/airportsdata/>`__  using pip:
+Install from `PyPi <https://pypi.org/project/airportsdata/>`__  using ``uv`` (recommended):
 
 .. code-block:: bash
 
-  pip install -U airportsdata
+  uv pip install --update airportsdata
+
+Or, using ``pip``:
+
+.. code-block:: bash
+
+  pip install --update airportsdata
 
 Once installed, to load the data into a dict:
 
 .. code-block:: python
 
    import airportsdata
-   airports = airportsdata.load()  # key is the ICAO identifier (the default)
-   print(airports['KJFK'])
+   icao_airports = airportsdata.load()  # key is the ICAO identifier (the default)
+   print(icao_airports['KJFK'])
 
 or
 
 .. code-block:: python
 
    import airportsdata
-   airports = airportsdata.load('IATA')  # key is the IATA location code
-   print(airports['JFK'])
+   iata_airports = airportsdata.load('IATA')  # key is the IATA location code
+   print(iata_airports['JFK'])
 
 or
 
 .. code-block:: python
 
    import airportsdata
-   airports = airportsdata.load('LID')  # key is the FAA LID
-   print(airports['01AA'])
+   lid_airports = airportsdata.load('LID')  # key is the FAA LID
+   print(lid_airports['01AA'])
 
 Older Python versions are supported for 3 years after being obsoleted by a new major release (i.e. about 4 years
 since their original release).

{airportsdata-20240806 → airportsdata-20250204}/airportsdata/__init__.py

@@ -3,6 +3,7 @@
 """
 Extensive database of location and timezone data for nearly every airport and landing strip in the world.
 """
+
 from __future__ import annotations
 
 import csv
@@ -10,8 +11,8 @@ from pathlib import Path
 from typing import Dict, Literal, TypedDict
 
 __project_name__ = __package__
-__min_python_version__ = (3, 9)  # minimum version of Python required to run; supported until 4 October 2024
-__version__ = '20240806'  # numbering follows the release date
+__min_python_version__ = (3, 10)  # minimum version of Python required to run; supported until October 2025
+__version__ = '20250204'  # numbering follows the release date (UTC)
 __author__ = 'Mike Borsetti <mike@borsetti.com>'
 __copyright__ = 'Copyright 2020- Mike Borsetti'
 __license__ = 'MIT'
@@ -57,14 +58,6 @@ def load(code_type: CodeType = 'ICAO') -> Dict[str, 'Airport']:
             Originally sourced from [TimeZoneDB](https://timezonedb.com)
         'lid': The FAA Location Identifier (for US country only; others is blank)
     """
-    # with open(os.path.join(dir, 'airports.json'), encoding='utf8') as f:
-    #     airports = json.load(f)
-    # if code_type.lower() == 'icao':
-    #     return airports
-    # else:
-    #     return {airport['iata']: airport for airport in dict(airports).values() if airport['iata']}
-    #
-    #
     key = code_type.lower()
     if key not in ('icao', 'iata', 'lid'):
         raise ValueError(f'code_type must be one of ICAO, IATA or LID; received {code_type}')
@@ -73,7 +66,9 @@ def load(code_type: CodeType = 'ICAO') -> Dict[str, 'Airport']:
     with this_dir.joinpath('airports.csv').open(encoding='utf8') as f:
         reader = csv.DictReader(f, quoting=csv.QUOTE_NONNUMERIC)
         for row in reader:
-            airports[row[key]] = row  # type: ignore[assignment]
+            # if row[key] and row[key] in airports:
+            #     raise ValueError(f"Duplicate key in csv: '{row[key]}'")
+            airports[row[key]] = row
     airports.pop('', None)
     return airports
 
@@ -88,18 +83,14 @@ def load_iata_macs() -> dict[str, IATAMAC]:
         'airports': a dict with the same data returned by load() for each airport that makes up the Multi Airport
            City, where the key is the airport's IATA code.
     """
-    # with open(os.path.join(dir, 'airports.json'), encoding='utf8') as f:
-    #     airports = json.load(f)
-    # if code_type.lower() == 'icao':
-    #     return airports
-    # else:
-    #     return {airport['iata']: airport for airport in dict(airports).values() if airport['iata']}
-    #
-    #
     airports = load('IATA')
     this_dir = Path(__file__).parent
     iata_macs: dict[str, IATAMAC] = {}
     row_d: dict[str, str]
+    multi_airport_city_code = ''
+    name = ''
+    country = ''
+    airport = ''
     with this_dir.joinpath('iata_macs.csv').open(encoding='utf8') as f:
         reader = csv.DictReader(f, quoting=csv.QUOTE_NONNUMERIC)
         for row_d in reader:
@@ -113,7 +104,7 @@ def load_iata_macs() -> dict[str, IATAMAC]:
                 elif key == 'Airport Code':
                     airport = value
             if multi_airport_city_code not in iata_macs:
-                iata_macs[multi_airport_city_code] = {  # type: ignore[assignment]
+                iata_macs[multi_airport_city_code] = {
                     'name': name,
                     'country': country,
                     'airports': {airport: airports[airport]},