python-terminusgps 1.15.1__tar.gz → 1.15.3__tar.gz

{python_terminusgps-1.15.1 → python_terminusgps-1.15.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 1.15.1
+Version: 1.15.3
 Summary: Provides abstractions/utilities for working with Wialon API, Authorize.NET API, AWS API, and more.
 Project-URL: Documentation, https://app.terminusgps.com/docs/apps/python-terminusgps/index.html
 Project-URL: Repository, https://github.com/terminusgps/python-terminusgps

{python_terminusgps-1.15.1 → python_terminusgps-1.15.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "1.15.1"
+version = "1.15.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-1.15.1 → python_terminusgps-1.15.3}/terminusgps/wialon/items/resource.py

@@ -21,10 +21,34 @@ class WialonResource(WialonBase):
         return response.get("item", {}).get("id")
 
     def delete(self) -> None:
-        if self.is_account:
-            self.delete_account()
-            return
-        super().delete()
+        """
+        Deletes all micro-objects assigned to the resource.
+
+        If the resource is an account, instead deletes all macro-objects and micro-objects assigned to the account.
+
+        :returns: Nothing.
+        :rtype: :py:obj:`None`
+
+        """
+        self.delete_account() if self.is_account else super().delete()
+
+    @property
+    def is_dealer(self) -> bool:
+        """
+        Whether or not the resource/account has dealer rights.
+
+        If the resource is **not** an account, this always returns :py:obj:`False`.
+
+        :type: :py:obj:`bool`
+
+        """
+        if not self.is_account:
+            return False  # Resources cannot have dealer rights
+        return bool(
+            self.session.wialon_api.get_account_data(
+                **{"itemId": self.id, "type": 1}
+            ).get("dealerRights")
+        )
 
     @property
     def is_account(self) -> bool:
@@ -60,6 +84,8 @@ class WialonResource(WialonBase):
         """
         Sets dealer rights on the account.
 
+        You **probably don't** need to use this method.
+
         :param enabled: :py:obj:`True` to enable dealer rights, :py:obj:`False` to disable dealer rights. Default is :py:obj:`False`.
         :type enabled: :py:obj:`bool`
         :raises AssertionError: If the resource is not an account.
@@ -123,6 +149,7 @@ class WialonResource(WialonBase):
         self.session.wialon_api.account_create_account(
             **{"itemId": self.id, "plan": billing_plan}
         )
+        self.set_settings_flags()
 
     def delete_account(self) -> None:
         """

python_terminusgps-1.15.3/terminusgps/wialon/utils.py

@@ -0,0 +1,175 @@
+import secrets
+import string
+import warnings
+from typing import Type
+
+from terminusgps.wialon import items, flags
+from terminusgps.wialon.items.base import WialonBase
+from terminusgps.wialon.session import WialonSession
+
+
+def get_hw_type_id(name: str, session: WialonSession) -> int | None:
+    """
+    Takes a Wialon hardware type name and returns its id, if it exists.
+
+    :param name: The name of a Wialon hardware type.
+    :type name: :py:obj:`str`
+    :param session: A valid Wialon API session.
+    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :raises WialonError: If something goes wrong with Wialon.
+    :returns: A Wialon hardware type id, if it was found.
+    :rtype: :py:obj:`int` | :py:obj:`None`
+
+    """
+    response = session.wialon_api.core_get_hw_types(
+        **{
+            "filterType": "id",
+            "filterValue": "name,id",
+            "includeType": "true",
+            "ignoreRename": "true",
+        }
+    )
+    hw_types = {item.get("name"): item.get("id") for item in response}
+    return int(hw_types.get(name)) if name in hw_types.keys() else None
+
+
+def get_id_from_iccid(iccid: str, session: WialonSession) -> str | None:
+    """
+    Takes a Wialon unit's IMEI # and returns its unit id, if it exists.
+
+    :param iccid: A unique id.
+    :type iccid: :py:obj:`str`
+    :param session: A valid Wialon API session.
+    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :raises WialonError: If something goes wrong with Wialon.
+    :returns: A Wialon object id, if it was found.
+    :rtype: :py:obj:`str` | :py:obj:`None`
+
+    """
+    response = session.wialon_api.core_search_items(
+        **{
+            "spec": {
+                "itemsType": "avl_unit",
+                "propName": "rel_admin_field_value",
+                "propValueMask": str(iccid),
+                "sortType": "admin_fields",
+                "propType": "adminfield",
+                "or_logic": 0,
+            },
+            "force": 0,
+            "flags": flags.DATAFLAG_UNIT_BASE,
+            "from": 0,
+            "to": 0,
+        }
+    )
+
+    if response.get("totalItemsCount", 0) == 1:
+        return response["items"][0].get("id")
+
+
+def get_wialon_cls(items_type: str) -> Type[WialonBase]:
+    """
+    Returns a Wialon object class based on items_type.
+
+    :param items_type: A Wialon object type.
+    :type items_type: :py:obj:`str`
+    :returns: A subclass of :py:obj:`~terminusgps.wialon.items.base.WialonBase`.
+    :rtype: :py:obj:`~terminusgps.wialon.items.base.WialonBase`
+
+    """
+    match items_type:
+        case "user":
+            wialon_cls = items.WialonUser
+        case "avl_unit":
+            wialon_cls = items.WialonUnit
+        case "avl_unit_group":
+            wialon_cls = items.WialonUnitGroup
+        case "avl_resource":
+            wialon_cls = items.WialonResource
+        case _:
+            raise ValueError(f"Invalid items_type '{items_type}'")
+    return wialon_cls
+
+
+def is_unique(value: str, session: WialonSession, items_type: str = "avl_unit") -> bool:
+    """
+    Determines if the value is unique among Wialon objects of type 'items_type'.
+
+    :param value: A value whose uniqueness is unknown.
+    :type value: :py:obj:`str`
+    :param session: A valid Wialon API session.
+    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :param items_type: The type of Wialon objects to validate the value against. Default is ``"avl_unit"``.
+    :type items_type: :py:obj:`str`
+    :returns: Whether or not the value is unique among 'items_type'.
+    :rtype: :py:obj:`bool`
+
+
+    """
+    result = session.wialon_api.core_check_unique(
+        **{"type": items_type, "value": value.strip()}
+    ).get("result")
+    return not bool(result)
+
+
+def gen_wialon_password(length: int = 32) -> str:
+    """
+    DEPRECATED: Use :py:func:`~terminusgps.wialon.utils.generate_wialon_password` instead.
+
+    Generates a Wialon compliant password of random characters.
+
+    Password length can be between ``8`` and ``64`` characters.
+
+    :param length: Length of the generated password. Default is ``32``.
+    :type length: :py:obj:`int`
+    :raises ValueError: If the provided length is invalid.
+    :returns: A Wialon compliant password.
+    :rtype: :py:obj:`str`
+
+    """
+    warnings.warn(
+        "gen_wialon_password is deprecated and will be removed in a future version. Use generate_wialon_password instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return generate_wialon_password(length)
+
+
+def generate_wialon_password(length: int = 32) -> str:
+    """
+    Generates a Wialon compliant password of random characters.
+
+    Password length can be between ``8`` and ``64`` characters.
+
+    :param length: Length of the generated password. Default is ``32``.
+    :type length: :py:obj:`int`
+    :raises ValueError: If the provided length is invalid.
+    :returns: A Wialon compliant password.
+    :rtype: :py:obj:`str`
+
+    """
+    min_length, max_length = 8, 64
+    if length > max_length:
+        raise ValueError(
+            f"Password cannot be greater than {max_length} characters in length. Got {length}."
+        )
+    elif length < min_length:
+        raise ValueError(
+            f"Password cannot be less than {min_length} 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-1.15.1 → python_terminusgps-1.15.3}/uv.lock

@@ -504,7 +504,7 @@ wheels = [
 
 [[package]]
 name = "python-terminusgps"
-version = "1.15.1"
+version = "1.15.3"
 source = { editable = "." }
 dependencies = [
     { name = "argparse" },

python_terminusgps-1.15.1/terminusgps/wialon/utils.py

@@ -1,113 +0,0 @@
-import secrets
-import string
-
-from typing import Any
-from .session import WialonSession
-from .flags import DATAFLAG_UNIT_BASE
-
-from terminusgps.wialon.items import (
-    WialonUser,
-    WialonUnit,
-    WialonUnitGroup,
-    WialonResource,
-)
-
-
-def get_hw_type_id(name: str, session: WialonSession) -> int | None:
-    response = session.wialon_api.core_get_hw_types(
-        **{
-            "filterType": "id",
-            "filterValue": "name,id",
-            "includeType": "true",
-            "ignoreRename": "true",
-        }
-    )
-    hw_types = {item.get("name"): item.get("id") for item in response}
-    return int(hw_types.get(name)) if name in hw_types.keys() else None
-
-
-def get_wialon_cls(items_type: str) -> Any:
-    """Returns a Wialon object class based on items_type."""
-    match items_type:
-        case "user":
-            wialon_cls = WialonUser
-        case "avl_unit":
-            wialon_cls = WialonUnit
-        case "avl_unit_group":
-            wialon_cls = WialonUnitGroup
-        case "avl_resource":
-            wialon_cls = WialonResource
-        case _:
-            raise ValueError(f"Invalid items_type '{items_type}'")
-    return wialon_cls
-
-
-def is_unique(value: str, session: WialonSession, items_type: str = "avl_unit") -> bool:
-    """Determines if the value is unique among Wialon objects of type 'items_type'."""
-    result = session.wialon_api.core_check_unique(
-        **{"type": items_type, "value": value.strip()}
-    ).get("result")
-    return not bool(result)
-
-
-def gen_wialon_password(length: int = 32) -> str:
-    """Generates a Wialon compliant password."""
-    min_length, max_length = 4, 64
-    if length > max_length:
-        raise ValueError(
-            f"Password cannot be greater than {max_length} characters in length. Got {length}."
-        )
-    elif length < min_length:
-        raise ValueError(
-            f"Password cannot be less than {min_length} 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_id_from_iccid(iccid: str, session: WialonSession) -> str | None:
-    """Takes a Wialon unit's IMEI # and returns its unit id, if it exists."""
-    response = session.wialon_api.core_search_items(
-        **{
-            "spec": {
-                "itemsType": "avl_unit",
-                "propName": "rel_admin_field_value",
-                "propValueMask": str(iccid),
-                "sortType": "admin_fields",
-                "propType": "adminfield",
-                "or_logic": 0,
-            },
-            "force": 0,
-            "flags": DATAFLAG_UNIT_BASE,
-            "from": 0,
-            "to": 0,
-        }
-    )
-
-    if response.get("totalItemsCount", 0) == 1:
-        return response["items"][0].get("id")
-
-
-def main() -> None:
-    with WialonSession() as session:
-        wialon_id = get_id_from_iccid("89015809000307608963", session)
-        print(f"{wialon_id = }")
-    return
-
-
-if __name__ == "__main__":
-    main()