telesign 3.0.0__tar.gz → 4.0.0__tar.gz

{telesign-3.0.0/telesign.egg-info → telesign-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: telesign
-Version: 3.0.0
+Version: 4.0.0
 Summary: TeleSign SDK
 Home-page: https://github.com/telesign/python_telesign
 Author: TeleSign Corp.
@@ -112,3 +112,9 @@ Classifier: Programming Language :: Python :: 3.3
 Classifier: Programming Language :: Python :: 3.4
 Classifier: Programming Language :: Python :: 3.5
 Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12

telesign-4.0.0/examples/score/1_check_phone_number_risk_level.py

@@ -0,0 +1,25 @@
+from __future__ import print_function
+from telesign.score import ScoreClient
+
+customer_id = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890"
+api_key = "ABC12345yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw=="
+
+phone_number = "phone_number"
+account_lifecycle_event = "create"
+
+score_client = ScoreClient(customer_id, api_key)
+response = score_client.score(phone_number, account_lifecycle_event)
+
+if response.ok:
+    print(
+        "Phone number {} has a '{}' risk level and the recommendation is to '{}' the transaction.".format(
+            phone_number,
+            response.json['risk']['level'],
+            response.json['risk']['recommendation'])
+    )
+else:
+    print(
+        "Request failed with status code: {}. Details: {}".format(
+            response.status_code, 
+            response.json)
+    )

telesign-4.0.0/setup.py

@@ -0,0 +1,51 @@
+import sys
+from codecs import open
+from os import path
+
+from setuptools import setup, find_packages
+
+EXCLUDE_FROM_PACKAGES = ["tests"]
+
+here = path.abspath(path.dirname(__file__))
+
+version = "4.0.0"
+
+with open(path.join(here, "README.rst"), encoding="utf-8") as f:
+    long_description = f.read()
+
+setup(
+    name="telesign",
+    version=version,
+    description="TeleSign SDK",
+    license="MIT",
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Natural Language :: English",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 2",
+        "Programming Language :: Python :: 2.6",
+        "Programming Language :: Python :: 2.7",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.3",
+        "Programming Language :: Python :: 3.4",
+        "Programming Language :: Python :: 3.5",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    long_description=long_description,
+    keywords="telesign, sms, voice, mobile, authentication, identity, messaging",
+    author="TeleSign Corp.",
+    author_email="support@telesign.com",
+    url="https://github.com/telesign/python_telesign",
+    install_requires=["requests"],
+    test_suite="nose.collector",
+    tests_require=["nose", "pytz"],
+    packages=find_packages(exclude=EXCLUDE_FROM_PACKAGES),
+)

{telesign-3.0.0 → telesign-4.0.0}/telesign/__init__.py

@@ -1,7 +1,5 @@
 from pkg_resources import get_distribution
 
-__import__('pkg_resources').declare_namespace(__name__)
-
 __version__ = get_distribution("telesign").version
 __author__ = "TeleSign"
 __copyright__ = "Copyright 2017, TeleSign Corp."

telesign-4.0.0/telesign/score.py

@@ -0,0 +1,35 @@
+from telesign.rest import RestClient
+
+DETECT_HOST = "https://detect.telesign.com"
+INTELLIGENCE_RESOURCE = "/intelligence/phone"
+
+class ScoreClient(RestClient):
+    """
+    ScoreClient for TeleSign Intelligence Cloud.
+    Supports POST /intelligence/phone endpoint(Cloud migration).
+    """
+
+    def __init__(self, customer_id, api_key, rest_endpoint=DETECT_HOST, **kwargs):
+        super(ScoreClient, self).__init__(customer_id, api_key, rest_endpoint, **kwargs)
+
+    def score(self, phone_number, account_lifecycle_event, **params):
+        """
+        Obtain a risk recommendation for a phone number using Telesign Intelligence Cloud API.
+        Required parameters:
+          - phone_number
+          - account_lifecycle_event ("create", "sign-in", "transact", "update", "delete")
+        Optional parameters: account_id, device_id, email_address, external_id, originating_ip, etc.
+        """
+        if not phone_number:
+            raise ValueError("phone_number cannot be null or empty")
+
+        if not account_lifecycle_event:
+            raise ValueError("account_lifecycle_event cannot be null or empty")
+
+        params["phone_number"] = phone_number
+        params["account_lifecycle_event"] = account_lifecycle_event
+
+        return self.post(
+            INTELLIGENCE_RESOURCE, 
+            **params
+        )

{telesign-3.0.0 → telesign-4.0.0/telesign.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: telesign
-Version: 3.0.0
+Version: 4.0.0
 Summary: TeleSign SDK
 Home-page: https://github.com/telesign/python_telesign
 Author: TeleSign Corp.
@@ -112,3 +112,9 @@ Classifier: Programming Language :: Python :: 3.3
 Classifier: Programming Language :: Python :: 3.4
 Classifier: Programming Language :: Python :: 3.5
 Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12

{telesign-3.0.0 → telesign-4.0.0}/telesign.egg-info/SOURCES.txt

@@ -26,4 +26,5 @@ telesign.egg-info/top_level.txt
 tests/__init__.py
 tests/test_phoneid.py
 tests/test_rest.py
+tests/test_score.py
 tests/test_util.py

telesign-4.0.0/tests/test_score.py

@@ -0,0 +1,45 @@
+from __future__ import unicode_literals
+import os
+from unittest import TestCase, mock
+from telesign.score import ScoreClient
+
+class TestScoreClient(TestCase):
+    def setUp(self):
+        self.customer_id = os.getenv('CUSTOMER_ID', 'FFFFFFFF-EEEE-DDDD-1234-AB1234567890')
+        self.api_key = os.getenv('API_KEY', 'ABC12345yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==')
+        self.phone_number_test = os.getenv('PHONE_NUMBER', 'phone_number')
+        self.account_lifecycle_event = "create"
+
+    @mock.patch('telesign.rest.requests.Session.post')
+    def test_score_method(self, mock_post):
+        mock_response = mock.Mock()
+        mock_response.ok = True
+        mock_response.status_code = 200
+        mock_response.headers = {'Content-Type': 'application/json'}
+        mock_response.json.return_value = {
+            "risk": {
+                "level": "LOW",
+                "recommendation": "allow"
+            }
+        }
+        mock_post.return_value = mock_response
+
+        client = ScoreClient(self.customer_id, self.api_key)
+        response = client.score(self.phone_number_test, self.account_lifecycle_event)
+
+        called_url = mock_post.call_args[0][0]
+        self.assertIn('/intelligence/phone', called_url)
+
+        called_kwargs = mock_post.call_args[1] if mock_post.call_args else {}
+        called_data = called_kwargs.get('data', '')
+
+        self.assertTrue(called_data, "POST data is empty, expected form parameters")
+        self.assertIn(f'phone_number={self.phone_number_test}', called_data)
+        self.assertIn(f'account_lifecycle_event={self.account_lifecycle_event}', called_data)
+
+        self.assertEqual(response.status_code, 200)
+        self.assertTrue(response.ok)
+        self.assertEqual(response.headers.get('Content-Type'), 'application/json')
+        self.assertIn('risk', response.json)
+        self.assertEqual(response.json['risk']['level'], 'LOW')
+        self.assertEqual(response.json['risk']['recommendation'], 'allow')

telesign-3.0.0/examples/score/1_check_phone_number_risk_level.py

@@ -1,17 +0,0 @@
-from __future__ import print_function
-from telesign.score import ScoreClient
-
-customer_id = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890"
-api_key = "EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw=="
-
-phone_number = "phone_number"
-account_lifecycle_event = "create"
-
-data = ScoreClient(customer_id, api_key)
-response = data.score(phone_number, account_lifecycle_event)
-
-if response.ok:
-    print("Phone number {} has a '{}' risk level and the recommendation is to '{}' the transaction.".format(
-        phone_number,
-        response.json['risk']['level'],
-        response.json['risk']['recommendation']))

telesign-3.0.0/setup.py

@@ -1,47 +0,0 @@
-import sys
-from codecs import open
-from os import path
-
-from setuptools import setup, find_packages
-
-EXCLUDE_FROM_PACKAGES = ['tests']
-
-needs_mock = sys.version_info < (3, 3)
-mock = ['mock'] if needs_mock else []
-
-here = path.abspath(path.dirname(__file__))
-
-version = "3.0.0"
-
-with open(path.join(here, 'README.rst'), encoding='utf-8') as f:
-    long_description = f.read()
-
-setup(name='telesign',
-      version=version,
-      description="TeleSign SDK",
-      license="MIT",
-      classifiers=[
-          "Development Status :: 5 - Production/Stable",
-          "Intended Audience :: Developers",
-          "License :: OSI Approved :: MIT License",
-          "Natural Language :: English",
-          "Programming Language :: Python",
-          "Programming Language :: Python :: 2",
-          "Programming Language :: Python :: 2.6",
-          "Programming Language :: Python :: 2.7",
-          "Programming Language :: Python :: 3",
-          "Programming Language :: Python :: 3.3",
-          "Programming Language :: Python :: 3.4",
-          "Programming Language :: Python :: 3.5",
-          "Programming Language :: Python :: 3.6",
-      ],
-      long_description=long_description,
-      keywords='telesign, sms, voice, mobile, authentication, identity, messaging',
-      author='TeleSign Corp.',
-      author_email='support@telesign.com',
-      url="https://github.com/telesign/python_telesign",
-      install_requires=['requests'],
-      test_suite='nose.collector',
-      tests_require=['nose', 'pytz'] + mock,
-      packages=find_packages(exclude=EXCLUDE_FROM_PACKAGES),
-      )

telesign-3.0.0/telesign/score.py

@@ -1,25 +0,0 @@
-from __future__ import unicode_literals
-
-from telesign.rest import RestClient
-
-SCORE_RESOURCE = "/v1/score/{phone_number}"
-
-
-class ScoreClient(RestClient):
-    """
-    Score provides risk information about a specified phone number.
-    """
-
-    def __init__(self, customer_id, api_key, **kwargs):
-        super(ScoreClient, self).__init__(customer_id, api_key, **kwargs)
-
-    def score(self, phone_number, account_lifecycle_event, **params):
-        """
-        Score is an API that delivers reputation scoring based on phone number intelligence, traffic patterns, machine
-        learning, and a global data consortium.
-
-        See https://developer.telesign.com/docs/score-api for detailed API documentation.
-        """
-        return self.post(SCORE_RESOURCE.format(phone_number=phone_number),
-                         account_lifecycle_event=account_lifecycle_event,
-                         **params)