Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/e3v3a/iata-arrivals-cli

Get airport arrivals, departures, details and METAR weather info from CLI
https://github.com/e3v3a/iata-arrivals-cli

airport arrivals cli departures flights iata icao metar package pip

Last synced: 15 days ago
JSON representation

Get airport arrivals, departures, details and METAR weather info from CLI

Host: GitHub
URL: https://github.com/e3v3a/iata-arrivals-cli
Owner: E3V3A
License: gpl-3.0
Created: 2018-11-28T14:52:37.000Z (almost 6 years ago)
Default Branch: master
Last Pushed: 2022-01-21T23:37:13.000Z (almost 3 years ago)
Last Synced: 2024-10-13T12:27:28.206Z (about 1 month ago)
Topics: airport, arrivals, cli, departures, flights, iata, icao, metar, package, pip
Language: Python
Homepage:
Size: 115 KB
Stars: 20
Watchers: 4
Forks: 7
Open Issues: 4
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.txt
- License: LICENSE.txt

Awesome Lists containing this project

README

### The IATA Arrivals CLI (Command Line Interface)

[![pypi supported versions][1]][2]
[![PyPI version][3]][4]
[![Maintenance][5]][6]
[![GitHub last commit][7]][8]
[![Average time to resolve an issue][9]][10]

[1]: https://img.shields.io/pypi/pyversions/iata-arrivals-cli.svg
[2]: https://pypi.python.org/pypi/iata-arrivals-cli
[3]: https://badge.fury.io/py/iata-arrivals-cli.svg
[4]: https://badge.fury.io/py/iata-arrivals-cli
[5]: https://img.shields.io/badge/Maintained%3F-yes-green.svg
[6]: https://GitHub.com/E3V3A/iata-arrivals-cli/graphs/commit-activity
[7]: https://img.shields.io/github/last-commit/E3V3A/iata-arrivals-cli.svg
[8]: https://github.com/E3V3A/iata-arrivals-cli/commits/master "Last commits to Master branch"
[9]: http://isitmaintained.com/badge/resolution/E3V3A/iata-arrivals-cli.svg
[10]: http://isitmaintained.com//project/E3V3A/iata-arrivals-cli "Average time to resolve an issue"

[13]: https://api.codacy.com/project/badge/Grade/176ceaabe43d4113b535f2fbd0487a9e
[14]: https://www.codacy.com/app/E3V3A/iata-arrivals-cli?utm_source=github.com&utm_medium=referral&utm_content=E3V3A/iata-arrivals-cli&utm_campaign=Badge_Grade

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](./docs/screenshot_arrivals.png)
_{(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](https://en.wikipedia.org/wiki/IATA_airport_code) 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](https://en.wikipedia.org/wiki/ICAO_airport_code) 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](./docs/screenshot_airports.png "List most airports for a country")
![Full](./docs/screenshot_departures1.png "List current Departures for an airport")
![Full](./docs/screenshot_info.png "List airport info for an airport")

### Dependencies

This package depend on the API library [pyflightdata](https://github.com/supercoderz/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:

```bash
pip install iata-arrivals-cli
```

For manual/development install:

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

In other words you can do this:

```bash
# pip install
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]

Options:
-d -- Show Departures instead of Arrivals (default)
-n -- Only show next number of flights
-i -- 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 -- List all available airport IATA codes for a country given by
-m -- Get last hour's METAR data for an airport given by its IATA
-x -- Show direct fligths between 2 airports given by their 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

- [pyflightdata](https://github.com/supercoderz/pyflightdata)
- [flightradar24](https://github.com/mkorkmaz/flightradar24)
- [MMM-aviationwx](https://github.com/dam3313/MMM-aviationwx/) - A [MagicMirror](https://github.com/MichMich/MagicMirror) METAR module
- [MMM-FlightsAbove](https://github.com/E3V3A/MMM-FlightsAbove) - A MagicMirror Module for displaying current flights in the sky above you!
- Do you know of - or have any others? (Post it in an new issue.)

#### Even more...

- https://github.com/jhermsmeier/node-flight-designator
- https://github.com/ram-nadella/airport-codes
- https://github.com/jpatokal/openflights
- https://github.com/derhuerst/flightradar24-client
- https://github.com/iatacodes/nodejs-sdk
- https://github.com/Otetz/iata_codes
- https://github.com/msgrasser/iata-parser
- https://github.com/leopieters/aviation-edge-api
- https://github.com/marians/py-icao-aircrft

[and so on...](https://github.com/search?p=13&q=iata&type=Repositories&utf8=%E2%9C%93)

### 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/?format=application/json`
5. http://www.fly.faa.gov/flyfaa/usmap.jsp

---

### License

![GPLv3 Logo](https://www.gnu.org/graphics/gplv3-88x31.png "I use `GPLv3` because sharing code modifications is more beneficial for the world.")
[![GitHub license][21]][22]
A license to :sparkling_heart:!

_{I use `GPLv3` because sharing code modifications is more beneficial for the world.}

[21]: https://img.shields.io/github/license/E3V3A/iata-arrivals-cli.svg
[22]: https://github.com/E3V3A/iata-arrivals-cli/blob/master/LICENSE.txt