python-terminusgps 49.2.0__tar.gz → 50.0.0__tar.gz

{python_terminusgps-49.2.0 → python_terminusgps-50.0.0}/PKG-INFO

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

{python_terminusgps-49.2.0 → python_terminusgps-50.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "49.2.0"
+version = "50.0.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.2.0 → python_terminusgps-50.0.0}/terminusgps/authorizenet/constants.py

@@ -4,6 +4,24 @@ from django.db import models
 from django.utils.translation import gettext_lazy as _
 
 
+class BankAccountType(models.TextChoices):
+    CHECKING = "checking", _("Checking account")
+    """Checking account."""
+    SAVINGS = "savings", _("Savings account")
+    """Savings account."""
+    BUSINESS_CHECKING = "businessChecking", _("Business checking account")
+    """Business checking account."""
+
+
+class ECheckType(models.TextChoices):
+    PPD = "PPD", _("Prearranged Payment and Deposit Entry")
+    """Prearranged Payment and Deposit Entry."""
+    TEL = "TEL", _("Telephone-Initiated Entry")
+    """Telephone-Initiated Entry."""
+    WEB = "WEB", _("Web-Initiated Entry")
+    """Web-Initiated Entry."""
+
+
 class CreditCardType(models.TextChoices):
     AMEX = apicontractsv1.cardTypeEnum.AmericanExpress, _("American Express")
     """American express card."""

{python_terminusgps-49.2.0 → python_terminusgps-50.0.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.0.0/terminusgps/wialon/utils.py

@@ -0,0 +1,180 @@
+import secrets
+import string
+
+from terminusgps.wialon.session import WialonSession
+
+
+def get_id_from_iccid(
+    iccid: str,
+    session: WialonSession,
+    *,
+    use_cache: bool = True,
+    afield_key: str = "iccid",
+) -> int | None:
+    """
+    Returns a Wialon unit ID 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 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.
+    :returns: A Wialon unit ID, if found.
+    :rtype: int | None
+
+    """
+    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": 1,
+            "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 int(response["items"][0]["id"])
+
+
+def get_id_from_imei(
+    imei: str, session: WialonSession, *, use_cache: bool = True
+) -> int | None:
+    """
+    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 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.
+    :returns: A Wialon unit ID, if found.
+    :rtype: int | None
+
+    """
+    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": 1,
+            "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 int(response["items"][0]["id"])
+
+
+def get_ids_from_carrier(
+    carrier: str,
+    session: WialonSession,
+    *,
+    use_cache: bool = True,
+    afield_key: str = "carrier",
+) -> list[int]:
+    """
+    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
+    :returns: A list of Wialon unit IDs, if any were found.
+    :rtype: list[int]
+
+    """
+    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": 1,
+            "from": 0,
+            "to": 0,
+        }
+    )
+    if int(response["totalItemsCount"]) == 0:
+        return []
+    return [int(unit["id"]) for unit in response["items"]]
+
+
+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

{python_terminusgps-49.2.0 → python_terminusgps-50.0.0}/uv.lock

@@ -128,11 +128,11 @@ wheels = [
 
 [[package]]
 name = "asgiref"
-version = "3.10.0"
+version = "3.11.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/46/08/4dfec9b90758a59acc6be32ac82e98d1fbfc321cb5cfa410436dbacf821c/asgiref-3.10.0.tar.gz", hash = "sha256:d89f2d8cd8b56dada7d52fa7dc8075baa08fb836560710d38c292a7a3f78c04e", size = 37483 }
+sdist = { url = "https://files.pythonhosted.org/packages/76/b9/4db2509eabd14b4a8c71d1b24c8d5734c52b8560a7b1e1a8b56c8d25568b/asgiref-3.11.0.tar.gz", hash = "sha256:13acff32519542a1736223fb79a715acdebe24286d98e8b164a73085f40da2c4", size = 37969 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/17/9c/fc2331f538fbf7eedba64b2052e99ccf9ba9d6888e2f41441ee28847004b/asgiref-3.10.0-py3-none-any.whl", hash = "sha256:aef8a81283a34d0ab31630c9b7dfe70c812c95eba78171367ca8745e88124734", size = 24050 },
+    { url = "https://files.pythonhosted.org/packages/91/be/317c2c55b8bbec407257d45f5c8d1b6867abc76d12043f2d3d58c538a4ea/asgiref-3.11.0-py3-none-any.whl", hash = "sha256:1db9021efadb0d9512ce8ffaf72fcef601c7b73a8807a1bb2ef143dc6b14846d", size = 24096 },
 ]
 
 [[package]]
@@ -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.2.0"
+version = "50.0.0"
 source = { editable = "." }
 dependencies = [
     { name = "authorizenet" },
@@ -979,11 +979,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 +1006,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.2.0/terminusgps/wialon/items/__init__.py

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

python_terminusgps-49.2.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}
-        )