Releases: adafruit/Adafruit_IO_Python
Adafruit IO Python
- 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
inClient
has been removed (see: 808ec3f). 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.
Add receive method for MQTT
- Updated the MQTT API to support "receiving" (via
client.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.
2.1
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.
- 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 Weather Service
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.
2.0.18
- 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.
2.0.17: Groups!
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
withtopic
inside_mqtt_message()
Usage Example: https://github.com/adafruit/io-client-python/blob/master/examples/mqtt/mqtt_groups_pubsub.py
2.0.16
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.
2.0.15
PyPi Release
v2.0.14 Bump version
Feed Sharing
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.