telesign 2.2.6__py2.py3-none-any.whl → 2.3.0__py2.py3-none-any.whl

telesign/rest.py

@@ -16,18 +16,14 @@ from telesign.util import AuthMethod
 
 class RestClient(requests.models.RequestEncodingMixin):
     """
-    The TeleSign RestClient is a generic HTTP REST client that can be extended to make requests against any of
-    TeleSign's REST API endpoints.
+    The Telesign RestClient is a generic HTTP REST client that can be extended to make requests against any of
+    Telesign's REST API endpoints.
 
     RequestEncodingMixin offers the function _encode_params for url encoding the body for use in string_to_sign outside
     of a regular HTTP request.
 
     See https://developer.telesign.com for detailed API documentation.
     """
-    user_agent = "TeleSignSDK/python-{sdk_version} Python/{python_version} Requests/{requests_version}".format(
-        sdk_version=telesign.__version__,
-        python_version=python_version(),
-        requests_version=requests.__version__)
 
     class Response(object):
         """
@@ -51,11 +47,14 @@ class RestClient(requests.models.RequestEncodingMixin):
                  customer_id,
                  api_key,
                  rest_endpoint='https://rest-api.telesign.com',
+                 source="python_telesign",
+                 sdk_version_origin=None,
+                 sdk_version_dependency=None,
                  proxies=None,
                  timeout=10,
                  auth_method=None):
         """
-        TeleSign RestClient useful for making generic RESTful requests against our API.
+        Telesign RestClient useful for making generic RESTful requests against our API.
 
         :param customer_id: Your customer_id string associated with your account.
         :param api_key: Your api_key string associated with your account.
@@ -77,6 +76,17 @@ class RestClient(requests.models.RequestEncodingMixin):
 
         self.auth_method = auth_method
 
+        current_version_sdk = telesign.__version__ if source == "python_telesign" else sdk_version_origin
+
+        self.user_agent = "TeleSignSDK/python Python/{python_version} Requests/{requests_version} OriginatingSDK/{source} SDKVersion/{sdk_version}".format(
+        python_version=python_version(),
+        requests_version=requests.__version__,
+        source=source,
+        sdk_version=current_version_sdk)
+
+        if source != "python_telesign":
+            self.user_agent = self.user_agent + " DependencySDKVersion/{sdk_version_dependency}".format(sdk_version_dependency=sdk_version_dependency)
+
     @staticmethod
     def generate_telesign_headers(customer_id,
                                   api_key,
@@ -89,17 +99,17 @@ class RestClient(requests.models.RequestEncodingMixin):
                                   content_type=None,
                                   auth_method=None):
         """
-        Generates the TeleSign REST API headers used to authenticate requests.
+        Generates the Telesign REST API headers used to authenticate requests.
 
         Creates the canonicalized string_to_sign and generates the HMAC signature. This is used to authenticate requests
-        against the TeleSign REST API.
+        against the Telesign REST API.
 
         See https://developer.telesign.com/docs/authentication for detailed API documentation.
 
         :param customer_id: Your account customer_id.
         :param api_key: Your account api_key.
         :param method_name: The HTTP method name of the request as a upper case string, should be one of 'POST', 'GET',
-            'PUT' or 'DELETE'.
+            'PUT', 'PATCH' or 'DELETE'.
         :param resource: The partial resource URI to perform the request against, as a string.
         :param url_encoded_fields: HTTP body parameters to perform the HTTP request with, must be a urlencoded string.
         :param date_rfc2616: The date and time of the request formatted in rfc 2616, as a string.
@@ -107,7 +117,7 @@ class RestClient(requests.models.RequestEncodingMixin):
         :param user_agent: (optional) User Agent associated with the request, as a string.
         :param content_type: (optional) ContentType of the request, as a string.
         :param auth_method: (optional) Authentication type ex: Basic, HMAC etc
-        :return: The TeleSign authentication headers.
+        :return: The Telesign authentication headers.
         """
         if date_rfc2616 is None:
             date_rfc2616 = formatdate(usegmt=True)
@@ -167,7 +177,7 @@ class RestClient(requests.models.RequestEncodingMixin):
 
     def post(self, resource, body=None, json_fields=None, **query_params):
         """
-        Generic TeleSign REST API POST handler.
+        Generic Telesign REST API POST handler.
 
         :param resource: The partial resource URI to perform the request against, as a string.
         :param body: (optional) A dictionary sent as a part of request body.
@@ -178,7 +188,7 @@ class RestClient(requests.models.RequestEncodingMixin):
 
     def get(self, resource, body=None, json_fields=None, **query_params):
         """
-        Generic TeleSign REST API GET handler.
+        Generic Telesign REST API GET handler.
 
         :param resource: The partial resource URI to perform the request against, as a string.
         :param body: (optional) A dictionary sent as a part of request body.
@@ -189,7 +199,7 @@ class RestClient(requests.models.RequestEncodingMixin):
 
     def put(self, resource, body=None, json_fields=None, **query_params):
         """
-        Generic TeleSign REST API PUT handler.
+        Generic Telesign REST API PUT handler.
 
         :param resource: The partial resource URI to perform the request against, as a string.
         :param body: (optional) A dictionary sent as a part of request body.
@@ -203,7 +213,7 @@ class RestClient(requests.models.RequestEncodingMixin):
 
     def delete(self, resource, body=None, json_fields=None, **query_params):
         """
-        Generic TeleSign REST API DELETE handler.
+        Generic Telesign REST API DELETE handler.
 
         :param resource: The partial resource URI to perform the request against, as a string.
         :param body: (optional) A dictionary sent as a part of request body.
@@ -211,10 +221,22 @@ class RestClient(requests.models.RequestEncodingMixin):
         :return: The RestClient Response object.
         """
         return self._execute(self.session.delete, 'DELETE', resource, body, json_fields, **query_params)
+    
+    def patch(self, resource, body=None, json_fields=None, **query_params):
+        """
+        Generic Telesign REST API PATCH handler.
+
+        :param resource: The partial resource URI to perform the request against, as a string.
+        :param body: (optional) A dictionary sent as a part of request body.
+        :param json_fields: (optional) A dictionary sent as a JSON body.
+        :param query_params: query_params to perform the PATCH request with, as a dictionary.
+        :return: The RestClient Response object.
+        """
+        return self._execute(self.session.patch, 'PATCH', resource, body, json_fields, **query_params)
 
     def _execute(self, method_function, method_name, resource, body=None, json_fields=None, **query_params):
         """
-        Generic TeleSign REST API request handler.
+        Generic Telesign REST API request handler.
 
         :param method_function: The Requests HTTP request function to perform the request.
         :param method_name: The HTTP method name, as an upper case string.

{telesign-2.2.6.dist-info → telesign-2.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: telesign
-Version: 2.2.6
+Version: 2.3.0
 Summary: TeleSign SDK
 Home-page: https://github.com/telesign/python_telesign
 Author: TeleSign Corp.

{telesign-2.2.6.dist-info → telesign-2.3.0.dist-info}/RECORD

@@ -3,12 +3,12 @@ telesign/appverify.py,sha256=wBeaeUxGmYcZkrbxkkXlG3-0oZr5sVvegzVpdvaoO2A,1195
 telesign/intelligence.py,sha256=t-xwlgxkXw1OMupF5K4_UKWeTArOr9XPvddmqgZftPI,1452
 telesign/messaging.py,sha256=v7l-eKUPqz7Nrwka0YNPMkC2TaoFUvQm3yp_djuTPu0,1367
 telesign/phoneid.py,sha256=mk03NxL3wlaXpd8b-BB6q_SKfCxbtuTO19ayAHxmzz0,954
-telesign/rest.py,sha256=s9ADfwcDhC9lpPJdpohkl6JiZ6URcb8diy2cnQOYX1o,11501
+telesign/rest.py,sha256=26EESKSPzSPIAf3VpVmCEPE8HSpAZRfGw5koIHsJeh8,12653
 telesign/score.py,sha256=Kceu6IrirN9SsuT1geEWs0QHAn6H9ZNFyIDVHcBJdwg,908
 telesign/util.py,sha256=stDxpL5ZQeGskE_OSGP04UFHs3ZP2ACaRpW1WyQGMHg,1624
 telesign/voice.py,sha256=DJaWyQpun-T7LfNjpxpsUjupiv2ShW1jqoFQA-CE2-Y,1341
-telesign-2.2.6.dist-info/LICENSE.txt,sha256=a--xZ4PCKUL5rpct8RrUC6ODU_8ZKIU51kJPfsA4HUs,1058
-telesign-2.2.6.dist-info/METADATA,sha256=DFbelVbeU83W0KXnGEGZyvp5rKZ9YFdZ0HCckG1eqCo,4532
-telesign-2.2.6.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
-telesign-2.2.6.dist-info/top_level.txt,sha256=6LG7Jcr1jnpVhOWaIShoTdwYJn0QCfPhfudyVJNz1qg,9
-telesign-2.2.6.dist-info/RECORD,,
+telesign-2.3.0.dist-info/LICENSE.txt,sha256=a--xZ4PCKUL5rpct8RrUC6ODU_8ZKIU51kJPfsA4HUs,1058
+telesign-2.3.0.dist-info/METADATA,sha256=7pxOUYH6cvpiHfYp7v0GFYN9Wgz3ZWqahdN3qHfm__g,4532
+telesign-2.3.0.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
+telesign-2.3.0.dist-info/top_level.txt,sha256=6LG7Jcr1jnpVhOWaIShoTdwYJn0QCfPhfudyVJNz1qg,9
+telesign-2.3.0.dist-info/RECORD,,