python-terminusgps 28.11.0__py3-none-any.whl → 29.0.0__py3-none-any.whl

{python_terminusgps-28.11.0.dist-info → python_terminusgps-29.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 28.11.0
+Version: 29.0.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
@@ -17,5 +17,7 @@ Requires-Dist: authorizenet>=1.1.5
 Requires-Dist: boto3>=1.34.144
 Requires-Dist: django>=5.1.5
 Requires-Dist: matplotlib>=3.10.1
+Requires-Dist: opencv-python>=4.11.0.86
+Requires-Dist: pandas>=2.2.3
 Requires-Dist: python-wialon>=1.2.4
 Requires-Dist: twilio>=9.4.5

{python_terminusgps-28.11.0.dist-info → python_terminusgps-29.0.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
 terminusgps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-terminusgps/mixins.py,sha256=r6_I9D_7cX6_ZlkYp2GySu_2gywzhvs1lePFFf3dDYA,981
+terminusgps/mixins.py,sha256=jzs_dH_YDmohH86I3uPnN-66C9OPVXaDPVdRHXA6vdk,940
 terminusgps/settings.py,sha256=vY5yNjyMu-7Ya0bIPWUvrrSLERtxHGdkfeoY4Ul6cP0,613
-terminusgps/validators.py,sha256=4qGYSNXje-8SstuRsKYF9RH7-0B1v0xjRuYDHFaz9eg,2278
+terminusgps/validators.py,sha256=KxXw8NlN1-h1WN8RkWz_E8XI2imXb7dIQ6hVhhxctIg,3638
 terminusgps/authorizenet/__init__.py,sha256=LiGLlWNNiqS7RSOP4Apabx-b9EBYyNbxRY_a0mvJoaE,466
 terminusgps/authorizenet/auth.py,sha256=ICxPPzoUc64VbsIIemEWKrn8xjHGwbNdo2VbtaFCFss,1107
 terminusgps/authorizenet/errors.py,sha256=HG5NwVxQCtOYidVl30y49PC0Ovw5VYdsy9wTgUFMw9M,949
@@ -15,24 +15,26 @@ terminusgps/authorizenet/profiles/subscriptions.py,sha256=N4_0kbBBJ0FtKdIydN8FLn
 terminusgps/aws/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 terminusgps/aws/connect.py,sha256=TWf2bVz6LqSNQfVD7FKRn3K71VuLOwBj05Gs-9BsROg,693
 terminusgps/aws/secrets.py,sha256=MxQEmmBLpMUQ2tYAsHdCYf-7RZ84LiogdKcTsACX5dw,361
+terminusgps/opencv/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+terminusgps/opencv/barcode_scanner.py,sha256=VwebCfo-T0ORCdJ1YX46dVNt8HwwbtHQ-32m7tBbhH4,167
 terminusgps/twilio/__init__.py,sha256=dYo41F2jft_eHDWSUtSpKGSRG1bewq_qClqilUJZkYM,33
 terminusgps/twilio/caller.py,sha256=TiQ4f0TDDC35he1M1iSsBM2vutdGriwtV4pc17T--6I,3552
 terminusgps/twilio/validators.py,sha256=nn7CCBTktNjcln6M4MR0ACxEsClgioSu89LRLgIiBZk,1112
 terminusgps/wialon/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-terminusgps/wialon/constants.py,sha256=n1ux68oWYWnzeZdN811Iw_Lk78KBM0YMJMoonn67uZY,1723
-terminusgps/wialon/flags.py,sha256=_NIL3mrEGhvI5YISVjimjYtUatdgOqhZPJX368MtKSU,13959
+terminusgps/wialon/constants.py,sha256=TgwQjUEQZXXDewepGCVCDIkL6RELI53GouM8qq2RM_M,1805
+terminusgps/wialon/flags.py,sha256=O3oeJ5Thhv5ULnoEFNuvvWhqTf8xb6AtIwRci61UyJI,26098
 terminusgps/wialon/logger.py,sha256=nUBsaLMaffSaAHGHAM6mFXDzix9hbNecVtA3INVtii8,968
 terminusgps/wialon/session.py,sha256=THl88yfVBfRH8daKh1lmLSR8ro8TbyOokHx1Cev-En8,9638
-terminusgps/wialon/utils.py,sha256=qhfO8BtCctd5WtJ6qA5poSpNlefVNA2q2l3S6t5FfTc,7753
+terminusgps/wialon/utils.py,sha256=fGl41EItDxqq9JGDKoU50zfELjfab2XjVfIXy5RvRio,6343
 terminusgps/wialon/items/__init__.py,sha256=3BVthghekMvhMQSzQgBMlD_phxmKSmp3Zvmo-z0O8Bs,211
-terminusgps/wialon/items/base.py,sha256=GCSzhDc3bk-jltWYNL60BEYCeSNRsPWos5aeFvgye8Y,7208
-terminusgps/wialon/items/resource.py,sha256=vNR6hJmf23RxsqXpDhM0dODbQB8KKTKcy6ncjpEZty8,14610
-terminusgps/wialon/items/retranslator.py,sha256=vauuaLoEdKQF0FnOvJfksmLKsIlxvGZxt80dLTh3SVs,3789
-terminusgps/wialon/items/route.py,sha256=8SzlqNmpYVdt-ZAY--B_KHoDIHgN0Zb7KBsBWAzoz3s,1209
-terminusgps/wialon/items/unit.py,sha256=i7sQiRu3N0XxyTHVN2RnmjYy9X48KdnZLSB18ic37w8,9363
-terminusgps/wialon/items/unit_group.py,sha256=YsYh34l2DjSKcv5SIZkEVi5FSjveGB1gxU2fwdLyvl4,4101
-terminusgps/wialon/items/user.py,sha256=PFYBie04F16YE2B5364PLxkmlTmQr4sZXpItvRBxsDc,7143
-python_terminusgps-28.11.0.dist-info/METADATA,sha256=EiJNW0h7a2jgPPjIEQ8bYo2BvlcAmMKqnXkuVMp6vW0,947
-python_terminusgps-28.11.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_terminusgps-28.11.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-python_terminusgps-28.11.0.dist-info/RECORD,,
+terminusgps/wialon/items/base.py,sha256=rwKaXd6vcHPNJ2cwBeeX8VYMJiDig_f4hFThAwkhwZk,7247
+terminusgps/wialon/items/resource.py,sha256=wfUxACO4OdzT2IdCF9oBmU_7nYiH3Xvs6BripPD5IMI,14622
+terminusgps/wialon/items/retranslator.py,sha256=sVEWrp8q1I-tO_rMTCH7TeQDDbZryIq8d9KVnhYyhH0,3795
+terminusgps/wialon/items/route.py,sha256=amNPKZqgl8pEzKA_XJudnvBPzEsfHTmrC7uF15sZVI4,1216
+terminusgps/wialon/items/unit.py,sha256=0IjfQSnJqVHVDheVA7x_upDjepsvMIFdE2invmtcXgc,9377
+terminusgps/wialon/items/unit_group.py,sha256=QV2ZZgICaN3n6W1pFIyMLyNKB6KYBsLyKG64i-qXoOg,4113
+terminusgps/wialon/items/user.py,sha256=N30wdejdG7LXrgafdKZH74YArGkX3xpZfTucn3m3aqM,7155
+python_terminusgps-29.0.0.dist-info/METADATA,sha256=NErafOVNtPCzNAzrb-yTExNo2iJfDPjJ5mhRJio1R3M,1015
+python_terminusgps-29.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_terminusgps-29.0.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+python_terminusgps-29.0.0.dist-info/RECORD,,

terminusgps/mixins.py

@@ -14,9 +14,7 @@ class HtmxTemplateResponseMixin(TemplateResponseMixin):
 
     partial_template_name: str | None = None
     """
-    A partial template rendered by `htmx`_.
-
-    .. _htmx: https://htmx.org/docs/
+    A partial template rendered by htmx.
 
     :type: :py:obj:`str` | :py:obj:`None`
     :value: :py:obj:`None`

terminusgps/opencv/barcode_scanner.py

@@ -0,0 +1,7 @@
+import cv2 as cv
+import numpy as np
+
+
+def scan_barcode(img: np.ndarray) -> tuple:
+    detector = cv.barcode.BarcodeDetector()
+    return detector.detectAndDecode(img)

terminusgps/validators.py

@@ -3,6 +3,49 @@ import string
 from django.core.exceptions import ValidationError
 from django.utils.translation import gettext_lazy as _
 
+from .wialon.session import WialonSession
+
+
+class WialonValidatorBase:
+    def __init__(self) -> None:
+        self.session: WialonSession = WialonSession()
+        self.session.login(self.session.token)
+
+    def __call__(self, value: str) -> None:
+        raise NotImplementedError("Subclasses must implement this method.")
+
+
+class WialonImeiNumberValidator(WialonValidatorBase):
+    def __call__(self, value: str) -> None:
+        response = self.session.wialon_api.core_search_items(
+            **{
+                "spec": {
+                    "itemsType": "avl_unit",
+                    "propName": "sys_id,sys_unique_id",
+                    "propValueMask": f"*,*{value}*",
+                    "sortType": "sys_id,sys_unique_id",
+                },
+                "force": 0,
+                "flags": 1,
+                "from": 0,
+                "to": 0,
+            }
+        )
+        if response is None or not response.get("items"):
+            raise ValidationError(
+                _("IMEI #%(value)s was not found in Wialon."),
+                code="invalid",
+                params={"value": value},
+            )
+
+
+def validate_imei_number(value: str) -> None:
+    """Raises :py:exec:`ValidationError` if the value is an invalid IMEI number."""
+    try:
+        WialonImeiNumberValidator()(value)
+    except ValidationError:
+        raise
+
 
 def validate_vin_number(value: str) -> None:
     """Raises :py:exec:`ValidationError` if the value is an invalid VIN number."""

terminusgps/wialon/constants.py

@@ -1,50 +1,57 @@
-from terminusgps.wialon import flags
+import enum
 
-ACCESSMASK_RESOURCE_BASIC: int = sum(
-    [
-        flags.ACCESSFLAG_VIEW_ITEM_BASIC,
-        flags.ACCESSFLAG_VIEW_CUSTOM_FIELDS,
-        flags.ACCESSFLAG_MANAGE_CUSTOM_FIELDS,
-        flags.ACCESSFLAG_VIEW_ADMIN_FIELDS,
-        flags.ACCESSFLAG_RESOURCE_VIEW_NOTIFICATIONS,
-        flags.ACCESSFLAG_RESOURCE_MANAGE_NOTIFICATIONS,
-        flags.ACCESSFLAG_RESOURCE_VIEW_POIS,
-        flags.ACCESSFLAG_RESOURCE_VIEW_GEOFENCES,
-        flags.ACCESSFLAG_RESOURCE_MANAGE_GEOFENCES,
-        flags.ACCESSFLAG_RESOURCE_VIEW_DRIVERS,
-        flags.ACCESSFLAG_RESOURCE_MANAGE_DRIVERS,
-        flags.ACCESSFLAG_RESOURCE_VIEW_ORDERS,
-        flags.ACCESSFLAG_RESOURCE_VIEW_TRAILERS,
-    ]
+from . import flags
+
+
+class WialonItemsType(enum.StrEnum):
+    HARDWARE = "avl_hw"
+    RESOURCE = "avl_resource"
+    RETRANSLATOR = "avl_retranslator"
+    ROUTE = "avl_route"
+    UNIT = "avl_unit"
+    UNIT_GROUP = "avl_unit_group"
+    USER = "user"
+
+
+ACCESSMASK_RESOURCE_BASIC: int = (
+    flags.AccessFlag.VIEW_ITEM_BASIC
+    | flags.AccessFlag.VIEW_CUSTOM_FIELDS
+    | flags.AccessFlag.MANAGE_CUSTOM_FIELDS
+    | flags.AccessFlag.VIEW_ADMIN_FIELDS
+    | flags.AccessFlag.RESOURCE_VIEW_NOTIFICATIONS
+    | flags.AccessFlag.RESOURCE_MANAGE_NOTIFICATIONS
+    | flags.AccessFlag.RESOURCE_VIEW_POIS
+    | flags.AccessFlag.RESOURCE_VIEW_GEOFENCES
+    | flags.AccessFlag.RESOURCE_MANAGE_GEOFENCES
+    | flags.AccessFlag.RESOURCE_VIEW_DRIVERS
+    | flags.AccessFlag.RESOURCE_MANAGE_DRIVERS
+    | flags.AccessFlag.RESOURCE_VIEW_ORDERS
+    | flags.AccessFlag.RESOURCE_VIEW_TRAILERS
 )
 """Basic resource permissions"""
 
-ACCESSMASK_UNIT_BASIC: int = sum(
-    [
-        flags.ACCESSFLAG_VIEW_ITEM_BASIC,
-        flags.ACCESSFLAG_VIEW_ITEM_DETAILED,
-        flags.ACCESSFLAG_RENAME_ITEM,
-        flags.ACCESSFLAG_VIEW_CUSTOM_FIELDS,
-        flags.ACCESSFLAG_MANAGE_CUSTOM_FIELDS,
-        flags.ACCESSFLAG_MANAGE_ICON,
-        flags.ACCESSFLAG_QUERY_REPORTS,
-        flags.ACCESSFLAG_VIEW_ATTACHED_FILES,
-        flags.ACCESSFLAG_UNIT_EXECUTE_COMMANDS,
-        flags.ACCESSFLAG_UNIT_VIEW_SERVICE_INTERVALS,
-        flags.ACCESSFLAG_UNIT_REGISTER_EVENTS,
-        flags.ACCESSFLAG_UNIT_IMPORT_MESSAGES,
-        flags.ACCESSFLAG_UNIT_EXPORT_MESSAGES,
-    ]
+ACCESSMASK_UNIT_BASIC: int = (
+    flags.AccessFlag.VIEW_ITEM_BASIC
+    | flags.AccessFlag.VIEW_ITEM_DETAILED
+    | flags.AccessFlag.RENAME_ITEM
+    | flags.AccessFlag.VIEW_CUSTOM_FIELDS
+    | flags.AccessFlag.MANAGE_CUSTOM_FIELDS
+    | flags.AccessFlag.MANAGE_ICON
+    | flags.AccessFlag.QUERY_REPORTS
+    | flags.AccessFlag.VIEW_ATTACHED_FILES
+    | flags.AccessFlag.UNIT_EXECUTE_COMMANDS
+    | flags.AccessFlag.UNIT_VIEW_SERVICE_INTERVALS
+    | flags.AccessFlag.UNIT_REGISTER_EVENTS
+    | flags.AccessFlag.UNIT_IMPORT_MESSAGES
+    | flags.AccessFlag.UNIT_EXPORT_MESSAGES
 )
 """Basic unit permissions"""
 
-ACCESSMASK_UNIT_MIGRATION: int = sum(
-    [
-        flags.ACCESSFLAG_DELETE_ITEM,
-        flags.ACCESSFLAG_MANAGE_ITEM_ACCESS,
-        flags.ACCESSFLAG_UNIT_DELETE_MESSAGES,
-        flags.ACCESSFLAG_UNIT_MANAGE_CONNECTIVITY,
-        flags.ACCESSFLAG_VIEW_ITEM_BASIC,
-    ]
+ACCESSMASK_UNIT_MIGRATION: int = (
+    flags.AccessFlag.DELETE_ITEM
+    | flags.AccessFlag.MANAGE_ITEM_ACCESS
+    | flags.AccessFlag.UNIT_DELETE_MESSAGES
+    | flags.AccessFlag.UNIT_MANAGE_CONNECTIVITY
+    | flags.AccessFlag.VIEW_ITEM_BASIC
 )
 """Unit migration permissions"""

terminusgps/wialon/flags.py

@@ -1,3 +1,318 @@
+import enum
+
+
+class AccessFlag(enum.Flag):
+    VIEW_ITEM_BASIC = 0x0001
+    """View this item's basic properties"""
+    VIEW_ITEM_DETAILED = 0x0002
+    """View this item's detailed properties"""
+    MANAGE_ITEM_ACCESS = 0x0004
+    """Manage access to this item"""
+    DELETE_ITEM = 0x0008
+    """Delete this item"""
+    RENAME_ITEM = 0x0010
+    """Rename this item"""
+    VIEW_CUSTOM_FIELDS = 0x0020
+    """View this item's custom fields"""
+    MANAGE_CUSTOM_FIELDS = 0x0040
+    """Manage this item's custom fields"""
+    MANAGE_UNMENTIONED_FIELDS = 0x0080
+    """Manage this item's unmentioned properties"""
+    MANAGE_ICON = 0x0100
+    """Manage this item's icon"""
+    QUERY_REPORTS = 0x0200
+    """Query this item's reports or messages"""
+    MANAGE_ACL = 0x0400
+    """Manage this item's ACL propagated objects"""
+    MANAGE_ITEM_LOG = 0x0800
+    """Manage this item's log"""
+    VIEW_ADMIN_FIELDS = 0x1000
+    """View this item's administrative fields"""
+    MANAGE_ADMIN_FIELDS = 0x2000
+    """Manage this item's administrative fields"""
+    VIEW_ATTACHED_FILES = 0x4000
+    """View this item's attached files"""
+    MANAGE_ATTACHED_FILES = 0x8000
+    """Manage this item's attached files"""
+    UNIT_MANAGE_CONNECTIVITY = 0x0000100000
+    """Manage this unit/group's connectivity settings"""
+    UNIT_MANAGE_SENSORS = 0x0000200000
+    """Manage this unit/group's sensors"""
+    UNIT_MANAGE_COUNTERS = 0x0000400000
+    """Manage this unit/group's counters"""
+    UNIT_DELETE_MESSAGES = 0x0000800000
+    """Delete this unit/group's messages"""
+    UNIT_EXECUTE_COMMANDS = 0x0001000000
+    """Execute this unit/group's commands"""
+    UNIT_REGISTER_EVENTS = 0x0002000000
+    """Register this unit/group's events"""
+    UNIT_VIEW_CONNECTIVITY = 0x0004000000
+    """View this unit/group's connectivity settings"""
+    UNIT_VIEW_SERVICE_INTERVALS = 0x0010000000
+    """View this unit/group's service intervals"""
+    UNIT_MANAGE_SERVICE_INTERVALS = 0x0020000000
+    """Manage this unit/group's service intervals"""
+    UNIT_IMPORT_MESSAGES = 0x0040000000
+    """Import this unit/group's messages"""
+    UNIT_EXPORT_MESSAGES = 0x0080000000
+    """Export this unit/group's messages"""
+    UNIT_VIEW_COMMANDS = 0x0400000000
+    """View this unit/group's commands"""
+    UNIT_MANAGE_COMMANDS = 0x0800000000
+    """Manage this unit/group's commands"""
+    UNIT_MANAGE_TRIP_DETECTOR = 0x4000000000
+    """Manage this unit/group's trip detector and fuel consumption"""
+    UNIT_MANAGE_ASSIGNMENTS = 0x8000000000
+    """Manage this unit/group's job, notification, route, and retranslator assignments"""
+    USER_MANAGE_ACCESS_RIGHTS = 0x100000
+    """Manage this user's access rights"""
+    USER_ACT_AS_OTHER = 0x200000
+    """Can assume the identity of this user (login as)"""
+    USER_MANAGE_FLAGS = 0x400000
+    """Manage this user's access flags"""
+    USER_VIEW_PUSH_MESSAGES = 0x800000
+    """View this user's push messages"""
+    USER_MANAGE_PUSH_MESSAGES = 0x1000000
+    """Manage this user's push messages"""
+    RETRANSLATOR_MANAGE_PROPERTIES = 0x100000
+    """Manage this retranslator's properties (including start/stop)"""
+    RETRANSLATOR_MANAGE_UNITS = 0x2000000
+    """Manage this retranslator's available units"""
+    RESOURCE_VIEW_NOTIFICATIONS = 0x0000000100000
+    """View this resource's notifications"""
+    RESOURCE_MANAGE_NOTIFICATIONS = 0x0000000200000
+    """Manage this resource's notifications"""
+    RESOURCE_VIEW_POIS = 0x0000000400000
+    """View this resource's points of interest"""
+    RESOURCE_MANAGE_POIS = 0x0000000800000
+    """Manage this resource's points of interest"""
+    RESOURCE_VIEW_GEOFENCES = 0x0000001000000
+    """View this resource's geofences"""
+    RESOURCE_MANAGE_GEOFENCES = 0x0000002000000
+    """Manage this resource's geofences"""
+    RESOURCE_VIEW_JOBS = 0x0000004000000
+    """View this resource's jobs"""
+    RESOURCE_MANAGE_JOBS = 0x0000008000000
+    """Manage this resource's jobs"""
+    RESOURCE_VIEW_REPORT_TEMPLATES = 0x0000010000000
+    """View this resource's report templates"""
+    RESOURCE_MANAGE_REPORT_TEMPLATES = 0x0000020000000
+    """Manage this resource's report templates"""
+    RESOURCE_VIEW_DRIVERS = 0x0000040000000
+    """View this resource's drivers"""
+    RESOURCE_MANAGE_DRIVERS = 0x0000080000000
+    """Manage this resource's drivers"""
+    RESOURCE_MANAGE_ACCOUNT = 0x0000100000000
+    """Manage this resource's account"""
+    RESOURCE_VIEW_ORDERS = 0x0000200000000
+    """View this resource's orders"""
+    RESOURCE_MANAGE_ORDERS = 0x0000400000000
+    """Manage this resource's orders"""
+    RESOURCE_VIEW_TRAILERS = 0x0100000000000
+    """View this resource's trailers"""
+    RESOURCE_MANAGE_TRAILERS = 0x0200000000000
+    """Manage this resource's trailers"""
+    ROUTE_MANAGE_ROUTE = 0x0000000100000
+    """Manage this route's properties"""
+    FULL_ACCESS = 0xFFFFFFFFFFFFFFF
+    """Sets all possible access flags to an item"""
+
+
+class DataFlag(enum.Flag):
+    RESOURCE_BASE = 0x00000001
+    """This resource's basic properties"""
+    RESOURCE_CUSTOM_PROPERTIES = 0x00000002
+    """This resource's custom properties"""
+    RESOURCE_BILLING_PROPERTIES = 0x00000004
+    """This resource's billing properties"""
+    RESOURCE_CUSTOM_FIELDS = 0x00000008
+    """This resource's custom fields"""
+    RESOURCE_MESSAGES = 0x00000020
+    """This resource's messages"""
+    RESOURCE_GUID = 0x00000040
+    """This resource's GUID"""
+    RESOURCE_ADMIN_FIELDS = 0x00000080
+    """This resources administrative fields"""
+    RESOURCE_DRIVERS = 0x00000100
+    """This resource's drivers"""
+    RESOURCE_JOBS = 0x00000200
+    """This resource's jobs"""
+    RESOURCE_NOTIFICATIONS = 0x00000400
+    """This resource's notifications"""
+    RESOURCE_POIS = 0x00000800
+    """This resouce's points of interest"""
+    RESOURCE_GEOFENCES = 0x00001000
+    """This resource's geofences"""
+    RESOURCE_REPORT_TEMPLATES = 0x00002000
+    """This resource's report templates"""
+    RESOURCE_DRIVER_ATTACHABLE_UNITS = 0x00004000
+    """This resource's units allowed for driver attachment"""
+    RESOURCE_DRIVER_GROUPS = 0x00008000
+    """This resource's driver groups"""
+    RESOURCE_TRAILERS = 0x00010000
+    """This resource's trailers"""
+    RESOURCE_TRAILER_GROUPS = 0x00020000
+    """This resource's trailer groups"""
+    RESOURCE_TRAILER_ATTACHABLE_UNITS = 0x00040000
+    """This resource's units allowed for trailer attachment"""
+    RESOURCE_ORDERS = 0x00080000
+    """This resource's orders"""
+    RESOURCE_GEOFENCE_GROUPS = 0x00100000
+    """This resource's geofence groups"""
+    RESOURCE_TAGS = 0x00200000
+    """This resource's tags (passengers)"""
+    RESOURCE_TAG_ATTACHABLE_UNITS = 0x00400000
+    """This resource's units allowed for tag attachment"""
+    RESOURCE_TAG_GROUPS = 0x00800000
+    """This resource's tag groups (passengers)"""
+    RESOURCE_ALL = 4611686018427387903
+    """All possible resource data flags"""
+    RETRANSLATOR_BASE = 0x00000001
+    """This retranslator's basic properties"""
+    RETRANSLATOR_CUSTOM_PROPERTIES = 0x00000002
+    """This retranslator's custom properties"""
+    RETRANSLATOR_BILLING_PROPERTIES = 0x00000004
+    """This retranslator's billing properties"""
+    RETRANSLATOR_GUID = 0x00000040
+    """This retranslator's GUID"""
+    RETRANSLATOR_ADMIN_FIELDS = 0x00000080
+    """This retranslator's admin fields"""
+    RETRANSLATOR_CONFIGURATION = 0x00000100
+    """This retranslator's state and configuration"""
+    RETRANSLATOR_UNITS = 0x00000200
+    """This retranslator's bound units"""
+    RETRANSLATOR_ALL = 4611686018427387903
+    """All possible retranslator data flags"""
+    ROUTE_BASE = 0x00000001
+    """This route's basic properties"""
+    ROUTE_CUSTOM_PROPERTIES = 0x00000002
+    """This route's custom properties"""
+    ROUTE_BILLING_PROPERTIES = 0x00000004
+    """This route's billing properties"""
+    ROUTE_GUID = 0x00000040
+    """This route's GUID"""
+    ROUTE_ADMIN_FIELDS = 0x00000080
+    """This route's administrative fields"""
+    ROUTE_CONFIGURATION = 0x00000100
+    """This route's configuration"""
+    ROUTE_CHECKPOINTS = 0x00000200
+    """This route's checkpoints"""
+    ROUTE_SCHEDULES = 0x00000400
+    """This route's schedules"""
+    ROUTE_ROUNDS = 0x00000800
+    """This route's rounds"""
+    ROUTE_ALL = 4611686018427387903
+    """All possible route data flags"""
+    UNIT_BASE = 0x00000001
+    """This unit's basic properties"""
+    UNIT_CUSTOM_PROPERTIES = 0x00000002
+    """This unit's custom properties"""
+    UNIT_BILLING_PROPERTIES = 0x00000004
+    """This unit's billing properties"""
+    UNIT_CUSTOM_FIELDS = 0x00000008
+    """This unit's custom fields"""
+    UNIT_IMAGE = 0x00000010
+    """This unit's image/icon"""
+    UNIT_MESSAGES = 0x00000020
+    """This unit's messages"""
+    UNIT_GUID = 0x00000040
+    """This unit's GUID"""
+    UNIT_ADMIN_FIELDS = 0x00000080
+    """This unit's administrative fields"""
+    UNIT_ADVANCED_PROPERTIES = 0x00000100
+    """This unit's advanced properties"""
+    UNIT_CURRENT_MOMENT_COMMANDS = 0x00000200
+    """This unit's available for current moment commands"""
+    UNIT_LAST_MESSAGE = 0x00000400
+    """This unit's last message and position"""
+    UNIT_SENSORS = 0x00001000
+    """This unit's sensors"""
+    UNIT_COUNTERS = 0x00002000
+    """This unit's counters"""
+    UNIT_MAINTENANCE = 0x00008000
+    """This unit's maintenance"""
+    UNIT_REPORT_CONFIGURATION = 0x00020000
+    """This unit's report configuration, trip detector, and fuel consumption"""
+    UNIT_AVAILABLE_COMMANDS = 0x00080000
+    """This unit's available commands"""
+    UNIT_MESSAGE_PARAMETERS = 0x00100000
+    """This unit's message parameters"""
+    UNIT_CONNECTION_STATUS = 0x00200000
+    """This unit's connection status"""
+    UNIT_POSITION = 0x00400000
+    """This unit's position"""
+    UNIT_PROFILE_FIELDS = 0x00800000
+    """This unit's profile files"""
+    UNIT_ALL = 4611686018427387903
+    """All possible unit data flags"""
+    GROUP_BASE = 0x00000001
+    """This group's basic properties"""
+    GROUP_CUSTOM_PROPERTIES = 0x00000002
+    """This group's custom properties"""
+    GROUP_BILLING_PROPERTIES = 0x00000004
+    """This group's billing properties"""
+    GROUP_CUSTOM_FIELDS = 0x00000008
+    """This group's custom fields"""
+    GROUP_IMAGE = 0x00000010
+    """This group's image/icon"""
+    GROUP_GUID = 0x00000040
+    """This group's GUID"""
+    GROUP_ADMIN_FIELDS = 0x00000080
+    """This group's administrative fields"""
+    GROUP_ALL = 4611686018427387903
+    """All possible group data flags"""
+    USER_BASE = 0x00000001
+    """This user's basic properties"""
+    USER_CUSTOM_PROPERTIES = 0x00000002
+    """This user's custom properties"""
+    USER_BILLING_PROPERTIES = 0x00000004
+    """This user's billing properties"""
+    USER_CUSTOM_FIELDS = 0x00000008
+    """This user's custom fields"""
+    USER_MESSAGES = 0x00000020
+    """This user's messages"""
+    USER_GUID = 0x00000040
+    """This user's GUID"""
+    USER_ADMIN_FIELDS = 0x00000080
+    """This user's administrative fields"""
+    USER_OTHER_PROPERTIES = 0x00000100
+    """This user's other properties"""
+    USER_NOTIFICATIONS = 0x00000200
+    """This user's notifications"""
+    USER_ALL = 4611686018427387903
+    """All possible user data flags"""
+
+
+class SettingsFlag(enum.Flag):
+    USER_DISABLED = 0x01
+    """This user is disabled"""
+    USER_CANNOT_CHANGE_PASSWORD = 0x02
+    """This user cannot change their password"""
+    USER_CAN_CREATE_ITEMS = 0x04
+    """This user can create objects"""
+    USER_CANNOT_CHANGE_SETTINGS = 0x10
+    """This user cannot change settings"""
+    USER_CAN_SEND_SMS = 0x20
+    """This user can send SMS messages"""
+
+
+class TokenFlag(enum.Flag):
+    ONLINE_TRACKING = 0x100
+    """Online tracking"""
+    VIEW_ACCESS = 0x200
+    """View access to most data"""
+    MANAGE_NONSENSITIVE = 0x400
+    """Modification of non-sensitive data"""
+    MANAGE_SENSITIVE = 0x800
+    """Modification of sensitive data"""
+    MANAGE_CRITICAL = 0x1000
+    """Modification of critical data, including message deletion"""
+    COMMUNICATION = 0x2000
+    """Modification of communication data"""
+    MANAGE_ALL = -1
+    """Unlimited operation as authorized user"""
+
+
 # Access flags
 ## General - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/core/check_items_billing#general
 ACCESSFLAG_VIEW_ITEM_BASIC = 0x0001

terminusgps/wialon/items/base.py

@@ -22,7 +22,7 @@ class WialonBase:
     def populate(self) -> None:
         """Retrieves and saves the latest data for the item from Wialon."""
         response = self.session.wialon_api.core_search_item(
-            **{"id": str(self.id), "flags": 0x1}
+            **{"id": str(self.id), "flags": flags.DataFlag.UNIT_BASE.value}
         )
         if response is not None:
             item = response.get("item", {})
@@ -205,7 +205,7 @@ class WialonBase:
     def cfields(self) -> dict[str, str]:
         """Custom fields for the Wialon object."""
         response = self.session.wialon_api.core_search_item(
-            **{"id": self.id, "flags": flags.DATAFLAG_UNIT_CUSTOM_FIELDS}
+            **{"id": self.id, "flags": flags.DataFlag.UNIT_CUSTOM_FIELDS.value}
         )
         fields = response.get("item", {}).get("flds") if response is not None else {}
         return {field["n"]: field["v"] for field in fields.values()} if fields else {}
@@ -214,7 +214,7 @@ class WialonBase:
     def afields(self) -> dict[str, str]:
         """Admin fields for the Wialon object."""
         response = self.session.wialon_api.core_search_item(
-            **{"id": self.id, "flags": flags.DATAFLAG_UNIT_ADMIN_FIELDS}
+            **{"id": self.id, "flags": flags.DataFlag.UNIT_ADMIN_FIELDS.value}
         )
         fields = response.get("item", {}).get("aflds") if response is not None else {}
         return {field["n"]: field["v"] for field in fields.values()} if fields else {}

terminusgps/wialon/items/resource.py

@@ -30,7 +30,7 @@ class WialonResource(WialonBase):
             **{
                 "creatorId": creator_id,
                 "name": name,
-                "dataFlags": flags.DATAFLAG_UNIT_BASE,
+                "dataFlags": flags.DataFlag.UNIT_BASE.value,
                 "skipCreatorCheck": int(skip_creator_check),
             }
         )
@@ -81,7 +81,7 @@ class WialonResource(WialonBase):
 
         """
         response = self.session.wialon_api.core_search_item(
-            **{"id": self.id, "flags": flags.DATAFLAG_RESOURCE_BILLING_PROPERTIES}
+            **{"id": self.id, "flags": flags.DataFlag.RESOURCE_BILLING_PROPERTIES.value}
         )
         return int(response.get("item", {}).get("bact")) == self.id
 

terminusgps/wialon/items/retranslator.py

@@ -27,7 +27,7 @@ class WialonRetranslator(WialonBase):
                 "creatorId": creator_id,
                 "name": name,
                 "config": config,
-                "dataFlags": flags.DATAFLAG_UNIT_BASE,
+                "dataFlags": flags.DataFlag.UNIT_BASE.value,
             }
         )
         return (

terminusgps/wialon/items/route.py

@@ -24,7 +24,7 @@ class WialonRoute(WialonBase):
             **{
                 "creatorId": creator_id,
                 "name": name,
-                "dataFlags": flags.DATAFLAG_UNIT_BASE,
+                "dataFlags": flags.DataFlag.ROUTE_BASE.value,
             }
         )
         return (

terminusgps/wialon/items/unit.py

@@ -33,7 +33,7 @@ class WialonUnit(WialonBase):
                 "creatorId": creator_id,
                 "name": name,
                 "hwTypeId": hw_type_id,
-                "dataFlags": flags.DATAFLAG_UNIT_BASE,
+                "dataFlags": flags.DataFlag.UNIT_BASE,
             }
         )
         return (
@@ -47,9 +47,9 @@ class WialonUnit(WialonBase):
         response = self.session.wialon_api.core_search_item(
             **{
                 "id": self.id,
-                "flags": sum(
-                    [flags.DATAFLAG_UNIT_ADVANCED_PROPERTIES, flags.DATAFLAG_UNIT_IMAGE]
-                ),
+                "flags": (
+                    flags.DataFlag.UNIT_ADVANCED_PROPERTIES | flags.DataFlag.UNIT_IMAGE
+                ).value,
             }
         )
         if response:
@@ -60,7 +60,7 @@ class WialonUnit(WialonBase):
 
     def get_position(self) -> dict | None:
         return self.session.wialon_api.core_search_item(
-            **{"id": self.id, "flags": flags.DATAFLAG_UNIT_POSITION}
+            **{"id": self.id, "flags": flags.DataFlag.UNIT_POSITION.value}
         )
 
     @property
@@ -73,7 +73,7 @@ class WialonUnit(WialonBase):
         """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}
+                **{"id": self.id, "flags": flags.DataFlag.UNIT_BASE.value}
             ).get("item", False)
         )
 

terminusgps/wialon/items/unit_group.py

@@ -24,7 +24,7 @@ class WialonUnitGroup(WialonBase):
             **{
                 "creatorId": creator_id,
                 "name": name,
-                "dataFlags": flags.DATAFLAG_UNIT_BASE,
+                "dataFlags": flags.DataFlag.UNIT_BASE.value,
             }
         )
         return (
@@ -111,7 +111,7 @@ class WialonUnitGroup(WialonBase):
                     "or_logic": 0,
                 },
                 "force": 1,
-                "flags": flags.DATAFLAG_UNIT_BASE,
+                "flags": flags.DataFlag.UNIT_BASE.value,
                 "from": 0,
                 "to": 0,
             }

terminusgps/wialon/items/user.py

@@ -26,10 +26,10 @@ class WialonUser(WialonBase):
 
         response = self.session.wialon_api.core_create_user(
             **{
-                "creatorId": creator_id,
+                "creatorId": str(creator_id),
                 "name": name,
                 "password": password,
-                "dataFlags": flags.DATAFLAG_UNIT_BASE,
+                "dataFlags": str(flags.DataFlag.UNIT_BASE.value),
             }
         )
         return (
@@ -110,7 +110,7 @@ class WialonUser(WialonBase):
         :rtype: :py:obj:`None`
 
         """
-        self.add_cproperty(("phone", quote_plus(phone)))
+        self.add_cproperty("phone", quote_plus(phone))
 
     def assign_email(self, email: str) -> None:
         """
@@ -123,7 +123,7 @@ class WialonUser(WialonBase):
         :rtype: :py:obj:`None`
 
         """
-        self.add_cproperty(("email", email))
+        self.add_cproperty("email", email)
 
     def grant_access(
         self, item: WialonBase, access_mask: int = constants.ACCESSMASK_UNIT_BASIC

terminusgps/wialon/utils.py

@@ -2,8 +2,7 @@ import secrets
 import string
 import typing
 
-from terminusgps.wialon import flags, items
-from terminusgps.wialon.items.base import WialonBase
+from terminusgps.wialon import constants, flags
 from terminusgps.wialon.session import WialonSession
 
 
@@ -90,7 +89,7 @@ def get_id_from_imei(imei: str, session: WialonSession) -> str | None:
                 "or_logic": 0,
             },
             "force": 0,
-            "flags": flags.DATAFLAG_UNIT_BASE,
+            "flags": flags.DataFlag.UNIT_BASE.value,
             "from": 0,
             "to": 0,
         }
@@ -100,45 +99,6 @@ def get_id_from_imei(imei: str, session: WialonSession) -> str | None:
         return results["items"][0].get("id")
 
 
-def get_id_from_iccid(iccid: str, session: WialonSession) -> str | None:
-    """
-    DEPRECATED: Use :py:func:`~terminusgps.wialon.utils.get_id_from_imei`.
-
-    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 during a Wialon API call.
-    :returns: A Wialon object id, if it was found.
-    :rtype: :py:obj:`str` | :py:obj:`None`
-
-    """
-    return get_id_from_imei(imei=iccid, session=session)
-
-
-def get_wialon_cls(items_type: str) -> typing.Type[WialonBase] | None:
-    """
-    Returns a Wialon object class based on ``items_type``.
-
-    Valid ``items_type`` are ``"user"``, ``"avl_unit"``, ``"avl_unit_group"`` and ``"avl_resource"``.
-
-    :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` | :py:obj:`None`
-
-    """
-    items_map: dict[str, typing.Type[WialonBase]] = {
-        "user": items.WialonUser,
-        "avl_unit": items.WialonUnit,
-        "avl_unit_group": items.WialonUnitGroup,
-        "avl_resource": items.WialonResource,
-    }
-    return items_map.get(items_type)
-
-
 def get_vin_info(vin_number: str, session: WialonSession) -> dict:
     """
     Retrieves vehicle data from a VIN number.
@@ -164,7 +124,11 @@ def get_vin_info(vin_number: str, session: WialonSession) -> dict:
     }
 
 
-def is_unique(value: str, session: WialonSession, items_type: str = "avl_unit") -> bool:
+def is_unique(
+    value: str,
+    session: WialonSession,
+    items_type: str = constants.WialonItemsType.UNIT.value,
+) -> bool:
     """
     Determines if the value is unique among Wialon objects of type 'items_type'.