python-terminusgps 47.1.1__tar.gz → 47.1.3__tar.gz

{python_terminusgps-47.1.1 → python_terminusgps-47.1.3}/PKG-INFO

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

{python_terminusgps-47.1.1 → python_terminusgps-47.1.3}/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.1.3/docs/source/wialon/utils.rst

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

{python_terminusgps-47.1.1 → python_terminusgps-47.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "47.1.1"
+version = "47.1.3"
 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.1 → python_terminusgps-47.1.3}/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(
@@ -96,7 +96,7 @@ def get_carrier_names(session: WialonSession) -> list[str]:
         }
     )
     carrier_names: list[str] = [
-        field["v"]
+        str(field["v"]).lower()
         for item in response.get("items", [{}])
         for field in item.get("aflds", {}).values()
         if field["n"] == "carrier" and field["v"]
@@ -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.1 → python_terminusgps-47.1.3}/uv.lock

@@ -142,7 +142,7 @@ wheels = [
 
 [[package]]
 name = "django-stubs"
-version = "5.2.6"
+version = "5.2.7"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "django" },
@@ -150,22 +150,22 @@ dependencies = [
     { name = "types-pyyaml" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/0c/ec/ab347204c6a13e6f1bbe1faefe5404a4ca3f2df72f568c53e32da4afc803/django_stubs-5.2.6.tar.gz", hash = "sha256:991dc36c10fefd6bf0cfd163db3dabd15787112f96cfedf6e8388ba1930040fb", size = 257279 }
+sdist = { url = "https://files.pythonhosted.org/packages/5d/a8/bc8c55212978f1e666486b60a4bfb0bc3a066de8212fa7389ff0f3dca639/django_stubs-5.2.7.tar.gz", hash = "sha256:2a07e47a8a867836a763c6bba8bf3775847b4fd9555bfa940360e32d0ee384a1", size = 257339 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/90/fd/fa8c7740991599696412d00930641dc35eb047d1d70dc1f924e8ab999db3/django_stubs-5.2.6-py3-none-any.whl", hash = "sha256:bb517a60355474a2c8403a48d16ff906c8bc46d604f419206de10ac018a5f4bc", size = 507711 },
+    { url = "https://files.pythonhosted.org/packages/ad/66/1c8063eee88a943f01d073dbbbda34ed093bf6e19738178506a66abbd5ad/django_stubs-5.2.7-py3-none-any.whl", hash = "sha256:2864e74b56ead866ff1365a051f24d852f6ed02238959664f558a6c9601c95bf", size = 507733 },
 ]
 
 [[package]]
 name = "django-stubs-ext"
-version = "5.2.6"
+version = "5.2.7"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "django" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/4c/13/d9d4fb0a797966b941f51ee2ac60eede308890488149985a91bacfc80ca2/django_stubs_ext-5.2.6.tar.gz", hash = "sha256:1165a596138a54edac12616af126332db03b812c8272ada724b4e89188a3c41f", size = 6524 }
+sdist = { url = "https://files.pythonhosted.org/packages/9b/6f/a0bab0e6a7676ab3ca02d51b459444e9bd6dd747e3a43b9c24cae6d0a1c6/django_stubs_ext-5.2.7.tar.gz", hash = "sha256:b690655bd4cb8a44ae57abb314e0995dc90414280db8f26fff0cb9fb367d1cac", size = 6524 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/67/69/2ce28341493e35b7b182e2c0474288a350edf1cb27220517fb8abd4143c9/django_stubs_ext-5.2.6-py3-none-any.whl", hash = "sha256:c3736dcea49666140c92a1471dda83c31e8d5e71dc364ab3cedc7698dbf01cee", size = 9980 },
+    { url = "https://files.pythonhosted.org/packages/f8/c9/60445606e26706d3fccadf3b80ee1a9f32c1012683ff2ada7580937b2da9/django_stubs_ext-5.2.7-py3-none-any.whl", hash = "sha256:0466a7132587d49c5bbe12082ac9824d117a0dedcad5d0ada75a6e0d3aca6f60", size = 9979 },
 ]
 
 [[package]]
@@ -323,7 +323,7 @@ wheels = [
 
 [[package]]
 name = "python-terminusgps"
-version = "47.1.1"
+version = "47.1.3"
 source = { editable = "." }
 dependencies = [
     { name = "authorizenet" },