requests-forecast's Introduction

requests-forecast

🚧 WIP updates

This project "just worked" for half a decade until DarkSky announced they were shuttering their support.

This is a WIP upgrade to switch the API over to https://weathermachine.io

This will break, shift, and will eventually be renamed to support this new library.

For complete docs and API options see: https://weathermachine.io/docs

For complete docs and API options see: https://developer.forecast.io/docs/v2

Requirements

Python 3.6+
requests

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='YOUR-API-KEY')

Getting the current conditions

current = forecast.currently()
print(current['temperature'])
58.9

Getting minutely conditions

current = forecast.minutely()
current['summary']
u'Mostly cloudy for the hour.'
current['data'][0].keys()
[u'precipIntensity', u'time']

Getting hourly conditions

current = forecast.hourly()
current['temperature']
59.52
forecast.hourly()['summary']
Mostly cloudy until tomorrow afternoon.
forecast.hourly()['data'][0]['temperature']
59.52

Getting daily conditions

forecast.daily()['summary']
u'Mixed precipitation off-and-on throughout the week; temperatures peaking at 70\xb0 on Sunday.'
forecast.daily()['data'][0]['temperatureMax']
63.85
forecast.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 requests_forecast import Forecast

forecast = Forecast(apikey='YOUR-API-KEY')
data = forecast.get(latitude=38.9717, longitude=-95.235)

forecast.currently()['temperature']
58.9

data = forecast.get(latitude=38.9717, longitude=-95.235)

forecast.currently()['temperature']
58.9

forecast.currently()['temperature']
36.75

License

New BSD

requests-forecast's People

Contributors

Stargazers

Watchers

requests-forecast's Issues

Exception getting alerts when there are none

When there are no alerts, forecast.get_alerts() should return None (or maybe an empty list).

In [11]: forecast.get_alerts()
---------------------------------------------------------------------------
TypeError                                 Traceback (most recent call last)
/Users/.../.venv/lib/python2.7/site-packages/django/core/management/commands/shell.pyc in <module>()
----> 1 forecast.get_alerts()

/Users/.../.venv/lib/python2.7/site-packages/requests_forecast.pyc in get_alerts(self)
     79             #return self.json.alerts
     80             return DataBlock(self.json.alerts, self.timezone)
---> 81         return DataBlock()
     82
     83     def get_currently(self):

/Users/.../.venv/lib/python2.7/site-packages/requests_forecast.pyc in __init__(self, data, timezone)
     12     def __init__(self, data=None, timezone=None):
     13         self.timezone = timezone
---> 14         super(DataBlock, self).__init__(data)
     15         self.data = []
     16

TypeError: 'NoneType' object is not iterable

Obviously this is not critical, as I can catch the TypeError in my own code.

Recommend Projects