Added kwarg for adding a QoS Level for subscribe calls. Addresses https://github.com/adafruit/Adafruit_IO_Python/issues/106
Added an on_subscribe callback for subscribing to new topics.
- mqtt_subscribe.py example extended to use new on_subscribe callback method.

To use in CPython, pip3 install adafruit-io.

Read the docs for info on how to use it.

Adafruit_IO_Python - Support for new Time API

Published by brentru over 5 years ago

This release adds Adafruit IO Python support for a new time api. This new time endpoint supports sending localized time to the Adafruit IO Python REST API client, based on the client's IP address. This release does not update the time endpoint within the MQTT client, it is only for the REST client.

The receive_time method now returns a struct_time containing the year, month, day, hour, minute second, day of the week, day of the year, and a boolean for if it's daylight savings. #96

an updated Usage Example is located at basics/time.py

Note: The previous /time endpoint returned a plaintext response, instead of json. Since the new endpoint returns a JSON response, this PR will remove all plaintext-handling from the library used for the old /time endpoint:

To use in CPython, pip3 install adafruit-io.

Read the docs for info on how to use it.

Adafruit_IO_Python - 2.3.1

Published by brentru over 5 years ago

Fix mqtt_client to prevent errors resulting from referencing topic before assignment or accessing parsed_topic out of order. #94
Remove while True topic subscription loop from mqtt_time.py example. The example now uses the blocking_client.
Bump version string

To use in CPython, pip3 install adafruit-io.

Read the docs for info on how to use it.

Adafruit_IO_Python - Improved Sending Data

Published by brentru over 5 years ago

Changes:

The send_data method can now send metadata associated with the data point. You can also now set the amount of precision associated with floating point values. #92
This change will break code using the send_location_data() method. Code using this method will need to be changed to use the updated send_data method.
- The Adafruit IO Python Location example has been updated to reflect usage of the new send_data method

To use in CPython, pip3 install adafruit-io.

Read the docs for info on how to use it.

Adafruit_IO_Python - Adafruit IO Python

Published by brentru over 5 years ago

This library is now called Adafruit_IO_Python (previously io-client-python) to match Adafruit IO Arduino.
References to io-client-python have been removed throughout the library
Potentially Breaking Change: The kwarg api_version in Client has been removed (see: https://github.com/adafruit/Adafruit_IO_Python/commit/808ec3fcb2a8d943f77f636493c8aae81a22d823). The Adafruit IO API's api version is not likely to change in the near future, and no longer needs to be supported as an optional kwarg.

To use in CPython, pip3 install adafruit-io.

Read the docs for info on how to use it.

Adafruit_IO_Python - Add receive method for MQTT

Published by brentru over 5 years ago

Updated the MQTT API to support "receiving" (viaclient.receive(FEED_NAME)) the last value of a feed from Adafruit IO.
- Calls to this method will publish the last feed value to the requested feed and trigger a callback.
Increment version

To use in CPython, pip3 install adafruit-io.

Read the docs for info on how to use it.

Adafruit_IO_Python - 2.1

Published by brentru almost 6 years ago

Create random data streams that can generate colors, words, numbers, or pick a value from a custom data set and send it directly to your devices.

The web interface for this service is available on Adafruit IO's Integrations page.

Release Notes

Updated API Client for Adafruit IO's random data service.
- Example
Updated MQTT Client for subscribing to random data by ID.

To use in CPython, pip3 install adafruit-io.

Read the docs for info on how to use it.

Adafruit_IO_Python - Adafruit IO Weather Service

Published by brentru almost 6 years ago

Get hyper local, minute-by-minute weather forecasts delivered directly to your device running Adafruit IO Python. Service provided by Dark Sky.

The web panel for this service is available on Adafruit IO's Integrations page.

Note: An active Adafruit IO Plus subscription is required for using this integration. For more information about [Adafruit IO Plus (including its features and pricing), click here] (https://io.adafruit.com/plus).

Release Notes

Updated Client for use with Adafruit IO's weather service.
Updated MQTTClient for subscribing to weather forecasts.
Added example of subscribing to three different forecasts using the MQTT client, receiving and parsing data from the su is here

To use in CPython, pip3 install adafruit-io.

Read the docs for info on how to use it.

Adafruit_IO_Python - 2.0.18

Published by brentru almost 6 years ago

Breaking Change: Updated keyword argument order within method send_location_data(). Specifically, value has been moved to the end of the call and is optional.

Previous function calls:
ioClient.send_location_data(locationFeed.key, value, lat, lon, ele)

New function calls:
ioClient.send_location_data(locationFeed.key, lat, lon, ele, value)

Example of send_location_data() usage

Other release notes:

Added descriptive docstrings to methods in client.py for Sphinx/ReadTheDocs.
Slowed down TravisCI tests to avoid throttling.
Updated location examples to reflect breaking change to send_location_data

To use in CPython, pip3 install adafruit-io.

Read the docs for info on how to use it.

Adafruit_IO_Python - 2.0.17: Groups!

Published by brentru about 6 years ago

Release Notes:

Changes within mqtt_client.py:

SUBSCRIBE to a group with client.subscribe_group(GROUP_ID)
PUBLISH to a group using client.publish(FEED, VALUE, GROUP_ID)
Added kwarg option for unsubscribing to groups using unsubscribe()
Replaced feed with topic inside _mqtt_message()

Usage Example: https://github.com/adafruit/io-client-python/blob/master/examples/mqtt/mqtt_groups_pubsub.py

Adafruit_IO_Python - 2.0.16

Published by brentru about 6 years ago

Release Notes:

Adding a new example of using the Adafruit IO Python library to send a base64-encoded image to a a feed on Adafruit IO from a Raspberry Pi Camera (https://www.adafruit.com/product/3099) or a Raspberry Pi NoIR Camera (https://www.adafruit.com/product/3100).

Here's an example of this sketch in-action, from the eyes of a PiCam haphazardly placed on my desk.

The image is displayed on an Adafruit IO Dashboard using an Image Block, connected to a feed receiving the image data.
Adafruit IO Camera Feed Screenshot

Adafruit_IO_Python - 2.0.15

Published by brentru about 6 years ago

Adafruit_IO_Python - PyPi Release

Published by brentru about 6 years ago

Adafruit_IO_Python - Feed Sharing

Published by brentru about 6 years ago

Feed Sharing!

We've added the ability to subscribe to someone else's feed (with permission, of course) and publish to it from the mqtt_client within Adafruit IO Python.

What is feed sharing? https://learn.adafruit.com/adafruit-io-basics-feeds/sharing-a-feed

Minor Notes:
Added client.unsubscribe() method to mqtt_client to support unsubscribing from a topic.

Adafruit_IO_Python - TypeError Handling Fix

Published by brentru over 6 years ago

Handling TypeError: the JSON object must be str, not 'bytes' in Python 3.5.x for Raspberry Pi users of this library.