telesign 2.2.3__tar.gz → 2.2.4__tar.gz

telesign-2.2.4/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 1.1
+Name: telesign
+Version: 2.2.4
+Summary: TeleSign SDK
+Home-page: https://github.com/telesign/python_telesign
+Author: TeleSign Corp.
+Author-email: support@telesign.com
+License: MIT
+Description: .. image:: https://raw.github.com/TeleSign/python_telesign/master/python_banner.jpg
+               :target: https://standard.telesign.com
+        
+        .. image:: https://img.shields.io/travis/TeleSign/python_telesign.svg
+               :target: https://travis-ci.org/TeleSign/python_telesign
+        
+        .. image:: https://img.shields.io/codecov/c/github/TeleSign/python_telesign.svg
+               :target: https://codecov.io/gh/TeleSign/python_telesign
+        
+        .. image:: https://img.shields.io/pypi/v/telesign.svg
+               :target: https://pypi.python.org/pypi/telesign
+        
+        .. image:: https://img.shields.io/pypi/l/telesign.svg
+               :target: https://github.com/TeleSign/python_telesign/blob/master/LICENSE
+        
+        ===================
+        TeleSign Python SDK
+        ===================
+        
+        TeleSign is a communications platform as a service (CPaaS) company, founded on security. Since 2005, TeleSign has
+        been a trusted partner to the world’s leading websites and mobile applications, helping secure billions of end-user
+        accounts. Today, TeleSign’s data-driven, cloud communications platform is changing the way businesses engage with
+        customers and prevent fraud.
+        
+        For more information about TeleSign, visit our `website <http://www.TeleSign.com>`_.
+        
+        Documentation
+        -------------
+        
+        Code documentation is included in the SDK. Complete documentation, quick start guides and reference material
+        for the TeleSign API is available within the `TeleSign Standard Documentation <https://standard.telesign.com/>`_.
+        
+        Installation
+        ------------
+        
+        To install the TeleSign Python SDK:
+        
+        .. code-block:: bash
+        
+            $ pip install telesign
+        
+        Python **2.7+** is required for the TeleSign Python SDK.
+        
+        Authentication
+        --------------
+        
+        You will need a Customer ID and API Key in order to use TeleSign’s API. If you already have an account you can retrieve
+        them from your account dashboard within the `Portal <https://portal.telesign.com/login>`_. If you have not signed up
+        yet, sign up `here <https://portal.telesign.com/signup>`_.
+        
+        Dependencies
+        ------------
+        
+        We make use of popular, feature-rich and well-tested open-source libraries to perform the underlying functionality of
+        the SDK. These dependencies are managed by the community accepted package manager. If you are unable to add these
+        additional third party dependencies to your project we have ensured that the SDK code is easy to read and can serve as
+        sample code. We have also made sure that more complicated functions such as generate_telesign_headers can be easily
+        extracted from the SDK and used 'as is' in your project.
+        
+        Python Code Example: Messaging
+        ------------------------------
+        
+        Here is a basic code example with the JSON response.
+        
+        .. code-block:: python
+        
+            from __future__ import print_function
+            from telesign.messaging import MessagingClient
+        
+            customer_id = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890"
+            api_key = "EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw=="
+        
+            phone_number = "phone_number"
+            message = "You're scheduled for a dentist appointment at 2:30PM."
+            message_type = "ARN"
+        
+            messaging_client = MessagingClient(customer_id, api_key)
+            response = messaging_client.message(phone_number, message, message_type)
+        
+            print(response.json)
+        
+        .. code-block:: javascript
+               
+            {'reference_id': 'DGFDF6E11AB86303ASDFD425BE00000657',
+             'status': {'code': 103,
+                'description': 'Call in progress',
+                'updated_on': '2016-12-12T00:39:58.325559Z'}}
+        
+        For more examples, see the `examples <https://github.com/TeleSign/python_telesign/tree/master/examples>`_ folder or
+        visit the `TeleSign Standard Documentation <https://standard.telesign.com/>`_.
+        
+Keywords: telesign,sms,voice,mobile,authentication,identity,messaging
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6

{telesign-2.2.3 → telesign-2.2.4}/setup.py

@@ -11,7 +11,7 @@ mock = ['mock'] if needs_mock else []
 
 here = path.abspath(path.dirname(__file__))
 
-version = "2.2.3"
+version = "2.2.4"
 
 with open(path.join(here, 'README.rst'), encoding='utf-8') as f:
     long_description = f.read()

telesign-2.2.4/telesign/phoneid.py

@@ -0,0 +1,28 @@
+from __future__ import unicode_literals
+
+import json
+
+from telesign.rest import RestClient
+
+PHONEID_RESOURCE = "/v1/phoneid/{phone_number}"
+
+
+class PhoneIdClient(RestClient):
+    """
+    A set of APIs that deliver deep phone number data attributes that help optimize the end user
+    verification process and evaluate risk.
+    """
+
+    def __init__(self, customer_id, api_key, **kwargs):
+        super(PhoneIdClient, self).__init__(customer_id, api_key, **kwargs)
+
+    def phoneid(self, phone_number, **params):
+        """
+        The PhoneID API provides a cleansed phone number, phone type, and telecom carrier information to determine the
+        best communication method - SMS or voice.
+
+        See https://developer.telesign.com/docs/phoneid-api for detailed API documentation.
+        """
+        return self.post(PHONEID_RESOURCE.format(phone_number=phone_number),
+                        json_fields=params,
+                        **params)

{telesign-2.2.3 → telesign-2.2.4}/telesign/rest.py

@@ -8,6 +8,7 @@ from hashlib import sha256
 from platform import python_version
 
 import requests
+import json
 
 import telesign
 from telesign.util import AuthMethod
@@ -118,14 +119,14 @@ class RestClient(requests.models.RequestEncodingMixin):
             content_type = "application/x-www-form-urlencoded" if method_name in ("POST", "PUT") else ""
 
         # Default auth_method is Digest if not explicitly specified
-        if auth_method == AuthMethod.BASIC.value:
+        if auth_method == AuthMethod.BASIC:
             usr_apikey = "{customer_id}:{api_key}".format(customer_id=customer_id,
                                                           api_key=api_key)
             b64val = b64encode(usr_apikey.encode())
-            authorization = "{auth_method} {b64val}".format(auth_method=AuthMethod.BASIC.value,
+            authorization = "{auth_method} {b64val}".format(auth_method=AuthMethod.BASIC,
                                                             b64val=b64val.decode())
         else:
-            auth_method = AuthMethod.HMAC_SHA256.value
+            auth_method = AuthMethod.HMAC_SHA256
 
             string_to_sign_builder = ["{method}".format(method=method_name)]
 
@@ -164,7 +165,7 @@ class RestClient(requests.models.RequestEncodingMixin):
 
         return headers
 
-    def post(self, resource, body=None, **query_params):
+    def post(self, resource, body=None, json_fields=None, **query_params):
         """
         Generic TeleSign REST API POST handler.
 
@@ -173,9 +174,9 @@ class RestClient(requests.models.RequestEncodingMixin):
         :param query_params: query_params to perform the POST request with, as a dictionary.
         :return: The RestClient Response object.
         """
-        return self._execute(self.session.post, 'POST', resource, body, **query_params)
+        return self._execute(self.session.post, 'POST', resource, body, json_fields, **query_params)
 
-    def get(self, resource, body=None, **query_params):
+    def get(self, resource, body=None, json_fields=None, **query_params):
         """
         Generic TeleSign REST API GET handler.
 
@@ -184,9 +185,9 @@ class RestClient(requests.models.RequestEncodingMixin):
         :param query_params: query_params to perform the GET request with, as a dictionary.
         :return: The RestClient Response object.
         """
-        return self._execute(self.session.get, 'GET', resource, body, **query_params)
+        return self._execute(self.session.get, 'GET', resource, body, json_fields, **query_params)
 
-    def put(self, resource, body=None, **query_params):
+    def put(self, resource, body=None, json_fields=None, **query_params):
         """
         Generic TeleSign REST API PUT handler.
 
@@ -195,9 +196,9 @@ class RestClient(requests.models.RequestEncodingMixin):
         :param query_params: query_params to perform the PUT request with, as a dictionary.
         :return: The RestClient Response object.
         """
-        return self._execute(self.session.put, 'PUT', resource, body, **query_params)
+        return self._execute(self.session.put, 'PUT', resource, body, json_fields, **query_params)
 
-    def delete(self, resource, body=None, **query_params):
+    def delete(self, resource, body=None, json_fields=None, **query_params):
         """
         Generic TeleSign REST API DELETE handler.
 
@@ -206,9 +207,9 @@ class RestClient(requests.models.RequestEncodingMixin):
         :param query_params: query_params to perform the DELETE request with, as a dictionary.
         :return: The RestClient Response object.
         """
-        return self._execute(self.session.delete, 'DELETE', resource, body, **query_params)
+        return self._execute(self.session.delete, 'DELETE', resource, body, json_fields, **query_params)
 
-    def _execute(self, method_function, method_name, resource, body=None, **query_params):
+    def _execute(self, method_function, method_name, resource, body=None, json_fields=None, **query_params):
         """
         Generic TeleSign REST API request handler.
 
@@ -222,7 +223,11 @@ class RestClient(requests.models.RequestEncodingMixin):
         resource_uri = "{api_host}{resource}".format(api_host=self.api_host, resource=resource)
 
         url_encoded_fields = self._encode_params(query_params)
-        if body:
+        if json_fields:
+            fields = json.dumps(json_fields)
+            url_encoded_fields = fields
+
+        if body or json_fields:
             content_type = "application/json"
         else:
             content_type = None  # set later
@@ -235,13 +240,14 @@ class RestClient(requests.models.RequestEncodingMixin):
                                                        user_agent=self.user_agent,
                                                        content_type=content_type,
                                                        auth_method=self.auth_method)
-
         if method_name in ['POST', 'PUT']:
             payload = {}
             if body:
                 payload['json'] = body
             if query_params:
                 payload['data'] = url_encoded_fields
+            if json_fields:
+                payload = {'data': url_encoded_fields}
         else:
             payload = {'params': url_encoded_fields}
 

telesign-2.2.4/telesign.egg-info/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 1.1
+Name: telesign
+Version: 2.2.4
+Summary: TeleSign SDK
+Home-page: https://github.com/telesign/python_telesign
+Author: TeleSign Corp.
+Author-email: support@telesign.com
+License: MIT
+Description: .. image:: https://raw.github.com/TeleSign/python_telesign/master/python_banner.jpg
+               :target: https://standard.telesign.com
+        
+        .. image:: https://img.shields.io/travis/TeleSign/python_telesign.svg
+               :target: https://travis-ci.org/TeleSign/python_telesign
+        
+        .. image:: https://img.shields.io/codecov/c/github/TeleSign/python_telesign.svg
+               :target: https://codecov.io/gh/TeleSign/python_telesign
+        
+        .. image:: https://img.shields.io/pypi/v/telesign.svg
+               :target: https://pypi.python.org/pypi/telesign
+        
+        .. image:: https://img.shields.io/pypi/l/telesign.svg
+               :target: https://github.com/TeleSign/python_telesign/blob/master/LICENSE
+        
+        ===================
+        TeleSign Python SDK
+        ===================
+        
+        TeleSign is a communications platform as a service (CPaaS) company, founded on security. Since 2005, TeleSign has
+        been a trusted partner to the world’s leading websites and mobile applications, helping secure billions of end-user
+        accounts. Today, TeleSign’s data-driven, cloud communications platform is changing the way businesses engage with
+        customers and prevent fraud.
+        
+        For more information about TeleSign, visit our `website <http://www.TeleSign.com>`_.
+        
+        Documentation
+        -------------
+        
+        Code documentation is included in the SDK. Complete documentation, quick start guides and reference material
+        for the TeleSign API is available within the `TeleSign Standard Documentation <https://standard.telesign.com/>`_.
+        
+        Installation
+        ------------
+        
+        To install the TeleSign Python SDK:
+        
+        .. code-block:: bash
+        
+            $ pip install telesign
+        
+        Python **2.7+** is required for the TeleSign Python SDK.
+        
+        Authentication
+        --------------
+        
+        You will need a Customer ID and API Key in order to use TeleSign’s API. If you already have an account you can retrieve
+        them from your account dashboard within the `Portal <https://portal.telesign.com/login>`_. If you have not signed up
+        yet, sign up `here <https://portal.telesign.com/signup>`_.
+        
+        Dependencies
+        ------------
+        
+        We make use of popular, feature-rich and well-tested open-source libraries to perform the underlying functionality of
+        the SDK. These dependencies are managed by the community accepted package manager. If you are unable to add these
+        additional third party dependencies to your project we have ensured that the SDK code is easy to read and can serve as
+        sample code. We have also made sure that more complicated functions such as generate_telesign_headers can be easily
+        extracted from the SDK and used 'as is' in your project.
+        
+        Python Code Example: Messaging
+        ------------------------------
+        
+        Here is a basic code example with the JSON response.
+        
+        .. code-block:: python
+        
+            from __future__ import print_function
+            from telesign.messaging import MessagingClient
+        
+            customer_id = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890"
+            api_key = "EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw=="
+        
+            phone_number = "phone_number"
+            message = "You're scheduled for a dentist appointment at 2:30PM."
+            message_type = "ARN"
+        
+            messaging_client = MessagingClient(customer_id, api_key)
+            response = messaging_client.message(phone_number, message, message_type)
+        
+            print(response.json)
+        
+        .. code-block:: javascript
+               
+            {'reference_id': 'DGFDF6E11AB86303ASDFD425BE00000657',
+             'status': {'code': 103,
+                'description': 'Call in progress',
+                'updated_on': '2016-12-12T00:39:58.325559Z'}}
+        
+        For more examples, see the `examples <https://github.com/TeleSign/python_telesign/tree/master/examples>`_ folder or
+        visit the `TeleSign Standard Documentation <https://standard.telesign.com/>`_.
+        
+Keywords: telesign,sms,voice,mobile,authentication,identity,messaging
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6

{telesign-2.2.3 → telesign-2.2.4}/telesign.egg-info/SOURCES.txt

@@ -28,5 +28,6 @@ telesign.egg-info/dependency_links.txt
 telesign.egg-info/requires.txt
 telesign.egg-info/top_level.txt
 tests/__init__.py
+tests/test_phoneid.py
 tests/test_rest.py
 tests/test_util.py

telesign-2.2.4/tests/test_phoneid.py

@@ -0,0 +1,48 @@
+from __future__ import unicode_literals
+import os
+from unittest import TestCase
+from telesign.phoneid import PhoneIdClient
+
+class TestPhoneId(TestCase):
+    def setUp(self):
+        self.customer_id = os.getenv('CUSTOMER_ID', 'FFFFFFFF-EEEE-DDDD-1234-AB1234567890')
+        self.api_key = os.getenv('API_KEY', 'EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==')
+        self.phone_number_test = "11234567890"
+
+    def test_phoneid_constructor(self):
+
+        client = PhoneIdClient(self.customer_id,
+                            self.api_key)
+
+        self.assertEqual(client.customer_id, self.customer_id)
+        self.assertEqual(client.api_key, self.api_key)
+        
+
+    def test_phoneid_pid_contact(self):
+
+        client = PhoneIdClient(self.customer_id, self.api_key)
+        content_type_expected = 'application/json'
+        status_code_expected = 200
+        
+        payload = {  
+            "addons": {
+                "contact": {}
+            },
+            "phone_number": self.phone_number_test
+        }
+
+        response = client.phoneid(**payload)
+
+        self.assertEqual(response.headers.get('Content-Type'), content_type_expected, "Content-Type args do not match expected")
+        self.assertEqual(response.status_code, status_code_expected, "Status code args do not match expected")
+
+    def test_phoneid_pid(self):
+
+        client = PhoneIdClient(self.customer_id, self.api_key)
+        content_type_expected = 'application/json'
+        status_code_expected = 200
+
+        response = client.phoneid(self.phone_number_test)
+
+        self.assertEqual(response.headers.get('Content-Type'), content_type_expected, "Content-Type args do not match expected")
+        self.assertEqual(response.status_code, status_code_expected, "Status code args do not match expected")

telesign-2.2.3/PKG-INFO

@@ -1,115 +0,0 @@
-Metadata-Version: 2.1
-Name: telesign
-Version: 2.2.3
-Summary: TeleSign SDK
-Home-page: https://github.com/telesign/python_telesign
-Author: TeleSign Corp.
-Author-email: support@telesign.com
-License: MIT
-Keywords: telesign,sms,voice,mobile,authentication,identity,messaging
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 2
-Classifier: Programming Language :: Python :: 2.6
-Classifier: Programming Language :: Python :: 2.7
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.3
-Classifier: Programming Language :: Python :: 3.4
-Classifier: Programming Language :: Python :: 3.5
-Classifier: Programming Language :: Python :: 3.6
-License-File: LICENSE.txt
-Requires-Dist: requests
-
-.. image:: https://raw.github.com/TeleSign/python_telesign/master/python_banner.jpg
-       :target: https://standard.telesign.com
-
-.. image:: https://img.shields.io/travis/TeleSign/python_telesign.svg
-       :target: https://travis-ci.org/TeleSign/python_telesign
-
-.. image:: https://img.shields.io/codecov/c/github/TeleSign/python_telesign.svg
-       :target: https://codecov.io/gh/TeleSign/python_telesign
-
-.. image:: https://img.shields.io/pypi/v/telesign.svg
-       :target: https://pypi.python.org/pypi/telesign
-
-.. image:: https://img.shields.io/pypi/l/telesign.svg
-       :target: https://github.com/TeleSign/python_telesign/blob/master/LICENSE
-
-===================
-TeleSign Python SDK
-===================
-
-TeleSign is a communications platform as a service (CPaaS) company, founded on security. Since 2005, TeleSign has
-been a trusted partner to the world’s leading websites and mobile applications, helping secure billions of end-user
-accounts. Today, TeleSign’s data-driven, cloud communications platform is changing the way businesses engage with
-customers and prevent fraud.
-
-For more information about TeleSign, visit our `website <http://www.TeleSign.com>`_.
-
-Documentation
--------------
-
-Code documentation is included in the SDK. Complete documentation, quick start guides and reference material
-for the TeleSign API is available within the `TeleSign Standard Documentation <https://standard.telesign.com/>`_.
-
-Installation
-------------
-
-To install the TeleSign Python SDK:
-
-.. code-block:: bash
-
-    $ pip install telesign
-
-Python **2.7+** is required for the TeleSign Python SDK.
-
-Authentication
---------------
-
-You will need a Customer ID and API Key in order to use TeleSign’s API. If you already have an account you can retrieve
-them from your account dashboard within the `Portal <https://portal.telesign.com/login>`_. If you have not signed up
-yet, sign up `here <https://portal.telesign.com/signup>`_.
-
-Dependencies
-------------
-
-We make use of popular, feature-rich and well-tested open-source libraries to perform the underlying functionality of
-the SDK. These dependencies are managed by the community accepted package manager. If you are unable to add these
-additional third party dependencies to your project we have ensured that the SDK code is easy to read and can serve as
-sample code. We have also made sure that more complicated functions such as generate_telesign_headers can be easily
-extracted from the SDK and used 'as is' in your project.
-
-Python Code Example: Messaging
-------------------------------
-
-Here is a basic code example with the JSON response.
-
-.. code-block:: python
-
-    from __future__ import print_function
-    from telesign.messaging import MessagingClient
-
-    customer_id = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890"
-    api_key = "EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw=="
-
-    phone_number = "phone_number"
-    message = "You're scheduled for a dentist appointment at 2:30PM."
-    message_type = "ARN"
-
-    messaging_client = MessagingClient(customer_id, api_key)
-    response = messaging_client.message(phone_number, message, message_type)
-
-    print(response.json)
-
-.. code-block:: javascript
-       
-    {'reference_id': 'DGFDF6E11AB86303ASDFD425BE00000657',
-     'status': {'code': 103,
-        'description': 'Call in progress',
-        'updated_on': '2016-12-12T00:39:58.325559Z'}}
-
-For more examples, see the `examples <https://github.com/TeleSign/python_telesign/tree/master/examples>`_ folder or
-visit the `TeleSign Standard Documentation <https://standard.telesign.com/>`_.

telesign-2.2.3/telesign/phoneid.py

@@ -1,54 +0,0 @@
-from __future__ import unicode_literals
-
-import json
-
-from telesign.rest import RestClient
-
-PHONEID_RESOURCE = "/v1/phoneid/{phone_number}"
-
-
-class PhoneIdClient(RestClient):
-    """
-    A set of APIs that deliver deep phone number data attributes that help optimize the end user
-    verification process and evaluate risk.
-    """
-
-    def __init__(self, customer_id, api_key, **kwargs):
-        super(PhoneIdClient, self).__init__(customer_id, api_key, **kwargs)
-
-    def phoneid(self, phone_number, **params):
-        """
-        The PhoneID API provides a cleansed phone number, phone type, and telecom carrier information to determine the
-        best communication method - SMS or voice.
-
-        See https://developer.telesign.com/docs/phoneid-api for detailed API documentation.
-        """
-        return self.post(PHONEID_RESOURCE.format(phone_number=phone_number),
-                         **params)
-
-    def _execute(self, method_function, method_name, resource, **params):
-        resource_uri = "{api_host}{resource}".format(api_host=self.api_host, resource=resource)
-
-        json_fields = json.dumps(params)
-
-        content_type = "application/json" if method_name in ("POST", "PUT") else ""
-
-        headers = self.generate_telesign_headers(self.customer_id,
-                                                 self.api_key,
-                                                 method_name,
-                                                 resource,
-                                                 json_fields,
-                                                 user_agent=self.user_agent,
-                                                 content_type=content_type)
-
-        if method_name in ['POST', 'PUT']:
-            payload = {'data': json_fields}
-        else:
-            payload = {'params': json_fields}
-
-        response = self.Response(method_function(resource_uri,
-                                                 headers=headers,
-                                                 timeout=self.timeout,
-                                                 **payload))
-
-        return response

telesign-2.2.3/telesign.egg-info/PKG-INFO

@@ -1,115 +0,0 @@
-Metadata-Version: 2.1
-Name: telesign
-Version: 2.2.3
-Summary: TeleSign SDK
-Home-page: https://github.com/telesign/python_telesign
-Author: TeleSign Corp.
-Author-email: support@telesign.com
-License: MIT
-Keywords: telesign,sms,voice,mobile,authentication,identity,messaging
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 2
-Classifier: Programming Language :: Python :: 2.6
-Classifier: Programming Language :: Python :: 2.7
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.3
-Classifier: Programming Language :: Python :: 3.4
-Classifier: Programming Language :: Python :: 3.5
-Classifier: Programming Language :: Python :: 3.6
-License-File: LICENSE.txt
-Requires-Dist: requests
-
-.. image:: https://raw.github.com/TeleSign/python_telesign/master/python_banner.jpg
-       :target: https://standard.telesign.com
-
-.. image:: https://img.shields.io/travis/TeleSign/python_telesign.svg
-       :target: https://travis-ci.org/TeleSign/python_telesign
-
-.. image:: https://img.shields.io/codecov/c/github/TeleSign/python_telesign.svg
-       :target: https://codecov.io/gh/TeleSign/python_telesign
-
-.. image:: https://img.shields.io/pypi/v/telesign.svg
-       :target: https://pypi.python.org/pypi/telesign
-
-.. image:: https://img.shields.io/pypi/l/telesign.svg
-       :target: https://github.com/TeleSign/python_telesign/blob/master/LICENSE
-
-===================
-TeleSign Python SDK
-===================
-
-TeleSign is a communications platform as a service (CPaaS) company, founded on security. Since 2005, TeleSign has
-been a trusted partner to the world’s leading websites and mobile applications, helping secure billions of end-user
-accounts. Today, TeleSign’s data-driven, cloud communications platform is changing the way businesses engage with
-customers and prevent fraud.
-
-For more information about TeleSign, visit our `website <http://www.TeleSign.com>`_.
-
-Documentation
--------------
-
-Code documentation is included in the SDK. Complete documentation, quick start guides and reference material
-for the TeleSign API is available within the `TeleSign Standard Documentation <https://standard.telesign.com/>`_.
-
-Installation
-------------
-
-To install the TeleSign Python SDK:
-
-.. code-block:: bash
-
-    $ pip install telesign
-
-Python **2.7+** is required for the TeleSign Python SDK.
-
-Authentication
---------------
-
-You will need a Customer ID and API Key in order to use TeleSign’s API. If you already have an account you can retrieve
-them from your account dashboard within the `Portal <https://portal.telesign.com/login>`_. If you have not signed up
-yet, sign up `here <https://portal.telesign.com/signup>`_.
-
-Dependencies
-------------
-
-We make use of popular, feature-rich and well-tested open-source libraries to perform the underlying functionality of
-the SDK. These dependencies are managed by the community accepted package manager. If you are unable to add these
-additional third party dependencies to your project we have ensured that the SDK code is easy to read and can serve as
-sample code. We have also made sure that more complicated functions such as generate_telesign_headers can be easily
-extracted from the SDK and used 'as is' in your project.
-
-Python Code Example: Messaging
-------------------------------
-
-Here is a basic code example with the JSON response.
-
-.. code-block:: python
-
-    from __future__ import print_function
-    from telesign.messaging import MessagingClient
-
-    customer_id = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890"
-    api_key = "EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw=="
-
-    phone_number = "phone_number"
-    message = "You're scheduled for a dentist appointment at 2:30PM."
-    message_type = "ARN"
-
-    messaging_client = MessagingClient(customer_id, api_key)
-    response = messaging_client.message(phone_number, message, message_type)
-
-    print(response.json)
-
-.. code-block:: javascript
-       
-    {'reference_id': 'DGFDF6E11AB86303ASDFD425BE00000657',
-     'status': {'code': 103,
-        'description': 'Call in progress',
-        'updated_on': '2016-12-12T00:39:58.325559Z'}}
-
-For more examples, see the `examples <https://github.com/TeleSign/python_telesign/tree/master/examples>`_ folder or
-visit the `TeleSign Standard Documentation <https://standard.telesign.com/>`_.