Add Users (#269)

* add users api and tests

* updated README

* updated changelog

* Bump version: 3.7.1 → 3.8.0

Author: maxkahan

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 3.7.1
+current_version = 3.8.0
 commit = True
 tag = False
 

CHANGES.md

@@ -1,3 +1,6 @@
+# 3.8.0
+- Adding support for the [Users component of the Vonage Application API](https://developer.vonage.com/en/api/application.v2#User)
+
 # 3.7.1
 - Fixing dependency version to a specific major version
 

README.md

@@ -27,6 +27,7 @@ need a Vonage account. Sign up [for free at vonage.com][signup].
 - [Pricing API](#pricing-api)
 - [Managing Secrets](#managing-secrets)
 - [Application API](#application-api)
+- [Users API](#users-api)
 - [Validating Webhook Signatures](#validate-webhook-signatures)
 - [JWT Parameters](#jwt-parameters)
 - [Overriding API Attributes](#overriding-api-attributes)
@@ -1082,6 +1083,42 @@ response = client.application.delete_application(uuid)
 
 Docs: [https://developer.nexmo.com/api/application.v2#deleteApplication](https://developer.nexmo.com/api/application.v2#deleteApplication?utm_source=DEV_REL&utm_medium=github&utm_campaign=python-client-library#destroy-an-application)
 
+
+## Users API
+
+These API methods are part of the [Application (v2) API](https://developer.vonage.com/en/application/overview) but are a in separate module in the SDK. [See the API reference for more details](https://developer.vonage.com/en/api/application.v2#User).
+
+### List all Users
+
+```python
+client.users.list_users()
+```
+
+### Create a new user
+
+```python
+client.users.create_user() # Default values generated
+client.users.create_user(params={...}) # Specify custom values
+```
+
+### Get detailed information about a user
+
+```python
+client.users.get_user('USER_ID')
+```
+
+### Update user details
+
+```python
+client.users.update_user('USER_ID', params={...})
+```
+
+### Delete a user
+
+```python
+client.users.delete_user('USER_ID')
+```
+
 ## Validate webhook signatures
 
 ```python

setup.py

@@ -9,7 +9,7 @@
 
 setup(
     name="vonage",
-    version="3.7.1",
+    version="3.8.0",
     description="Vonage Server SDK for Python",
     long_description=long_description,
     long_description_content_type="text/markdown",

src/vonage/__init__.py

@@ -1,4 +1,4 @@
 from .client import *
 from .ncco_builder.ncco import *
 
-__version__ = "3.7.1"
+__version__ = "3.8.0"

src/vonage/client.py

@@ -13,6 +13,7 @@
 from .short_codes import ShortCodes
 from .sms import Sms
 from .subaccounts import Subaccounts
+from .users import Users
 from .ussd import Ussd
 from .voice import Voice
 from .verify import Verify
@@ -122,6 +123,7 @@ def __init__(
         self.short_codes = ShortCodes(self)
         self.sms = Sms(self)
         self.subaccounts = Subaccounts(self)
+        self.users = Users(self)
         self.ussd = Ussd(self)
         self.verify = Verify(self)
         self.verify2 = Verify2(self)

src/vonage/errors.py

@@ -50,3 +50,7 @@ class SubaccountsError(ClientError):
 
 class ProactiveConnectError(ClientError):
     """An error relating to the Proactive Connect API."""
+
+
+class UsersError(ClientError):
+    """An error relating to the Users API."""

src/vonage/users.py

@@ -0,0 +1,72 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from vonage import Client
+
+from .errors import UsersError
+from ._internal import set_auth_type
+
+
+class Users:
+    """Class containing methods for user management as part of the Application API."""
+
+    def __init__(self, client: Client):
+        self._client = client
+        self._auth_type = set_auth_type(self._client)
+
+    def list_users(
+        self,
+        page_size: int = None,
+        order: str = 'asc',
+        cursor: str = None,
+        name: str = None,
+    ):
+        """
+        Lists the name and user id of all users associated with the account.
+        For complete information on a user, call Users.get_user, passing in the user id.
+        """
+
+        if order.lower() not in ('asc', 'desc'):
+            raise UsersError(
+                'Invalid order parameter. Must be one of: "asc", "desc", "ASC", "DESC".'
+            )
+
+        params = {'page_size': page_size, 'order': order.lower(), 'cursor': cursor, 'name': name}
+        return self._client.get(
+            self._client.api_host(),
+            '/v1/users',
+            params,
+            auth_type=self._auth_type,
+        )
+
+    def create_user(self, params: dict = None):
+        self._client.headers['Content-Type'] = 'application/json'
+        return self._client.post(
+            self._client.api_host(),
+            '/v1/users',
+            params,
+            auth_type=self._auth_type,
+        )
+
+    def get_user(self, user_id: str):
+        return self._client.get(
+            self._client.api_host(),
+            f'/v1/users/{user_id}',
+            auth_type=self._auth_type,
+        )
+
+    def update_user(self, user_id: str, params: dict):
+        return self._client.patch(
+            self._client.api_host(),
+            f'/v1/users/{user_id}',
+            params,
+            auth_type=self._auth_type,
+        )
+
+    def delete_user(self, user_id: str):
+        return self._client.delete(
+            self._client.api_host(),
+            f'/v1/users/{user_id}',
+            auth_type=self._auth_type,
+        )

tests/data/users/invalid_content_type.json

@@ -0,0 +1,13 @@
+{
+    "title": "Bad request.",
+    "type": "https://developer.nexmo.com/api/conversation#http:error:validation-fail",
+    "code": "http:error:validation-fail",
+    "detail": "Invalid Content-Type.",
+    "instance": "9d0e245d-fac0-450e-811f-52343041df61",
+    "invalid_parameters": [
+        {
+            "name": "content-type",
+            "reason": "content-type \"application/octet-stream\" is not supported. Supported versions are [application/json]"
+        }
+    ]
+}

tests/data/users/list_users_400.json

@@ -0,0 +1,13 @@
+{
+    "title": "Bad request.",
+    "type": "https://developer.nexmo.com/api/conversation#http:error:validation-fail",
+    "code": "http:error:validation-fail",
+    "detail": "Input validation failure.",
+    "instance": "04ee4d32-78c9-4acf-bdc1-b7d1fa860c92",
+    "invalid_parameters": [
+        {
+            "name": "page_size",
+            "reason": "\"page_size\" must be a number"
+        }
+    ]
+}