Skip to content

Latest commit

 

History

History
199 lines (137 loc) · 7.35 KB

README.md

File metadata and controls

199 lines (137 loc) · 7.35 KB

The IATA Arrivals CLI (Command Line Interface)

pypi supported versions PyPI version Maintenance GitHub last commit Average time to resolve an issue

A simple tool to show dapartures, arrivals and various airport information given an IATA code or country name.

STATUS: Version Date Maintained?
Working 1.0.2 2022-01-21 YES

Example Output:

Full
(FFS always include a screenshot in your GitHub repo!)

Repo Description

This is a repository of various Python3 and (eventually) Node.js tools that can be used to obtain various flight information from airports around the globe. The tools here depend on both some open source libraries and some provider API's. However, most likely the functionality of this can easily be broken as the services are private and the tools often depend on various forms of web scraping and API hacking.


Q: What does arrivals do?

arrivals is a Python3 script that display current arrivals and departures given an airport IATA code. However, it can also show additional airport and weather information. These include items such as:

  • The official IATA full/long Name of the airport
  • The IATA and ICAO airport codes
  • The Lat/Lon GPS coordinates with map URL
  • The Airport website URL
  • The current weather info such as:
    Nav, Sky, Visibility, Temperature, Pressure, Wind Speed/Direction, Humidity etc.
  • The Airport's current METAR info
  • The ICAO code and IATA names of most officially listed airports for a given country name.
  • The most recent and scheduled non-stop flights between 2 given airports.

Q: What does it not do?

  • show detailed flight info
  • show aircraft or carrier info
  • show aiport info for airports not connected to the international
    air traffic controller (ATC) network or internet.
  • it may not show the very latest METAR data (depending on Airport availability)

Screenshots!

Full Full Full

Dependencies

This package depend on the API library pyflightdata, which is used to collect all the relevant data from the FlightRadar24 site. However, that library in turn depend on:

  • beautifulsoup4, jsonpath-rw, lxml, metar, requests, ply, decorator, html5lib, webencodings

It is also recommended to install lxml before, you install pyflightdata, because that dependency often require extra source compiling, which is prone to additional dependency errors.

Installation

For pip install:

pip install iata-arrivals-cli

For manual/development install:

  1. First install all dependencies from above
  2. Then install pyflightdata
  3. Then clone this repository
  4. Then install it in your bin path at your convenience

In other words you can do this:

# pip install <dependencies-from-above>
pip install pyflightdata
git clone https://github.com/E3V3A/iata-arrivals-cli.git
cd iata-arrivals-cli
#pip install iata-arrivals-cli

Usage

$ arrivals -h

 Usage:  arrivals [options] <airport-IATA-code>

 Options:
        -d <airport-iata>    -- Show Departures instead of Arrivals (default)
        -n <n>               -- Only show next <n> number of flights
        -i <airport-iata>    -- Show information about an Airport given its IATA code [Country, Lat/Lon, TZ]
        -j <1,2>             -- Enable debug mode at level 1 or 2 to print the full JSON response
        -l <country-name>    -- List all available airport IATA codes for a country given by <country-name>
        -m <airport-iata>    -- Get last hour's METAR data for an airport given by its IATA <airport-code>
        -x <iata-1> <iata-2> -- Show direct fligths between 2 airports given by their <iata> codes
        -c                   -- Print Copyright License and maintenance URL.
        -v                   -- Print program Version
        -h, --help           -- Print this help


 --- IMPORTANT! -----------------------------------------------
   • All times shown are in the timezone of your computer!
   • Do not attempt to run these queries in rapid succession,
     as your IP might get blocked by the API providers.
 --------------------------------------------------------------

Development

Feel free to send a PR in case you have some improvements.

Related Projects

Even more...

and so on...

Related Services Used

  1. http://pyflightdata.readthedocs.io/en/latest/pyflightdata.html
  2. https://www.latlong.net/
  3. https://aviationweather.gov/
  4. http://services.faa.gov/airport/status/<IATA_CODE>?format=application/json
  5. http://www.fly.faa.gov/flyfaa/usmap.jsp

License

GPLv3 Logo
GitHub license
A license to 💖!

I use GPLv3 because sharing code modifications is more beneficial for the world.