python-terminusgps 24.1.0__py3-none-any.whl → 24.2.0__py3-none-any.whl

{python_terminusgps-24.1.0.dist-info → python_terminusgps-24.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 24.1.0
+Version: 24.2.0
 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-24.1.0.dist-info → python_terminusgps-24.2.0.dist-info}/RECORD

@@ -27,10 +27,10 @@ terminusgps/wialon/items/base.py,sha256=EAtzlnCvB7WTu3iX1bV1-S9TvwXc-Eez7e0X4TMi
 terminusgps/wialon/items/resource.py,sha256=qmQKEakJa9LH5YkI9-iBDA0hsotc5ctcwdb7kZuXdfQ,14549
 terminusgps/wialon/items/retranslator.py,sha256=8q9EDc92w92MElnHIeEzH3Ra4kiPXrx4t9V5nPDZuRU,3728
 terminusgps/wialon/items/route.py,sha256=PTJx1gmT_PGz7nlSSUS2VzjYD-aAuvkEOIdIFneUSSQ,1148
-terminusgps/wialon/items/unit.py,sha256=-jQL5Alvz77FZWteYNM9VNX15jtCufI-DWRRj3hRsgA,8539
-terminusgps/wialon/items/unit_group.py,sha256=vGVJMBY1BrKK0tP-C1DCIz4Bh6P-HKRnKY1g8g95UIs,5031
+terminusgps/wialon/items/unit.py,sha256=K0kmzFEInR3dAQVtMUA6M7KNy7HlD5IKl7f7YElr2sQ,9116
+terminusgps/wialon/items/unit_group.py,sha256=Stp-WfCGbOqcnxV6FU1AKtV7KIxIwCHa0NwhNJfgRoM,5032
 terminusgps/wialon/items/user.py,sha256=INwAibQVmjNNelepQXMfDevgJqMvIjHHgEjAMLRvhB0,7082
-python_terminusgps-24.1.0.dist-info/METADATA,sha256=s6KcarRL1pMhfGFwc2zK8Rhghm0Mah1N8kU5xViYnIU,946
-python_terminusgps-24.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_terminusgps-24.1.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-python_terminusgps-24.1.0.dist-info/RECORD,,
+python_terminusgps-24.2.0.dist-info/METADATA,sha256=bbVaXq63-hNzcN6anqXZROwwpiLiQCVGaysMjctFxRY,946
+python_terminusgps-24.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_terminusgps-24.2.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+python_terminusgps-24.2.0.dist-info/RECORD,,

terminusgps/wialon/items/unit.py

@@ -17,7 +17,9 @@ class WialonUnit(WialonBase):
         :type name: :py:obj:`str`
         :param hw_type_id: A Wialon hardware type ID.
         :type hw_type_id: :py:obj:`str` | :py:obj:`int`
-        :returns: The Wialon id for the new unit.
+        :raises ValueError: If ``creator_id`` is a :py:obj:`str` but not a digit.
+        :raises ValueError: If ``hw_type_id`` is a :py:obj:`str` but not a digit.
+        :returns: An id for the new unit.
         :rtype: :py:obj:`int` | :py:obj:`None`
 
         """
@@ -55,23 +57,36 @@ class WialonUnit(WialonBase):
             **{"id": self.id, "flags": flags.DATAFLAG_UNIT_POSITION}
         )
 
+    @property
+    def exists(self) -> bool:
+        """Whether or not the unit exists in Wialon."""
+        return bool(
+            self.session.wialon_api.core_search_item(
+                **{"id": self.id, "flags": flags.DATAFLAG_UNIT_BASE}
+            ).get("item", False)
+        )
+
     @property
     def available_commands(self) -> dict:
+        """Assigned commands to the unit."""
         return self.session.wialon_api.core_get_hw_cmds(
             **{"deviceTypeId": 0, "unitId": self.id}
         )
 
     @property
     def image_uri(self) -> str:
+        """An image URI for the unit."""
         return self._image_uri
 
     @property
     def imei_number(self) -> int | None:
+        """The unit's IMEI number."""
         if self._imei_number:
             return int(self._imei_number)
 
     @property
     def active(self) -> bool:
+        """Whether or not the unit is active."""
         if self._active:
             return bool(self._active)
         return False
@@ -85,7 +100,7 @@ class WialonUnit(WialonBase):
         param: dict | None = None,
     ) -> None:
         """
-        Executes a command on this Wialon unit.
+        Executes a command on the unit.
 
         :param name: A Wialon command name.
         :type name: :py:obj:`str`
@@ -115,7 +130,7 @@ class WialonUnit(WialonBase):
 
     def set_access_password(self, password: str) -> None:
         """
-        Sets a new access password for this Wialon unit.
+        Sets a new access password for the unit.
 
         :param password: A new access password.
         :type name: :py:obj:`str`
@@ -131,7 +146,7 @@ class WialonUnit(WialonBase):
 
     def activate(self) -> None:
         """
-        Activates this Wialon unit.
+        Activates the unit.
 
         :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
@@ -145,7 +160,7 @@ class WialonUnit(WialonBase):
 
     def deactivate(self) -> None:
         """
-        Deactivates this Wialon unit.
+        Deactivates the unit.
 
         :raises WialonError: If something goes wrong with Wialon.
         :returns: Nothing.
@@ -159,7 +174,7 @@ class WialonUnit(WialonBase):
 
     def assign_phone(self, phone: str) -> None:
         """
-        Assigns a phone number to this Wialon unit.
+        Assigns a phone number to the unit.
 
         :param phone: A phone number beginning with a country code.
         :type phone: :py:obj:`str`

terminusgps/wialon/items/unit_group.py

@@ -120,10 +120,11 @@ class WialonUnitGroup(WialonBase):
 def main() -> None:
     import logging
 
-    from django.utils import timezone
     from django.conf import settings
-    from terminusgps.wialon.session import WialonSession
+    from django.utils import timezone
+
     from terminusgps.wialon.items import WialonUnit
+    from terminusgps.wialon.session import WialonSession
     from terminusgps.wialon.utils import get_hw_type_id
 
     timestamp = f"{timezone.now():%Y_%m_%d_%H:%M:%S}"