python-terminusgps 20.6.2__py3-none-any.whl → 20.7.0__py3-none-any.whl

{python_terminusgps-20.6.2.dist-info → python_terminusgps-20.7.0.dist-info}/METADATA

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

@@ -19,17 +19,15 @@ terminusgps/wialon/flags.py,sha256=_NIL3mrEGhvI5YISVjimjYtUatdgOqhZPJX368MtKSU,1
 terminusgps/wialon/logger.py,sha256=nUBsaLMaffSaAHGHAM6mFXDzix9hbNecVtA3INVtii8,968
 terminusgps/wialon/session.py,sha256=6xg65LZz6cebWclTQp1KRLvPss0aM-bWhAmmwiDOlMg,10267
 terminusgps/wialon/utils.py,sha256=IN45hASI6iP3Wd35ejGeoIYDIQ_w65-W05eVUdWFRxo,5712
-terminusgps/wialon/items/__init__.py,sha256=cfUC5sfVsTwmpgsR-w9wA4ay6_EZYAPgEeuw2k06RJM,256
+terminusgps/wialon/items/__init__.py,sha256=3BVthghekMvhMQSzQgBMlD_phxmKSmp3Zvmo-z0O8Bs,211
 terminusgps/wialon/items/base.py,sha256=EAtzlnCvB7WTu3iX1bV1-S9TvwXc-Eez7e0X4TMiK9U,6943
-terminusgps/wialon/items/geofence.py,sha256=LOjWWtRpAFMhE_16SU4sqNEZphmswpeTNtiFCZBB5Ig,1740
-terminusgps/wialon/items/notification.py,sha256=6IrswN6fdEkJErIqtMq45bTl9xVARQw8nokDsy3x1MA,97
-terminusgps/wialon/items/resource.py,sha256=79SwbCyE1zlaoeBfU0erEqvqBAYUC4KAKs8AOLJqflU,9652
+terminusgps/wialon/items/resource.py,sha256=z264-upqaAWjrI7Mv2Ryy8yRy7XQLBR26GCCswLsdx4,13567
 terminusgps/wialon/items/retranslator.py,sha256=8q9EDc92w92MElnHIeEzH3Ra4kiPXrx4t9V5nPDZuRU,3728
 terminusgps/wialon/items/route.py,sha256=PTJx1gmT_PGz7nlSSUS2VzjYD-aAuvkEOIdIFneUSSQ,1148
-terminusgps/wialon/items/unit.py,sha256=sXgEW3mbGgHCI9-lD69voy8yiKv39rKJei6ybYODKpM,8531
+terminusgps/wialon/items/unit.py,sha256=K5IoGSRoH_JiAZoKK6Wb9DToaDScaL7mPKqSOAwtg0A,8618
 terminusgps/wialon/items/unit_group.py,sha256=vGVJMBY1BrKK0tP-C1DCIz4Bh6P-HKRnKY1g8g95UIs,5031
 terminusgps/wialon/items/user.py,sha256=INwAibQVmjNNelepQXMfDevgJqMvIjHHgEjAMLRvhB0,7082
-python_terminusgps-20.6.2.dist-info/METADATA,sha256=zWNeCwUyy0L3XVwB8vizM3tACdq1P8sO8OmQBPEDFlE,912
-python_terminusgps-20.6.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_terminusgps-20.6.2.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-python_terminusgps-20.6.2.dist-info/RECORD,,
+python_terminusgps-20.7.0.dist-info/METADATA,sha256=_VCihk48_Dh60rQSGjKm-PP6A26obKdUENWPQCij17E,912
+python_terminusgps-20.7.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_terminusgps-20.7.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+python_terminusgps-20.7.0.dist-info/RECORD,,

terminusgps/wialon/items/__init__.py

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

terminusgps/wialon/items/resource.py

@@ -1,9 +1,13 @@
+from urllib.parse import quote_plus
+
 from terminusgps.wialon import flags
 from terminusgps.wialon.items.base import WialonBase
 
 
 class WialonResource(WialonBase):
-    def create(self, creator_id: str | int, name: str) -> int | None:
+    def create(
+        self, creator_id: str | int, name: str, skip_creator_check: bool = False
+    ) -> int | None:
         """
         Creates a new Wialon resource.
 
@@ -11,6 +15,8 @@ class WialonResource(WialonBase):
         :type creator_id: :py:obj:`int` | :py:obj:`str`
         :param name: A name for the resource.
         :type name: :py:obj:`str`
+        :param skip_creator_check: Bypass object creation restrictions while creating the resource.
+        :type skip_creator_check: :py:obj:`bool`
         :raises ValueError: If ``creator_id`` is not a digit.
         :raises WialonError: If something goes wrong with Wialon.
         :returns: The Wialon id for the new resource, if it was created.
@@ -25,6 +31,7 @@ class WialonResource(WialonBase):
                 "creatorId": creator_id,
                 "name": name,
                 "dataFlags": flags.DATAFLAG_UNIT_BASE,
+                "skipCreatorCheck": int(skip_creator_check),
             }
         )
         return int(response.get("item", {}).get("id")) if response.get("item") else None
@@ -272,3 +279,106 @@ class WialonResource(WialonBase):
                 "denyBalance": deny_balance_val,
             }
         )
+
+    def create_driver(
+        self,
+        name: str,
+        code: str = "",
+        desc: str = "",
+        phone: str = "",
+        mobile_auth_code: str = "",
+        image_checksum: str = "",
+        image_ratio: str = "",
+        custom_fields: dict[str, str] | None = None,
+    ) -> None:
+        """
+        Creates a driver for the resource.
+
+        :param name: A name for the new driver.
+        :type name: :py:obj:`str`
+        :param code: A unique code for the new driver.
+        :type code: :py:obj:`str`
+        :param desc: Description for the driver.
+        :type desc: :py:obj:`str`
+        :param phone: A phone number beginning in a country code. No spaces.
+        :type phone: :py:obj:`str`
+        :param mobile_auth_code: Authentication code for Wialon mobile app.
+        :type mobile_auth_code: :py:obj:`str`
+        :param image_checksum: Checksum for driver image.
+        :type image_checksum: :py:obj:`str`
+        :param image_ratio: Driver image aspect ratio.
+        :type image_ratio: :py:obj:`float` | :py:obj:`None`
+        :param custom_fields: Additional custom fields to add to the driver.
+        :type custom_fields: :py:obj:`dict` | :py:obj:`None`
+        :raises WialonError: If something goes wrong calling the Wialon API.
+        :returns: Nothing.
+        :rtype: :py:obj:`None`
+
+        """
+        params = {
+            "itemId": self.id,
+            "id": 0,
+            "callMode": "create",
+            "ej": {"apps": []},
+            "c": code,
+            "ds": desc,
+            "n": name,
+            "f": 1,
+            "pwd": mobile_auth_code,
+        }
+
+        if phone:
+            params.update({"p": quote_plus(phone)})
+        if custom_fields:
+            params.update({"jp": custom_fields})
+        response = self.session.wialon_api.resource_update_driver(**params)
+        print(f"{response = }")
+
+    def create_passenger(
+        self,
+        name: str,
+        code: str,
+        phone: str = "",
+        timezone: int | None = None,
+        image_checksum: str = "",
+        image_ratio: float | None = None,
+        custom_fields: dict[str, str] | None = None,
+    ) -> None:
+        """
+        Creates a passenger/tag for the resource.
+
+        :param name: A name for the new passenger.
+        :type name: :py:obj:`str`
+        :param code: A unique code for the new passenger.
+        :type code: :py:obj:`str`
+        :param phone: A phone number beginning in a country code. No spaces.
+        :type phone: :py:obj:`str`
+        :param timezone: A timezone integer.
+        :type timezone: :py:obj:`int` | :py:obj:`None`
+        :param image_checksum: Checksum for passenger image.
+        :type image_checksum: :py:obj:`str`
+        :param image_ratio: Passenger image aspect ratio.
+        :type image_ratio: :py:obj:`float` | :py:obj:`None`
+        :param custom_fields: Additional custom fields to add to the passenger.
+        :type custom_fields: :py:obj:`dict` | :py:obj:`None`
+        :raises WialonError: If something goes wrong calling the Wialon API.
+        :returns: Nothing.
+        :rtype: :py:obj:`None`
+
+        """
+        params = {
+            "itemId": self.id,
+            "id": 0,
+            "callMode": "create",
+            "c": code,
+            "ck": image_checksum,
+            "r": image_ratio,
+            "n": name,
+        }
+        if phone:
+            params.update({"p": quote_plus(phone)})
+        if timezone:
+            params.update({"tz": timezone})
+        if custom_fields:
+            params.update({"jp": custom_fields})
+        self.session.wialon_api.resource_update_tag(**params)

terminusgps/wialon/items/unit.py

@@ -199,6 +199,7 @@ class WialonUnit(WialonBase):
         return list(dict.fromkeys(phone_numbers))  # Removes duplicate phone numbers
 
     def clean_phone_numbers(self, phones: list[str]) -> list[str]:
+        """Takes a list of phone numbers and returns a list of clean phone numbers."""
         cleaned_phones = []
         for num in phones:
             if "," in num:

terminusgps/wialon/items/geofence.py

@@ -1,60 +0,0 @@
-from django.db import models
-
-from terminusgps.wialon.items.base import WialonBase
-
-
-class WialonGeofence(WialonBase):
-    def __new__(cls) -> "WialonGeofence":
-        raise NotImplementedError()
-
-    class WialonGeofenceShape(models.IntegerChoices):
-        LINE = 1
-        POLYGON = 2
-        CIRCLE = 3
-
-    class WialonGeofenceColor(models.IntegerChoices):
-        RED = int("ff0000", 16)
-        ORANGE = int("ff7b00", 16)
-        YELLOW = int("fffb00", 16)
-        GREEN = int("20ff00", 16)
-        BLUE = int("0090ff", 16)
-        PURPLE = int("7000ff", 16)
-        WHITE = int("f3f3f3", 16)
-        BLACK = int("030303", 16)
-
-    def create(
-        self,
-        resource_id: str | int,
-        name: str,
-        xpos: float,
-        ypos: float,
-        desc: str | None = None,
-        shape: int = WialonGeofenceShape.CIRCLE,
-        width: int = 100,
-        flags: int = 0x04,
-        color: int = WialonGeofenceColor.GREEN,
-        text_color: int = WialonGeofenceColor.BLACK,
-        text_size: int = 12,
-        min_zoom: int = 2,
-        max_zoom: int = 19,
-    ) -> int | None:
-        response = self.session.wialon_api.resource_update_zone(
-            **{
-                "itemId": resource_id,
-                "id": 0,
-                "callMode": "create",
-                "n": name,
-                "d": desc if desc else name,
-                "t": shape,
-                "w": width,
-                "f": flags,
-                "c": color,
-                "tc": text_color,
-                "ts": text_size,
-                "min": min_zoom,
-                "max": max_zoom,
-                "p": [{"x": xpos, "y": ypos, "r": width}],
-            }
-        )
-        if response:
-            return int(response[0])

terminusgps/wialon/items/notification.py

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