feat: add new users API for managing channel data (#4)

* Add new users API for managing channel data

* Update README documentation about new API

Author: thomaswhyyou

README.md

@@ -66,6 +66,25 @@ client.notify(
     "priority": 1
   }
 )
+
+```
+### Getting and setting channel data
+
+```python
+from knockapi import Knock
+client = Knock(api_key="sk_12345")
+
+# Set channel data for an APNS
+client.users.set_channel_data(
+  id="jhammond",
+  channel_id=KNOCK_APNS_CHANNEL_ID,
+  channel_data={
+    "tokens": [apns_token]
+  }
+)
+
+# Get channel data for the APNS channel
+client.users.get_channel_data(id="jhammond", channel_id=KNOCK_APNS_CHANNEL_ID)
 ```
 
 ### Canceling notifies

knockapi/client.py

@@ -1,6 +1,6 @@
 import requests
 
-__version__ = '0.2.2'
+__version__ = '0.3.0'
 
 
 class Connection(object):

knockapi/resources/users.py

@@ -7,7 +7,7 @@ def get_user(self, id):
         Get a user by their id
 
         Args:
-            id: The users ID
+            id: The user ID
 
         Returns:
             dict: User response from Knock.
@@ -20,7 +20,7 @@ def identify(self, id, data={}):
         Identify a user, upserting them
 
         Args:
-            id (str): The users ID
+            id (str): The user ID
             data (dict): Other properties to put on the user
 
         Returns:
@@ -34,10 +34,39 @@ def delete(self, id):
         Delets the given user.
 
         Args:
-            id (str): The users ID
+            id (str): The user ID
 
         Returns:
             dict: User response from Knock.
         """
         endpoint = '/users/{}'.format(id)
         return self.client.request('delete', endpoint)
+
+    def get_channel_data(self, id, channel_id):
+        """
+        Get user's channel data for the given channel id.
+
+        Args:
+            id (str): The user ID
+            channel_id (str): Target channel ID
+
+        Returns:
+            dict: Channel data from Knock.
+        """
+        endpoint = '/users/{}/channel_data/{}'.format(id, channel_id)
+        return self.client.request('get', endpoint)
+
+    def set_channel_data(self, id, channel_id, channel_data):
+        """
+        Upserts user's channel data for the given channel id.
+
+        Args:
+            id (str): The user ID
+            channel_id (str): Target channel ID
+            channel_data (dict): Channel data
+
+        Returns:
+            dict: Channel data from Knock.
+        """
+        endpoint = '/users/{}/channel_data/{}'.format(id, channel_id)
+        return self.client.request('put', endpoint, payload={'data': channel_data})

setup.py

@@ -4,7 +4,7 @@
 
 from setuptools.command.install import install
 
-version = '0.2.2'
+version = '0.3.0'
 
 with open("README.md", "r") as f:
     long_description = f.read()