Add client.append function for easily appending data to a feed.

Author: tdicola

Adafruit_IO/client.py

@@ -89,6 +89,14 @@ def send(self, feed_name, value):
         path = "api/feeds/{0}/data/send".format(feed_name)
         return Data.from_dict(self._post(path, {'value': value}))
 
+    def append(self, feed, value):
+        """Helper function to simplify adding a value to a feed.  Will append the
+        specified value to the feed identified by either name, key, or ID.
+        Returns a Data instance with details about the newly appended row of data.
+        Note that unlike send the feed should exist before calling append.
+        """
+        return self.create_data(feed, Data(value=value))
+
     def receive(self, feed):
         """Retrieve the most recent value for the specified feed.  Feed can be a
         feed ID, feed key, or feed name.  Returns a Data instance whose value

setup.py

@@ -4,7 +4,7 @@
 
 setup(
     name='adafruit-io',
-    version='0.9.0',
+    version='0.9.1',
     author='Justin Cooper',
     author_email='justin@adafruit.com',
     packages=['Adafruit_IO'],

tests/test_client.py

@@ -111,6 +111,27 @@ def test_create_data(self):
         result = io.create_data('TestFeed', data)
         self.assertEqual(int(result.value), 42)
 
+    def test_append_by_feed_name(self):
+        io = self.get_client()
+        self.ensure_feed_deleted(io, 'TestFeed')
+        feed = io.create_feed(Feed(name='TestFeed'))
+        result = io.append('TestFeed', 42)
+        self.assertEqual(int(result.value), 42)
+
+    def test_append_by_feed_key(self):
+        io = self.get_client()
+        self.ensure_feed_deleted(io, 'Test Feed Fancy Name')
+        feed = io.create_feed(Feed(name='Test Feed Fancy Name'))
+        result = io.append(feed.key, 42)
+        self.assertEqual(int(result.value), 42)
+
+    def test_append_by_feed_id(self):
+        io = self.get_client()
+        self.ensure_feed_deleted(io, 'TestFeed')
+        feed = io.create_feed(Feed(name='TestFeed'))
+        result = io.append(feed.id, 42)
+        self.assertEqual(int(result.value), 42)
+
     def test_create_feed(self):
         io = self.get_client()
         self.ensure_feed_deleted(io, 'TestFeed')