Merge pull request #125 from adafruit/update_batch_send_to_take_dict

Add list of dicts support to send_batch_data

adafruit_io/adafruit_io.py

@@ -636,12 +636,17 @@ def send_batch_data(self, feed_key: str, data_list: list):
         Sends a batch array of data to a specified Adafruit IO feed
 
         :param str feed_key: Adafruit IO feed key
-        :param list Data: Data list to send
+        :param list Data: Data list to send (namedtuples or dicts with 'value' key)
         """
         validate_feed_key(feed_key)
+        if not isinstance(data_list, list) or data_list == []:
+            raise ValueError("Data must be a list of dicts or namedtuples")
+        if not isinstance(data_list[0], dict):  # assume namedtuple
+            data_list = type(data_list)((data._asdict() for data in data_list))
+        if not all("value" in data for data in data_list):
+            raise ValueError("Data list items must at least contain a 'value' key")
         path = self._compose_path("feeds/{0}/data/batch".format(feed_key))
-        data_dict = type(data_list)((data._asdict() for data in data_list))
-        self._post(path, {"data": data_dict})
+        self._post(path, {"data": data_list})
 
     def send_group_data(
         self, group_key: str, feeds_and_data: list, metadata: Optional[dict] = None

examples/adafruit_io_http/adafruit_io_batch_cpython.py

@@ -0,0 +1,87 @@
+# SPDX-FileCopyrightText: 2024 Tyeth Gundry for Adafruit Industries
+# SPDX-License-Identifier: MIT
+
+# adafruit_circuitpython_adafruitio usage for batch data with a CPython socket.
+import datetime
+import socket
+import ssl
+from random import randint
+import adafruit_requests
+from adafruit_io.adafruit_io import IO_HTTP, AdafruitIO_RequestError
+
+# Add a secrets.py to your filesystem that has a dictionary called secrets with "aio_username"
+# and "aio_key" entries with your IO credentials, or set environment variables/defaults below.
+# *** DO NOT share that file or commit it into Git or other source control. ***
+# pylint: disable=no-name-in-module,wrong-import-order
+try:
+    from secrets import secrets
+except ImportError:
+    import os
+
+    secrets = {
+        "aio_username": os.getenv("ADAFRUIT_AIO_USERNAME", "Your_Username_Here"),
+        "aio_key": os.getenv("ADAFRUIT_AIO_KEY", "Your_Adafruit_IO_Key_Here"),
+    }
+    if (
+        secrets["aio_key"] == "Your_Adafruit_IO_Key_Here"
+        or secrets["aio_username"] == "Your_Username_Here"
+    ):
+        print("Adafruit IO secrets are kept in secrets.py, please add them there!")
+        raise
+
+# Set your Adafruit IO Username and Key in secrets.py
+# (visit io.adafruit.com if you need to create an account,
+# or if you need your Adafruit IO key.)
+aio_username = secrets["aio_username"]
+aio_key = secrets["aio_key"]
+
+
+requests = adafruit_requests.Session(socket, ssl.create_default_context())
+# Initialize an Adafruit IO HTTP API object
+io = IO_HTTP(aio_username, aio_key, requests)
+
+try:
+    # Get the 'temperature' feed from Adafruit IO
+    temperature_feed = io.get_feed("batch-temperature")
+except AdafruitIO_RequestError:
+    # If no 'temperature' feed exists, create one
+    temperature_feed = io.create_new_feed("batch-temperature")
+
+# Get current time from Adafruit IO time service (in UTC)
+years, months, days, hours, minutes, seconds, *_ = io.receive_time("UTC")
+current_time = datetime.datetime(years, months, days, hours, minutes, seconds)
+print("Current time from Adafruit IO: ", current_time)
+
+# Create random values at different timestamps to send to the feed
+data = []
+for i in range(5):
+    random_value = randint(0, 50)
+    time_offset = i - 5
+    created_at = current_time + datetime.timedelta(seconds=time_offset)
+    print(
+        "Adding datapoint {0} (at T:{1}) to collection for batch-temperature feed...".format(
+            random_value, time_offset
+        )
+    )
+    data.append(
+        {
+            "value": random_value,
+            "created_at": created_at.isoformat(),  # optional metadata like lat, lon, ele, etc
+        }
+    )
+
+# Send the data to the feed as a single batch
+io.send_batch_data(temperature_feed["key"], data)
+print("Data sent!")
+print()
+print(
+    "View your feed graph at: https://io.adafruit.com/{0}/feeds/{1}".format(
+        aio_username, temperature_feed["key"]
+    )
+)
+print()
+
+# Retrieve data value from the feed
+print("Retrieving data from batch-temperature feed...")
+received_data = io.receive_data(temperature_feed["key"])
+print("Data from temperature feed: ", received_data["value"])