A minimalist Forecast.io API client.
Project description
For complete docs and API options see: https://developer.forecast.io/docs/v2
Requirements
Python 2.5+
requests 1.2.0+
Installation
To install requests-forecast, simply:
$ pip install requests-forecast
Documentation
Development version: http://requests-forecast.rtfd.org.
Quickstart
Creating a client
>>> from requests_forecast import Forecast >>> forecast = Forecast(apikey='FORECAST_API_KEY', latitude=38.9717, longitude=-95.235)
Getting the current conditions
>>> current = forecast.get_currently() >>> print current['temperature'] 58.9
Getting minutely conditions
>>> current = forecast.get_minutely() >>> current['summary'] u'Mostly cloudy for the hour.' >>> current['data'][0].keys() [u'precipIntensity', u'time']
Getting hourly conditions
>>> current = forecast.get_hourly() >>> current['temperature'] 59.52 >>> forecast.get_hourly()['summary'] Mostly cloudy until tomorrow afternoon. >>> forecast.get_hourly()['data'][0]['temperature'] >>> 59.52
Getting daily conditions
>>> forecast.get_daily()['summary'] u'Mixed precipitation off-and-on throughout the week; temperatures peaking at 70\xb0 on Sunday.' >>> forecast.get_daily()['data'][0]['temperatureMax'] 63.85 >>> forecast.get_daily()['data'][0]['temperatureMin'] 35.05
Getting alerts
>>> forecast.alerts() { "expires": 1366898400, "uri": "http://alerts.weather.gov/cap/wwacapget.php?x=KS124EFAC89CD0.FreezeWarning.124EFAD6F320KS.TOPNPWTOP.8ab7d76a4db42b9136a1a6849a631097", "title": "Freeze Warning for Douglas, KS" }
Example usage
from datetime import datetime from requests_forecast import Forecast forecast = Forecast(apikey='YOUR-API-KEY') data = forecast.get(latitude=38.9717, longitude=-95.235) >>> forecast.get_currently()['temperature'] 58.9 data = forecast.get(latitude=38.9717, longitude=-95.235, time=datetime(year=2013, month=12, day=29)) >>> forecast.get_currently()['temperature'] 58.9 >>> forecast.get_currently()['temperature'] 36.75
License
New BSD
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
requests-forecast-0.6.0.tar.gz
(24.1 kB
view hashes)
Built Distribution
Close
Hashes for requests_forecast-0.6.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0bf3c6822220eb83c94c334c7f11c20c60777706a27ff3a171a39fc509c300e5 |
|
MD5 | 2bf2f000b6c35e1c1a46a6ce4d5f0c1b |
|
BLAKE2b-256 | 63ad1ac75a9e5ba2f2076dd5143e6dceff09e8a1ec1f6ee7c85927ec10dd003f |