Skip to main content

A CLI utility for retrieving weather information.

Project description

# wxcast

A CLI utility for retrieving weather information.

[![Build Status](](

![wxcast metar](images/metar.gif)

## Overview

Provides weather information in terminal:

- Weather text information from NWS API.
- METAR info from AVWX API.
- Seven day forecasts based on location using geopy and NWS API.

## Installation

pip install wxcast

## Requirements

- certifi
- Click>=6.0
- geopy
- requests

## Test Requirements

- flake8
- pytest
- pytest-cov
- vcrpy

## Usage


Provides the METAR information for a given airport ICAO:

>>> wxcast metar kden
KDEN 250100Z 06011KT 1/2SM -DZ BR OVC005 09/07 A2999 RMK AO2 SFC VIS 1 1/2 P0001 T00890072

The data can be decoded and pretty printed to terminal using the
-d/--decoded option.

>>> wxcast metar -d kden
At 250100Z the conditions for KDEN are LIFR

Altimeter: 29.99inHg (1016hPa)
Clouds: Overcast layer at 500ft - Reported AGL
Dewpoint: 07C (45F)
Other: Light Drizzle, Mist
Temperature: 09C (48F)
Visibility: 0.5sm (0.8km)
Wind: ENE-060 at 11kt

City: Denver
Country: USA
Elevation: 5433ft (1656m)
Latitude: 39.86165639
Longitude: -104.6731775
Name: International Airport
Priority: 0
State: CO

### Products

Provides the available text products for a given WFO (weather forecast

>>> wxcast products bou
AFD: Area Forecast Discussion
CAP: Common Alerting Protocol
FDI: Fire Danger Indices
FWF: Routine Fire Wx Fcst (With/Without 6-10 Day Outlook)
FWL: Land Management Forecasts
FWM: Miscellaneous Fire Weather Product
FWN: Fire Weather Notification
FWO: Fire Weather Observation
FWS: Suppression Forecast
HRR: Weather Roundup
HWO: Hazardous Weather Outlook
OSO: Other Surface Observations
PFM: Point Forecast Matrices
PNS: Public Information Statement
RFW: Red Flag Warning
RR2: Hydro-Met Data Report Part 2
RR3: Hydro-Met Data Report Part 3
RR9: Hydro-Met Data Report Part 9
RTP: Regional Max/Min Temp and Precipitation Table
SRG: Soaring Guidance
STQ: Spot Forecast Request
SYN: Regional Weather Synopsis
TVL: Travelers Forecast
VFT: Terminal Aerodrome Forecast (TAF) Verification
ZFP: Zone Forecast Product

### Text Product

Provides the text information for the given product and WFO. Displays
text in a pager window for easier reading and scrolling.

>>> wxcast text bou afd

### Forecast

Provides the seven day NWS forecast for the given location.

>>> wxcast forecast denver
Tonight: Rain showers likely. Cloudy. Low around 42, with temperatures
rising to around 45 overnight. North northeast
wind around 7 mph. Chance of precipitation is
60%. New rainfall amounts less than a tenth of an
inch possible.
Monday: A chance of rain showers. Mostly cloudy, with a high near 53.
North northeast wind around 7 mph. Chance of
precipitation is 30%. New rainfall amounts less
than a tenth of an inch possible.
Monday Night: A slight chance of showers and thunderstorms before midnight.
Mostly cloudy, with a low around 41. South
southeast wind around 3 mph. Chance of
precipitation is 20%. New rainfall amounts less
than a tenth of an inch possible.

The location can be a city, address or zip/postal code.

>>> wxcast forecast 80303

If there are spaces in the location it must be surrounded by quotes.

>>> wxcast forecast "325 Broadway Boulder, CO"

## Issues/Enhancements

Please submit issues and requests to

## Contributing

Contributions to **wxcast** are welcome and encouraged. See
[CONTRIBUTING]( for info on getting started.

## License

Copyright (c) 2017 Sean Marlow.

Distributed under the terms of GPL-3.0+ license, see [LICENSE](LICENSE)
for details.

# v1.2.1 (2018-02-19)

- Convert docs to md for PyPI compatibility.

# v1.2.0 (2018-02-18)

- Remove asserts.
- Account for dictionary values in decoded metar.

# v1.1.0 (2017-12-01)

- Update readme.
- Cleanup exception handling.
- Add unit and integration tests with vcrpy.
- Cleanup flake8 warnings.
- Add config for travis integration testing.

# v1.0.6 (2017-09-24)

- Remove docs directory.
- Fix manifest.

# v1.0.5 (2017-09-24)

# v1.0.4 (2017-09-24)

- Fix license trove classifier.

# v1.0.3 (2017-09-24)

- Remove universal flag from setup config.

# v1.0.2 (2017-09-24)

- Fix doc extensions in setup.

# v1.0.1 (2017-09-24)

- Fix manifest.

# v1.0.0 (2017-09-24)

- Cleanup flake8 warnings.
- Remove config in favor of geopy to get location for seven day
- Migrate to f'{strings}'
- Migrate to adoc from rst.
- Cleanup code.
- Update readme and docs.

# v0.3.0 (2017-08-09)

- Remove cert and use certifi for NWS API.
- Convert elevation to feet.

# v0.2.1 (2017-08-09)

- Attempt to fix cert.

# v0.2.0 (2017-08-08)

- Attempt to fix cert.

# v0.1.0 (2017-01-14)

- First release on PyPI.

Project details

Download files

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

Files for wxcast, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size wxcast-1.2.1.tar.gz (33.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page