python-terminusgps 29.1.1__py3-none-any.whl → 30.0.0__py3-none-any.whl

{python_terminusgps-29.1.1.dist-info → python_terminusgps-30.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-terminusgps
-Version: 29.1.1
+Version: 30.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

{python_terminusgps-29.1.1.dist-info → python_terminusgps-30.0.0.dist-info}/RECORD

@@ -2,7 +2,6 @@ terminusgps/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 terminusgps/mixins.py,sha256=jzs_dH_YDmohH86I3uPnN-66C9OPVXaDPVdRHXA6vdk,940
 terminusgps/settings.py,sha256=vY5yNjyMu-7Ya0bIPWUvrrSLERtxHGdkfeoY4Ul6cP0,613
 terminusgps/utils.py,sha256=SYDQyHA5tTuVwdpZGsCtf0LpTTD0ilRKoxa8StfSTpQ,156
-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
@@ -20,20 +19,21 @@ terminusgps/twilio/__init__.py,sha256=dYo41F2jft_eHDWSUtSpKGSRG1bewq_qClqilUJZkY
 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=TgwQjUEQZXXDewepGCVCDIkL6RELI53GouM8qq2RM_M,1805
-terminusgps/wialon/flags.py,sha256=O3oeJ5Thhv5ULnoEFNuvvWhqTf8xb6AtIwRci61UyJI,26098
+terminusgps/wialon/constants.py,sha256=5Yj5YflagDaqIYrF2k8QOqyFgmNkXM05647omBTZeDc,5467
+terminusgps/wialon/flags.py,sha256=M50EdhxQ8IMnJnU0mrHK7-h8Asc6tvNiTOOfd1dBW6A,12815
 terminusgps/wialon/logger.py,sha256=nUBsaLMaffSaAHGHAM6mFXDzix9hbNecVtA3INVtii8,968
-terminusgps/wialon/session.py,sha256=THl88yfVBfRH8daKh1lmLSR8ro8TbyOokHx1Cev-En8,9638
-terminusgps/wialon/utils.py,sha256=fGl41EItDxqq9JGDKoU50zfELjfab2XjVfIXy5RvRio,6343
+terminusgps/wialon/session.py,sha256=UUPJFwoN4sUnB9Q7i18pjmBaKFt3wdZ1MZdj68ieO_0,9640
+terminusgps/wialon/utils.py,sha256=E_5OCC9wHhrKEwJv4hkTOqplJ_KmnQ5KlSPOhuXbhcg,8423
+terminusgps/wialon/validators.py,sha256=NNqMhoXn1M_f4Edm6oD8I7lzzXKZSqyZ6n7fR3obWj8,4241
 terminusgps/wialon/items/__init__.py,sha256=3BVthghekMvhMQSzQgBMlD_phxmKSmp3Zvmo-z0O8Bs,211
-terminusgps/wialon/items/base.py,sha256=rwKaXd6vcHPNJ2cwBeeX8VYMJiDig_f4hFThAwkhwZk,7247
+terminusgps/wialon/items/base.py,sha256=EmuTVxI7GdlCCJIwFrw0v55gDuYUWNYZ39O2Yl8K2Mc,7876
 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.py,sha256=ChONjm3wlFSlbNz-yEXziNbbs4LJ70F9-MI2c-p905k,10638
 terminusgps/wialon/items/unit_group.py,sha256=QV2ZZgICaN3n6W1pFIyMLyNKB6KYBsLyKG64i-qXoOg,4113
 terminusgps/wialon/items/user.py,sha256=N30wdejdG7LXrgafdKZH74YArGkX3xpZfTucn3m3aqM,7155
-python_terminusgps-29.1.1.dist-info/METADATA,sha256=mrycwPLcPwvSKXWPVNfsdK_fcEe3XamGUuMTFXDVeBQ,1061
-python_terminusgps-29.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-python_terminusgps-29.1.1.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-python_terminusgps-29.1.1.dist-info/RECORD,,
+python_terminusgps-30.0.0.dist-info/METADATA,sha256=vXR-HgsmbNNrCtIUUUVdg-piU6D81zbNRMnL3WSg1Rg,1061
+python_terminusgps-30.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+python_terminusgps-30.0.0.dist-info/licenses/COPYING,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+python_terminusgps-30.0.0.dist-info/RECORD,,

terminusgps/wialon/constants.py

@@ -4,54 +4,156 @@ from . import flags
 
 
 class WialonItemsType(enum.StrEnum):
+    """
+    Wialon item types for Wialon API calls.
+
+    `Wialon Item Types Reference <https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/core/search_items>`_
+
+    """
+
     HARDWARE = "avl_hw"
+    """Hardware type."""
     RESOURCE = "avl_resource"
+    """Resource."""
     RETRANSLATOR = "avl_retranslator"
+    """Retranslator."""
     ROUTE = "avl_route"
+    """Route."""
     UNIT = "avl_unit"
+    """Unit."""
     UNIT_GROUP = "avl_unit_group"
+    """Unit group."""
     USER = "user"
+    """User."""
+
+
+class WialonItemProperty(enum.StrEnum):
+    """
+    Wialon item properties for Wialon API calls.
+
+    `Wialon Item Property Reference <https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/core/search_items>`_
+
+    """
+
+    ACCOUNT_BALANCE = "sys_account_balance"
+    """Current account balance."""
+    ACCOUNT_BLOCKED = "sys_account_disabled"
+    """Whether or not the account is blocked."""
+    ACCOUNT_BLOCKED_TIME = "rel_account_disabled_mod_time"
+    """Time (UNIX timestamp) the account was last blocked."""
+    ACCOUNT_DAYS = "sys_account_days"
+    """Number of days on the account."""
+    ACCOUNT_DEALER_RIGHTS = "sys_account_enable_parent"
+    """Whether or not the account has dealer rights."""
+    ACCOUNT_ID = "sys_billing_account_guid"
+    """Account id."""
+    ACCOUNT_NAME = "rel_billing_account_name"
+    """Account name."""
+    ACCOUNT_NUM_UNITS = "rel_account_units_usage"
+    """Number of units in the account."""
+    ACCOUNT_PARENT_NAME = "rel_billing_parent_account_name"
+    """Parent account name for the account."""
+    ACCOUNT_PLAN_NAME = "rel_billing_plan_name"
+    """Billing plan assigned to the account."""
+    ADMIN_FIELD_NAME = "rel_adminfield_name"
+    """Admin field name."""
+    ADMIN_FIELD_NAME_VALUE = "rel_adminfield_name_value"
+    """Admin field name/value, format: ``'name:value'``."""
+    ADMIN_FIELD_VALUE = "rel_adminfield_value"
+    """Admin field value."""
+    CREATION_TIME = "rel_creation_time"
+    """Time (UNIX timestamp) the object was created."""
+    CREATOR_ID = "sys_user_creator"
+    """Creator user id."""
+    CREATOR_NAME = "rel_user_creator_name"
+    """Creator user name."""
+    CUSTOM_FIELD_NAME = "rel_customfield_name"
+    """Custom field name."""
+    CUSTOM_FIELD_NAME_VALUE = "rel_customfield_name_value"
+    """Custom field name/value, format: ``'name:value'``."""
+    CUSTOM_FIELD_VALUE = "rel_customfield_value"
+    """Custom field value."""
+    GROUP_NUM_UNITS = "rel_group_unit_count"
+    """Number of units in the group."""
+    HARDWARE_ID = "rel_hw_type_id"
+    """Hardware id."""
+    HARDWARE_NAME = "rel_hw_type_name"
+    """Hardware name."""
+    HARDWARE_STATE = "sys_comm_state"
+    """Hardware state."""
+    ID = "sys_id"
+    """Object id."""
+    LAST_LOGIN_TIME = "login_date"
+    """Time (UNIX timestamp) the user last logged in."""
+    LAST_MESSAGE_TIME = "rel_last_msg_date"
+    """Time (UNIX timestamp) of the last message."""
+    NAME = "sys_name"
+    """Object name."""
+    PHONE = "sys_phone_number"
+    """Object phone number."""
+    PHONE2 = "sys_phone_number2"
+    """Secondary (optional) object phone number."""
+    PROFILE_FIELD = "profilefield"
+    """Profile field."""
+    PROFILE_FIELD_NAME = "rel_profilefield_name"
+    """Profile field name."""
+    PROFILE_FIELD_NAME_VALUE = "rel_profilefield_name_value"
+    """Profile field name/value, format: ``'name:value'``"""
+    PROFILE_FIELD_VALUE = "rel_profilefield_value"
+    """Profile field value."""
+    RESOURCE_IS_ACCOUNT = "rel_is_account"
+    """Whether or not the resource is an account."""
+    RETRANSLATOR_ENABLED = "retranslator_enabled"
+    """Whether or not a retranslator is enabled."""
+    UNIQUE_ID = "sys_unique_id"
+    """Object unique id."""
 
 
-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
+ACCESSMASK_RESOURCE_BASIC: int = sum(
+    [
+        flags.AccessFlag.MANAGE_CUSTOM_FIELDS,
+        flags.AccessFlag.RESOURCE_MANAGE_DRIVERS,
+        flags.AccessFlag.RESOURCE_MANAGE_GEOFENCES,
+        flags.AccessFlag.RESOURCE_MANAGE_NOTIFICATIONS,
+        flags.AccessFlag.RESOURCE_VIEW_DRIVERS,
+        flags.AccessFlag.RESOURCE_VIEW_GEOFENCES,
+        flags.AccessFlag.RESOURCE_VIEW_NOTIFICATIONS,
+        flags.AccessFlag.RESOURCE_VIEW_ORDERS,
+        flags.AccessFlag.RESOURCE_VIEW_POIS,
+        flags.AccessFlag.RESOURCE_VIEW_TRAILERS,
+        flags.AccessFlag.VIEW_ADMIN_FIELDS,
+        flags.AccessFlag.VIEW_CUSTOM_FIELDS,
+        flags.AccessFlag.VIEW_ITEM_BASIC,
+    ]
 )
 """Basic resource permissions"""
 
-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
+ACCESSMASK_UNIT_BASIC: int = sum(
+    [
+        flags.AccessFlag.MANAGE_CUSTOM_FIELDS,
+        flags.AccessFlag.MANAGE_ICON,
+        flags.AccessFlag.QUERY_REPORTS,
+        flags.AccessFlag.RENAME_ITEM,
+        flags.AccessFlag.UNIT_EXECUTE_COMMANDS,
+        flags.AccessFlag.UNIT_EXPORT_MESSAGES,
+        flags.AccessFlag.UNIT_IMPORT_MESSAGES,
+        flags.AccessFlag.UNIT_REGISTER_EVENTS,
+        flags.AccessFlag.UNIT_VIEW_SERVICE_INTERVALS,
+        flags.AccessFlag.VIEW_ATTACHED_FILES,
+        flags.AccessFlag.VIEW_CUSTOM_FIELDS,
+        flags.AccessFlag.VIEW_ITEM_BASIC,
+        flags.AccessFlag.VIEW_ITEM_DETAILED,
+    ]
 )
 """Basic unit permissions"""
 
-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
+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,
+    ]
 )
 """Unit migration permissions"""

terminusgps/wialon/flags.py

@@ -1,7 +1,14 @@
 import enum
 
 
-class AccessFlag(enum.Flag):
+class AccessFlag(enum.IntFlag):
+    """
+    Access flags for Wialon API calls.
+
+    `Access Flags Reference <https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/core/check_items_billing>`_
+
+    """
+
     VIEW_ITEM_BASIC = 0x0001
     """View this item's basic properties"""
     VIEW_ITEM_DETAILED = 0x0002
@@ -118,7 +125,14 @@ class AccessFlag(enum.Flag):
     """Sets all possible access flags to an item"""
 
 
-class DataFlag(enum.Flag):
+class DataFlag(enum.IntFlag):
+    """
+    Data flags for Wialon API calls.
+
+    `Data Flags Reference <https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/format/format>`_
+
+    """
+
     RESOURCE_BASE = 0x00000001
     """This resource's basic properties"""
     RESOURCE_CUSTOM_PROPERTIES = 0x00000002
@@ -283,7 +297,14 @@ class DataFlag(enum.Flag):
     """All possible user data flags"""
 
 
-class SettingsFlag(enum.Flag):
+class SettingsFlag(enum.IntFlag):
+    """
+    User settings flags for Wialon API calls.
+
+    `User Settings Flags Reference <https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/user/update_user_flags>`_
+
+    """
+
     USER_DISABLED = 0x01
     """This user is disabled"""
     USER_CANNOT_CHANGE_PASSWORD = 0x02
@@ -296,7 +317,14 @@ class SettingsFlag(enum.Flag):
     """This user can send SMS messages"""
 
 
-class TokenFlag(enum.Flag):
+class TokenFlag(enum.IntFlag):
+    """
+    Token flags for Wialon API calls.
+
+    `Token Flags Reference <https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/token/login>`_
+
+    """
+
     ONLINE_TRACKING = 0x100
     """Online tracking"""
     VIEW_ACCESS = 0x200
@@ -311,487 +339,3 @@ class TokenFlag(enum.Flag):
     """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
-"""View this item's basic properties"""
-
-ACCESSFLAG_VIEW_ITEM_DETAILED = 0x0002
-"""View this item's detailed properties"""
-
-ACCESSFLAG_MANAGE_ITEM_ACCESS = 0x0004
-"""Manage access to this item"""
-
-ACCESSFLAG_DELETE_ITEM = 0x0008
-"""Delete this item"""
-
-ACCESSFLAG_RENAME_ITEM = 0x0010
-"""Rename this item"""
-
-ACCESSFLAG_VIEW_CUSTOM_FIELDS = 0x0020
-"""View this item's custom fields"""
-
-ACCESSFLAG_MANAGE_CUSTOM_FIELDS = 0x0040
-"""Manage this item's custom fields"""
-
-ACCESSFLAG_MANAGE_UNMENTIONED_FIELDS = 0x0080
-"""Manage this item's unmentioned properties"""
-
-ACCESSFLAG_MANAGE_ICON = 0x0100
-"""Manage this item's icon"""
-
-ACCESSFLAG_QUERY_REPORTS = 0x0200
-"""Query this item's reports or messages"""
-
-ACCESSFLAG_MANAGE_ACL = 0x0400
-"""Manage this item's ACL propagated objects"""
-
-ACCESSFLAG_MANAGE_ITEM_LOG = 0x0800
-"""Manage this item's log"""
-
-ACCESSFLAG_VIEW_ADMIN_FIELDS = 0x1000
-"""View this item's administrative fields"""
-
-ACCESSFLAG_MANAGE_ADMIN_FIELDS = 0x2000
-"""Manage this item's administrative fields"""
-
-ACCESSFLAG_VIEW_ATTACHED_FILES = 0x4000
-"""View this item's attached files"""
-
-ACCESSFLAG_MANAGE_ATTACHED_FILES = 0x8000
-"""Manage this item's attached files"""
-
-
-## Unit/Unit Group - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/core/check_items_billing#units_and_unit_groups
-ACCESSFLAG_UNIT_MANAGE_CONNECTIVITY = 0x0000100000
-"""Manage this unit/group's connectivity settings"""
-
-ACCESSFLAG_UNIT_MANAGE_SENSORS = 0x0000200000
-"""Manage this unit/group's sensors"""
-
-ACCESSFLAG_UNIT_MANAGE_COUNTERS = 0x0000400000
-"""Manage this unit/group's counters"""
-
-ACCESSFLAG_UNIT_DELETE_MESSAGES = 0x0000800000
-"""Delete this unit/group's messages"""
-
-ACCESSFLAG_UNIT_EXECUTE_COMMANDS = 0x0001000000
-"""Execute this unit/group's commands"""
-
-ACCESSFLAG_UNIT_REGISTER_EVENTS = 0x0002000000
-"""Register this unit/group's events"""
-
-ACCESSFLAG_UNIT_VIEW_CONNECTIVITY = 0x0004000000
-"""View this unit/group's connectivity settings"""
-
-ACCESSFLAG_UNIT_VIEW_SERVICE_INTERVALS = 0x0010000000
-"""View this unit/group's service intervals"""
-
-ACCESSFLAG_UNIT_MANAGE_SERVICE_INTERVALS = 0x0020000000
-"""Manage this unit/group's service intervals"""
-
-ACCESSFLAG_UNIT_IMPORT_MESSAGES = 0x0040000000
-"""Import this unit/group's messages"""
-
-ACCESSFLAG_UNIT_EXPORT_MESSAGES = 0x0080000000
-"""Export this unit/group's messages"""
-
-ACCESSFLAG_UNIT_VIEW_COMMANDS = 0x0400000000
-"""View this unit/group's commands"""
-
-ACCESSFLAG_UNIT_MANAGE_COMMANDS = 0x0800000000
-"""Manage this unit/group's commands"""
-
-ACCESSFLAG_UNIT_MANAGE_TRIP_DETECTOR = 0x4000000000
-"""Manage this unit/group's trip detector and fuel consumption"""
-
-ACCESSFLAG_UNIT_MANAGE_ASSIGNMENTS = 0x8000000000
-"""Manage this unit/group's job, notification, route, and retranslator assignments"""
-
-
-## User - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/core/check_items_billing#users
-ACCESSFLAG_USER_MANAGE_ACCESS_RIGHTS = 0x100000
-"""Manage this user's access rights"""
-
-ACCESSFLAG_USER_ACT_AS_OTHER = 0x200000
-"""Can assume the identity of this user (login as)"""
-
-ACCESSFLAG_USER_MANAGE_FLAGS = 0x400000
-"""Manage this user's access flags"""
-
-ACCESSFLAG_USER_VIEW_PUSH_MESSAGES = 0x800000
-"""View this user's push messages"""
-
-ACCESSFLAG_USER_MANAGE_PUSH_MESSAGES = 0x1000000
-"""Manage this user's push messages"""
-
-
-## Retranslator - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/core/check_items_billing#retranslators
-ACCESSFLAG_RETRANSLATOR_MANAGE_PROPERTIES = 0x100000
-"""Manage this retranslator's properties (including start/stop)"""
-
-ACCESSFLAG_RETRANSLATOR_MANAGE_UNITS = 0x2000000
-"""Manage this retranslator's available units"""
-
-
-## Resources (Accounts) - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/core/check_items_billing#resources_accounts
-ACCESSFLAG_RESOURCE_VIEW_NOTIFICATIONS = 0x0000000100000
-"""View this resource's notifications"""
-
-ACCESSFLAG_RESOURCE_MANAGE_NOTIFICATIONS = 0x0000000200000
-"""Manage this resource's notifications"""
-
-ACCESSFLAG_RESOURCE_VIEW_POIS = 0x0000000400000
-"""View this resource's points of interest"""
-
-ACCESSFLAG_RESOURCE_MANAGE_POIS = 0x0000000800000
-"""Manage this resource's points of interest"""
-
-ACCESSFLAG_RESOURCE_VIEW_GEOFENCES = 0x0000001000000
-"""View this resource's geofences"""
-
-ACCESSFLAG_RESOURCE_MANAGE_GEOFENCES = 0x0000002000000
-"""Manage this resource's geofences"""
-
-ACCESSFLAG_RESOURCE_VIEW_JOBS = 0x0000004000000
-"""View this resource's jobs"""
-
-ACCESSFLAG_RESOURCE_MANAGE_JOBS = 0x0000008000000
-"""Manage this resource's jobs"""
-
-ACCESSFLAG_RESOURCE_VIEW_REPORT_TEMPLATES = 0x0000010000000
-"""View this resource's report templates"""
-
-ACCESSFLAG_RESOURCE_MANAGE_REPORT_TEMPLATES = 0x0000020000000
-"""Manage this resource's report templates"""
-
-ACCESSFLAG_RESOURCE_VIEW_DRIVERS = 0x0000040000000
-"""View this resource's drivers"""
-
-ACCESSFLAG_RESOURCE_MANAGE_DRIVERS = 0x0000080000000
-"""Manage this resource's drivers"""
-
-ACCESSFLAG_RESOURCE_MANAGE_ACCOUNT = 0x0000100000000
-"""Manage this resource's account"""
-
-ACCESSFLAG_RESOURCE_VIEW_ORDERS = 0x0000200000000
-"""View this resource's orders"""
-
-ACCESSFLAG_RESOURCE_MANAGE_ORDERS = 0x0000400000000
-"""Manage this resource's orders"""
-
-ACCESSFLAG_RESOURCE_VIEW_TRAILERS = 0x0100000000000
-"""View this resource's trailers"""
-
-ACCESSFLAG_RESOURCE_MANAGE_TRAILERS = 0x0200000000000
-"""Manage this resource's trailers"""
-
-
-## Routes - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/core/check_items_billing#routes
-ACCESSFLAG_ROUTE_MANAGE_ROUTE = 0x0000000100000
-"""Manage this route's properties"""
-
-
-## Other - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/core/check_items_billing#other
-ACCESSFLAG_FULL_ACCESS = 0xFFFFFFFFFFFFFFF
-"""Sets all possible access flags to an item"""
-
-
-# Data flags
-## Resource (Accounts) - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/format/resource
-DATAFLAG_RESOURCE_BASE = 0x00000001
-"""This resource's basic properties"""
-
-DATAFLAG_RESOURCE_CUSTOM_PROPERTIES = 0x00000002
-"""This resource's custom properties"""
-
-DATAFLAG_RESOURCE_BILLING_PROPERTIES = 0x00000004
-"""This resource's billing properties"""
-
-DATAFLAG_RESOURCE_CUSTOM_FIELDS = 0x00000008
-"""This resource's custom fields"""
-
-DATAFLAG_RESOURCE_MESSAGES = 0x00000020
-"""This resource's messages"""
-
-DATAFLAG_RESOURCE_GUID = 0x00000040
-"""This resource's GUID"""
-
-DATAFLAG_RESOURCE_ADMIN_FIELDS = 0x00000080
-"""This resources administrative fields"""
-
-DATAFLAG_RESOURCE_DRIVERS = 0x00000100
-"""This resource's drivers"""
-
-DATAFLAG_RESOURCE_JOBS = 0x00000200
-"""This resource's jobs"""
-
-DATAFLAG_RESOURCE_NOTIFICATIONS = 0x00000400
-"""This resource's notifications"""
-
-DATAFLAG_RESOURCE_POIS = 0x00000800
-"""This resouce's points of interest"""
-
-DATAFLAG_RESOURCE_GEOFENCES = 0x00001000
-"""This resource's geofences"""
-
-DATAFLAG_RESOURCE_REPORT_TEMPLATES = 0x00002000
-"""This resource's report templates"""
-
-DATAFLAG_RESOURCE_DRIVER_ATTACHABLE_UNITS = 0x00004000
-"""This resource's units allowed for driver attachment"""
-
-DATAFLAG_RESOURCE_DRIVER_GROUPS = 0x00008000
-"""This resource's driver groups"""
-
-DATAFLAG_RESOURCE_TRAILERS = 0x00010000
-"""This resource's trailers"""
-
-DATAFLAG_RESOURCE_TRAILER_GROUPS = 0x00020000
-"""This resource's trailer groups"""
-
-DATAFLAG_RESOURCE_TRAILER_ATTACHABLE_UNITS = 0x00040000
-"""This resource's units allowed for trailer attachment"""
-
-DATAFLAG_RESOURCE_ORDERS = 0x00080000
-"""This resource's orders"""
-
-DATAFLAG_RESOURCE_GEOFENCE_GROUPS = 0x00100000
-"""This resource's geofence groups"""
-
-DATAFLAG_RESOURCE_TAGS = 0x00200000
-"""This resource's tags (passengers)"""
-
-DATAFLAG_RESOURCE_TAG_ATTACHABLE_UNITS = 0x00400000
-"""This resource's units allowed for tag attachment"""
-
-DATAFLAG_RESOURCE_TAG_GROUPS = 0x00800000
-"""This resource's tag groups (passengers)"""
-
-DATAFLAG_RESOURCE_ALL = 4611686018427387903
-"""All possible resource data flags"""
-
-
-## Retranslator - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/format/retranslator
-DATAFLAG_RETRANSLATOR_BASE = 0x00000001
-"""This retranslator's basic properties"""
-
-DATAFLAG_RETRANSLATOR_CUSTOM_PROPERTIES = 0x00000002
-"""This retranslator's custom properties"""
-
-DATAFLAG_RETRANSLATOR_BILLING_PROPERTIES = 0x00000004
-"""This retranslator's billing properties"""
-
-DATAFLAG_RETRANSLATOR_GUID = 0x00000040
-"""This retranslator's GUID"""
-
-DATAFLAG_RETRANSLATOR_ADMIN_FIELDS = 0x00000080
-"""This retranslator's admin fields"""
-
-DATAFLAG_RETRANSLATOR_CONFIGURATION = 0x00000100
-"""This retranslator's state and configuration"""
-
-DATAFLAG_RETRANSLATOR_UNITS = 0x00000200
-"""This retranslator's bound units"""
-
-DATAFLAG_RETRANSLATOR_ALL = 4611686018427387903
-"""All possible retranslator data flags"""
-
-
-## Route - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/format/route
-DATAFLAG_ROUTE_BASE = 0x00000001
-"""This route's basic properties"""
-
-DATAFLAG_ROUTE_CUSTOM_PROPERTIES = 0x00000002
-"""This route's custom properties"""
-
-DATAFLAG_ROUTE_BILLING_PROPERTIES = 0x00000004
-"""This route's billing properties"""
-
-DATAFLAG_ROUTE_GUID = 0x00000040
-"""This route's GUID"""
-
-DATAFLAG_ROUTE_ADMIN_FIELDS = 0x00000080
-"""This route's administrative fields"""
-
-DATAFLAG_ROUTE_CONFIGURATION = 0x00000100
-"""This route's configuration"""
-
-DATAFLAG_ROUTE_CHECKPOINTS = 0x00000200
-"""This route's checkpoints"""
-
-DATAFLAG_ROUTE_SCHEDULES = 0x00000400
-"""This route's schedules"""
-
-DATAFLAG_ROUTE_ROUNDS = 0x00000800
-"""This route's rounds"""
-
-DATAFLAG_ROUTE_ALL = 4611686018427387903
-"""All possible route data flags"""
-
-
-## Unit - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/format/unit
-DATAFLAG_UNIT_BASE = 0x00000001
-"""This unit's basic properties"""
-
-DATAFLAG_UNIT_CUSTOM_PROPERTIES = 0x00000002
-"""This unit's custom properties"""
-
-DATAFLAG_UNIT_BILLING_PROPERTIES = 0x00000004
-"""This unit's billing properties"""
-
-DATAFLAG_UNIT_CUSTOM_FIELDS = 0x00000008
-"""This unit's custom fields"""
-
-DATAFLAG_UNIT_IMAGE = 0x00000010
-"""This unit's image/icon"""
-
-DATAFLAG_UNIT_MESSAGES = 0x00000020
-"""This unit's messages"""
-
-DATAFLAG_UNIT_GUID = 0x00000040
-"""This unit's GUID"""
-
-DATAFLAG_UNIT_ADMIN_FIELDS = 0x00000080
-"""This unit's administrative fields"""
-
-DATAFLAG_UNIT_ADVANCED_PROPERTIES = 0x00000100
-"""This unit's advanced properties"""
-
-DATAFLAG_UNIT_CURRENT_MOMENT_COMMANDS = 0x00000200
-"""This unit's available for current moment commands"""
-
-DATAFLAG_UNIT_LAST_MESSAGE = 0x00000400
-"""This unit's last message and position"""
-
-DATAFLAG_UNIT_SENSORS = 0x00001000
-"""This unit's sensors"""
-
-DATAFLAG_UNIT_COUNTERS = 0x00002000
-"""This unit's counters"""
-
-DATAFLAG_UNIT_MAINTENANCE = 0x00008000
-"""This unit's maintenance"""
-
-DATAFLAG_UNIT_REPORT_CONFIGURATION = 0x00020000
-"""This unit's report configuration, trip detector, and fuel consumption"""
-
-DATAFLAG_UNIT_AVAILABLE_COMMANDS = 0x00080000
-"""This unit's available commands"""
-
-DATAFLAG_UNIT_MESSAGE_PARAMETERS = 0x00100000
-"""This unit's message parameters"""
-
-DATAFLAG_UNIT_CONNECTION_STATUS = 0x00200000
-"""This unit's connection status"""
-
-DATAFLAG_UNIT_POSITION = 0x00400000
-"""This unit's position"""
-
-DATAFLAG_UNIT_PROFILE_FIELDS = 0x00800000
-"""This unit's profile files"""
-
-DATAFLAG_UNIT_ALL = 4611686018427387903
-"""All possible unit data flags"""
-
-
-## Unit Groups - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/format/group
-DATAFLAG_GROUP_BASE = 0x00000001
-"""This group's basic properties"""
-
-DATAFLAG_GROUP_CUSTOM_PROPERTIES = 0x00000002
-"""This group's custom properties"""
-
-DATAFLAG_GROUP_BILLING_PROPERTIES = 0x00000004
-"""This group's billing properties"""
-
-DATAFLAG_GROUP_CUSTOM_FIELDS = 0x00000008
-"""This group's custom fields"""
-
-DATAFLAG_GROUP_IMAGE = 0x00000010
-"""This group's image/icon"""
-
-DATAFLAG_GROUP_GUID = 0x00000040
-"""This group's GUID"""
-
-DATAFLAG_GROUP_ADMIN_FIELDS = 0x00000080
-"""This group's administrative fields"""
-
-DATAFLAG_GROUP_ALL = 4611686018427387903
-"""All possible group data flags"""
-
-
-## User - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/format/user
-DATAFLAG_USER_BASE = 0x00000001
-"""This user's basic properties"""
-
-DATAFLAG_USER_CUSTOM_PROPERTIES = 0x00000002
-"""This user's custom properties"""
-
-DATAFLAG_USER_BILLING_PROPERTIES = 0x00000004
-"""This user's billing properties"""
-
-DATAFLAG_USER_CUSTOM_FIELDS = 0x00000008
-"""This user's custom fields"""
-
-DATAFLAG_USER_MESSAGES = 0x00000020
-"""This user's messages"""
-
-DATAFLAG_USER_GUID = 0x00000040
-"""This user's GUID"""
-
-DATAFLAG_USER_ADMIN_FIELDS = 0x00000080
-"""This user's administrative fields"""
-
-DATAFLAG_USER_OTHER_PROPERTIES = 0x00000100
-"""This user's other properties"""
-
-DATAFLAG_USER_NOTIFICATIONS = 0x00000200
-"""This user's notifications"""
-
-DATAFLAG_USER_ALL = 4611686018427387903
-"""All possible user data flags"""
-
-
-# Settings flags
-## User - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/user/update_user_flags
-SETTINGSFLAG_USER_DISABLED = 0x01
-"""This user is disabled"""
-
-SETTINGSFLAG_USER_CANNOT_CHANGE_PASSWORD = 0x02
-"""This user cannot change their password"""
-
-SETTINGSFLAG_USER_CAN_CREATE_ITEMS = 0x04
-"""This user can create objects"""
-
-SETTINGSFLAG_USER_CANNOT_CHANGE_SETTINGS = 0x10
-"""This user cannot change settings"""
-
-SETTINGSFLAG_USER_CAN_SEND_SMS = 0x20
-"""This user can send SMS messages"""
-
-
-# Token flags
-## General - https://sdk.wialon.com/wiki/en/sidebar/remoteapi/apiref/format/token
-TOKENFLAG_ONLINE_TRACKING = 0x100
-"""Online tracking"""
-
-TOKENFLAG_VIEW_ACCESS = 0x200
-"""View access to most data"""
-
-TOKENFLAG_MANAGE_NONSENSITIVE = 0x400
-"""Modification of non-sensitive data"""
-
-TOKENFLAG_MANAGE_SENSITIVE = 0x800
-"""Modification of sensitive data"""
-
-TOKENFLAG_MANAGE_CRITICAL = 0x1000
-"""Modification of critical data, including message deletion"""
-
-TOKENFLAG_COMMUNICATION = 0x2000
-"""Modification of communication data"""
-
-TOKENFLAG_MANAGE_ALL = -1
-"""Unlimited operation as authorized user"""

terminusgps/wialon/items/base.py

@@ -14,7 +14,9 @@ class WialonBase:
 
         self._session = session
         self._id = str(id if id else self.create(*args, **kwargs))
-        self.populate()
+        self._name = None
+        self._hw_type = None
+        self._access_lvl = None
 
     def __str__(self) -> str:
         return str(self.id)
@@ -26,9 +28,30 @@ class WialonBase:
         )
         if response is not None:
             item = response.get("item", {})
-            self.name = item.get("nm")
-            self.hw_type = item.get("cls")
-            self.access_lvl = item.get("uacl")
+            self._name = item.get("nm")
+            self._hw_type = item.get("cls")
+            self._access_lvl = item.get("uacl")
+
+    @property
+    def name(self) -> str:
+        """Name of the Wialon object."""
+        if self._name is None:
+            self.populate()
+        return str(self._name)
+
+    @property
+    def hw_type(self) -> str:
+        """Hardware type of the Wialon object."""
+        if self._hw_type is None:
+            self.populate()
+        return str(self._hw_type)
+
+    @property
+    def access_lvl(self) -> str:
+        """Access level of the Wialon object."""
+        if self._access_lvl is None:
+            self.populate()
+        return str(self._access_lvl)
 
     @property
     def session(self) -> WialonSession:

terminusgps/wialon/items/unit.py

@@ -1,10 +1,18 @@
-from urllib.parse import quote_plus
+from urllib.parse import quote_plus, urljoin
+
+from django.conf import settings
 
 from terminusgps.wialon import flags
 from terminusgps.wialon.items.base import WialonBase
 
 
 class WialonUnit(WialonBase):
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self._imei_number = None
+        self._active = None
+        self._image_uri = None
+
     def create(
         self, creator_id: str | int, name: str, hw_type_id: str | int
     ) -> int | None:
@@ -48,11 +56,13 @@ class WialonUnit(WialonBase):
             **{
                 "id": self.id,
                 "flags": (
-                    flags.DataFlag.UNIT_ADVANCED_PROPERTIES | flags.DataFlag.UNIT_IMAGE
+                    flags.DataFlag.UNIT_ADVANCED_PROPERTIES
+                    | flags.DataFlag.UNIT_IMAGE
+                    | flags.DataFlag.UNIT_ADMIN_FIELDS
                 ).value,
             }
         )
-        if response:
+        if response is not None:
             item = response.get("item", {})
             self._imei_number = item.get("uid")
             self._active = item.get("act", False)
@@ -79,28 +89,72 @@ class WialonUnit(WialonBase):
 
     @property
     def available_commands(self) -> dict:
-        """Assigned commands to the unit."""
+        """
+        Commands assigned to the unit.
+
+        :type: :py:obj:`dict`
+
+        """
         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
+        """
+        Image URI for the unit.
+
+        :type :py:obj:`str`
+
+        """
+        if self._image_uri is None:
+            self.populate()
+        return str(self._image_uri)
 
     @property
-    def imei_number(self) -> int | None:
-        """The unit's IMEI number."""
-        if self._imei_number:
-            return int(self._imei_number)
+    def imei_number(self) -> str:
+        """
+        IMEI # for the unit.
+
+        :type: :py:obj:`str`
+
+        """
+        if self._imei_number is None:
+            self.populate()
+        return str(self._imei_number)
+
+    @property
+    def iccid(self) -> str | None:
+        """
+        SIM Card # for the unit, if any.
+
+        :type: :py:obj:`str` | :py:obj:`None`
+
+        """
+        return self.afields.get("iccid")
+
+    @property
+    def carrier(self) -> str | None:
+        """
+        Name of the telecommunications company associated with the unit's SIM card, if any.
+
+        :type: :py:obj:`str` | :py:obj:`None`
+
+        """
+        return self.afields.get("carrier")
 
     @property
     def active(self) -> bool:
-        """Whether or not the unit is active."""
-        if self._active:
-            return bool(self._active)
-        return False
+        """Whether or not the unit is activated."""
+        if self._active is None:
+            self.populate()
+        return bool(self._active)
+
+    @property
+    def image_url(self) -> str | None:
+        if hasattr(settings, "WIALON_HOST"):
+            return urljoin(settings.WIALON_HOST, self._image_uri)
+        return urljoin("https://hst-api.wialon.com", self._image_uri)
 
     def execute_command(
         self,

terminusgps/wialon/session.py

@@ -269,7 +269,7 @@ class WialonSession:
 
         """
         try:
-            self.logger.info("Logging into Wialon API session...")
+            self.logger.debug("Logging into Wialon API session...")
             response = self.wialon_api.token_login(**{"token": token, "fl": flags})
             self._set_login_response(response)
             self.logger.debug(f"Logged into Wialon API session '{response.get('eid')}'")
@@ -286,7 +286,7 @@ class WialonSession:
         :rtype: :py:obj:`None`
 
         """
-        self.logger.info("Logging out of Wialon API session...")
+        self.logger.debug("Logging out of Wialon API session...")
         response: dict = self.wialon_api.core_logout({})
 
         if response.get("error") != 0:

terminusgps/wialon/utils.py

@@ -6,7 +6,69 @@ from terminusgps.wialon import constants, flags
 from terminusgps.wialon.session import WialonSession
 
 
-def get_resource_ids(session: WialonSession) -> list[int] | None:
+def get_units_by_carrier(carrier_name: str, session: WialonSession) -> list[str]:
+    """
+    Returns a list of all unit ids by telecommunications carrier company name.
+
+    :param carrier_name: A telecommunications carrier company name, e.g. ``"US Cell"`` or ``"Conetixx"``.
+    :type carrier_name: :py:obj:`str`
+    :param session: A valid Wialon API session.
+    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :returns: A list of unit ids.
+    :rtype: :py:obj:`list`
+
+    """
+    property: str = constants.WialonItemProperty.ADMIN_FIELD_NAME_VALUE.value
+    results = session.wialon_api.core_search_items(
+        **{
+            "spec": {
+                "itemsType": "avl_unit",
+                "propName": property,
+                "propValueMask": f"carrier:{carrier_name}",
+                "sortType": property,
+            },
+            "force": 0,
+            "flags": flags.DataFlag.UNIT_BASE.value,
+            "from": 0,
+            "to": 0,
+        }
+    )
+    return [item.get("id") for item in results.get("items", [])]
+
+
+def get_unit_by_iccid(iccid: str, session: WialonSession) -> str | None:
+    """
+    Returns a unit id by iccid (SIM card #).
+
+    :param iccid: A SIM card #.
+    :type iccid: :py:obj:`str`
+    :param session: A valid Wialon API session.
+    :type session: :py:obj:`~terminusgps.wialon.session.WialonSession`
+    :returns: The unit id, if it was found.
+    :rtype: :py:obj:`str` | :py:obj:`None`
+
+    """
+    property: str = constants.WialonItemProperty.ADMIN_FIELD_NAME_VALUE.value
+    results = session.wialon_api.core_search_items(
+        **{
+            "spec": {
+                "itemsType": "avl_unit",
+                "propName": property,
+                "propValueMask": f"iccid:{iccid}",
+                "sortType": property,
+            },
+            "force": 0,
+            "flags": flags.DataFlag.UNIT_BASE.value,
+            "from": 0,
+            "to": 0,
+        }
+    )
+    if results.get("totalItemsCount") != 1:
+        raise ValueError(results)
+    return results.get("items", [{}])[0].get("id")
+
+
+def get_resources(session: WialonSession) -> list[int] | None:
     """
     Returns a list of all resource ids in Wialon.
 
@@ -61,7 +123,7 @@ def get_hw_type_id(name: str, session: WialonSession) -> int | None:
     return int(hw_types.get(name)) if name in hw_types.keys() else None
 
 
-def get_id_from_imei(imei: str, session: WialonSession) -> str | None:
+def get_unit_by_imei(imei: str, session: WialonSession) -> str | None:
     """
     Takes a Wialon unit's IMEI # and returns its unit id.
 
@@ -170,11 +232,11 @@ def generate_wialon_password(length: int = 32) -> 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}."
+            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}."
+            f"Password cannot be less than {min_length} characters in length, got {length}."
         )
 
     s0 = list(string.ascii_uppercase)

terminusgps/{validators.py → wialon/validators.py}

@@ -1,20 +1,38 @@
 import string
 
-from django.core.exceptions import ValidationError
+from django.conf import settings
+from django.core.exceptions import ImproperlyConfigured, ValidationError
 from django.utils.translation import gettext_lazy as _
 
-from .wialon.session import WialonSession
+from terminusgps.wialon.session import WialonSession
+
+if not hasattr(settings, "WIALON_TOKEN"):
+    raise ImproperlyConfigured("'WIALON_TOKEN' setting is required.")
 
 
 class WialonValidatorBase:
     def __init__(self) -> None:
         self.session: WialonSession = WialonSession()
-        self.session.login(self.session.token)
+        self.session.login(settings.WIALON_TOKEN)
 
     def __call__(self, value: str) -> None:
         raise NotImplementedError("Subclasses must implement this method.")
 
 
+class WialonVinNumberValidator(WialonValidatorBase):
+    def __call__(self, value: str) -> None:
+        response = self.session.wialon_api.unit_get_vin_info(vin=value)
+        if "error" in response["vin_lookup_result"].keys():
+            raise ValidationError(
+                _("Failed to get info for VIN '%(value)s': '%(message)s'"),
+                code="invalid",
+                params={
+                    "value": value,
+                    "message": response["vin_lookup_result"].get("message", ""),
+                },
+            )
+
+
 class WialonImeiNumberValidator(WialonValidatorBase):
     def __call__(self, value: str) -> None:
         response = self.session.wialon_api.core_search_items(
@@ -33,7 +51,7 @@ class WialonImeiNumberValidator(WialonValidatorBase):
         )
         if response is None or not response.get("items"):
             raise ValidationError(
-                _("IMEI #%(value)s was not found in Wialon."),
+                _("IMEI '%(value)s' was not found in Wialon."),
                 code="invalid",
                 params={"value": value},
             )
@@ -41,20 +59,18 @@ class WialonImeiNumberValidator(WialonValidatorBase):
 
 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
+    WialonImeiNumberValidator()(value)
 
 
 def validate_vin_number(value: str) -> None:
     """Raises :py:exec:`ValidationError` if the value is an invalid VIN number."""
-    if not len(value) == 17:
+    if len(value) != 17:
         raise ValidationError(
-            _("Whoops! VIN # must be exactly 17 characters long, got %(len)s."),
+            _("Whoops! VIN # must be exactly 17 characters in length, got %(length)s."),
             code="invalid",
-            params={"len": len(value)},
+            params={"length": len(value)},
         )
+    WialonVinNumberValidator()(value)
 
 
 def validate_wialon_password(value: str) -> None:
@@ -62,19 +78,16 @@ def validate_wialon_password(value: str) -> None:
     special_symbols_0: list[str] = ["!", "@", "#", "$", "%", "^", "*"]
     special_symbols_1: list[str] = ["(", ")", "[", "]", "-", "_", "+"]
     forbidden_symbols: list[str] = [",", ":", "&", "<", ">", "'"]
-    value = value.strip() if value.startswith(" ") or value.endswith(" ") else value
 
     if len(value) < 4:
         raise ValidationError(
-            _("Password cannot be less than 4 characters in length. Got '%(len)s'."),
+            _("Password cannot be less than 4 characters in length, got %(len)s."),
             code="invalid",
             params={"len": len(value)},
         )
     if len(value) > 64:
         raise ValidationError(
-            _(
-                "Password cannot be greater than 64 characters in length. Got '%(len)s'."
-            ),
+            _("Password cannot be greater than 64 characters in length, got %(len)s."),
             code="invalid",
             params={"len": len(value)},
         )