Skip to main content

A pythonic implementation of the National Weather Service API

Project description

NWS-APy: A Pythonic Implementation of the National Weather Service API

NWS-APy (APy for short) takes a pythonic approach to retrieving (GET) and organizing data using the National Weather Service API (found here: https://www.weather.gov/documentation/services-web-api#/)

There are 3 goals that the package aims to achieve:

  • Keep clean, simplistic, minimalistic, and consistent code on the user end.
  • Minimize potential 404/500 errors and knowledge overhead.
  • Format output to popular meteorological data types.

A simple example

APy is designed to be simple and easy to use. For example, if we wanted to get all of the tornado warnings in Oklahoma and just display the headline:

from nwsapy import api_connector

tor_warnings = api_connector.get_active_alerts(event = "Tornado Warning", area = "OK")

# Check to make sure there aren't any request errors.
# If so, let the user know by raising an error.
if tor_warnings.has_any_request_errors:
    raise ConnectionError(f'Details: {tor_warnings['detail']})

# iterate through all of the tornado warnings in Oklahoma and print the headline.
for warning in tor_warnings:
    print(warning.headline)

Documentation

Documentation for NWSAPy be found here

Contact/Support

I want to hear from you. If you have any questions regarding the package usage, please send me an email. If you encounter an issue, please open an issue on GitHub.

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

nwsapy-1.0.3.tar.gz (50.1 kB view details)

Uploaded Source

File details

Details for the file nwsapy-1.0.3.tar.gz.

File metadata

  • Download URL: nwsapy-1.0.3.tar.gz
  • Upload date:
  • Size: 50.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.5.0.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.3

File hashes

Hashes for nwsapy-1.0.3.tar.gz
Algorithm Hash digest
SHA256 ea6eca848d2f0f57575c82b4568ee6f0022e70b3bb160393f46865f1b5b39a17
MD5 1d3356c127dd1927d260feadb411fb79
BLAKE2b-256 94cbda192bcb46ff49741827dfdaeb99c8d1aeb6df81b6d5b3ac209884d4ef37

See more details on using hashes here.

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