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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 45.4.0
+Version: 45.6.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.4.0 → python_terminusgps-45.6.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.4.0"
+release = "45.6.0"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

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

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "45.4.0"
+version = "45.6.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.4.0 → python_terminusgps-45.6.0}/terminusgps/authorizenet/api/payment_profiles.py

@@ -13,23 +13,37 @@ __all__ = [
 
 def create_customer_payment_profile(
     customer_profile_id: int,
-    payment_profile: apicontractsv1.customerPaymentProfileType,
+    payment: apicontractsv1.paymentType,
+    address: apicontractsv1.customerAddressType,
+    default: bool = False,
+    validation: str | None = None,
 ) -> tuple[ObjectifiedElement, type[APIOperationBase]]:
     """
     `createCustomerPaymentProfileRequest <https://developer.authorize.net/api/reference/index.html#customer-profiles-create-customer-payment-profile>`_.
 
     :param customer_profile_id: An Authorizenet customer profile id.
     :type customer_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.
+    :param payment: An Authorizenet payment element.
+    :type payment: ~authorizenet.apicontractsv1.paymentType
+    :param address: An Authorizenet address element.
+    :type address: ~authorizenet.apicontractsv1.customerAddressType
+    :param default: Whether to set the payment profile as default. Default is :py:obj:`False`.
+    :type default: bool
+    :param validation: Validation mode to use when validating the payment profile. If not provided, the payment profile is not validated. Default is :py:obj:`None`.
+    :type validation: str | None
     :returns: A tuple containing an Authorizenet API request element and controller class.
     :rtype: tuple[~lxml.objectify.ObjectifiedElement, type[~authorizenet.apicontrollersbase.APIOperationBase]]
 
     """
     request = apicontractsv1.createCustomerPaymentProfileRequest()
     request.customerProfileId = str(customer_profile_id)
-    request.paymentProfile = payment_profile
+    request.paymentProfile = apicontractsv1.customerPaymentProfileType()
+    request.paymentProfile.payment = payment
+    request.paymentProfile.billTo = address
+    request.paymentProfile.defaultPaymentProfile = str(default).lower()
+
+    if validation is not None:
+        request.validationMode = str(validation)
     return request, apicontrollers.createCustomerPaymentProfileController
 
 
@@ -59,7 +73,7 @@ def get_customer_payment_profile(
 
 
 def validate_customer_payment_profile(
-    customer_profile_id: int, payment_profile_id: int
+    customer_profile_id: int, payment_profile_id: int, validation: str
 ) -> tuple[ObjectifiedElement, type[APIOperationBase]]:
     """
     `validateCustomerPaymentProfileRequest <https://developer.authorize.net/api/reference/index.html#customer-profiles-validate-customer-payment-profile>`_.
@@ -68,6 +82,8 @@ def validate_customer_payment_profile(
     :type customer_profile_id: int
     :param payment_profile_id: An Authorizenet customer payment profile id.
     :type payment_profile_id: int
+    :param validation: Validation mode to use when validating the payment profile.
+    :type validation: str
     :returns: A tuple containing an Authorizenet API request element and controller class.
     :rtype: tuple[~lxml.objectify.ObjectifiedElement, type[~authorizenet.apicontrollersbase.APIOperationBase]]
 
@@ -75,13 +91,17 @@ def validate_customer_payment_profile(
     request = apicontractsv1.validateCustomerPaymentProfileRequest()
     request.customerProfileId = str(customer_profile_id)
     request.customerPaymentProfileId = str(payment_profile_id)
+    request.validationMode = validation
     return request, apicontrollers.validateCustomerPaymentProfileController
 
 
 def update_customer_payment_profile(
     customer_profile_id: int,
     payment_profile_id: int,
-    payment_profile: apicontractsv1.customerPaymentProfileType,
+    payment: apicontractsv1.paymentType | None = None,
+    address: apicontractsv1.customerAddressType | None = None,
+    default: bool | None = None,
+    validation: str | None = None,
 ) -> tuple[ObjectifiedElement, type[APIOperationBase]]:
     """
     `updateCustomerPaymentProfileRequest <https://developer.authorize.net/api/reference/index.html#customer-profiles-update-customer-payment-profile>`_.
@@ -90,18 +110,37 @@ def update_customer_payment_profile(
     :type customer_profile_id: int
     :param payment_profile_id: An Authorizenet customer payment profile id.
     :type payment_profile_id: int
-    :param payment_profile: An Authorizenet payment profile element.
-    :type payment_profile: ~authorizenet.apicontractsv1.customerPaymentProfileType
+    :param payment: An Authorizenet payment element.
+    :type payment: ~authorizenet.apicontractsv1.paymentType | None
+    :param address: An Authorizenet address element.
+    :type address: ~authorizenet.apicontractsv1.customerAddressType | None
+    :param default: Whether to set the payment profile as default. If not provided, the payment profile's default state is not updated. Default is :py:obj:`None`.
+    :type default: bool | None
+    :param validation: Validation mode to use when validating the payment profile. If not provided, the payment profile is not validated. Default is :py:obj:`None`.
+    :type validation: str | None
+    :raises ValueError: If neither payment nor address was provided.
     :returns: A tuple containing an Authorizenet API request element and controller class.
     :rtype: tuple[~lxml.objectify.ObjectifiedElement, type[~authorizenet.apicontrollersbase.APIOperationBase]]
 
     """
-    if not hasattr(payment_profile, "customerPaymentProfileId"):
-        payment_profile.customerPaymentProfileId = str(payment_profile_id)
+    if payment is None and address is None:
+        raise ValueError(
+            f"At least one of 'payment' or 'address' is required, got '{payment}' and '{address}'."
+        )
 
     request = apicontractsv1.updateCustomerPaymentProfileRequest()
     request.customerProfileId = str(customer_profile_id)
-    request.paymentProfile = payment_profile
+    request.paymentProfile = apicontractsv1.customerPaymentProfileType()
+    request.paymentProfile.customerPaymentProfileId = str(payment_profile_id)
+
+    if payment is not None:
+        request.paymentProfile.payment = payment
+    if address is not None:
+        request.paymentProfile.billTo = address
+    if default is not None:
+        request.paymentProfile.defaultPaymentProfile = str(default).lower()
+    if validation is not None:
+        request.validationMode = str(validation)
     return request, apicontrollers.updateCustomerPaymentProfileController
 
 

{python_terminusgps-45.4.0 → python_terminusgps-45.6.0}/terminusgps/authorizenet/services.py

@@ -1,4 +1,3 @@
-from abc import ABC
 from functools import cached_property
 from typing import Callable
 
@@ -8,11 +7,14 @@ 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
+from .controllers import (
+    AuthorizenetControllerExecutionError,
+    execute_controller,
+)
 
 
-class AuthorizenetService(ABC):
-    """Base class for services that interact with the Authorizenet API."""
+class AuthorizenetService:
+    """A service that safely interacts with the Authorizenet API."""
 
     REQUIRED_SETTINGS = (
         "MERCHANT_AUTH_ENVIRONMENT",
@@ -27,7 +29,7 @@ class AuthorizenetService(ABC):
             if not hasattr(settings, setting):
                 raise ImproperlyConfigured(f"'{setting}' setting is required.")
 
-    def call_api(self, func: Callable, *args, **kwargs) -> ObjectifiedElement:
+    def request(self, func: Callable, *args, **kwargs) -> ObjectifiedElement:
         """
         Calls the Authorizenet API function with arguments and returns the result.
 
@@ -35,14 +37,19 @@ class AuthorizenetService(ABC):
         :type func: ~typing.Callable
         :param args: Positional arguments for the API call.
         :param kwargs: Keyword arguments for the API call.
+        :raises ValueError: If any function arguments were invalid.
         :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)
+        try:
+            request, controller_cls = func(*args, **kwargs)
+            request.merchantAuthentication = self.merchantAuthentication
+            controller = controller_cls(request)
+            return execute_controller(controller, self.environment)
+        except AuthorizenetControllerExecutionError | ValueError:
+            raise
 
     @cached_property
     def merchantAuthentication(self) -> merchantAuthenticationType:

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

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