airportsdata 2026.3.25__tar.gz

airportsdata-2026.3.25/LICENSE

@@ -0,0 +1,24 @@
+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.

airportsdata-2026.3.25/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: airportsdata
+Version: 2026.3.25
+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-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: 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 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+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,428
+
+.. |IATA| replace:: 7,884
+
+.. |LID| replace:: 12,746
+
+.. |pyversion| image:: https://img.shields.io/pypi/v/airportsdata.svg
+    :target: https://pypi.org/project/airportsdata/
+    :alt: pypi version
+.. |support| image:: https://img.shields.io/pypi/pyversions/airportsdata.svg
+    :target: https://pypi.org/project/airportsdata/
+    :alt: supported Python version
+.. |pypi_version| image:: https://img.shields.io/pypi/v/airportsdata.svg?label=
+    :target: https://pypi.org/project/airportsdata/
+    :alt: PyPI version
+.. |format| image:: https://img.shields.io/pypi/format/airportsdata.svg
+    :target: https://pypi.org/project/airportsdata/
+    :alt: Kit format
+.. |downloads| image:: https://static.pepy.tech/badge/airportsdata
+    :target: https://www.pepy.tech/project/airportsdata
+    :alt: PyPI downloads
+.. |license| image:: https://img.shields.io/pypi/l/airportsdata.svg
+    :target: https://pypi.org/project/airportsdata/
+    :alt: license
+.. |issues| image:: https://img.shields.io/github/issues-raw/mborsetti/airportsdata
+    :target: https://github.com/mborsetti/airportsdata/issues
+    :alt: issues
+.. |CI| image:: https://github.com/mborsetti/airportsdata/actions/workflows/ci-cd.yaml/badge.svg?event=push
+    :target: https://github.com/mborsetti/airportsdata/actions
+    :alt: CI testing status
+.. |coveralls| image:: https://coveralls.io/repos/github/mborsetti/airportsdata/badge.svg?branch=main
+    :target: https://coveralls.io/github/mborsetti/airportsdata?branch=main
+    :alt: code coverage by Coveralls
+.. |status| image:: https://img.shields.io/pypi/status/airportsdata.svg
+    :target: https://pypi.org/project/airportsdata/
+    :alt: Package stability
+.. |security| image:: https://img.shields.io/badge/security-bandit-yellow.svg
+    :target: https://github.com/PyCQA/bandit
+    :alt: Security Status
+
+Extensive database of location and timezone data for nearly every operational airport and landing strip in the world,
+with |ICAO| entries.
+
+Each entry consists of the following data:
+
+* ``icao``: ICAO 4-letter Location Indicator (Doc 7910) or (if none) an internal Pseudo-ICAO Identifier [#]_ (|ICAO|
+  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 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 or 6 decimal digits);
+* ``lon``: Longitude (decimal) of the `airport reference point
+  <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.
+
+.. [#] See `here <https://github.com/mborsetti/airportsdata/blob/main/README_identifiers.rst>`__ for an explanation on
+   how the Pseudo-ICAO Identifier is generated for airports and seaplane bases without an ICAO 4-letter Location
+   Indicator.
+
+.. [#] 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
+expected by users.
+
+Important notes:
+
+* Timezone was originally sourced from `TimeZoneDB <https://timezonedb.com>`__;
+* No historical data (closed airports are removed);
+* No seaplane bases or heliports unless they have a IATA code;
+* No surface transportation stations, even if they have an official IATA code;
+* Airports under construction may be included if they have ICAO and IATA codes and scheduled airline service.
+
+Please report any issues you may find `here
+<https://github.com/mborsetti/airportsdata/blob/main/CONTRIBUTING.rst>`__.
+
+This project is a fork of `mwgg/Airports <https://github.com/mwgg/Airports>`__. All new data submitted in this fork have
+been validated against national `Aeronautical Information Publications (AIP)
+<https://github.com/mborsetti/airportsdata/blob/main/README_AIP.rst>`__ or equivalent, ARINC database,
+`IATA <https://www.iata.org/en/publications/directories/code-search/>`__ or
+`ch-aviation.com <https://about.ch-aviation.com/airports/>`_  before publishing.
+
+Raw data
+========
+
+A CSV (comma separated values) file, with headers and encoded in UTF-8, is downloadable from GitHub `here
+<https://github.com/mborsetti/airportsdata/raw/main/airportsdata/airports.csv>`__.
+
+Python
+======
+|pyversion| |support| |format| |status| |security| |CI| |coveralls| |issues|
+
+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 --update airportsdata
+
+Once installed, to load the data into a dict:
+
+.. code-block:: python
+
+   import airportsdata
+   icao_airports = airportsdata.load()  # key is the ICAO identifier (the default)
+   print(icao_airports['KJFK'])
+
+or
+
+.. code-block:: python
+
+   import airportsdata
+   iata_airports = airportsdata.load('IATA')  # key is the IATA location code
+   print(iata_airports['JFK'])
+
+or
+
+.. code-block:: python
+
+   import airportsdata
+   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).
+
+License |license|
+=================
+
+Released under the `MIT License <https://opensource.org/licenses/MIT>`__ (see license `here
+<https://github.com/mborsetti/airportsdata/blob/main/LICENSE>`__).

airportsdata-2026.3.25/README.rst

@@ -0,0 +1,149 @@
+========================
+airportsdata |downloads|
+========================
+
+.. |ICAO| replace:: 28,428
+
+.. |IATA| replace:: 7,884
+
+.. |LID| replace:: 12,746
+
+.. |pyversion| image:: https://img.shields.io/pypi/v/airportsdata.svg
+    :target: https://pypi.org/project/airportsdata/
+    :alt: pypi version
+.. |support| image:: https://img.shields.io/pypi/pyversions/airportsdata.svg
+    :target: https://pypi.org/project/airportsdata/
+    :alt: supported Python version
+.. |pypi_version| image:: https://img.shields.io/pypi/v/airportsdata.svg?label=
+    :target: https://pypi.org/project/airportsdata/
+    :alt: PyPI version
+.. |format| image:: https://img.shields.io/pypi/format/airportsdata.svg
+    :target: https://pypi.org/project/airportsdata/
+    :alt: Kit format
+.. |downloads| image:: https://static.pepy.tech/badge/airportsdata
+    :target: https://www.pepy.tech/project/airportsdata
+    :alt: PyPI downloads
+.. |license| image:: https://img.shields.io/pypi/l/airportsdata.svg
+    :target: https://pypi.org/project/airportsdata/
+    :alt: license
+.. |issues| image:: https://img.shields.io/github/issues-raw/mborsetti/airportsdata
+    :target: https://github.com/mborsetti/airportsdata/issues
+    :alt: issues
+.. |CI| image:: https://github.com/mborsetti/airportsdata/actions/workflows/ci-cd.yaml/badge.svg?event=push
+    :target: https://github.com/mborsetti/airportsdata/actions
+    :alt: CI testing status
+.. |coveralls| image:: https://coveralls.io/repos/github/mborsetti/airportsdata/badge.svg?branch=main
+    :target: https://coveralls.io/github/mborsetti/airportsdata?branch=main
+    :alt: code coverage by Coveralls
+.. |status| image:: https://img.shields.io/pypi/status/airportsdata.svg
+    :target: https://pypi.org/project/airportsdata/
+    :alt: Package stability
+.. |security| image:: https://img.shields.io/badge/security-bandit-yellow.svg
+    :target: https://github.com/PyCQA/bandit
+    :alt: Security Status
+
+Extensive database of location and timezone data for nearly every operational airport and landing strip in the world,
+with |ICAO| entries.
+
+Each entry consists of the following data:
+
+* ``icao``: ICAO 4-letter Location Indicator (Doc 7910) or (if none) an internal Pseudo-ICAO Identifier [#]_ (|ICAO|
+  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 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 or 6 decimal digits);
+* ``lon``: Longitude (decimal) of the `airport reference point
+  <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.
+
+.. [#] See `here <https://github.com/mborsetti/airportsdata/blob/main/README_identifiers.rst>`__ for an explanation on
+   how the Pseudo-ICAO Identifier is generated for airports and seaplane bases without an ICAO 4-letter Location
+   Indicator.
+
+.. [#] 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
+expected by users.
+
+Important notes:
+
+* Timezone was originally sourced from `TimeZoneDB <https://timezonedb.com>`__;
+* No historical data (closed airports are removed);
+* No seaplane bases or heliports unless they have a IATA code;
+* No surface transportation stations, even if they have an official IATA code;
+* Airports under construction may be included if they have ICAO and IATA codes and scheduled airline service.
+
+Please report any issues you may find `here
+<https://github.com/mborsetti/airportsdata/blob/main/CONTRIBUTING.rst>`__.
+
+This project is a fork of `mwgg/Airports <https://github.com/mwgg/Airports>`__. All new data submitted in this fork have
+been validated against national `Aeronautical Information Publications (AIP)
+<https://github.com/mborsetti/airportsdata/blob/main/README_AIP.rst>`__ or equivalent, ARINC database,
+`IATA <https://www.iata.org/en/publications/directories/code-search/>`__ or
+`ch-aviation.com <https://about.ch-aviation.com/airports/>`_  before publishing.
+
+Raw data
+========
+
+A CSV (comma separated values) file, with headers and encoded in UTF-8, is downloadable from GitHub `here
+<https://github.com/mborsetti/airportsdata/raw/main/airportsdata/airports.csv>`__.
+
+Python
+======
+|pyversion| |support| |format| |status| |security| |CI| |coveralls| |issues|
+
+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 --update airportsdata
+
+Once installed, to load the data into a dict:
+
+.. code-block:: python
+
+   import airportsdata
+   icao_airports = airportsdata.load()  # key is the ICAO identifier (the default)
+   print(icao_airports['KJFK'])
+
+or
+
+.. code-block:: python
+
+   import airportsdata
+   iata_airports = airportsdata.load('IATA')  # key is the IATA location code
+   print(iata_airports['JFK'])
+
+or
+
+.. code-block:: python
+
+   import airportsdata
+   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).
+
+License |license|
+=================
+
+Released under the `MIT License <https://opensource.org/licenses/MIT>`__ (see license `here
+<https://github.com/mborsetti/airportsdata/blob/main/LICENSE>`__).

airportsdata-2026.3.25/airportsdata/__init__.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+
+"""
+Extensive database of location and timezone data for nearly every airport and landing strip in the world.
+"""
+
+from __future__ import annotations
+
+import csv
+from pathlib import Path
+from typing import Dict, Literal, TypedDict
+
+__project_name__ = __package__
+__min_python_version__ = (3, 10)  # minimum version of Python required to run; supported until October 2025
+__version__ = '2026.03.25'  # numbering follows the release date (UTC)
+__author__ = 'Mike Borsetti <mike@borsetti.com>'
+__copyright__ = 'Copyright 2020- Mike Borsetti'
+__license__ = 'MIT'
+__url__ = f'https://github.com/mborsetti/{__project_name__}'
+
+Airport = TypedDict(
+    'Airport',
+    {
+        'icao': str,
+        'iata': str,
+        'name': str,
+        'city': str,
+        'subd': str,
+        'country': str,
+        'elevation': float,
+        'lat': float,
+        'lon': float,
+        'tz': str,
+        'lid': str,
+    },
+)
+CodeType = Literal['ICAO', 'IATA', 'LID']
+IATAMAC = TypedDict('IATAMAC', {'name': str, 'country': str, 'airports': Dict[str, Airport]})
+
+
+def load(code_type: CodeType = 'ICAO') -> Dict[str, 'Airport']:
+    """Loads airport data into a dict
+
+    :param code_type: optional argument defining the key in the dictionary: 'ICAO' (default if omitted),
+    'IATA' (for IATA Location Codes) or 'LID' (for U.S. FAA Location Identifiers).
+
+    :return: a dict of dicts, each entry having the following keys:
+        'icao': ICAO 4-letter Location Indicator or 4-alphanumeric FAA/TC LID
+        'iata': IATA 3-letter Location Code or an empty string
+        'name': Official name (diacritized latin script)
+        'city': City
+        'subd': Subdivision (e.g. state, province, region, etc.)
+        'country': ISO 3166-1 alpha 2-code (plus 'XK' for Kosovo)
+        'elevation': MSL elevation (the highest point of the landing area) in feet
+        'lat': Latitude (decimal)
+        'lon': Longitude (decimal)
+        'tz': Timezone expressed as a tz database name (IANA-compliant) or empty string for country 'AQ' (Antarctica).
+            Originally sourced from [TimeZoneDB](https://timezonedb.com)
+        'lid': The FAA Location Identifier (for US country only; others is blank)
+    """
+    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}')
+    this_dir = Path(__file__).parent
+    airports: 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:
+            # 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
+
+
+def load_iata_macs() -> dict[str, IATAMAC]:
+    """Loads IATA's Multi Airport Cities (for the "purpose of pricing, fare construction and mileage creation")
+    data into a dict.
+
+    :return: a dict of dicts, each entry having the following keys:
+        'name': The IATA city name,
+        'country': The IATA country code,
+        '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.
+    """
+    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:
+            for key, value in row_d.items():
+                if key == 'Country':
+                    country = value
+                elif key == 'City Code':
+                    multi_airport_city_code = value
+                elif key == 'City Name':
+                    name = value
+                elif key == 'Airport Code':
+                    airport = value
+            if multi_airport_city_code not in iata_macs:
+                iata_macs[multi_airport_city_code] = {
+                    'name': name,
+                    'country': country,
+                    'airports': {airport: airports[airport]},
+                }
+            else:
+                iata_macs[multi_airport_city_code]['airports'][airport] = airports[airport]
+    return iata_macs
+
+
+# Python 3.9 code used to save the dict to CSV:
+# with open('airports.csv', 'w', newline='') as f:
+#     fieldnames = airports[list(airports.keys())[0]].keys()
+#     writer = csv.DictWriter(f, fieldnames=fieldnames, quoting=csv.QUOTE_NONNUMERIC)
+#     writer.writeheader()
+#     for data in airports.values():
+#         writer.writerow(data)