python-terminusgps 43.2.0__py3-none-any.whl → 44.0.0__py3-none-any.whl

{python_terminusgps-43.2.0.dist-info → python_terminusgps-44.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 43.2.0
+Version: 44.0.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-44.0.0.dist-info/RECORD

@@ -0,0 +1,35 @@
+terminusgps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+terminusgps/default_settings.py,sha256=7GLW3RlkuTbpj82KSWjcbgf-unEmrPvKCyLci14LG6g,537
+terminusgps/mixins.py,sha256=Q9ZJuzpk3d9lDnlVA8ZTVvnZWxB13p08EQ8yVJcztn4,1034
+terminusgps/validators.py,sha256=R6kS8X-mreNRpmsrNthoa7rxMLy8-iz6FEL-Ww2pFdI,7290
+terminusgps/authorizenet/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+terminusgps/authorizenet/auth.py,sha256=ZWb9ebJp22o-ImiMLQIzSMENICnbPZOlbX5RO0IEyRU,2199
+terminusgps/authorizenet/constants.py,sha256=eukAZQVuv3XHL-Kd1gqxf8IYUqNC67ClTz4ZU7JPNYE,1459
+terminusgps/authorizenet/controllers.py,sha256=wzCsgza5jdOfeoaQ-IHojEe8G0qVAv5I0F18Fbl1tSY,1644
+terminusgps/authorizenet/validators.py,sha256=Wq4rqEuqG3JzOO7O1wM6oQ0FciNxxOK0HnJqTuLa8CY,3916
+terminusgps/authorizenet/api/__init__.py,sha256=VXR4Yco1yz5R-R7vgaH2zTP9VFqzfvvGy_XJVjyb3i0,154
+terminusgps/authorizenet/api/address_profiles.py,sha256=_BmhMbhrWnUyk7WfY6I0cDxDtS9r2H8l69OnZV6wxRU,4779
+terminusgps/authorizenet/api/customer_profiles.py,sha256=cmXFH4a_Ng26o4u6RMVPBqLWxYSearlhNgM8n7ArZKs,4502
+terminusgps/authorizenet/api/payment_profiles.py,sha256=etyfvivAtXeo-GdUXxyNVkDfrjPg3fLXSnp-aRsnqxY,6516
+terminusgps/authorizenet/api/subscriptions.py,sha256=wdiD3UaKSkPQhTZLrDWq8ZFNPW5JIIjOWyPvAEgb1xg,4541
+terminusgps/authorizenet/api/transactions.py,sha256=y1Bq0niTWsWEi_tMJzXUTYj3_GoJnL5K4fPuGER77kw,2731
+terminusgps/wialon/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+terminusgps/wialon/constants.py,sha256=p2BhopeE6lXzjzdzb4ZKOz0rhJQIMUbXLrBy1Yzf57s,13730
+terminusgps/wialon/flags.py,sha256=M50EdhxQ8IMnJnU0mrHK7-h8Asc6tvNiTOOfd1dBW6A,12815
+terminusgps/wialon/session.py,sha256=GdgPvhNbUrvx_-vPRWsjY5TeuI3HgjlHcy315LBpZ7o,5646
+terminusgps/wialon/utils.py,sha256=E7J9s4p7P-OePtttxcBogxu3WiXqf4xxr_Tksbisl60,9957
+terminusgps/wialon/validators.py,sha256=o5__H9HHnGYth8QAKErJG5rEub7FnT8ue0S3IQ8b67o,4232
+terminusgps/wialon/items/__init__.py,sha256=RTiY9ziXqKCB8VWGoExOIErDlUMBBfzzsA7nlOlCZ2w,41
+terminusgps/wialon/items/account.py,sha256=eN9oOuXReVR_x5P9HKg2xlk6vk7FlVnki7bjzlzaWg4,7868
+terminusgps/wialon/items/base.py,sha256=CQwxYhW6HXMCZX8l91pWac5DTBiOqyK_FAThpUQb9fM,9360
+terminusgps/wialon/items/factory.py,sha256=7Xjog8qJPUqKj6RVO92ZaN_fD6WWb9x9ARHkZ3VPeBo,4074
+terminusgps/wialon/items/resource.py,sha256=XTnj6GAnKBDL6eGZsR_KMe2EocM369FXyvSwejM1aLQ,4876
+terminusgps/wialon/items/retranslator.py,sha256=u4qJ44G7r3ntdJ2rFcfkTJhxs9DshER3GG1Yojo5kxw,1458
+terminusgps/wialon/items/route.py,sha256=9hmRBEFRJF3lKukv_y3blZxqxv75YgFCcRALrU6A6QI,1306
+terminusgps/wialon/items/unit.py,sha256=B5iuGEghu89SL8KzYLUytYNRa8cogsVtf-bJ_RybPTA,5522
+terminusgps/wialon/items/unit_group.py,sha256=MIR0x5IlTjcnwx8Y9wXLNTql-wwVVj7NCe7dL2vOw4c,2131
+terminusgps/wialon/items/user.py,sha256=CRSICiJ-qzybEO_gXuKyzW5oa2RQeIp0SzX9ARcdME4,5151
+python_terminusgps-44.0.0.dist-info/METADATA,sha256=otSJOGlPOttJ0Aar_SwAMWze6kri5RXkdiOSGDpZx54,938
+python_terminusgps-44.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_terminusgps-44.0.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+python_terminusgps-44.0.0.dist-info/RECORD,,

terminusgps/authorizenet/auth.py

@@ -1,20 +1,25 @@
 from authorizenet.apicontractsv1 import merchantAuthenticationType
 from django.conf import settings
-
-from terminusgps.django import settings as default_settings
-
-if not settings.configured:
-    settings.configure(default_settings)
+from django.core.exceptions import ImproperlyConfigured
 
 
 def get_merchant_auth() -> merchantAuthenticationType:
     """
-    Returns the current merchant authentication information for Authorizenet API requests.
+    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: :py:obj:`~authorizenet.apicontractsv1.merchantAuthenticationType`
+    :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),
@@ -23,21 +28,29 @@ def get_merchant_auth() -> merchantAuthenticationType:
 
 def get_environment() -> str:
     """
-    Returns the current environment for Authorizenet API requests.
+    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: :py:obj:`str`
+    :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 current validation mode for Authorizenet API requests.
+    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: :py:obj:`str`
+    :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

terminusgps/authorizenet/constants.py

@@ -1,12 +1,10 @@
 from authorizenet import apicontractsv1
+from authorizenet.constants import constants as anet_constants
 from django.db import models
 from django.utils.translation import gettext_lazy as _
 
-ANET_XMLNS = "{AnetApi/xml/v1/schema/AnetApiSchema.xsd}"
-"""Authorizenet XML namespace."""
 
-
-class AuthorizenetSubscriptionStatus(models.TextChoices):
+class SubscriptionStatus(models.TextChoices):
     """An Authorizenet subscription status."""
 
     ACTIVE = "active", _("Active")
@@ -21,10 +19,28 @@ class AuthorizenetSubscriptionStatus(models.TextChoices):
     """Terminated subscription."""
 
 
-class AuthorizenetSubscriptionIntervalUnit(models.TextChoices):
+class SubscriptionIntervalUnit(models.TextChoices):
     """An Authorizenet subscription interval unit."""
 
     DAYS = apicontractsv1.ARBSubscriptionUnitEnum.days, _("Days")
     """Days interval unit."""
     MONTHS = apicontractsv1.ARBSubscriptionUnitEnum.months, _("Months")
     """Months interval unit."""
+
+
+class Environment(models.TextChoices):
+    """An Authorizenet execution environment."""
+
+    SANDBOX = anet_constants.SANDBOX, _("Sandbox Environment")
+    """Sandbox environment."""
+    PRODUCTION = anet_constants.PRODUCTION, _("Production Environment")
+    """Production environment."""
+
+
+class ValidationMode(models.TextChoices):
+    """An Authorizenet validation mode."""
+
+    TEST = "testMode", _("Test Mode")
+    """Test mode."""
+    LIVE = "liveMode", _("Live Mode")
+    """Live mode."""

terminusgps/authorizenet/controllers.py

@@ -11,10 +11,10 @@ def execute_controller(
     Executes an Authorizenet API controller and returns its response.
 
     :param controller: An Authorizenet API controller.
-    :type controller: :py:obj:`~authorizenet.apicontrollersbase.APIOperationBase`
+    :type controller: ~authorizenet.apicontrollersbase.APIOperationBase
     :raises AuthorizenetControllerExecutionError: If the API call fails.
     :returns: An Authorizenet API response, if any.
-    :rtype: :py:obj:`~lxml.objectify.ObjectifiedElement` | :py:obj:`None`
+    :rtype: ~lxml.objectify.ObjectifiedElement | None
 
     """
     controller.setenvironment(get_environment())
@@ -33,17 +33,6 @@ class AuthorizenetControllerExecutionError(Exception):
     """Raised when an Authorizenet API controller fails to execute."""
 
     def __init__(self, message: str, code: str, *args, **kwargs) -> None:
-        """
-        Sets :py:attr:`message` and :py:attr`code` for the exception.
-
-        :param message: An Authorizenet API error message.
-        :type message: :py:obj:`str`
-        :param code: An Authorizenet API error code.
-        :type code: :py:obj:`str`
-        :returns: Nothing.
-        :rtype: :py:obj:`None`
-
-        """
         super().__init__(message, *args, **kwargs)
         self._message = message
         self._code = code

terminusgps/{django/settings.py → default_settings.py}

@@ -1,18 +1,18 @@
 import os
 import pathlib
 
-from authorizenet.constants import constants
+from terminusgps.authorizenet.constants import Environment, ValidationMode
 
 BASE_DIR = pathlib.Path(__file__).resolve().parent
+
 DEBUG = True
 SECRET_KEY = "xem*6no%8d9%^qzt2f3x3ar-uq4_+7h9myc$t0!+4%bj5us6f)"
 USE_TZ = False
-DEFAULT_FIELD_CLASS = "p-2 w-full bg-white dark:bg-gray-700 dark:text-white rounded border dark:border-terminus-gray-300"
-DEFAULT_TAX_RATE = "0.0825"
+
+MERCHANT_AUTH_ENVIRONMENT = Environment.SANDBOX
+MERCHANT_AUTH_VALIDATION_MODE = ValidationMode.TEST
 
 # Secrets
 MERCHANT_AUTH_LOGIN_ID = os.getenv("MERCHANT_AUTH_LOGIN_ID")
 MERCHANT_AUTH_TRANSACTION_KEY = os.getenv("MERCHANT_AUTH_TRANSACTION_KEY")
-MERCHANT_AUTH_ENVIRONMENT = constants.SANDBOX
-MERCHANT_AUTH_VALIDATION_MODE = "testMode"
 WIALON_TOKEN = os.getenv("WIALON_TOKEN")

terminusgps/validators.py

@@ -0,0 +1,219 @@
+import calendar
+import datetime
+
+from django.core.exceptions import ValidationError
+from django.utils.translation import gettext_lazy as _
+
+VALID_COUNTRY_CODES = ("+1", "+52")
+
+
+def validate_e164_phone_number(value: str) -> None:
+    """Raises :py:exc:`~django.core.exceptions.ValidationError` if the value is not a valid `E.164 <https://en.wikipedia.org/wiki/E.164>`_ formatted phone number."""
+    if not value:
+        raise ValidationError(
+            _("This field is required, got '%(value)s'"),
+            code="invalid",
+            params={"value": value},
+        )
+    if not value.startswith("+"):
+        raise ValidationError(
+            _("E.164 phone number must begin with a '+', got '%(char)s'."),
+            code="invalid",
+            params={"char": value[0]},
+        )
+    if " " in value:
+        raise ValidationError(
+            _("E.164 phone number cannot contain spaces, got '%(value)s'."),
+            code="invalid",
+            params={"value": value},
+        )
+    if "-" in value:
+        raise ValidationError(
+            _("E.164 phone number cannot contain hyphens, got '%(value)s'."),
+            code="invalid",
+            params={"value": value},
+        )
+    if len(value) < 12:
+        raise ValidationError(
+            _(
+                "E.164 phone number cannot be less than 12 characters in length, got %(len)s."
+            ),
+            code="invalid",
+            params={"len": len(value)},
+        )
+    if len(value) > 15:
+        raise ValidationError(
+            _(
+                "E.164 phone number cannot be greater than 15 characters in length, got %(len)s."
+            ),
+            code="invalid",
+            params={"len": len(value)},
+        )
+
+    country_code = value[:-10]
+    area_code = value[-10:-7]
+    subscriber_number = value[-7:]
+
+    if len(country_code) < 2 or len(country_code) > 5:
+        raise ValidationError(
+            _(
+                "E.164 phone number country code must be between 2 and 5 characters in length, got %(len)s."
+            ),
+            code="invalid",
+            params={"len": len(country_code)},
+        )
+    if country_code not in VALID_COUNTRY_CODES:
+        raise ValidationError(
+            _(
+                "E.164 phone number cannot contain an invalid country code, got '%(country_code)s'."
+            ),
+            code="invalid",
+            params={"country_code": country_code},
+        )
+    if not len(area_code) == 3:
+        raise ValidationError(
+            _(
+                "E.164 phone number must contain a 3-digit area code, got '%(area_code)s'."
+            ),
+            code="invalid",
+            params={"area_code": area_code},
+        )
+    if not area_code.isdigit():
+        raise ValidationError(
+            _(
+                "E.164 phone number must have a valid area code, got '%(area_code)s'."
+            ),
+            code="invalid",
+            params={"area_code": area_code},
+        )
+    if not len(subscriber_number) == 7:
+        raise ValidationError(
+            _(
+                "E.164 phone number must contain a 7-digit subscriber number, got '%(subscriber_number)s'."
+            ),
+            code="invalid",
+            params={"subscriber_number": subscriber_number},
+        )
+    if not subscriber_number.isdigit():
+        raise ValidationError(
+            _(
+                "E.164 phone number must have a valid subscriber number, got '%(subscriber_number)s'."
+            ),
+            code="invalid",
+            params={"subscriber_number": subscriber_number},
+        )
+
+
+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: str
+    :raises ValidationError: If the value contains non-digit characters.
+    :raises ValidationError: If the value fails the Luhn algorithm.
+    :returns: Nothing.
+    :rtype: 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: 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: 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: 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: 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},
+        )

terminusgps/wialon/items/account.py

@@ -19,7 +19,7 @@ class WialonAccount(WialonObject):
         :param billing_plan: A Wialon account billing plan.
         :type billing_plan: str
         :raises ValueError: If ``resource_id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A Wialon object dictionary.
         :rtype: dict[str, str]
 
@@ -45,7 +45,7 @@ class WialonAccount(WialonObject):
         :param reasons: An optional collection of reason strings. Default is :py:obj:`None`.
         :type reasons: ~collections.abc.Collection[str] | None
         :raises AssertionError: If the Wialon account id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -62,7 +62,7 @@ class WialonAccount(WialonObject):
         Enables the account in Wialon.
 
         :raises AssertionError: If the Wialon account id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -77,7 +77,7 @@ class WialonAccount(WialonObject):
         Disables the account in Wialon.
 
         :raises AssertionError: If the Wialon account id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -103,7 +103,7 @@ class WialonAccount(WialonObject):
         :param description: A description for the payment.
         :type description: str
         :raises AssertionError: If the Wialon account id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -125,7 +125,7 @@ class WialonAccount(WialonObject):
         :param enabled: Whether to set the account as a dealer or not.
         :type enabled: bool
         :raises AssertionError: If the Wialon account id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -151,7 +151,7 @@ class WialonAccount(WialonObject):
         :param deny_balance: Balance required for service denial. Default is ``0.00``.
         :type deny_balance: ~decimal.Decimal
         :raises AssertionError: If the Wialon account id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -173,7 +173,7 @@ class WialonAccount(WialonObject):
         :param name: A Wialon billing plan name.
         :type name: str
         :raises AssertionError: If the Wialon account id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -190,7 +190,7 @@ class WialonAccount(WialonObject):
         :param days: Minimum number of days as an integer.
         :type days: int
         :raises AssertionError: If the Wialon account id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -207,7 +207,7 @@ class WialonAccount(WialonObject):
         :param response_type: A response flag integer. Default is ``1``.
         :type response_type: int
         :raises AssertionError: If the Wialon account id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A dictionary containing the account's data from Wialon.
         :rtype: dict[str, str]
 

terminusgps/wialon/items/base.py

@@ -111,7 +111,7 @@ class WialonObject(ABC):
         Returns a list of admin field dictionaries from Wialon.
 
         :raises AssertionError: If the Wialon object id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A list of admin field dictionaries.
         :rtype: list[dict[str, str]]
 
@@ -142,7 +142,7 @@ class WialonObject(ABC):
         :type id: int | str | None
         :raises AssertionError: If the Wialon object id wasn't set.
         :raises ValueError: If ``id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An admin field dictionary.
         :rtype: dict[str, str]
 
@@ -168,7 +168,7 @@ class WialonObject(ABC):
         :type id: int | str
         :raises AssertionError: If the Wialon object id wasn't set.
         :raises ValueError: If ``id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -185,7 +185,7 @@ class WialonObject(ABC):
         Returns a list of custom field dictionaries from Wialon.
 
         :raises AssertionError: If the Wialon object id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A list of admin field dictionaries.
         :rtype: list[dict[str, str]]
 
@@ -214,7 +214,7 @@ class WialonObject(ABC):
         :type id: int | str | None
         :raises AssertionError: If the Wialon object id wasn't set.
         :raises ValueError: If ``id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A custom field dictionary.
         :rtype: dict[str, str]
 
@@ -240,7 +240,7 @@ class WialonObject(ABC):
         :type id: int | str
         :raises AssertionError: If the Wialon object id wasn't set.
         :raises ValueError: If ``id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -261,7 +261,7 @@ class WialonObject(ABC):
         :param value: Profile field value.
         :type value: str
         :raises AssertionError: If the Wialon object id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A profile field dictionary.
         :rtype: dict[str, str]
 

terminusgps/wialon/items/resource.py

@@ -24,7 +24,7 @@ class WialonResource(WialonObject):
         :param skip_creator_check: Whether to ignore creator check during the API call. Default is :py:obj:`False`.
         :type skip_creator_check: bool
         :raises ValueError: If ``creator_id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A Wialon object dictionary.
         :rtype: dict[str, str]
 
@@ -56,7 +56,7 @@ class WialonResource(WialonObject):
         :param notification_ids: An optional collection of notification ids. Default is :py:obj:`None`.
         :type notification_ids: ~collections.abc.Collection[int] | None
         :raises AssertionError: If the Wialon resource id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A dictionary of notification data.
         :rtype: dict[str, str]
 
@@ -89,7 +89,7 @@ class WialonResource(WialonObject):
         :raises AssertionError: If the Wialon resource id wasn't set.
         :raises ValueError: If ``unit_id`` wasn't a digit.
         :raises ValueError: If ``driver_id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A dictionary of Wialon drivers.
         :rtype: dict[str, str]
 

terminusgps/wialon/items/retranslator.py

@@ -1,30 +1,12 @@
-import typing
-
 from terminusgps.wialon import flags
 from terminusgps.wialon.items.base import WialonObject
 
-WialonRetranslatorConfiguration = typing.TypedDict(
-    "WialonRetranslatorConfiguration",
-    {
-        "protocol": str,
-        "server": str,
-        "port": int,
-        "auth": str,
-        "ssl": int,
-        "debug": int,
-        "v6type": int,
-    },
-)
-
 
 class WialonRetranslator(WialonObject):
     """A Wialon `retranslator <https://wialon.com/en/gps-hardware/soft>`_."""
 
     def create(
-        self,
-        creator_id: int | str,
-        name: str,
-        config: WialonRetranslatorConfiguration,
+        self, creator_id: int | str, name: str, config: str
     ) -> dict[str, str]:
         """
         Creates the retranslator in Wialon and sets its id.
@@ -34,9 +16,9 @@ class WialonRetranslator(WialonObject):
         :param name: Wialon retranslator name.
         :type name: str
         :param config: Wialon retranslator configuration.
-        :type config: ~terminusgps.wialon.items.retranslator.WialonRetranslatorConfiguration
+        :type config: str
         :raises ValueError: If ``creator_id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A Wialon object dictionary.
         :rtype: dict[str, str]
 

terminusgps/wialon/items/route.py

@@ -14,7 +14,7 @@ class WialonRoute(WialonObject):
         :param name: Wialon route name.
         :type name: str
         :raises ValueError: If ``creator_id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A Wialon object dictionary.
         :rtype: dict[str, str]
 

terminusgps/wialon/items/unit.py

@@ -21,7 +21,7 @@ class WialonUnit(WialonObject):
         :type hw_type_id: int | str
         :raises ValueError: If ``creator_id`` wasn't a digit.
         :raises ValueError: If ``hw_type_id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A Wialon object dictionary.
         :rtype: dict[str, str]
 
@@ -51,7 +51,7 @@ class WialonUnit(WialonObject):
         Activates the unit in Wialon.
 
         :raises AssertionError: If the Wialon unit id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A dictionary with the unit's current status.
         :rtype: dict[str, str]
 
@@ -66,7 +66,7 @@ class WialonUnit(WialonObject):
         Deactivates the unit in Wialon.
 
         :raises AssertionError: If the Wialon unit id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A dictionary with the unit's current status.
         :rtype: dict[str, str]
 
@@ -98,7 +98,7 @@ class WialonUnit(WialonObject):
         :param flags: Command execution flags. Default is ``0``.
         :type flags: int
         :raises AssertionError: If the Wialon unit id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -126,7 +126,7 @@ class WialonUnit(WialonObject):
         :param command_ids: An optional collection of command ids. Default is :py:obj:`None`.
         :type command_ids: ~collections.abc.Collection[int] | None
         :raises AssertionError: If the Wialon unit id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A dictionary of command definition data.
         :rtype: dict[str, str]
 

terminusgps/wialon/items/unit_group.py

@@ -16,7 +16,7 @@ class WialonUnitGroup(WialonObject):
         :param name: Name for the unit group.
         :type name: str
         :raises ValueError: If ``creator_id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A Wialon object dictionary.
         :rtype: dict[str, str]
 
@@ -45,7 +45,7 @@ class WialonUnitGroup(WialonObject):
         :param unit_ids: A collection of Wialon unit ids.
         :type unit_ids: ~collections.abc.Collection[int]
         :raises AssertionError: If the Wialon unit group id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A dictionary containing the unit group's new unit list.
         :rtype: dict[str, str]
 

terminusgps/wialon/items/user.py

@@ -18,7 +18,7 @@ class WialonUser(WialonObject):
         :param password: Wialon user password.
         :type password: str
         :raises ValueError: If ``creator_id`` wasn't a digit.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A Wialon object dictionary.
         :rtype: dict[str, str]
 
@@ -52,7 +52,7 @@ class WialonUser(WialonObject):
         :param flags: Response flags. Default is ``0x1``.
         :type flags: int
         :raises AssertionError: If the Wialon user id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A dictionary of Wialon objects.
         :rtype: dict[str, str]
 
@@ -79,7 +79,7 @@ class WialonUser(WialonObject):
         :type access_mask: int
         :raises AssertionError: If the Wialon user id wasn't set.
         :raises ValueError: If the other Wialon object's id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 
@@ -100,7 +100,7 @@ class WialonUser(WialonObject):
         :param flags_mask: An integer mask which determines which bits will be changed.
         :type flags_mask: int
         :raises AssertionError: If the Wialon user id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: A dictionary containing the user's new settings flags.
         :rtype: dict[str, str]
 
@@ -121,7 +121,7 @@ class WialonUser(WialonObject):
         :param new_password: The user's new Wialon password.
         :type new_password: str
         :raises AssertionError: If the Wialon user id wasn't set.
-        :raises WialonAPIError: If something went wrong calling the Wialon API.
+        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
         :returns: An empty dictionary.
         :rtype: dict[str, str]
 

terminusgps/wialon/session.py

@@ -5,6 +5,8 @@ import wialon.api
 
 
 class WialonAPIError(Exception):
+    """Raised when a Wialon API call fails."""
+
     def __init__(self, message, *args, **kwargs) -> None:
         self.message = message
         self._code = int(message._code)
@@ -12,6 +14,7 @@ class WialonAPIError(Exception):
 
     @property
     def code(self) -> int:
+        """Wialon API error code."""
         return self._code
 
 
@@ -35,18 +38,18 @@ class WialonSession:
         """
         Starts or continues a Wialon API session.
 
-        :param token: An optional Wialon API token. Default is :confval:`WIALON_TOKEN`.
-        :type token: :py:obj:`str` | :py:obj:`None`
+        :param token: A Wialon API token. If not provided, the environment variable ``"WIALON_TOKEN"`` is used.
+        :type token: str | None
         :param sid: An optional Wialon API session id. If provided, the session is continued.
-        :type sid: :py:obj:`str` | :py:obj:`None`
+        :type sid: str | None
         :param scheme: HTTP request scheme to use. Default is ``"https"``.
-        :type scheme: :py:obj:`str`
+        :type scheme: str
         :param host: Wialon API host url. Default is ``"hst-api.wialon.com"``.
-        :type host: :py:obj:`str`
+        :type host: str
         :param port: Wialon API port. Default is ``443``.
-        :type port: :py:obj:`int`
+        :type port: int
         :returns: Nothing.
-        :rtype: :py:obj:`None`
+        :rtype: None
 
         """
 
@@ -69,7 +72,7 @@ class WialonSession:
 
         :raises AssertionError: If the session's Wialon API :py:attr:`token` wasn't set.
         :returns: A valid Wialon API session.
-        :rtype: :py:obj:`~terminusgps.wialon.session.WialonSession`
+        :rtype: ~terminusgps.wialon.session.WialonSession
 
         """
         assert self.token, "Wialon API token wasn't set."
@@ -81,7 +84,7 @@ class WialonSession:
         Logs out of the session by calling :py:meth:`logout`.
 
         :returns: Nothing.
-        :rtype: :py:obj:`None`
+        :rtype: None
 
         """
         self.logout()
@@ -95,8 +98,8 @@ class WialonSession:
         """
         User id of the session's authenticated Wialon user.
 
-        :type: :py:obj:`str` | :py:obj:`None`
-        :value: :py:obj:`None`
+        :type: str | None
+        :value: None
         """
         return self._uid
 
@@ -105,8 +108,8 @@ class WialonSession:
         """
         Username of the session's authenticated Wialon user.
 
-        :type: :py:obj:`str` | :py:obj:`None`
-        :value: :py:obj:`None`
+        :type: str | None
+        :value: None
 
         """
         return self._username
@@ -120,8 +123,8 @@ class WialonSession:
 
         Returns :py:obj:`None` if the session wasn't logged in.
 
-        :type: :py:obj:`str` | :py:obj:`None`
-        :value: :py:obj:`None`
+        :type: str | None
+        :value: None
 
         """
         return self.wialon_api.sid
@@ -131,7 +134,7 @@ class WialonSession:
         """
         Wialon API token set during :py:meth:`WialonSession.__init__`.
 
-        :type: :py:obj:`str`
+        :type: str
 
         """
         return str(self._token)
@@ -141,13 +144,13 @@ class WialonSession:
         Logs into the Wialon API, starts a new session then returns its id.
 
         :param token: An active Wialon API token.
-        :type token: :py:obj:`str`
+        :type token: str
         :param flags: A login response flag integer.
-        :type flags: :py:obj:`int`
+        :type flags: int
         :raises WialonError: If the login fails.
         :raises AssertionError: If the login token was not set.
         :returns: The new session id.
-        :rtype: :py:obj:`str`
+        :rtype: str
 
         """
         try:
@@ -165,7 +168,7 @@ class WialonSession:
         Logs out of the Wialon API session.
 
         :returns: Nothing.
-        :rtype: :py:obj:`None`
+        :rtype: None
 
         """
         sid = self.wialon_api.sid
@@ -182,10 +185,10 @@ class WialonSession:
         Sets the Wialon API session's attributes based on a login response.
 
         :param login_response: A dictionary returned from :py:meth:`login`.
-        :type login_response: :py:obj:`dict`
+        :type login_response: dict
         :raises ValueError: If ``login_response`` wasn't provided.
         :returns: Nothing.
-        :rtype: :py:obj:`None`
+        :rtype: None
 
         """
         if login_response is None:

python_terminusgps-43.2.0.dist-info/RECORD

@@ -1,42 +0,0 @@
-terminusgps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-terminusgps/authorizenet/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-terminusgps/authorizenet/auth.py,sha256=CKT_pfDEL-53GceOEaFtIU6IBXVuVd8MVHikpPAX0xY,1184
-terminusgps/authorizenet/constants.py,sha256=xU2oGpxsAlgJftI_S4WL8Ii5TJ3OD5FXnCUNceLzXbM,1015
-terminusgps/authorizenet/controllers.py,sha256=oEomwVPu6uT2z5BGKKm-zLWXhODvBajUQ4GxDOHTecQ,2011
-terminusgps/authorizenet/validators.py,sha256=Wq4rqEuqG3JzOO7O1wM6oQ0FciNxxOK0HnJqTuLa8CY,3916
-terminusgps/authorizenet/api/__init__.py,sha256=VXR4Yco1yz5R-R7vgaH2zTP9VFqzfvvGy_XJVjyb3i0,154
-terminusgps/authorizenet/api/address_profiles.py,sha256=_BmhMbhrWnUyk7WfY6I0cDxDtS9r2H8l69OnZV6wxRU,4779
-terminusgps/authorizenet/api/customer_profiles.py,sha256=cmXFH4a_Ng26o4u6RMVPBqLWxYSearlhNgM8n7ArZKs,4502
-terminusgps/authorizenet/api/payment_profiles.py,sha256=etyfvivAtXeo-GdUXxyNVkDfrjPg3fLXSnp-aRsnqxY,6516
-terminusgps/authorizenet/api/subscriptions.py,sha256=wdiD3UaKSkPQhTZLrDWq8ZFNPW5JIIjOWyPvAEgb1xg,4541
-terminusgps/authorizenet/api/transactions.py,sha256=y1Bq0niTWsWEi_tMJzXUTYj3_GoJnL5K4fPuGER77kw,2731
-terminusgps/django/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-terminusgps/django/mixins.py,sha256=Q9ZJuzpk3d9lDnlVA8ZTVvnZWxB13p08EQ8yVJcztn4,1034
-terminusgps/django/settings.py,sha256=JcHo9uonGLXoIbapkTYJ4GSIfiS74CtChzw1Cuq4XOk,644
-terminusgps/django/utils.py,sha256=SYDQyHA5tTuVwdpZGsCtf0LpTTD0ilRKoxa8StfSTpQ,156
-terminusgps/django/validators.py,sha256=chuJ4I1DBQ_H5dwb6CXPEIyv_CUuEzJzRUSijfss1vc,3510
-terminusgps/django/forms/__init__.py,sha256=hh8Z9AC_u2m2bu3h6sdmPyndfQneCEVovENPHmoTDC0,21
-terminusgps/django/forms/fields.py,sha256=BfuPzOZyGvWsEzONW2h4i01fhoL0IS0-gDdBKW4jHgI,2225
-terminusgps/django/forms/forms.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-terminusgps/django/forms/renderer.py,sha256=QSLQ94Ff7ZaV1jD6wAL-ltvdKIblED8Wsv5EXvSbUJ4,394
-terminusgps/django/forms/widgets.py,sha256=No4hPQ-BK5rrotaQ5iJEjWo8quYIPNf_1C2y4OAIxro,2037
-terminusgps/wialon/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-terminusgps/wialon/constants.py,sha256=p2BhopeE6lXzjzdzb4ZKOz0rhJQIMUbXLrBy1Yzf57s,13730
-terminusgps/wialon/flags.py,sha256=M50EdhxQ8IMnJnU0mrHK7-h8Asc6tvNiTOOfd1dBW6A,12815
-terminusgps/wialon/session.py,sha256=-WSjbWT5GpueD3xEM9EHBx0iPTOMB1BUr1swzyPZPZg,5797
-terminusgps/wialon/utils.py,sha256=E7J9s4p7P-OePtttxcBogxu3WiXqf4xxr_Tksbisl60,9957
-terminusgps/wialon/validators.py,sha256=o5__H9HHnGYth8QAKErJG5rEub7FnT8ue0S3IQ8b67o,4232
-terminusgps/wialon/items/__init__.py,sha256=RTiY9ziXqKCB8VWGoExOIErDlUMBBfzzsA7nlOlCZ2w,41
-terminusgps/wialon/items/account.py,sha256=FL_PZXimLarP3tZX1E9dLA977mSUOx98YJxVyc4WOxg,7588
-terminusgps/wialon/items/base.py,sha256=YSK00q2qUR9SluXojfy2HjfVbMQfnHp4djTcpNSCer4,9164
-terminusgps/wialon/items/factory.py,sha256=7Xjog8qJPUqKj6RVO92ZaN_fD6WWb9x9ARHkZ3VPeBo,4074
-terminusgps/wialon/items/resource.py,sha256=L8myvk9I8snUKFPWBdhMmP1KCb5aC8OtOe4P7Lb2KoY,4792
-terminusgps/wialon/items/retranslator.py,sha256=lWywPciEkazL0GbEV0r1TjBSNEpQcCQ5tDBOua0pGtE,1827
-terminusgps/wialon/items/route.py,sha256=nXFQNzIU2c-_rG-8r_cvZPq_hB7vQgMO5zIe7Sz5KmU,1278
-terminusgps/wialon/items/unit.py,sha256=Ze3t5aK3UX-z95BiDSaDCttCvAs-g6ZyA_NWx3uYp6Y,5382
-terminusgps/wialon/items/unit_group.py,sha256=zP6nBETRQ3tI6V7BYq5yoyG78DGyZM-rU14TMRrpAZA,2075
-terminusgps/wialon/items/user.py,sha256=HY3EWKD7RwcySjPL91Ulmll_gZZXoRaIr6v6I8tW2VM,5011
-python_terminusgps-43.2.0.dist-info/METADATA,sha256=TFEZSdm0iQwTrZfMqRfI6kwSxUOxoKC7KV9SLSuADq0,938
-python_terminusgps-43.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_terminusgps-43.2.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-python_terminusgps-43.2.0.dist-info/RECORD,,

terminusgps/django/forms/__init__.py

@@ -1 +0,0 @@
-from .forms import *

terminusgps/django/forms/fields.py

@@ -1,57 +0,0 @@
-from collections.abc import Sequence
-
-from authorizenet import apicontractsv1
-from django import forms
-
-from .widgets import AddressWidget, CreditCardWidget
-
-
-class CreditCardField(forms.MultiValueField):
-    require_all_fields = True
-
-    def __init__(self, fields=(), widget=CreditCardWidget(), *args, **kwargs) -> None:
-        if not fields:
-            fields = (
-                forms.CharField(label="Card #"),
-                forms.IntegerField(label="Expiry Month", min_value=1, max_value=12),
-                forms.IntegerField(label="Expiry Year"),
-                forms.CharField(label="CCV #"),
-            )
-        super().__init__(fields=fields, widget=widget, *args, **kwargs)
-
-    def compress(self, data_list: Sequence[str]) -> apicontractsv1.creditCardType:
-        """Compresses ``data_list`` into a :py:obj:`~authorizenet.apicontractsv1.creditCardType`."""
-        return apicontractsv1.creditCardType(
-            **{
-                "cardNumber": data_list[0],
-                "expirationDate": f"{data_list[1]}-{data_list[2]}",
-                "cardCode": data_list[3],
-            }
-        )
-
-
-class AddressField(forms.MultiValueField):
-    require_all_fields = True
-
-    def __init__(self, fields=(), widget=AddressWidget(), *args, **kwargs) -> None:
-        if not fields:
-            fields = (
-                forms.CharField(label="Street", max_length=128),
-                forms.CharField(label="City", max_length=128),
-                forms.CharField(label="State", max_length=64),
-                forms.CharField(label="Zip #", min_length=5, max_length=10),
-                forms.CharField(label="Country", max_length=2),
-            )
-        super().__init__(fields=fields, widget=widget, *args, **kwargs)
-
-    def compress(self, data_list: Sequence[str]) -> apicontractsv1.customerAddressType:
-        """Compresses ``data_list`` into a :py:obj:`~authorizenet.apicontractsv1.customerAddressType`."""
-        return apicontractsv1.customerAddressType(
-            **{
-                "address": data_list[0],
-                "city": data_list[1],
-                "state": data_list[2],
-                "zip": data_list[3],
-                "country": data_list[4],
-            }
-        )

terminusgps/django/forms/renderer.py

@@ -1,10 +0,0 @@
-from django.conf import settings
-from django.core.exceptions import ImproperlyConfigured
-from django.forms.renderers import TemplatesSetting
-
-if settings.configured and not hasattr(settings, "DEFAULT_FIELD_CLASS"):
-    raise ImproperlyConfigured("'DEFAULT_FIELD_CLASS' setting is required.")
-
-
-class TerminusgpsFormRenderer(TemplatesSetting):
-    field_template_name = "terminusgps/field.html"

terminusgps/django/forms/widgets.py

@@ -1,56 +0,0 @@
-from authorizenet import apicontractsv1
-from django import forms
-
-
-class CaptchaWidget(forms.widgets.CheckboxInput):
-    def get_context(self, name, value, attrs):
-        context = super().get_context(name, value, attrs)
-        print(f"{context = }")
-        return context
-
-    def check_test(self, value):
-        return bool(value)
-
-
-class CreditCardWidget(forms.widgets.MultiWidget):
-    def __init__(self, widgets=(), attrs: dict | None = None) -> None:
-        if not widgets:
-            widgets = [
-                forms.TextInput(attrs=attrs),
-                forms.TextInput(attrs=attrs),
-                forms.TextInput(attrs=attrs),
-                forms.TextInput(attrs=attrs),
-            ]
-        super().__init__(widgets=widgets, attrs=attrs)
-
-    def decompress(
-        self, value: apicontractsv1.creditCardType | None
-    ) -> list[str | None]:
-        """Decompresses a :py:attr:`~authorizenet.apicontractsv1.creditCardType` into a list of strings."""
-        if value is None:
-            return [None, None, None, None]
-
-        expiry_parts = value.expirationDate.split("-")
-        return [value.cardNumber, expiry_parts[0], expiry_parts[1], value.cardCode]
-
-
-class AddressWidget(forms.widgets.MultiWidget):
-    def __init__(self, widgets=(), attrs: dict | None = None) -> None:
-        if not widgets:
-            widgets = [
-                forms.TextInput(attrs=attrs),
-                forms.TextInput(attrs=attrs),
-                forms.TextInput(attrs=attrs),
-                forms.TextInput(attrs=attrs),
-                forms.TextInput(attrs=attrs),
-            ]
-        super().__init__(widgets=widgets, attrs=attrs)
-
-    def decompress(
-        self, value: apicontractsv1.customerAddressType | None
-    ) -> list[str | None]:
-        """Decompresses a :py:attr:`~authorizenet.apicontractsv1.customerAddressType` into a list of strings."""
-        if value is None:
-            return [None, None, None, None, None]
-
-        return [value.address, value.city, value.state, value.country, value.zip]

terminusgps/django/utils.py

@@ -1,7 +0,0 @@
-import numpy as np
-from PIL.Image import Image
-from pyzbar.pyzbar import decode
-
-
-def scan_barcode(img: np.ndarray | Image) -> list:
-    return decode(img)

terminusgps/django/validators.py

@@ -1,99 +0,0 @@
-from django.core.exceptions import ValidationError
-from django.utils.translation import gettext_lazy as _
-
-VALID_COUNTRY_CODES = ("+1", "+52")
-
-
-def validate_e164_phone_number(value: str) -> None:
-    """Raises :py:exc:`~django.core.exceptions.ValidationError` if the value is not a valid `E.164 <https://en.wikipedia.org/wiki/E.164>`_ formatted phone number."""
-    if not value:
-        raise ValidationError(
-            _("This field is required, got '%(value)s'"),
-            code="invalid",
-            params={"value": value},
-        )
-    if not value.startswith("+"):
-        raise ValidationError(
-            _("E.164 phone number must begin with a '+', got '%(char)s'."),
-            code="invalid",
-            params={"char": value[0]},
-        )
-    if " " in value:
-        raise ValidationError(
-            _("E.164 phone number cannot contain spaces, got '%(value)s'."),
-            code="invalid",
-            params={"value": value},
-        )
-    if "-" in value:
-        raise ValidationError(
-            _("E.164 phone number cannot contain hyphens, got '%(value)s'."),
-            code="invalid",
-            params={"value": value},
-        )
-    if len(value) < 12:
-        raise ValidationError(
-            _(
-                "E.164 phone number cannot be less than 12 characters in length, got %(len)s."
-            ),
-            code="invalid",
-            params={"len": len(value)},
-        )
-    if len(value) > 15:
-        raise ValidationError(
-            _(
-                "E.164 phone number cannot be greater than 15 characters in length, got %(len)s."
-            ),
-            code="invalid",
-            params={"len": len(value)},
-        )
-
-    country_code = value[:-10]
-    area_code = value[-10:-7]
-    subscriber_number = value[-7:]
-
-    if len(country_code) < 2 or len(country_code) > 5:
-        raise ValidationError(
-            _(
-                "E.164 phone number country code must be between 2 and 5 characters in length, got %(len)s."
-            ),
-            code="invalid",
-            params={"len": len(country_code)},
-        )
-    if country_code not in VALID_COUNTRY_CODES:
-        raise ValidationError(
-            _(
-                "E.164 phone number cannot contain an invalid country code, got '%(country_code)s'."
-            ),
-            code="invalid",
-            params={"country_code": country_code},
-        )
-    if not len(area_code) == 3:
-        raise ValidationError(
-            _(
-                "E.164 phone number must contain a 3-digit area code, got '%(area_code)s'."
-            ),
-            code="invalid",
-            params={"area_code": area_code},
-        )
-    if not area_code.isdigit():
-        raise ValidationError(
-            _("E.164 phone number must have a valid area code, got '%(area_code)s'."),
-            code="invalid",
-            params={"area_code": area_code},
-        )
-    if not len(subscriber_number) == 7:
-        raise ValidationError(
-            _(
-                "E.164 phone number must contain a 7-digit subscriber number, got '%(subscriber_number)s'."
-            ),
-            code="invalid",
-            params={"subscriber_number": subscriber_number},
-        )
-    if not subscriber_number.isdigit():
-        raise ValidationError(
-            _(
-                "E.164 phone number must have a valid subscriber number, got '%(subscriber_number)s'."
-            ),
-            code="invalid",
-            params={"subscriber_number": subscriber_number},
-        )