python-terminusgps 47.1.2__tar.gz → 47.2.0__tar.gz

{python_terminusgps-47.1.2 → python_terminusgps-47.2.0}/PKG-INFO

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

{python_terminusgps-47.1.2 → python_terminusgps-47.2.0}/docs/source/wialon/index.rst

@@ -13,3 +13,4 @@ Most Wialon objects are modeled as plain Python classes which have methods that
     items.rst
     session.rst
     usage.rst
+    utils.rst

python_terminusgps-47.2.0/docs/source/wialon/utils.rst

@@ -0,0 +1,5 @@
+Utilities
+=========
+
+.. automodule:: terminusgps.wialon.utils
+    :members:

{python_terminusgps-47.1.2 → python_terminusgps-47.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "47.1.2"
+version = "47.2.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-47.1.2 → python_terminusgps-47.2.0}/terminusgps/validators.py

@@ -7,6 +7,16 @@ from django.utils.translation import gettext_lazy as _
 VALID_COUNTRY_CODES = ("+1", "+52")
 
 
+def validate_is_digit(value: str) -> None:
+    """Raises :py:exc:`django.core.exceptions.ValidationError` if the value contained non-digit characters."""
+    if not value.isdigit():
+        raise ValidationError(
+            _("Value can only contain digits, got '%(value)s'."),
+            code="invalid",
+            params={"value": value},
+        )
+
+
 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.

{python_terminusgps-47.1.2 → python_terminusgps-47.2.0}/terminusgps/wialon/utils.py

@@ -14,9 +14,9 @@ def get_hw_types(session: WialonSession) -> list[dict[str, str | int]]:
     Returns a list of hardware type objects for Wialon.
 
     :param session: A valid Wialon API session.
-    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :type session: ~terminusgps.wialon.session.WialonSession
     :returns: A list of hardware types.
-    :rtype: :py:obj:`list`
+    :rtype: list[dict[str, str | int]]
 
     Hardware type format:
 
@@ -37,11 +37,11 @@ def get_user_by_name(name: str, session: WialonSession) -> WialonUser:
     Returns a Wialon user by name.
 
     :param name: A Wialon user name.
-    :type name: :py:obj:`str`
+    :type name: str
     :param session: A valid Wialon API session.
-    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :type session: ~terminusgps.wialon.session.WialonSession
     :returns: A Wialon user.
-    :rtype: :py:obj:`~terminusgps.wialon.items.user.WialonUser` | :py:obj:`None`
+    :rtype: ~terminusgps.wialon.items.user.WialonUser | None
 
     """
     response = session.wialon_api.core_search_items(
@@ -74,9 +74,9 @@ def get_carrier_names(session: WialonSession) -> list[str]:
     Returns a list of all telecommunication carrier company names present in Wialon.
 
     :param session: A valid Wialon API session.
-    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :type session: ~terminusgps.wialon.session.WialonSession
     :returns: A list of telecommunication carrier company names.
-    :rtype: :py:obj:`list`
+    :rtype: list[str]
 
     """
     response = session.wialon_api.core_search_items(
@@ -110,12 +110,12 @@ def get_units_by_carrier(
     """
     Returns a list of all units by telecommunications carrier company name.
 
-    :param carrier_name: A telecommunications carrier company name, e.g. ``"US Cell"`` or ``"Conetixx"``.
-    :type carrier_name: :py:obj:`str`
+    :param carrier_name: Case-insensitive telecommunications carrier company name, e.g. ``"UScell"`` or ``"Conetixx"``.
+    :type carrier_name: str
     :param session: A valid Wialon API session.
-    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
-    :returns: A list of units, if any were found.
-    :rtype: :py:obj:`list`
+    :type session: ~terminusgps.wialon.session.WialonSession
+    :returns: A list of units.
+    :rtype: list[~terminusgps.wialon.items.unit.WialonUnit]
 
     """
     response = session.wialon_api.core_search_items(
@@ -123,7 +123,7 @@ def get_units_by_carrier(
             "spec": {
                 "itemsType": "avl_unit",
                 "propName": "admin_fields,rel_adminfield_value",
-                "propValueMask": f"carrier,{carrier_name}",
+                "propValueMask": f"carrier,{carrier_name.lower()}",
                 "sortType": "admin_fields,admin_fields",
                 "propType": "propitemname",
             },
@@ -137,7 +137,7 @@ def get_units_by_carrier(
     num_items: int = int(response.get("totalItemsCount"))
     if num_items <= 0:
         raise ValueError(
-            f"Couldn't find any units by carrier '{carrier_name}'."
+            f"Couldn't find any units by carrier '{carrier_name.lower()}'."
         )
 
     factory = WialonObjectFactory(session)
@@ -150,11 +150,11 @@ def get_unit_by_iccid(iccid: str, session: WialonSession) -> WialonUnit:
     Returns a unit by iccid (SIM card #).
 
     :param iccid: A SIM card #.
-    :type iccid: :py:obj:`str`
+    :type iccid: str
     :param session: A valid Wialon API session.
-    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :type session: ~terminusgps.wialon.session.WialonSession
     :returns: The Wialon unit.
-    :rtype: :py:obj:`~terminusgps.wialon.items.WialonUnit`
+    :rtype: ~terminusgps.wialon.items.WialonUnit
 
     """
     response = session.wialon_api.core_search_items(
@@ -191,13 +191,13 @@ def get_unit_by_imei(
     Takes a Wialon unit's IMEI # and returns its unit id.
 
     :param imei: A Wialon unit's IMEI #.
-    :type imei: :py:obj:`str`
+    :type imei: str
     :param session: A valid Wialon API session.
-    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :type session: ~terminusgps.wialon.session.WialonSession
     :raises ValueError: If ``imei`` wasn't a digit.
     :raises WialonAPIError: If something went wrong calling the Wialon API.
     :returns: A Wialon unit, if it was found.
-    :rtype: :py:obj:`str` | :py:obj:`None`
+    :rtype: ~terminusgps.wialon.items.unit.WialonUnit | None
 
     """
     if isinstance(imei, str) and not imei.isdigit():
@@ -227,35 +227,25 @@ def get_unit_by_imei(
     return factory.get("avl_unit", id=int(response.get("items")[0].get("id")))
 
 
-def get_vin_info(
-    vin_number: str, session: WialonSession
-) -> dict[str, typing.Any]:
+def get_vin_info(vin: str, session: WialonSession) -> dict[str, typing.Any]:
     """
     Retrieves vehicle data from a VIN number.
 
-    :param value: A vehicle's VIN number.
-    :type value: :py:obj:`str`
+    :param vin: A vehicle VIN #.
+    :type vin: str
     :param session: A valid Wialon API session.
-    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :type session: ~terminusgps.wialon.session.WialonSession
     :returns: A dictionary of vehicle information, if any was found.
-    :rtype: :py:obj:`dict`
+    :rtype: dict[str, ~typing.Any]
 
     """
-    response = session.wialon_api.unit_get_vin_info(**{"vin": vin_number})
+    response = session.wialon_api.unit_get_vin_info(**{"vin": vin})
     results = response.get("vin_lookup_result", {})
     if "error" in results.keys():
         return {}
     return {field.get("n"): field.get("v") for field in results.get("pflds")}
 
 
-def check_unique(object_type: str, name: str, session: WialonSession) -> bool:
-    return bool(
-        session.wialon_api.core_check_unique(
-            **{"type": object_type, "value": name}
-        ).get("result")
-    )
-
-
 def generate_wialon_password(length: int = 32) -> str:
     """
     Generates a Wialon compliant password between ``8`` and ``64`` characters.
@@ -267,11 +257,11 @@ def generate_wialon_password(length: int = 32) -> str:
         - At least one special symbol.
         - At least three digits.
 
-    :param length: Length of the generated password. Default is :py:obj:`32`.
-    :type length: :py:obj:`int`
-    :raises ValueError: If ``length`` is less than ``8`` or greater than ``64``.
+    :param length: Length of the generated password. Default is ``32``.
+    :type length: int
+    :raises ValueError: If ``length`` was less than ``8`` or greater than ``64``.
     :returns: A Wialon compliant password.
-    :rtype: :py:obj:`str`
+    :rtype: str
 
     """
     min_length, max_length = 8, 64

{python_terminusgps-47.1.2 → python_terminusgps-47.2.0}/uv.lock

@@ -188,11 +188,11 @@ wheels = [
 
 [[package]]
 name = "idna"
-version = "3.10"
+version = "3.11"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/f1/70/7703c29685631f5a7590aa73f1f1d3fa9a380e654b86af429e0934a32f7d/idna-3.10.tar.gz", hash = "sha256:12f65c9b470abda6dc35cf8e63cc574b1c52b11df2c86030af0ac09b01b13ea9", size = 190490 }
+sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/76/c6/c88e154df9c4e1a2a66ccf0005a88dfb2650c1dffb6f5ce603dfbd452ce3/idna-3.10-py3-none-any.whl", hash = "sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3", size = 70442 },
+    { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008 },
 ]
 
 [[package]]
@@ -323,7 +323,7 @@ wheels = [
 
 [[package]]
 name = "python-terminusgps"
-version = "47.1.2"
+version = "47.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "authorizenet" },