python-terminusgps 45.2.0__tar.gz → 45.4.0__tar.gz

{python_terminusgps-45.2.0 → python_terminusgps-45.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 45.2.0
+Version: 45.4.0
 Summary: Provides abstractions/utilities for working with Wialon API, Authorize.NET API, AWS API, and more.
 Project-URL: Documentation, https://terminusgps.github.io/python-terminusgps
 Project-URL: Repository, https://github.com/terminusgps/python-terminusgps

{python_terminusgps-45.2.0 → python_terminusgps-45.4.0}/docs/source/conf.py

@@ -12,7 +12,7 @@ sys.path.insert(0, os.path.abspath("../../"))
 project = "python-terminusgps"
 copyright = "2025, Terminus GPS, LLC"
 author = "Terminus GPS, LLC"
-release = "45.2.0"
+release = "45.4.0"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

{python_terminusgps-45.2.0 → python_terminusgps-45.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "45.2.0"
+version = "45.4.0"
 description = "Provides abstractions/utilities for working with Wialon API, Authorize.NET API, AWS API, and more."
 readme = "README.md"
 authors = [ {name = "Blake Nall", email = "blake@terminusgps.com" } ]

{python_terminusgps-45.2.0 → python_terminusgps-45.4.0}/terminusgps/authorizenet/api/payment_profiles.py

@@ -2,8 +2,6 @@ from authorizenet import apicontractsv1, apicontrollers
 from authorizenet.apicontrollersbase import APIOperationBase
 from lxml.objectify import ObjectifiedElement
 
-from terminusgps.authorizenet.auth import get_validation_mode
-
 __all__ = [
     "create_customer_payment_profile",
     "get_customer_payment_profile",
@@ -16,7 +14,6 @@ __all__ = [
 def create_customer_payment_profile(
     customer_profile_id: int,
     payment_profile: apicontractsv1.customerPaymentProfileType,
-    validate: bool = True,
 ) -> tuple[ObjectifiedElement, type[APIOperationBase]]:
     """
     `createCustomerPaymentProfileRequest <https://developer.authorize.net/api/reference/index.html#customer-profiles-create-customer-payment-profile>`_.
@@ -33,8 +30,6 @@ def create_customer_payment_profile(
     request = apicontractsv1.createCustomerPaymentProfileRequest()
     request.customerProfileId = str(customer_profile_id)
     request.paymentProfile = payment_profile
-    if validate:
-        request.validationMode = get_validation_mode()
     return request, apicontrollers.createCustomerPaymentProfileController
 
 
@@ -80,7 +75,6 @@ def validate_customer_payment_profile(
     request = apicontractsv1.validateCustomerPaymentProfileRequest()
     request.customerProfileId = str(customer_profile_id)
     request.customerPaymentProfileId = str(payment_profile_id)
-    request.validationMode = get_validation_mode()
     return request, apicontrollers.validateCustomerPaymentProfileController
 
 
@@ -88,7 +82,6 @@ def update_customer_payment_profile(
     customer_profile_id: int,
     payment_profile_id: int,
     payment_profile: apicontractsv1.customerPaymentProfileType,
-    validate: bool = True,
 ) -> tuple[ObjectifiedElement, type[APIOperationBase]]:
     """
     `updateCustomerPaymentProfileRequest <https://developer.authorize.net/api/reference/index.html#customer-profiles-update-customer-payment-profile>`_.
@@ -99,8 +92,6 @@ def update_customer_payment_profile(
     :type payment_profile_id: int
     :param payment_profile: An Authorizenet payment profile element.
     :type payment_profile: ~authorizenet.apicontractsv1.customerPaymentProfileType
-    :param validate: Whether to validate the payment profile. Default is True.
-    :type validate: bool
     :returns: A tuple containing an Authorizenet API request element and controller class.
     :rtype: tuple[~lxml.objectify.ObjectifiedElement, type[~authorizenet.apicontrollersbase.APIOperationBase]]
 
@@ -111,8 +102,6 @@ def update_customer_payment_profile(
     request = apicontractsv1.updateCustomerPaymentProfileRequest()
     request.customerProfileId = str(customer_profile_id)
     request.paymentProfile = payment_profile
-    if validate:
-        request.validationMode = get_validation_mode()
     return request, apicontrollers.updateCustomerPaymentProfileController
 
 

python_terminusgps-45.4.0/terminusgps/authorizenet/auth.py

@@ -0,0 +1,38 @@
+from authorizenet.apicontractsv1 import merchantAuthenticationType
+from django.conf import settings
+
+
+def get_merchant_auth() -> merchantAuthenticationType:
+    """
+    Returns the merchant authentication information for Authorizenet API controller execution.
+
+    :returns: A merchant authentication object.
+    :rtype: ~authorizenet.apicontractsv1.merchantAuthenticationType
+
+    """
+    return merchantAuthenticationType(
+        name=str(settings.MERCHANT_AUTH_LOGIN_ID),
+        transactionKey=str(settings.MERCHANT_AUTH_TRANSACTION_KEY),
+    )
+
+
+def get_environment() -> str:
+    """
+    Returns the environment for Authorizenet API controller execution.
+
+    :returns: An Authorizenet API environment string.
+    :rtype: str
+
+    """
+    return settings.MERCHANT_AUTH_ENVIRONMENT
+
+
+def get_validation_mode() -> str:
+    """
+    Returns the validation mode for Authorizenet API controller execution.
+
+    :returns: An Authorizenet API validation string.
+    :rtype: str
+
+    """
+    return settings.MERCHANT_AUTH_VALIDATION_MODE

{python_terminusgps-45.2.0 → python_terminusgps-45.4.0}/terminusgps/authorizenet/controllers.py

@@ -3,7 +3,7 @@ from lxml.objectify import ObjectifiedElement
 
 
 def execute_controller(
-    controller: APIOperationBase,
+    controller: APIOperationBase, environment: str
 ) -> ObjectifiedElement | None:
     """
     Executes an Authorizenet API controller and returns its response.
@@ -19,8 +19,10 @@ def execute_controller(
     :rtype: ~lxml.objectify.ObjectifiedElement | None
 
     """
+    controller.setenvironment(environment)
     controller.execute()
     response = controller.getresponse()
+
     if response is None:
         raise AuthorizenetControllerExecutionError(
             message="Authorizenet controller response didn't exist.", code="1"

python_terminusgps-45.4.0/terminusgps/authorizenet/services.py

@@ -0,0 +1,60 @@
+from abc import ABC
+from functools import cached_property
+from typing import Callable
+
+from authorizenet.apicontractsv1 import merchantAuthenticationType
+from django.conf import settings
+from django.core.exceptions import ImproperlyConfigured
+from lxml.objectify import ObjectifiedElement
+
+from .auth import get_environment, get_merchant_auth, get_validation_mode
+from .controllers import execute_controller
+
+
+class AuthorizenetService(ABC):
+    """Base class for services that interact with the Authorizenet API."""
+
+    REQUIRED_SETTINGS = (
+        "MERCHANT_AUTH_ENVIRONMENT",
+        "MERCHANT_AUTH_LOGIN_ID",
+        "MERCHANT_AUTH_TRANSACTION_KEY",
+        "MERCHANT_AUTH_VALIDATION_MODE",
+    )
+
+    def __init__(self) -> None:
+        """Raises :py:exc:`~django.core.exceptions.ImproperlyConfigured` if required settings weren't set."""
+        for setting in self.REQUIRED_SETTINGS:
+            if not hasattr(settings, setting):
+                raise ImproperlyConfigured(f"'{setting}' setting is required.")
+
+    def call_api(self, func: Callable, *args, **kwargs) -> ObjectifiedElement:
+        """
+        Calls the Authorizenet API function with arguments and returns the result.
+
+        :param func: An Authorizenet API function.
+        :type func: ~typing.Callable
+        :param args: Positional arguments for the API call.
+        :param kwargs: Keyword arguments for the API call.
+        :raises ~terminusgps.authorizenet.controllers.AuthorizenetControllerExecutionError: If the API call failed.
+        :returns: The Authorizenet API call response.
+        :rtype: ~lxml.objectify.ObjectifiedElement
+
+        """
+        request, controller_cls = func(*args, **kwargs)
+        request.merchantAuthentication = self.merchantAuthentication
+        return execute_controller(controller_cls(request), self.environment)
+
+    @cached_property
+    def merchantAuthentication(self) -> merchantAuthenticationType:
+        """Merchant authentication element for Authorizenet API requests."""
+        return get_merchant_auth()
+
+    @cached_property
+    def environment(self) -> str:
+        """Environment for Authorizenet API requests."""
+        return get_environment()
+
+    @cached_property
+    def validationMode(self) -> str:
+        """Validation mode for Authorizenet API requests."""
+        return get_validation_mode()

{python_terminusgps-45.2.0 → python_terminusgps-45.4.0}/uv.lock

@@ -298,7 +298,7 @@ wheels = [
 
 [[package]]
 name = "python-terminusgps"
-version = "45.2.0"
+version = "45.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "authorizenet" },

python_terminusgps-45.2.0/terminusgps/authorizenet/auth.py

@@ -1,56 +0,0 @@
-from authorizenet.apicontractsv1 import merchantAuthenticationType
-from django.conf import settings
-from django.core.exceptions import ImproperlyConfigured
-
-
-def get_merchant_auth() -> merchantAuthenticationType:
-    """
-    Returns the merchant authentication information for Authorizenet API controller execution.
-
-    :raises ~django.core.exceptions.ImproperlyConfigured: If the :py:data:`MERCHANT_AUTH_LOGIN_ID` or the :py:data:`MERCHANT_AUTH_TRANSACTION_KEY` settings weren't set.
-    :returns: A merchant authentication object.
-    :rtype: ~authorizenet.apicontractsv1.merchantAuthenticationType
-
-    """
-    if not all(
-        [
-            hasattr(settings, "MERCHANT_AUTH_LOGIN_ID"),
-            hasattr(settings, "MERCHANT_AUTH_TRANSACTION_KEY"),
-        ]
-    ):
-        error_msg: str = "'MERCHANT_AUTH_LOGIN_ID' and 'MERCHANT_AUTH_TRANSACTION_KEY' settings are required."
-        raise ImproperlyConfigured(error_msg)
-    return merchantAuthenticationType(
-        name=str(settings.MERCHANT_AUTH_LOGIN_ID),
-        transactionKey=str(settings.MERCHANT_AUTH_TRANSACTION_KEY),
-    )
-
-
-def get_environment() -> str:
-    """
-    Returns the environment for Authorizenet API controller execution.
-
-    :raises ~django.core.exceptions.ImproperlyConfigured: If the :py:data:`MERCHANT_AUTH_ENVIRONMENT` setting wasn't set.
-    :returns: An Authorizenet API environment string.
-    :rtype: str
-
-    """
-    if not hasattr(settings, "MERCHANT_AUTH_ENVIRONMENT"):
-        error_msg: str = "'MERCHANT_AUTH_ENVIRONMENT' setting is required."
-        raise ImproperlyConfigured(error_msg)
-    return settings.MERCHANT_AUTH_ENVIRONMENT
-
-
-def get_validation_mode() -> str:
-    """
-    Returns the validation mode for Authorizenet API controller execution.
-
-    :raises ~django.core.exceptions.ImproperlyConfigured: If the :py:data:`MERCHANT_AUTH_VALIDATION_MODE` setting wasn't set.
-    :returns: An Authorizenet API validation string.
-    :rtype: str
-
-    """
-    if not hasattr(settings, "MERCHANT_AUTH_VALIDATION_MODE"):
-        error_msg: str = "'MERCHANT_AUTH_VALIDATION_MODE' setting is required."
-        raise ImproperlyConfigured(error_msg)
-    return settings.MERCHANT_AUTH_VALIDATION_MODE

python_terminusgps-45.2.0/terminusgps/authorizenet/validators.py

@@ -1,120 +0,0 @@
-import calendar
-import datetime
-
-from django.core.exceptions import ValidationError
-from django.utils.translation import gettext_lazy as _
-
-
-def validate_credit_card_number(value: str) -> None:
-    """
-    Raises :py:exc:`~django.core.exceptions.ValidationError` if the value is an invalid credit card number.
-
-    Uses the `Luhn algorithm <https://en.wikipedia.org/wiki/Luhn_algorithm>`_ to validate the credit card number.
-
-    :param value: A credit card number string.
-    :type value: :py:obj:`str`
-    :raises ValidationError: If the value contains non-digit characters.
-    :raises ValidationError: If the value fails the Luhn algorithm.
-    :returns: Nothing.
-    :rtype: :py:obj:`None`
-
-    """
-    if not value.isdigit():
-        raise ValidationError(
-            _("Credit card number can only contain digits. Got '%(value)s'."),
-            code="invalid",
-            params={"value": value},
-        )
-
-    card_number = [int(num) for num in reversed(value)]
-    even_digits = card_number[1::2]
-    odd_digits = card_number[0::2]
-
-    checksum = 0
-    checksum += sum(
-        [
-            digit * 2 if digit * 2 <= 9 else (digit * 2) % 9 or 9
-            for digit in even_digits
-        ]
-    )
-    checksum += sum([digit for digit in odd_digits])
-
-    if checksum % 10 != 0:
-        raise ValidationError(_("Invalid credit card number."), code="invalid")
-
-
-def validate_credit_card_expiry_month(value: str) -> None:
-    """
-    Raises :py:exc:`~django.core.exceptions.ValidationError` if the value is an invalid credit card expiration date month.
-
-    :param value: A credit card expiration year string.
-    :type value: :py:obj:`str`
-    :raises ValidationError: If the value contains non-digit characters.
-    :raises ValidationError: If the value is negative.
-    :raises ValidationError: If the value isn't between 1-12.
-    :returns: Nothing.
-    :rtype: :py:obj:`None`
-
-    """
-    if not value.isdigit():
-        raise ValidationError(
-            _("Expiration month can only contain digits, got '%(value)s'."),
-            code="invalid",
-            params={"value": value},
-        )
-    if not int(value) > 0:
-        raise ValidationError(
-            _(
-                "Expiration month can only be a positive value, got '%(value)s'."
-            ),
-            code="invalid",
-            params={"value": value},
-        )
-
-    try:
-        calendar.Month(int(value))
-    except ValueError:
-        raise ValidationError(
-            _("Expiration month must be between 1-12, got '%(value)s'."),
-            code="invalid",
-            params={"value": value},
-        )
-
-
-def validate_credit_card_expiry_year(value: str) -> None:
-    """
-    Raises :py:exc:`~django.core.exceptions.ValidationError` if the value is an invalid credit card expiration date year.
-
-    :param value: A credit card expiration year string.
-    :type value: :py:obj:`str`
-    :raises ValidationError: If the value contains non-digit characters.
-    :raises ValidationError: If the value is negative.
-    :raises ValidationError: If the value is a year in the past.
-    :returns: Nothing.
-    :rtype: :py:obj:`None`
-
-    """
-    if not value.isdigit():
-        raise ValidationError(
-            _("Expiration year can only contain digits, got '%(value)s'."),
-            code="invalid",
-            params={"value": value},
-        )
-    if not int(value) > 0:
-        raise ValidationError(
-            _(
-                "Expiration year can only be a positive value, got '%(value)s'."
-            ),
-            code="invalid",
-            params={"value": value},
-        )
-
-    input_year = datetime.datetime.strptime(value, "%y").year
-    this_year = datetime.datetime.now().year
-
-    if not input_year >= this_year:
-        raise ValidationError(
-            _("Expiration year cannot be in the past, got '%(value)s'."),
-            code="invalid",
-            params={"value": value},
-        )