make weather_id an optional param, update example

Author: brentru

Adafruit_IO/client.py

@@ -162,11 +162,14 @@ def receive_time(self, time):
         timepath = "time/{0}".format(time)
         return self._get(timepath, is_time=True)
 
-    def receive_weather(self, weather_id):
-        """Get the specified weather record with current weather and all available forecast information.
-        :param int id: ID for forecast
+    def receive_weather(self, weather_id=None):
+        """Adafruit IO Weather Service, Powered by Dark Sky
+        :param int id: optional ID for retrieving a specified weather record.
         """
-        weatherpath = "integrations/weather/{0}".format(weather_id)
+        if weather_id:
+          weatherpath = "integrations/weather/{0}".format(weather_id)
+        else:
+          weatherpath = "integrations/weather"
         return self._get(weatherpath)
 
     def receive(self, feed):

examples/basics/darkskies.py renamed to examples/basics/darksky.py

@@ -1,24 +1,29 @@
 """
-Example of getting a darkskies forecast
-from Adafruit IO.
+Example of getting a forecast from Adafruit IO
+Note: This functionality is for IO PLUS users ONLY.
+
+Author: Brent Rubell for Adafruit Industries
 """
 # import Adafruit IO REST client.
 from Adafruit_IO import Client, Feed, RequestError
 
+# Set to your Adafruit IO username.
+# (go to https://accounts.adafruit.com to find your username)
+ADAFRUIT_IO_USERNAME = 'USER'
+
 # Set to your Adafruit IO key.
 # Remember, your key is a secret,
 # so make sure not to publish it when you publish this code!
-ADAFRUIT_IO_KEY = 'PASS'
+ADAFRUIT_IO_KEY = 'PASSWORD'
 
-# Set to your Adafruit IO username.
-# (go to https://accounts.adafruit.com to find your username)
-ADAFRUIT_IO_USERNAME = 'USER'
 
 # Create an instance of the REST client.
 aio = Client(ADAFRUIT_IO_USERNAME, ADAFRUIT_IO_KEY)
 
+print('Get all weather integration records without their current forecast values.')
+records = aio.receive_weather()
+print(records)
 
-
+print('Get the specified weather record with current weather and all available forecast information.')
 forecast = aio.receive_weather(2153)
-
 print(forecast)