Skip to main content

Lightweight command line app to get fast weather data right on the command line

Project description

cli-weather

cli-weather is a command line app to get instant weather data based on city name or postalcode right on the command line. Written in python and powered by WeatherBIT API, cli-weather also provides detailed weather data on historic and 16 day forecasts basis and also detailed air quality information.

With cli-weather app you can retrieve current weather observations from over 45,000 live weather stations using WeatherBIT API, and highly localized weather forecasts for any point on the globe using the world's most trusted weather models!

You can look up weather data by many methods including:

  • By entering city_name
  • By entering postal_code

Installation

pip install cli-weather

Usage

cli-weather command [-h] [-c COUNTRY] [-a] [-u UNITS] [-d] [-f] city_name/postal_code
Command Description
city Get weather by city name
postalcode Get weather by postal code
Option Description
-a, --airquality Display current air quality
-f, --forecast Forecast on weather/airquality
-c, --country Country of entered area
-u, --units Metric, Scientific, Farenheit
-d, --detailed Display detailed weather data
-h, --help Show this message and exit

Data sources

Dependencies

Try without using pip

Fork this repository
$ git clone "https://github.com/username/cli-weather"
$ cd cli_weather
$ pip install requests
$ python main.py [command] [options]

License

GNU General Public License v3.0

ver 0.1.4

3 - Alpha Test Release

  • Introduced new optional argument -f, --forecast which gives 7 day weather forecast [for now will extend to airquality forecast by next release] with daily intervals from any point on the planet. The result can be fetched by either the city name or postalcode.
  • Forecast data from the world's most accurate weather models including the GFS 13km, ECMWF, DWD 6.5km ICON-Europe, and NOAA 3km HRRR.
  • Code reuse made for both city and postalcode by dividing functions in each class to new modules altogether.

ver 0.1.3

3 - Alpha Test Release

  • Current Air quality observations for any point in the world.Returns current information on the six major pollutants - PM 2.5, PM 10, CO, SO2, NO2, and O3 as well as an US EPA AirQuality Index (AQI) score.
  • Detailed aqi information along with its associated category and subsequent health risk status.
  • Functional-Programming layout, scope for more by next release
  • Set choices for units to avoid wrong units chosen
  • Change in description of --detailed optional argument to accomodate new -a functionality
  • Choose a subparser status during empty positional argument scenario

ver 0.1.2

3 - Alpha Test Release

  • Python2 and Python3 compatible
  • Introduction of wheel distribution in binary
  • Minor bug fixes in setup.py

ver 0.1.1

3 - Alpha Test Release

  • Minor bug fixes in setup.py
  • Doc update in PyPIDocumentation.md

ver 0.1.0

3 - Alpha Test Release

  • Get weather by city
  • Get weather by postalcode
  • Change units according as you wish [Metric/Scientific/Farenheit]
  • Only temparature by default, detailed information from snowfall to solar radiation using -d

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cli-weather-0.1.4.tar.gz (7.9 kB view hashes)

Uploaded Source

Built Distribution

cli_weather-0.1.4-py2.py3-none-any.whl (21.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page