python-terminusgps 49.3.0__tar.gz → 50.1.0__tar.gz

{python_terminusgps-49.3.0 → python_terminusgps-50.1.0}/PKG-INFO

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

{python_terminusgps-49.3.0 → python_terminusgps-50.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "49.3.0"
+version = "50.1.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-49.3.0 → python_terminusgps-50.1.0}/terminusgps/authorizenet/service.py

@@ -1,4 +1,3 @@
-from abc import ABC
 from functools import cached_property
 
 from authorizenet.apicontractsv1 import merchantAuthenticationType
@@ -35,8 +34,8 @@ class AuthorizenetControllerExecutionError(Exception):
         return self._code
 
 
-class AuthorizenetService(ABC):
-    """Base service for safely interacting with the Authorizenet API."""
+class AuthorizenetService:
+    """Service for safely interacting with the Authorizenet API."""
 
     REQUIRED_SETTINGS = (
         "MERCHANT_AUTH_ENVIRONMENT",

{python_terminusgps-49.3.0 → python_terminusgps-50.1.0}/terminusgps/wialon/session.py

@@ -15,8 +15,7 @@ class WialonAPIError(Exception):
         try:
             self._code = int(message._code)
         except ValueError:
-            # 6 = 'Unknown Error' according to Wialon
-            self._code = 6
+            self._code = 6  # 'Unknown Error' according to Wialon
         return super().__init__(message, *args, **kwargs)
 
     @property

python_terminusgps-50.1.0/terminusgps/wialon/utils.py

@@ -0,0 +1,209 @@
+import secrets
+import string
+import typing
+
+from terminusgps.wialon.session import WialonSession
+
+__all__ = [
+    "generate_wialon_password",
+    "get_unit_from_iccid",
+    "get_unit_from_imei",
+    "get_units_from_carrier",
+]
+
+
+def generate_wialon_password(length: int = 32) -> str:
+    """
+    Generates a Wialon compliant password between ``8`` and ``64`` characters.
+
+    The generated password will contain:
+
+        - At least one uppercase letter.
+        - At least one lowercase letter.
+        - At least one special symbol.
+        - At least three digits.
+
+    :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: str
+
+    """
+    if length > 64:
+        raise ValueError(
+            f"Password cannot be greater than 64 characters in length, got {length}."
+        )
+    elif length < 8:
+        raise ValueError(
+            f"Password cannot be less than 8 characters in length, got {length}."
+        )
+
+    s0 = list(string.ascii_uppercase)
+    s1 = list(string.ascii_lowercase)
+    s2 = list(string.digits)
+    s3 = list("!@#$%^*()[]-_+")
+
+    while True:
+        password = "".join(
+            [secrets.choice(s0 + s1 + s2 + s3) for _ in range(length)]
+        )
+        if (
+            any(c.islower() for c in password)
+            and any(c.isupper() for c in password)
+            and sum(c.isdigit() for c in password) >= 3
+            and any(c in s3 for c in password)
+        ):
+            break
+    return password
+
+
+def get_unit_from_iccid(
+    iccid: str,
+    session: WialonSession,
+    *,
+    flags: int = 1,
+    use_cache: bool = True,
+    afield_key: str = "iccid",
+) -> dict[str, typing.Any]:
+    """
+    Returns a Wialon unit from a telecom iccid.
+
+    :param iccid: A telecom iccid number.
+    :type iccid: str
+    :param session: A valid Wialon API session.
+    :type session: ~terminusgps.wialon.session.WialonSession
+    :param flags: Wialon API response format flags. Default is ``1``.
+    :type flags: int
+    :param use_cache: Whether to use a cached Wialon API response or force a Wialon API call. Default is :py:obj:`True`.
+    :type use_cache: bool
+    :param afield_key: Admin field key to search against. Default is ``"iccid"``.
+    :type afield_key: str
+    :raises ValueError: If multiple units were found with the provided iccid.
+    :raises ValueError: If zero units were found with the provided iccid.
+    :raises WialonAPIError: If something went wrong calling the Wialon API.
+    :returns: A Wialon unit dictionary.
+    :rtype: dict[str, ~typing.Any]
+
+    """
+    response = session.wialon_api.core_search_items(
+        **{
+            "spec": {
+                "itemsType": "avl_unit",
+                "propName": "rel_adminfield_name,rel_adminfield_value",
+                "propValueMask": f"{afield_key},{iccid}",
+                "sortType": "sys_name",
+                "propType": "admin_fields,admin_fields",
+            },
+            "force": int(not use_cache),
+            "flags": flags,
+            "from": 0,
+            "to": 0,
+        }
+    )
+    if int(response["totalItemsCount"]) > 1:
+        raise ValueError(f"Multiple units found for iccid #{iccid}.")
+    elif int(response["totalItemsCount"]) == 0:
+        raise ValueError(f"No units found for iccid #{iccid}.")
+    return response["items"][0]
+
+
+def get_unit_from_imei(
+    imei: str,
+    session: WialonSession,
+    *,
+    flags: int = 1,
+    use_cache: bool = True,
+) -> dict[str, typing.Any]:
+    """
+    Returns a Wialon unit ID from an IMEI (sys_unique_id) number.
+
+    :param imei: An IMEI number.
+    :type imei: str
+    :param session: A valid Wialon API session.
+    :type session: ~terminusgps.wialon.session.WialonSession
+    :param flags: Wialon API response format flags. Default is ``1``.
+    :type flags: int
+    :param use_cache: Whether to use a cached Wialon API response or force a Wialon API call. Default is :py:obj:`True`.
+    :type use_cache: bool
+    :raises ValueError: If multiple units were found with the provided IMEI number.
+    :raises ValueError: If zero units were found with the provided IMEI number.
+    :raises WialonAPIError: If something went wrong calling the Wialon API.
+    :returns: A Wialon unit dictionary.
+    :rtype: dict[str, ~typing.Any]
+
+    """
+    response = session.wialon_api.core_search_items(
+        **{
+            "spec": {
+                "itemsType": "avl_unit",
+                "propName": "sys_unique_id",
+                "propValueMask": imei,
+                "sortType": "sys_name",
+                "propType": "property",
+            },
+            "force": int(not use_cache),
+            "flags": flags,
+            "from": 0,
+            "to": 0,
+        }
+    )
+    if int(response["totalItemsCount"]) > 1:
+        raise ValueError(f"Multiple units found for IMEI #{imei}.")
+    elif int(response["totalItemsCount"]) == 0:
+        raise ValueError(f"No units found for IMEI #{imei}.")
+    return response["items"][0]
+
+
+def get_units_from_carrier(
+    carrier: str,
+    session: WialonSession,
+    *,
+    use_cache: bool = True,
+    afield_key: str = "carrier",
+    flags: int = 1,
+    start: int = 0,
+    end: int = 0,
+) -> list[dict[str, typing.Any]]:
+    """
+    Returns a list of Wialon unit IDs by telecom carrier name.
+
+    The list may be empty if no units were found.
+
+    :param carrier: A telecom carrier name.
+    :type carrier: str
+    :param session: A valid Wialon API session.
+    :type session: ~terminusgps.wialon.session.WialonSession
+    :param use_cache: Whether to use a cached Wialon API response or force a Wialon API call. Default is :py:obj:`True`.
+    :type use_cache: bool
+    :param afield_key: Admin field key to search against. Default is ``"carrier"``.
+    :type afield_key: str
+    :param flags: Wialon API response flags. Default is ``1``.
+    :type flags: int
+    :param start: Start index. Default is ``0``.
+    :type start: int
+    :param end: End index. Default is ``0``.
+    :type end: int
+    :raises WialonAPIError: If something went wrong calling the Wialon API.
+    :returns: A list of Wialon unit dictionaries.
+    :rtype: list[dict[str, ~typing.Any]]
+
+    """
+    response = session.wialon_api.core_search_items(
+        **{
+            "spec": {
+                "itemsType": "avl_unit",
+                "propName": "rel_adminfield_name,rel_adminfield_value",
+                "propValueMask": f"{afield_key},{carrier}",
+                "sortType": "sys_name",
+                "propType": "admin_fields,admin_fields",
+            },
+            "force": int(not use_cache),
+            "flags": flags,
+            "from": start,
+            "to": end,
+        }
+    )
+    if int(response["totalItemsCount"]) == 0:
+        return []
+    return response["items"]

{python_terminusgps-49.3.0 → python_terminusgps-50.1.0}/uv.lock

@@ -180,15 +180,15 @@ wheels = [
 
 [[package]]
 name = "beautifulsoup4"
-version = "4.14.2"
+version = "4.14.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "soupsieve" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/77/e9/df2358efd7659577435e2177bfa69cba6c33216681af51a707193dec162a/beautifulsoup4-4.14.2.tar.gz", hash = "sha256:2a98ab9f944a11acee9cc848508ec28d9228abfd522ef0fad6a02a72e0ded69e", size = 625822 }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b0/1c6a16426d389813b48d95e26898aff79abbde42ad353958ad95cc8c9b21/beautifulsoup4-4.14.3.tar.gz", hash = "sha256:6292b1c5186d356bba669ef9f7f051757099565ad9ada5dd630bd9de5fa7fb86", size = 627737 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/94/fe/3aed5d0be4d404d12d36ab97e2f1791424d9ca39c2f754a6285d59a3b01d/beautifulsoup4-4.14.2-py3-none-any.whl", hash = "sha256:5ef6fa3a8cbece8488d66985560f97ed091e22bbc4e9c2338508a9d5de6d4515", size = 106392 },
+    { url = "https://files.pythonhosted.org/packages/1a/39/47f9197bdd44df24d67ac8893641e16f386c984a0619ef2ee4c51fbbc019/beautifulsoup4-4.14.3-py3-none-any.whl", hash = "sha256:0918bfe44902e6ad8d57732ba310582e98da931428d231a5ecb9e7c703a735bb", size = 107721 },
 ]
 
 [[package]]
@@ -268,21 +268,21 @@ wheels = [
 
 [[package]]
 name = "django"
-version = "5.2.8"
+version = "6.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "asgiref" },
     { name = "sqlparse" },
     { name = "tzdata", marker = "sys_platform == 'win32'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/05/a2/933dbbb3dd9990494960f6e64aca2af4c0745b63b7113f59a822df92329e/django-5.2.8.tar.gz", hash = "sha256:23254866a5bb9a2cfa6004e8b809ec6246eba4b58a7589bc2772f1bcc8456c7f", size = 10849032 }
+sdist = { url = "https://files.pythonhosted.org/packages/15/75/19762bfc4ea556c303d9af8e36f0cd910ab17dff6c8774644314427a2120/django-6.0.tar.gz", hash = "sha256:7b0c1f50c0759bbe6331c6a39c89ae022a84672674aeda908784617ef47d8e26", size = 10932418 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/5e/3d/a035a4ee9b1d4d4beee2ae6e8e12fe6dee5514b21f62504e22efcbd9fb46/django-5.2.8-py3-none-any.whl", hash = "sha256:37e687f7bd73ddf043e2b6b97cfe02fcbb11f2dbb3adccc6a2b18c6daa054d7f", size = 8289692 },
+    { url = "https://files.pythonhosted.org/packages/d7/ae/f19e24789a5ad852670d6885f5480f5e5895576945fcc01817dfd9bc002a/django-6.0-py3-none-any.whl", hash = "sha256:1cc2c7344303bbfb7ba5070487c17f7fc0b7174bbb0a38cebf03c675f5f19b6d", size = 8339181 },
 ]
 
 [[package]]
 name = "django-stubs"
-version = "5.2.7"
+version = "5.2.8"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "django" },
@@ -290,22 +290,22 @@ dependencies = [
     { name = "types-pyyaml" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/5d/a8/bc8c55212978f1e666486b60a4bfb0bc3a066de8212fa7389ff0f3dca639/django_stubs-5.2.7.tar.gz", hash = "sha256:2a07e47a8a867836a763c6bba8bf3775847b4fd9555bfa940360e32d0ee384a1", size = 257339 }
+sdist = { url = "https://files.pythonhosted.org/packages/6c/75/97626224fd8f1787bb6f7f06944efcfddd5da7764bf741cf7f59d102f4a0/django_stubs-5.2.8.tar.gz", hash = "sha256:9bba597c9a8ed8c025cae4696803d5c8be1cf55bfc7648a084cbf864187e2f8b", size = 257709 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ad/66/1c8063eee88a943f01d073dbbbda34ed093bf6e19738178506a66abbd5ad/django_stubs-5.2.7-py3-none-any.whl", hash = "sha256:2864e74b56ead866ff1365a051f24d852f6ed02238959664f558a6c9601c95bf", size = 507733 },
+    { url = "https://files.pythonhosted.org/packages/7d/3f/7c9543ad5ade5ce1d33d187a3abd82164570314ebee72c6206ab5c044ebf/django_stubs-5.2.8-py3-none-any.whl", hash = "sha256:a3c63119fd7062ac63d58869698d07c9e5ec0561295c4e700317c54e8d26716c", size = 508136 },
 ]
 
 [[package]]
 name = "django-stubs-ext"
-version = "5.2.7"
+version = "5.2.8"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "django" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/9b/6f/a0bab0e6a7676ab3ca02d51b459444e9bd6dd747e3a43b9c24cae6d0a1c6/django_stubs_ext-5.2.7.tar.gz", hash = "sha256:b690655bd4cb8a44ae57abb314e0995dc90414280db8f26fff0cb9fb367d1cac", size = 6524 }
+sdist = { url = "https://files.pythonhosted.org/packages/14/a2/d67f4a5200ff7626b104eddceaf529761cba4ed318a73ffdb0677551be73/django_stubs_ext-5.2.8.tar.gz", hash = "sha256:b39938c46d7a547cd84e4a6378dbe51a3dd64d70300459087229e5fee27e5c6b", size = 6487 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/f8/c9/60445606e26706d3fccadf3b80ee1a9f32c1012683ff2ada7580937b2da9/django_stubs_ext-5.2.7-py3-none-any.whl", hash = "sha256:0466a7132587d49c5bbe12082ac9824d117a0dedcad5d0ada75a6e0d3aca6f60", size = 9979 },
+    { url = "https://files.pythonhosted.org/packages/da/2d/cb0151b780c3730cf0f2c0fcb1b065a5e88f877cf7a9217483c375353af1/django_stubs_ext-5.2.8-py3-none-any.whl", hash = "sha256:1dd5470c9675591362c78a157a3cf8aec45d0e7a7f0cf32f227a1363e54e0652", size = 9949 },
 ]
 
 [[package]]
@@ -748,7 +748,7 @@ wheels = [
 
 [[package]]
 name = "python-terminusgps"
-version = "49.3.0"
+version = "50.1.0"
 source = { editable = "." }
 dependencies = [
     { name = "authorizenet" },
@@ -820,13 +820,25 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738 },
 ]
 
+[[package]]
+name = "roman-numerals"
+version = "4.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6b/20/a6b20239f54814de5c34bf3f504e553b11780c2aad3677ad2daf989f1fb3/roman_numerals-4.0.0.tar.gz", hash = "sha256:231287018a8788bf8c0718482a08c15b90458523ea1d840a18a791a86d4583b3", size = 9027 }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ad/9d/ad950fd3b65cf0974c633862320829f3d461aef125b981504277c8409a93/roman_numerals-4.0.0-py3-none-any.whl", hash = "sha256:4131feb23ba1a542494873e4cee7844ec8d226a750134efc65ceb20939ed33c9", size = 7668 },
+]
+
 [[package]]
 name = "roman-numerals-py"
-version = "3.1.0"
+version = "4.0.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/30/76/48fd56d17c5bdbdf65609abbc67288728a98ed4c02919428d4f52d23b24b/roman_numerals_py-3.1.0.tar.gz", hash = "sha256:be4bf804f083a4ce001b5eb7e3c0862479d10f94c936f6c4e5f250aa5ff5bd2d", size = 9017 }
+dependencies = [
+    { name = "roman-numerals" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7e/02/6cb667fc1872c5fe814971be2973317f0747d86f1c0aac37d0e1a1df1ecc/roman_numerals_py-4.0.0.tar.gz", hash = "sha256:f7fa8dff5b7b7251d3a7586b97c57a0698e2e28898fa42c23bcc0cf51b02aee9", size = 1119 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/53/97/d2cbbaa10c9b826af0e10fdf836e1bf344d9f0abb873ebc34d1f49642d3f/roman_numerals_py-3.1.0-py3-none-any.whl", hash = "sha256:9da2ad2fb670bcf24e81070ceb3be72f6c11c440d73bd579fbeca1e9f330954c", size = 7742 },
+    { url = "https://files.pythonhosted.org/packages/d2/b7/c0aa3b0154e022faa8e8b4eadda0c49f53b09b6b8d55ed3b7cd311abfd92/roman_numerals_py-4.0.0-py3-none-any.whl", hash = "sha256:dfcecf6e0cddbf2ee1112e7e2ebf58ba771984f075cb57a30e1811cee4f06332", size = 1244 },
 ]
 
 [[package]]
@@ -979,11 +991,11 @@ wheels = [
 
 [[package]]
 name = "sqlparse"
-version = "0.5.3"
+version = "0.5.4"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/e5/40/edede8dd6977b0d3da179a342c198ed100dd2aba4be081861ee5911e4da4/sqlparse-0.5.3.tar.gz", hash = "sha256:09f67787f56a0b16ecdbde1bfc7f5d9c3371ca683cfeaa8e6ff60b4807ec9272", size = 84999 }
+sdist = { url = "https://files.pythonhosted.org/packages/18/67/701f86b28d63b2086de47c942eccf8ca2208b3be69715a1119a4e384415a/sqlparse-0.5.4.tar.gz", hash = "sha256:4396a7d3cf1cd679c1be976cf3dc6e0a51d0111e87787e7a8d780e7d5a998f9e", size = 120112 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a9/5c/bfd6bd0bf979426d405cc6e71eceb8701b148b16c21d2dc3c261efc61c7b/sqlparse-0.5.3-py3-none-any.whl", hash = "sha256:cf2196ed3418f3ba5de6af7e82c694a9fbdbfecccdfc72e281548517081f16ca", size = 44415 },
+    { url = "https://files.pythonhosted.org/packages/25/70/001ee337f7aa888fb2e3f5fd7592a6afc5283adb1ed44ce8df5764070f22/sqlparse-0.5.4-py3-none-any.whl", hash = "sha256:99a9f0314977b76d776a0fcb8554de91b9bb8a18560631d6bc48721d07023dcb", size = 45933 },
 ]
 
 [[package]]
@@ -1006,20 +1018,20 @@ wheels = [
 
 [[package]]
 name = "tzdata"
-version = "2025.2"
+version = "2025.3"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/95/32/1a225d6164441be760d75c2c42e2780dc0873fe382da3e98a2e1e48361e5/tzdata-2025.2.tar.gz", hash = "sha256:b60a638fcc0daffadf82fe0f57e53d06bdec2f36c4df66280ae79bce6bd6f2b9", size = 196380 }
+sdist = { url = "https://files.pythonhosted.org/packages/5e/a7/c202b344c5ca7daf398f3b8a477eeb205cf3b6f32e7ec3a6bac0629ca975/tzdata-2025.3.tar.gz", hash = "sha256:de39c2ca5dc7b0344f2eba86f49d614019d29f060fc4ebc8a417896a620b56a7", size = 196772 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/5c/23/c7abc0ca0a1526a0774eca151daeb8de62ec457e77262b66b359c3c7679e/tzdata-2025.2-py2.py3-none-any.whl", hash = "sha256:1a403fada01ff9221ca8044d701868fa132215d84beb92242d9acd2147f667a8", size = 347839 },
+    { url = "https://files.pythonhosted.org/packages/c7/b0/003792df09decd6849a5e39c28b513c06e84436a54440380862b5aeff25d/tzdata-2025.3-py2.py3-none-any.whl", hash = "sha256:06a47e5700f3081aab02b2e513160914ff0694bce9947d6b76ebd6bf57cfc5d1", size = 348521 },
 ]
 
 [[package]]
 name = "urllib3"
-version = "2.5.0"
+version = "2.6.2"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/15/22/9ee70a2574a4f4599c47dd506532914ce044817c7752a79b6a51286319bc/urllib3-2.5.0.tar.gz", hash = "sha256:3fc47733c7e419d4bc3f6b3dc2b4f890bb743906a30d56ba4a5bfa4bbff92760", size = 393185 }
+sdist = { url = "https://files.pythonhosted.org/packages/1e/24/a2a2ed9addd907787d7aa0355ba36a6cadf1768b934c652ea78acbd59dcd/urllib3-2.6.2.tar.gz", hash = "sha256:016f9c98bb7e98085cb2b4b17b87d2c702975664e4f060c6532e64d1c1a5e797", size = 432930 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a7/c2/fe1e52489ae3122415c51f387e221dd0773709bad6c6cdaa599e8a2c5185/urllib3-2.5.0-py3-none-any.whl", hash = "sha256:e6b01673c0fa6a13e374b50871808eb3bf7046c4b125b216f6bf1cc604cff0dc", size = 129795 },
+    { url = "https://files.pythonhosted.org/packages/6d/b9/4095b668ea3678bf6a0af005527f39de12fb026516fb3df17495a733b7f8/urllib3-2.6.2-py3-none-any.whl", hash = "sha256:ec21cddfe7724fc7cb4ba4bea7aa8e2ef36f607a4bab81aa6ce42a13dc3f03dd", size = 131182 },
 ]
 
 [[package]]

python_terminusgps-49.3.0/terminusgps/wialon/items/__init__.py

@@ -1 +0,0 @@
-from .factory import WialonObjectFactory

python_terminusgps-49.3.0/terminusgps/wialon/items/account.py

@@ -1,217 +0,0 @@
-import collections.abc
-import decimal
-import typing
-
-from terminusgps.wialon.items.base import WialonObject, requires_id
-
-
-class WialonAccount(WialonObject):
-    """A Wialon `account <https://help.wialon.com/en/wialon-hosting/user-guide/management-system/accounts-and-resources>`_."""
-
-    def create(
-        self, resource_id: int | str, billing_plan: str
-    ) -> dict[str, str]:
-        """
-        Creates the account in Wialon and sets its id.
-
-        :param resource_id: A Wialon resource id.
-        :type creator_id: int | str
-        :param billing_plan: A Wialon account billing plan.
-        :type billing_plan: str
-        :raises ValueError: If ``resource_id`` wasn't a digit.
-        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
-        :returns: A Wialon object dictionary.
-        :rtype: dict[str, str]
-
-        """
-        if isinstance(resource_id, str) and not resource_id.isdigit():
-            raise ValueError(
-                f"'resource_id' must be a digit, got '{resource_id}'."
-            )
-        response = self.session.wialon_api.account_create_account(
-            **{"itemId": resource_id, "plan": billing_plan}
-        )
-        self.id = resource_id
-        return response
-
-    @typing.override
-    @requires_id
-    def delete(
-        self, reasons: collections.abc.Collection[str] | None = None
-    ) -> dict[str, str]:
-        """
-        Deletes the account in Wialon.
-
-        :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 ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
-        :returns: An empty dictionary.
-        :rtype: dict[str, str]
-
-        """
-        return self.session.wialon_api.account_delete_account(
-            **{"itemId": self.id, "reasons": reasons}
-            if reasons is not None
-            else {"itemId": self.id}
-        )
-
-    @requires_id
-    def activate(self) -> dict[str, str]:
-        """
-        Enables the account in Wialon.
-
-        :raises AssertionError: If the Wialon account id wasn't set.
-        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
-        :returns: An empty dictionary.
-        :rtype: dict[str, str]
-
-        """
-        return self.session.wialon_api.account_enable_account(
-            **{"itemId": self.id, "enable": 1}
-        )
-
-    @requires_id
-    def deactivate(self) -> dict[str, str]:
-        """
-        Disables the account in Wialon.
-
-        :raises AssertionError: If the Wialon account id wasn't set.
-        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
-        :returns: An empty dictionary.
-        :rtype: dict[str, str]
-
-        """
-        return self.session.wialon_api.account_enable_account(
-            **{"itemId": self.id, "enable": 0}
-        )
-
-    @requires_id
-    def do_payment(
-        self,
-        balance_update: decimal.Decimal,
-        days_update: int,
-        description: str,
-    ) -> dict[str, str]:
-        """
-        Makes an account payment in Wialon.
-
-        :param balance_update: Amount to update the account balance by. Can be negative.
-        :type balance_update: ~decimal.Decimal
-        :param days_update: Amount of days to add to the account.
-        :type days_update: str
-        :param description: A description for the payment.
-        :type description: str
-        :raises AssertionError: If the Wialon account id wasn't set.
-        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
-        :returns: An empty dictionary.
-        :rtype: dict[str, str]
-
-        """
-        return self.session.wialon_api.account_do_payment(
-            **{
-                "itemId": self.id,
-                "balanceUpdate": str(balance_update),
-                "daysUpdate": days_update,
-                "description": description,
-            }
-        )
-
-    @requires_id
-    def set_dealer_rights(self, enabled: bool) -> dict[str, str]:
-        """
-        Enables or disables the account's dealer rights in Wialon.
-
-        :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 ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
-        :returns: An empty dictionary.
-        :rtype: dict[str, str]
-
-        """
-        return self.session.wialon_api.account_update_dealer_rights(
-            **{"itemId": self.id, "enable": int(enabled)}
-        )
-
-    @requires_id
-    def set_flags(
-        self,
-        flags: int,
-        block_balance: decimal.Decimal = decimal.Decimal("0.00"),
-        deny_balance: decimal.Decimal = decimal.Decimal("0.00"),
-    ) -> dict[str, str]:
-        """
-        Sets settings flags for the account in Wialon.
-
-        :param flags: A Wialon account settings flag integer.
-        :type flags: int
-        :param block_balance: Balance required for account blocking. Default is ``0.00``.
-        :type block_balance: ~decimal.Decimal
-        :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 ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
-        :returns: An empty dictionary.
-        :rtype: dict[str, str]
-
-        """
-        return self.session.wialon_api.account_update_flags(
-            **{
-                "itemId": self.id,
-                "flags": flags,
-                "blockBalance": block_balance,
-                "denyBalance": deny_balance,
-            }
-        )
-
-    @requires_id
-    def set_plan(self, name: str) -> dict[str, str]:
-        """
-        Sets the account's billing plan to ``name``.
-
-        :param name: A Wialon billing plan name.
-        :type name: str
-        :raises AssertionError: If the Wialon account id wasn't set.
-        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
-        :returns: An empty dictionary.
-        :rtype: dict[str, str]
-
-        """
-        return self.session.wialon_api.account_update_plan(
-            **{"itemId": self.id, "plan": name}
-        )
-
-    @requires_id
-    def set_minimum_days(self, days: int) -> dict[str, str]:
-        """
-        Sets the account's minimum days to ``days`` in Wialon.
-
-        :param days: Minimum number of days as an integer.
-        :type days: int
-        :raises AssertionError: If the Wialon account id wasn't set.
-        :raises ~terminusgps.wialon.session.WialonAPIError: If something went wrong calling the Wialon API.
-        :returns: An empty dictionary.
-        :rtype: dict[str, str]
-
-        """
-        return self.session.wialon_api.account_update_min_days(
-            **{"itemId": self.id, "minDays": days}
-        )
-
-    @requires_id
-    def get_data(self, response_type: int = 1) -> dict[str, str]:
-        """
-        Returns account data from Wialon.
-
-        :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 ~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]
-
-        """
-        return self.session.wialon_api.account_get_account_data(
-            **{"itemId": self.id, "type": response_type}
-        )