python-terminusgps 1.16.0__tar.gz → 1.17.1__tar.gz

{python_terminusgps-1.16.0 → python_terminusgps-1.17.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 1.16.0
+Version: 1.17.1
 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.16.0 → python_terminusgps-1.17.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-terminusgps"
-version = "1.16.0"
+version = "1.17.1"
 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.16.0 → python_terminusgps-1.17.1}/terminusgps/wialon/items/__init__.py

@@ -1,3 +1,4 @@
+from .notification import WialonNotification
 from .resource import WialonResource
 from .retranslator import WialonRetranslator
 from .route import WialonRoute

python_terminusgps-1.17.1/terminusgps/wialon/items/notification.py

@@ -0,0 +1,4 @@
+from terminusgps.wialon.items.base import WialonBase
+
+
+class WialonNotification(WialonBase): ...

{python_terminusgps-1.16.0 → python_terminusgps-1.17.1}/terminusgps/wialon/session.py

@@ -367,16 +367,3 @@ class WialonSessionManager:
             if not self._session:
                 self._session = WialonSession(sid=sid, log_level=log_level)
         return self._session
-
-
-def main() -> None:
-    from terminusgps.wialon.items import WialonUnit
-
-    with WialonSession(log_level=logging.DEBUG) as session:
-        unit = WialonUnit(id="28082258", session=session)
-        unit.add_cfield(("to_number", "+17133049421"))
-    return
-
-
-if __name__ == "__main__":
-    main()

{python_terminusgps-1.16.0 → python_terminusgps-1.17.1}/terminusgps/wialon/utils.py

@@ -91,6 +91,29 @@ def get_wialon_cls(items_type: str) -> typing.Type[WialonBase]:
     return wialon_cls
 
 
+def get_vin_info(vin_number: str, session: WialonSession) -> dict:
+    """
+    Retrieves vehicle data from a VIN number.
+
+    :param value: A vehicle's VIN number.
+    :type value: :py:obj:`str`
+    :param session: A valid Wialon API session.
+    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :returns: A dictionary of vehicle information, if any was found.
+    :rtype: :py:obj:`dict`
+
+    """
+    response = session.wialon_api.unit_get_vin_info(**{"vin": vin_number}).get(
+        "vin_lookup_result"
+    )
+
+    return (
+        {field.get("n"): field.get("v") for field in response.get("pflds")}
+        if "error" not in response.keys()
+        else {}
+    )
+
+
 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'.
@@ -104,7 +127,6 @@ def is_unique(value: str, session: WialonSession, items_type: str = "avl_unit")
     :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()}
@@ -173,13 +195,3 @@ def gen_wialon_password(length: int = 32) -> str:
         stacklevel=2,
     )
     return generate_wialon_password(length)
-
-
-__all__ = [
-    "get_hw_type_id",
-    "get_id_from_iccid",
-    "get_wialon_cls",
-    "is_unique",
-    "generate_wialon_password",
-    "gen_wialon_password",
-]

{python_terminusgps-1.16.0 → python_terminusgps-1.17.1}/uv.lock

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

python_terminusgps-1.16.0/terminusgps/wialon/items/notification.py

@@ -1,33 +0,0 @@
-from terminusgps.wialon.items.base import WialonBase
-
-
-class WialonNotification(WialonBase):
-    def create(
-        self,
-        resource_id: str | int,
-        name: str,
-        activation_time: int,
-        deactivation_time: int,
-        text: str | None = None,
-        max_alarms: int = 0,
-        interval: int = 0,
-        lang: str = "en",
-    ) -> int | None:
-        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.resource_update_notification(
-            **{
-                "itemId": resource_id,
-                "id": 0,
-                "callMode": "create",
-                "n": name,
-                "txt": text if text else name,
-                "ta": activation_time,
-                "td": deactivation_time,
-                "ma": max_alarms,
-                "mmtd": interval,
-                "la": lang,
-            }
-        )
-        return int(response[0].get("id")) if response else None