Add Get Client Token endpoint

Author: aseveryn-hw

CHANGELOG.rst

@@ -1,7 +1,12 @@
 Changelog
 =========
 
-1.1.4 (current)
+1.1.5 (current)
+------------------
+
+- Added Client Token endpoint
+
+1.1.4 (2018-12-04)
 ------------------
 
 - Added PayPal account endpoint

hyperwallet/__init__.py

@@ -6,7 +6,7 @@
 __email__           = 'devsupport@hyperwallet.com'
 __copyright__       = 'Copyright (c) 2017 Hyperwallet'
 __license__         = 'MIT'
-__version__         = '1.1.4'
+__version__         = '1.1.5'
 __url__             = 'https://github.com/hyperwallet/python-sdk'
 __download_url__    = 'https://pypi.python.org/pypi/hyperwallet-sdk'
 __description__     = 'A Python wrapper around the Hyperwallet API'
@@ -21,6 +21,7 @@
     PrepaidCard,                                                         # noqa
     PaperCheck,                                                          # noqa
     Transfer,                                                            # noqa
+    ClientToken,                                                         # noqa
     PayPalAccount,                                                       # noqa
     Payment,                                                             # noqa
     Balance,                                                             # noqa

hyperwallet/api.py

@@ -14,6 +14,7 @@
     PrepaidCard,
     PaperCheck,
     Transfer,
+    ClientToken,
     PayPalAccount,
     Payment,
     Balance,
@@ -1654,6 +1655,32 @@ def listPayPalAccounts(self,
 
     '''
 
+    ClientToken
+
+    '''
+
+    def getClientToken(self,
+                       userToken=None):
+        '''
+        Get a ClientToken.
+        :param userToken:
+             A user token. **REQUIRED**
+        :returns:
+            A ClientToken.
+        '''
+
+        if not userToken:
+            raise HyperwalletException('userToken is required')
+
+        response = self.apiClient.doPost(
+            os.path.join('users', userToken, 'client-token'),
+            None
+        )
+
+        return ClientToken(response)
+
+    '''
+
     Payments
     https://portal.hyperwallet.com/docs/api/v3/resources/payments
 

hyperwallet/models.py

@@ -125,6 +125,34 @@ def __repr__(self):
         )
 
 
+class ClientToken(HyperwalletModel):
+    '''
+    The ClientToken Model.
+
+    :param data:
+        A dictionary containing the attributes for the Client Token.
+    '''
+
+    def __init__(self, data):
+        '''
+        Create a new Client Token with the provided attributes.
+        '''
+
+        super(ClientToken, self).__init__(data)
+
+        self.defaults = {
+            'value': None,
+        }
+
+        for (param, default) in self.defaults.items():
+            setattr(self, param, data.get(param, default))
+
+    def __repr__(self):
+        return "ClientToken({value})".format(
+            value=self.value
+        )
+
+
 class TransferMethod(HyperwalletModel):
     '''
     The TransferMethod Model.

hyperwallet/tests/test_api.py

@@ -1366,6 +1366,30 @@ def test_list_paypal_accounts_success(self, mock_get):
 
     '''
 
+    ClientToken
+
+    '''
+
+    def test_get_client_token_fail_need_user_token(self):
+
+        with self.assertRaises(HyperwalletException) as exc:
+            self.api.getClientToken()
+
+        self.assertEqual(exc.exception.message, 'userToken is required')
+
+    @mock.patch('hyperwallet.utils.ApiClient._makeRequest')
+    def test_get_client_token_success(self, mock_post):
+
+        client_token_data = {
+            'value': 'test-value'
+        }
+        mock_post.return_value = client_token_data
+        response = self.api.getClientToken('user-token')
+
+        self.assertTrue(response.value, client_token_data.get('value'))
+
+    '''
+
     Payments
 
     '''

hyperwallet/tests/test_encryption.py

@@ -9,8 +9,7 @@
 from jwcrypto.common import json_encode
 from hyperwallet.exceptions import HyperwalletException
 from hyperwallet.utils.encryption import Encryption
-from django.core.validators import URLValidator
-from django.core.exceptions import ValidationError
+from six.moves.urllib.parse import urlparse
 
 
 class EncryptionTest(unittest.TestCase):
@@ -158,19 +157,37 @@ def test_should_throw_exception_when_jws_signature_has_expired(self):
         self.assertEqual(exc.exception.message, 'JWS signature has expired, checked by [exp] JWS header')
 
     def __getJwkKeySet(self, location):
-
+        '''
+        Retrieves JWK key data from given location.
+
+        :param location:
+            Location(can be a URL or path to file) of JWK key data. **REQUIRED**
+        :returns:
+            JWK key set found at given location.
+        '''
         try:
-            URLValidator()(location)
-        except ValidationError:
+            url = urlparse(location)
+            if url.scheme and url.netloc and url.path:
+                return requests.get(location).text
+            raise HyperwalletException('Failed to parse url from string = ' + location)
+        except Exception as e:
             if os.path.isfile(location):
                 with open(location) as f:
                     return f.read()
             else:
                 raise HyperwalletException('Wrong JWK key set location path = ' + location)
 
-        return requests.get(location).text
-
     def __findJwkKeyByAlgorithm(self, jwkKeySet, algorithm):
+        '''
+        Finds JWK key by given algorithm.
+
+        :param jwkKeySet:
+            JSON representation of JWK key set. **REQUIRED**
+        :param algorithm:
+            Algorithm of the JWK key to be found in key set. **REQUIRED**
+        :returns:
+            JWK key with given algorithm.
+        '''
 
         try:
             keySet = json.loads(jwkKeySet)

hyperwallet/tests/test_models.py

@@ -12,6 +12,7 @@
     PrepaidCard,
     PaperCheck,
     Transfer,
+    ClientToken,
     PayPalAccount,
     Payment,
     Balance,
@@ -73,6 +74,10 @@ def setUp(self):
             'createdOn': '2017-01-01'
         }
 
+        self.client_token_data = {
+            'value': 'test-client-token'
+        }
+
         self.transfer_method_data = {
             'token': 'trm-12345',
             'createdOn': '2017-01-01'
@@ -243,6 +248,23 @@ def test_transfer_model(self):
 
     '''
 
+    ClientToken
+
+    '''
+
+    def test_client_token_model(self):
+
+        test_client_token = ClientToken(self.client_token_data)
+
+        self.assertEqual(
+            test_client_token.__repr__(),
+            'ClientToken({value})'.format(
+                value=self.client_token_data.get('value')
+            )
+        )
+
+    '''
+
     PayPal Account
 
     '''