layrz-sdk 4.0.8__py3-none-any.whl → 4.0.10__py3-none-any.whl

layrz_sdk/entities/ats_possible_exit.py

@@ -19,7 +19,6 @@ class AtsPossibleExit(BaseModel):
   identifier: int | None = Field(
     default=None,
     description='Nullable positive big integer identifier for the exit',
-    ge=0,
   )
 
   # Volume / gauge snapshots

layrz_sdk/entities/message.py

@@ -1,15 +1,13 @@
 """Message entity"""
 
 from datetime import datetime
-from typing import Any, TypeAlias
+from typing import Any
 
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, field_validator
 
 from layrz_sdk.constants import UTC
-
-from .position import Position
-
-PayloadType: TypeAlias = dict[str, Any]
+from layrz_sdk.entities.geofence import Geofence
+from layrz_sdk.entities.position import Position
 
 
 class Message(BaseModel):
@@ -27,11 +25,11 @@ class Message(BaseModel):
     default_factory=lambda: Position(),
     description='Current position of the device',
   )
-  payload: PayloadType = Field(
+  payload: dict[str, Any] = Field(
     default_factory=dict,
     description='Payload data of the device message',
   )
-  sensors: PayloadType = Field(
+  sensors: dict[str, Any] = Field(
     default_factory=dict,
     description='Sensor data of the device message',
   )
@@ -39,3 +37,19 @@ class Message(BaseModel):
     default_factory=lambda: datetime.now(UTC),
     description='Timestamp when the message was received',
   )
+
+  geofences: list[Geofence] = Field(
+    default_factory=list,
+    description='List of geofences associated with the message',
+  )
+
+  @field_validator('geofences', mode='before')
+  def _validate_geofences(cls, value: Any) -> list[Geofence]:
+    """Validate geofences"""
+    if value is None:
+      return []
+
+    if not isinstance(value, list):
+      return []
+
+    return value

layrz_sdk/entities/operation.py

@@ -150,6 +150,17 @@ class Operation(BaseModel):
     description='Defines the destination phone numbers for Twilio notifications',
   )
 
+  @field_validator('destination_phones', mode='before')
+  def serialize_destination_phones(cls, value: Any) -> list[DestinationPhone]:
+    """Serialize destination phones to a list of DestinationPhone"""
+    if isinstance(value, list):
+      return value
+
+    if isinstance(value, DestinationPhone):
+      return [value]
+
+    return []
+
   attach_image: bool = Field(
     default=False,
     description='Defines if the operation should attach an image',

layrz_sdk/entities/operation_payload.py

@@ -204,6 +204,17 @@ class OperationPayload(BaseModel):
     description='Defines the destination phone numbers for Twilio notifications',
   )
 
+  @field_validator('destinations', mode='before')
+  def serialize_destinations(cls, value: Any) -> list[DestinationPhone]:
+    """Serialize destinations to a list of DestinationPhone"""
+    if isinstance(value, list):
+      return value
+
+    if isinstance(value, DestinationPhone):
+      return [value]
+
+    return []
+
   twilio_host_phone: DestinationPhone | None = Field(
     default=None,
     description='Defines the host phone number for Twilio notifications',

layrz_sdk/entities/position.py

@@ -1,6 +1,6 @@
 """Position entity"""
 
-from typing import Any, Self
+from typing import Any, Self, cast
 
 from pydantic import BaseModel, Field, field_validator
 
@@ -32,7 +32,7 @@ class Position(BaseModel):
       value = float(value)
 
     if -90 <= value <= 90:
-      return value
+      return cast(float, value)
 
     return None
 
@@ -49,7 +49,7 @@ class Position(BaseModel):
       value = float(value)
 
     if -180 <= value <= 180:
-      return value
+      return cast(float, value)
 
     return None
 
@@ -76,7 +76,7 @@ class Position(BaseModel):
     if isinstance(value, int):
       value = float(value)
 
-    return value
+    return cast(float, value)
 
   @field_validator('speed', mode='before')
   def _validate_speed(cls: Self, value: Any) -> None | float:
@@ -90,7 +90,7 @@ class Position(BaseModel):
     if isinstance(value, int):
       value = float(value)
 
-    return abs(value)
+    return cast(float, abs(value))
 
   @field_validator('direction', mode='before')
   def _validate_direction(cls: Self, value: Any) -> None | float:
@@ -105,6 +105,6 @@ class Position(BaseModel):
       value = float(value)
 
     if 0 <= value <= 360:
-      return value
+      return cast(float, value)
 
     return None

layrz_sdk/entities/report.py

@@ -10,13 +10,12 @@ from typing import Any, Optional, Self
 import xlsxwriter
 from pydantic import BaseModel, Field, field_validator
 
+from layrz_sdk.entities.custom_report_page import CustomReportPage
+from layrz_sdk.entities.report_data_type import ReportDataType
+from layrz_sdk.entities.report_format import ReportFormat
+from layrz_sdk.entities.report_page import ReportPage
 from layrz_sdk.helpers.color import use_black
 
-from .custom_report_page import CustomReportPage
-from .report_data_type import ReportDataType
-from .report_format import ReportFormat
-from .report_page import ReportPage
-
 log = logging.getLogger(__name__)
 
 
@@ -87,6 +86,7 @@ class Report(BaseModel):
     else:
       raise AttributeError(f'Unsupported export format: {self.export_format}')
 
+  @warnings.deprecated('export_as_json is deprecated, use export with export_format=ReportFormat.JSON instead')
   def export_as_json(self: Self) -> dict[str, Any]:
     """Returns the report as a JSON dict"""
     return self._export_json()
@@ -98,7 +98,7 @@ class Report(BaseModel):
       if isinstance(page, CustomReportPage):
         continue
 
-      headers = []
+      headers: list[dict[str, Any]] = []
       for header in page.headers:
         headers.append(
           {
@@ -231,34 +231,44 @@ class Report(BaseModel):
             'font_name': 'Aptos Narrow',
           }
 
+          format_ = book.add_format(style)
+
+          if cell.lock:
+            format_.set_locked(True)
+
           value: Any = None
 
-          if cell.data_type == ReportDataType.BOOL:
-            value = 'Yes' if cell.content else 'No'
-          elif cell.data_type == ReportDataType.DATETIME:
-            value = cell.content.strftime(cell.datetime_format)
-          elif cell.data_type == ReportDataType.INT:
-            try:
-              value = int(cell.content)
-            except ValueError:
-              value = cell.content
-              log.warning(f'Invalid int value: {cell.content} in cell {i + 1}, {j}')
-          elif cell.data_type == ReportDataType.FLOAT:
-            try:
+          match cell.data_type:
+            case ReportDataType.BOOL:
+              value = 'Yes' if cell.content else 'No'
+
+            case ReportDataType.DATETIME:
+              value = cell.content.strftime(cell.datetime_format)
+
+            case ReportDataType.INT:
+              try:
+                value = int(cell.content)
+              except ValueError:
+                value = cell.content
+                log.warning(f'Invalid int value: {cell.content} in cell {i + 1}, {j}')
+
+            case ReportDataType.FLOAT:
+              try:
+                value = float(cell.content)
+                format_.set_num_format('0.00')
+
+              except ValueError:
+                value = cell.content
+                log.warning(f'Invalid float value: {cell.content} in cell {i + 1}, {j}')
+
+            case ReportDataType.CURRENCY:
               value = float(cell.content)
-              style.update({'num_format': '0.00'})
-            except ValueError:
-              value = cell.content
-              log.warning(f'Invalid float value: {cell.content} in cell {i + 1}, {j}')
-          elif cell.data_type == ReportDataType.CURRENCY:
-            value = float(cell.content)
-            style.update(
-              {'num_format': f'"{cell.currency_symbol}" * #,##0.00;[Red]"{cell.currency_symbol}" * #,##0.00'}
-            )
-          else:
-            value = cell.content
+              format_.set_num_format(f'"{cell.currency_symbol}" * #,##0.00;[Red]"{cell.currency_symbol}" * #,##0.00')
+
+            case _:
+              value = str(cell.content)
 
-          sheet.write(i + 1, j, value, book.add_format(style))
+          sheet.write(i + 1, j, value, format_)
 
           if row.compact:
             sheet.set_row(i + 1, None, None, {'level': 1, 'hidden': True})

layrz_sdk/entities/report_col.py

@@ -20,6 +20,7 @@ class ReportCol(BaseModel):
   datetime_format: str = Field(description='Datetime format', default='%Y-%m-%d %H:%M:%S')
   currency_symbol: str = Field(description='Currency symbol', default='')
   bold: bool = Field(description='Bold text', default=False)
+  lock: bool = Field(description='Lock column', default=False)
 
   @field_validator('text_color', mode='before')
   def _validate_text_color(cls: Self, value: Any) -> Any:

layrz_sdk/entities/telemetry/assetmessage.py

@@ -117,7 +117,7 @@ class AssetMessage(BaseModel):
       case AssetOperationMode.STATIC:
         obj.position = asset.static_position.model_dump(exclude_none=True) if asset.static_position else {}
       case AssetOperationMode.ZONE:
-        points = MultiPoint([(p.longitude, p.latitude) for p in asset.points])
+        points: MultiPoint = MultiPoint([(p.longitude, p.latitude) for p in asset.points])
         obj.position = {'latitude': points.centroid.y, 'longitude': points.centroid.x}
       case _:
         obj.position = device_message.position

layrz_sdk/lcl/core.py

@@ -1,9 +1,7 @@
 """Layrz Compute Language SDK"""
 
 # ruff: noqa: ANN401
-from typing import Any, Optional
-
-from layrz_sdk.entities.message import PayloadType
+from typing import Any, Optional, Self, cast
 
 PATTERN_INVALID = 'Pattern should be string, received {received}'
 INVALID_NUMBER_OF_PARAMS = 'Invalid number of arguments - Expected {expected} - Given {received}'
@@ -18,9 +16,9 @@ class LclCore:
   def __init__(
     self,
     script: str = '',
-    sensors: Optional[PayloadType] = None,
-    previous_sensors: Optional[PayloadType] = None,
-    payload: Optional[PayloadType] = None,
+    sensors: dict[str, Any] | None = None,
+    previous_sensors: dict[str, Any] | None = None,
+    payload: dict[str, Any] | None = None,
     asset_constants: Optional[dict[str, Any]] = None,
     custom_fields: Optional[dict[str, Any]] = None,
   ) -> None:
@@ -158,7 +156,7 @@ class LclCore:
 
       return json.dumps(INVALID_ARGUMENTS.format(e=err))
 
-  def _standarize_datatypes(self, args: list[Any]) -> list[Any]:
+  def _standarize_datatypes(self: Self, args: Any) -> Any:
     """Standarize data types"""
     result_args = []
 
@@ -170,7 +168,7 @@ class LclCore:
 
     return result_args
 
-  def GET_PARAM(self, *args: list[Any]) -> Any:
+  def GET_PARAM(self: Self, *args: Any) -> Any | None:
     """GET_PARAM Function"""
     if len(args) > 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=2, received=len(args))
@@ -178,17 +176,20 @@ class LclCore:
     if args[0] is None:
       return None
 
+    if not isinstance(args[0], str):
+      return f'Argument 0 should be a string, got {type(args[0]).__name__}'
+
     if len(args) > 1:
-      return self._payload.get(args[0], args[1])  # type: ignore
-    return self._payload.get(args[0], None)  # type: ignore
+      return self._payload.get(args[0], args[1])
+    return self._payload.get(args[0], None)
 
-  def GET_DISTANCE_TRAVELED(self, *args: list[Any]) -> str | float:
+  def GET_DISTANCE_TRAVELED(self: Self, *args: Any) -> str | float:
     """GET_DISTANCE_TRAVELED Function"""
     if len(args) > 0:
       return INVALID_NUMBER_OF_PARAMS.format(expected=0, received=len(args))
-    return self._asset_constants.get('distanceTraveled', 0)  # type: ignore
+    return cast(float, self._asset_constants.get('distanceTraveled', 0))
 
-  def GET_PREVIOUS_SENSOR(self, *args: list[Any]) -> Any:
+  def GET_PREVIOUS_SENSOR(self: Self, *args: Any) -> Any:
     """GET_PREVIOUS_SENSOR Function"""
     if len(args) < 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -200,10 +201,10 @@ class LclCore:
       return None
 
     if len(args) > 1:
-      return self._previous_sensors.get(args[0], args[1])  # type: ignore
-    return self._previous_sensors.get(args[0], None)  # type: ignore
+      return self._previous_sensors.get(args[0], args[1])
+    return self._previous_sensors.get(args[0], None)
 
-  def GET_SENSOR(self, *args: list[Any]) -> Any:
+  def GET_SENSOR(self: Self, *args: Any) -> Any:
     """GET_SENSOR Function"""
     if len(args) < 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -215,16 +216,16 @@ class LclCore:
       return None
 
     if len(args) > 1:
-      return self._sensors.get(args[0], args[1])  # type: ignore
-    return self._sensors.get(args[0], None)  # type: ignore
+      return self._sensors.get(args[0], args[1])
+    return self._sensors.get(args[0], None)
 
-  def CONSTANT(self, *args: list[Any]) -> Any:
+  def CONSTANT(self: Self, *args: Any) -> Any:
     """CONSTANT Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
     return args[0]
 
-  def GET_CUSTOM_FIELD(self, *args: list[Any]) -> str:
+  def GET_CUSTOM_FIELD(self: Self, *args: Any) -> str | None:
     """GET_CUSTOM_FIELD Function"""
     if len(args) > 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=2, received=len(args))
@@ -233,11 +234,11 @@ class LclCore:
       return None
 
     if len(args) > 1:
-      return self._custom_fields.get(args[0], args[1])  # type: ignore
+      return cast(str | None, self._custom_fields.get(args[0], args[1]))
 
-    return self._custom_fields.get(args[0], '')  # type: ignore
+    return cast(str | None, self._custom_fields.get(args[0], ''))
 
-  def COMPARE(self, *args: list[Any]) -> str | None | bool:
+  def COMPARE(self: Self, *args: Any) -> str | None | bool:
     """COMPARE Function"""
     if len(args) != 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=2, received=len(args))
@@ -245,13 +246,13 @@ class LclCore:
     if args[0] is None or args[1] is None:
       return None
 
-    args = self._standarize_datatypes(args)  # type: ignore
+    args = self._standarize_datatypes(args)
 
     if not isinstance(args[0], type(args[1])):
       return DIFFERENT_TYPES.format(arg1=type(args[0]).__name__, arg2=type(args[1]).__name__)
-    return args[0] == args[1]
+    return cast(bool, args[0] == args[1])
 
-  def OR_OPERATOR(self, *args: list[Any]) -> bool:
+  def OR_OPERATOR(self: Self, *args: Any) -> bool | None:
     """OR_OPERATOR Function"""
     result = False
 
@@ -263,7 +264,7 @@ class LclCore:
 
     return result
 
-  def AND_OPERATOR(self, *args: list[Any]) -> bool:
+  def AND_OPERATOR(self: Self, *args: Any) -> bool | None:
     """AND_OPERATOR Function"""
     result = False
     is_first = True
@@ -274,30 +275,30 @@ class LclCore:
 
       if is_first:
         is_first = False
-        result = val  # type: ignore
+        result = val
       elif isinstance(val, bool):
         result = result and val
 
     return result
 
-  def SUM(self, *args: list[Any]) -> float:
+  def SUM(self: Self, *args: Any) -> float | None:
     """SUM Function"""
-    result = 0
+    result: float = 0
 
     for num in args:
       if num is None:
         return None
 
       try:
-        result += float(num)  # type: ignore
+        result += float(num)
       except Exception:
         pass
 
     return result
 
-  def SUBSTRACT(self, *args: list[Any]) -> float:
+  def SUBSTRACT(self: Self, *args: Any) -> float | None:
     """SUBSTRACT Function"""
-    result = 0
+    result: float = 0
     is_first = True
 
     for num in args:
@@ -306,18 +307,18 @@ class LclCore:
 
       try:
         if is_first:
-          result = float(num)  # type: ignore
+          result = float(num)
           is_first = False
         else:
-          result -= float(num)  # type: ignore
+          result -= float(num)
       except Exception:
         pass
 
     return result
 
-  def MULTIPLY(self, *args: list[Any]) -> float:
+  def MULTIPLY(self: Self, *args: Any) -> float | None:
     """MULTIPLY Function"""
-    result = 0
+    result: float = 0
     is_first = True
 
     for num in args:
@@ -327,17 +328,17 @@ class LclCore:
       try:
         if is_first:
           is_first = False
-          result = float(num)  # type: ignore
+          result = float(num)
         else:
-          result *= float(num)  # type: ignore
+          result *= float(num)
       except Exception:
         pass
 
     return result
 
-  def DIVIDE(self, *args: list[Any]) -> float:
+  def DIVIDE(self: Self, *args: Any) -> float | None:
     """DIVIDE Function"""
-    result = 0
+    result: float = 0
     is_first = True
 
     for num in args:
@@ -347,15 +348,15 @@ class LclCore:
       try:
         if is_first:
           is_first = False
-          result = float(num)  # type: ignore
+          result = float(num)
         else:
-          result /= float(num)  # type: ignore
+          result /= float(num)
       except Exception:
         pass
 
     return result
 
-  def TO_BOOL(self, *args: list[Any]) -> str | None | bool:
+  def TO_BOOL(self: Self, *args: Any) -> str | None | bool:
     """TO_BOOL Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -365,7 +366,7 @@ class LclCore:
 
     return bool(args[0])
 
-  def TO_STR(self, *args: list[Any]) -> str | None:
+  def TO_STR(self: Self, *args: Any) -> str | None:
     """TO_STR Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -375,7 +376,7 @@ class LclCore:
 
     return str(args[0])
 
-  def TO_INT(self, *args: list[Any]) -> str | None | int:
+  def TO_INT(self: Self, *args: Any) -> str | None | int:
     """TO_INT Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -383,9 +384,9 @@ class LclCore:
     if args[0] is None:
       return None
 
-    return int(args[0])  # type: ignore
+    return int(args[0])
 
-  def CEIL(self, *args: list[Any]) -> str | None | int:
+  def CEIL(self: Self, *args: Any) -> str | None | int:
     """CEIL Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -400,7 +401,7 @@ class LclCore:
 
     return math.ceil(args[0])
 
-  def FLOOR(self, *args: list[Any]) -> str | None | int:
+  def FLOOR(self: Self, *args: Any) -> str | None | int:
     """FLOOR Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -415,7 +416,7 @@ class LclCore:
 
     return math.floor(args[0])
 
-  def ROUND(self, *args: list[Any]) -> str | None | int:
+  def ROUND(self: Self, *args: Any) -> str | None | int:
     """ROUND Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -428,7 +429,7 @@ class LclCore:
 
     return round(args[0])
 
-  def SQRT(self, *args: list[Any]) -> str | None | float:
+  def SQRT(self: Self, *args: Any) -> str | None | float:
     """SQRT Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -438,9 +439,9 @@ class LclCore:
 
     import math
 
-    return math.sqrt(args[0])  # type: ignore
+    return math.sqrt(args[0])
 
-  def CONCAT(self, *args: list[Any]) -> str | None:
+  def CONCAT(self: Self, *args: Any) -> str | None:
     """CONCAT Function"""
     for val in args:
       if val is None:
@@ -448,7 +449,7 @@ class LclCore:
 
     return ''.join([str(val) for val in args])
 
-  def RANDOM(self, *args: list[Any]) -> float | str:
+  def RANDOM(self: Self, *args: Any) -> float | str | None:
     """RANDOM Function"""
     if len(args) > 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=2, received=len(args))
@@ -460,9 +461,9 @@ class LclCore:
 
     import random
 
-    return random.random() * (float(args[1]) - float(args[0])) + float(args[0])  # type: ignore
+    return random.random() * (float(args[1]) - float(args[0])) + float(args[0])
 
-  def RANDOM_INT(self, *args: list[Any]) -> int | str:
+  def RANDOM_INT(self: Self, *args: Any) -> int | str | None:
     """RANDOM_INT Function"""
     if len(args) != 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=2, received=len(args))
@@ -472,9 +473,9 @@ class LclCore:
 
     import random
 
-    return random.randint(int(args[0]), int(args[1]))  # type: ignore
+    return random.randint(int(args[0]), int(args[1]))
 
-  def GREATER_THAN_OR_EQUALS_TO(self, *args: list[Any]) -> str | None | bool:
+  def GREATER_THAN_OR_EQUALS_TO(self: Self, *args: Any) -> str | None | bool:
     """GREATER_THAN_OR_EQUALS_TO Function"""
     if len(args) > 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -484,13 +485,17 @@ class LclCore:
     if args[0] is None or args[1] is None:
       return None
 
-    args = self._standarize_datatypes(args)  # type: ignore
+    args = self._standarize_datatypes(args)
+
+    if not isinstance(args[0], (int, float)):
+      return f'Invalid argument 0 - must be real number, not {type(args[0]).__name__}'
+
+    if not isinstance(args[1], (int, float)):
+      return f'Invalid argument 1 - must be real number, not {type(args[1]).__name__}'
 
-    if not isinstance(args[0], type(args[1])):
-      return DIFFERENT_TYPES.format(arg1=type(args[0]).__name__, arg2=type(args[1]).__name__)
     return args[0] >= args[1]
 
-  def GREATER_THAN(self, *args: list[Any]) -> str | None | bool:
+  def GREATER_THAN(self: Self, *args: Any) -> str | None | bool:
     """GREATER_THAN Function"""
     if len(args) > 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -500,13 +505,17 @@ class LclCore:
     if args[0] is None or args[1] is None:
       return None
 
-    args = self._standarize_datatypes(args)  # type: ignore
+    args = self._standarize_datatypes(args)
+
+    if not isinstance(args[0], (int, float)):
+      return f'Invalid argument 0 - must be real number, not {type(args[0]).__name__}'
+
+    if not isinstance(args[1], (int, float)):
+      return f'Invalid argument 1 - must be real number, not {type(args[1]).__name__}'
 
-    if not isinstance(args[0], type(args[1])):
-      return DIFFERENT_TYPES.format(arg1=type(args[0]).__name__, arg2=type(args[1]).__name__)
     return args[0] > args[1]
 
-  def LESS_THAN_OR_EQUALS_TO(self, *args: list[Any]) -> str | None | bool:
+  def LESS_THAN_OR_EQUALS_TO(self: Self, *args: Any) -> str | None | bool:
     """LESS_THAN_OR_EQUALS_TO Function"""
     if len(args) > 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -516,13 +525,17 @@ class LclCore:
     if args[0] is None or args[1] is None:
       return None
 
-    args = self._standarize_datatypes(args)  # type: ignore
+    args = self._standarize_datatypes(args)
+
+    if not isinstance(args[0], (int, float)):
+      return f'Invalid argument 0 - must be real number, not {type(args[0]).__name__}'
+
+    if not isinstance(args[1], (int, float)):
+      return f'Invalid argument 1 - must be real number, not {type(args[1]).__name__}'
 
-    if not isinstance(args[0], type(args[1])):
-      return DIFFERENT_TYPES.format(arg1=type(args[0]).__name__, arg2=type(args[1]).__name__)
     return args[0] <= args[1]
 
-  def LESS_THAN(self, *args: list[Any]) -> str | None | bool:
+  def LESS_THAN(self: Self, *args: Any) -> str | None | bool:
     """LESS_THAN Function"""
     if len(args) > 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -532,13 +545,17 @@ class LclCore:
     if args[0] is None or args[1] is None:
       return None
 
-    args = self._standarize_datatypes(args)  # type: ignore
+    args = self._standarize_datatypes(args)
+
+    if not isinstance(args[0], (int, float)):
+      return f'Invalid argument 0 - must be real number, not {type(args[0]).__name__}'
+
+    if not isinstance(args[1], (int, float)):
+      return f'Invalid argument 1 - must be real number, not {type(args[1]).__name__}'
 
-    if not isinstance(args[0], type(args[1])):
-      return DIFFERENT_TYPES.format(arg1=type(args[0]).__name__, arg2=type(args[1]).__name__)
     return args[0] < args[1]
 
-  def DIFFERENT(self, *args: list[Any]) -> str | None | bool:
+  def DIFFERENT(self: Self, *args: Any) -> str | None | bool:
     """DIFFERENT Function"""
     if len(args) > 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -548,13 +565,14 @@ class LclCore:
     if args[0] is None or args[1] is None:
       return None
 
-    args = self._standarize_datatypes(args)  # type: ignore
+    args = self._standarize_datatypes(args)
 
     if not isinstance(args[0], type(args[1])):
       return DIFFERENT_TYPES.format(arg1=type(args[0]).__name__, arg2=type(args[1]).__name__)
-    return args[0] != args[1]
 
-  def HEX_TO_STR(self, *args: list[Any]) -> str | None:
+    return cast(bool, args[0] != args[1])
+
+  def HEX_TO_STR(self: Self, *args: Any) -> str | None:
     """HEX_TO_STR Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -563,16 +581,16 @@ class LclCore:
       return None
 
     hexa = args[0]
-    if hexa.startswith('0x'):  # type: ignore
+    if hexa.startswith('0x'):
       hexa = hexa[2:]
 
     try:
-      byte_array = bytes.fromhex(hexa)  # type: ignore
+      byte_array = bytes.fromhex(hexa)
       return byte_array.decode('ASCII')
     except Exception:
       return 'Invalid hex string'
 
-  def STR_TO_HEX(self, *args: list[Any]) -> str | None:
+  def STR_TO_HEX(self: Self, *args: Any) -> str | None:
     """STR_TO_HEX Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -582,7 +600,7 @@ class LclCore:
 
     return str(args[0]).encode('ASCII').hex()
 
-  def HEX_TO_INT(self, *args: list[Any]) -> str | None | int:
+  def HEX_TO_INT(self: Self, *args: Any) -> str | None | int:
     """HEX_TO_INT Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -591,11 +609,11 @@ class LclCore:
       return None
 
     try:
-      return int(int(args[0], 16))  # type: ignore
+      return int(int(args[0], 16))
     except Exception:
       return 'Invalid hex string'
 
-  def INT_TO_HEX(self, *args: list[Any]) -> str | None:
+  def INT_TO_HEX(self: Self, *args: Any) -> str | None:
     """INT_TO_HEX Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -604,11 +622,11 @@ class LclCore:
       return None
 
     try:
-      return hex(int(args[0]))[2:]  # type: ignore
+      return hex(int(args[0]))[2:]
     except Exception:
       return 'Invalid int value'
 
-  def TO_FLOAT(self, *args: list[Any]) -> str | None | float:
+  def TO_FLOAT(self: Self, *args: Any) -> str | None | float:
     """TO_FLOAT Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -617,11 +635,11 @@ class LclCore:
       return None
 
     try:
-      return float(args[0])  # type: ignore
+      return float(args[0])
     except Exception:
       return f'Invalid arguments - must be real number, not {type(args[0]).__name__}'
 
-  def IS_PARAMETER_PRESENT(self, *args: list[Any]) -> str | bool:
+  def IS_PARAMETER_PRESENT(self: Self, *args: Any) -> str | bool | None:
     """IS_PARAMETER_PRESENT Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -629,9 +647,9 @@ class LclCore:
     if args[0] is None:
       return None
 
-    return args[0] in self._payload  # type: ignore
+    return args[0] in self._payload
 
-  def IS_SENSOR_PRESENT(self, *args: list[Any]) -> str | bool:
+  def IS_SENSOR_PRESENT(self: Self, *args: Any) -> str | bool | None:
     """IS_SENSOR_PRESENT Function"""
     if len(args) > 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -639,9 +657,9 @@ class LclCore:
     if args[0] is None:
       return None
 
-    return args[0] in self._sensors  # type: ignore
+    return args[0] in self._sensors
 
-  def INSIDE_RANGE(self, *args: list[Any]) -> str | None | bool:
+  def INSIDE_RANGE(self: Self, *args: Any) -> str | None | bool:
     """INSIDE_RANGE Function"""
     if len(args) != 3:
       return INVALID_NUMBER_OF_PARAMS.format(expected=3, received=len(args))
@@ -649,18 +667,20 @@ class LclCore:
     if args[0] is None or args[1] is None or args[2] is None:
       return None
 
-    args = self._standarize_datatypes(args)  # type: ignore
+    args = self._standarize_datatypes(args)
 
-    if not isinstance(args[0], type(args[1])):
-      return DIFFERENT_TYPES_RANGES.format(
-        arg1=type(args[0]).__name__,
-        arg2=type(args[1]).__name__,
-        arg3=type(args[2]).__name__,
-      )
+    if not isinstance(args[0], (int, float)):
+      return f'Invalid argument 0 - must be real number, not {type(args[0]).__name__}'
+
+    if not isinstance(args[1], (int, float)):
+      return f'Invalid argument 1 - must be real number, not {type(args[1]).__name__}'
+
+    if not isinstance(args[2], (int, float)):
+      return f'Invalid argument 2 - must be real number, not {type(args[2]).__name__}'
 
     return args[1] <= args[0] <= args[2]
 
-  def OUTSIDE_RANGE(self, *args: list[Any]) -> str | None | bool:
+  def OUTSIDE_RANGE(self: Self, *args: Any) -> str | None | bool:
     """OUTSIDE_RANGE Function"""
     if len(args) != 3:
       return INVALID_NUMBER_OF_PARAMS.format(expected=3, received=len(args))
@@ -668,7 +688,7 @@ class LclCore:
     if args[0] is None or args[1] is None or args[2] is None:
       return None
 
-    args = self._standarize_datatypes(args)  # type: ignore
+    args = self._standarize_datatypes(args)
 
     if not isinstance(args[0], type(args[1])):
       return DIFFERENT_TYPES_RANGES.format(
@@ -679,14 +699,14 @@ class LclCore:
 
     return not args[1] <= args[0] <= args[2]
 
-  def GET_TIME_DIFFERENCE(self, *args: list[Any]) -> str | float:
+  def GET_TIME_DIFFERENCE(self: Self, *args: Any) -> str | float:
     """GET_TIME_DIFFERENCE Function"""
     if len(args) > 0:
       return INVALID_NUMBER_OF_PARAMS.format(expected=0, received=len(args))
 
-    return self._asset_constants.get('timeElapsed', 0)  # type: ignore
+    return cast(float, self._asset_constants.get('timeElapsed', 0))
 
-  def IF(self, *args: list[Any]) -> Any:
+  def IF(self: Self, *args: Any) -> Any:
     """IF Function"""
     if len(args) != 3:
       return INVALID_NUMBER_OF_PARAMS.format(expected=3, received=len(args))
@@ -696,14 +716,14 @@ class LclCore:
 
     return args[1] if args[0] else args[2]
 
-  def NOW(self, *args: list[Any]) -> float:
+  def NOW(self: Self, *args: Any) -> float:
     """NOW Function"""
     import zoneinfo
     from datetime import datetime
 
     return datetime.now(tz=zoneinfo.ZoneInfo('UTC')).timestamp()
 
-  def REGEX(self, *args: list[Any]) -> str | None | bool:
+  def REGEX(self: Self, *args: Any) -> str | None | bool:
     """REGEX Function"""
     if len(args) != 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=2, received=len(args))
@@ -719,14 +739,14 @@ class LclCore:
     pattern = re.compile(args[1])
     return bool(pattern.match(args[0]))
 
-  def IS_NONE(self, *args: list[Any]) -> str | bool:
+  def IS_NONE(self: Self, *args: Any) -> str | bool:
     """IS_NONE Function"""
     if len(args) != 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
 
     return args[0] is None
 
-  def NOT(self, *args: list[Any]) -> str | bool:
+  def NOT(self: Self, *args: Any) -> str | bool | None:
     """NOT Function"""
     if len(args) != 1:
       return INVALID_NUMBER_OF_PARAMS.format(expected=1, received=len(args))
@@ -736,7 +756,7 @@ class LclCore:
 
     return not args[0]
 
-  def CONTAINS(self, *args: list[Any]) -> str | bool:
+  def CONTAINS(self: Self, *args: Any) -> str | bool | None:
     """CONTAINS function"""
     if len(args) != 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=2, received=len(args))
@@ -746,7 +766,7 @@ class LclCore:
 
     return str(args[0]) in str(args[1])
 
-  def STARTS_WITH(self, *args: list[Any]) -> str | bool:
+  def STARTS_WITH(self: Self, *args: Any) -> str | bool | None:
     """STARTS_WITH function"""
     if len(args) != 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=2, received=len(args))
@@ -756,7 +776,7 @@ class LclCore:
 
     return str(args[1]).startswith(str(args[0]))
 
-  def ENDS_WITH(self, *args: list[Any]) -> str | bool:
+  def ENDS_WITH(self: Self, *args: Any) -> str | bool | None:
     """ENDS_WITH function"""
     if len(args) != 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=2, received=len(args))
@@ -766,14 +786,14 @@ class LclCore:
 
     return str(args[1]).endswith(str(args[0]))
 
-  def PRIMARY_DEVICE(self, *args: list[Any]) -> str:
+  def PRIMARY_DEVICE(self: Self, *args: Any) -> str | None:
     """PRIMARY_DEVICE function"""
     if len(args) > 0:
       return INVALID_NUMBER_OF_PARAMS.format(expected=0, received=len(args))
 
-    return self._asset_constants.get('primaryDevice', None)  # type: ignore
+    return self._asset_constants.get('primaryDevice', None)
 
-  def SUBSTRING(self, *args: list[Any]) -> str:
+  def SUBSTRING(self: Self, *args: Any) -> str | None:
     """Get a substring from string (args[0])"""
     if len(args) < 2:
       return INVALID_NUMBER_OF_PARAMS.format(
@@ -809,7 +829,7 @@ class LclCore:
       return args[0][args[1] : args[2]]
     return args[0][args[1] :]
 
-  def UNIX_TO_STR(self, *args: list[Any]) -> str:
+  def UNIX_TO_STR(self: Self, *args: Any) -> str | None:
     """Convert UNIX timestamp date (args[0]) to format (args[1]) string"""
     if len(args) < 2:
       return INVALID_NUMBER_OF_PARAMS.format(expected=2, received=len(args))
@@ -830,13 +850,13 @@ class LclCore:
         return None
 
       try:
-        tz = zoneinfo.ZoneInfo(args[2])  # type: ignore
+        tz = zoneinfo.ZoneInfo(args[2])
       except zoneinfo.ZoneInfoNotFoundError:
         tz = zoneinfo.ZoneInfo('UTC')
 
-    return datetime.fromtimestamp(int(args[0]), tz=zoneinfo.ZoneInfo('UTC')).astimezone(tz).strftime(args[1])  # type: ignore
+    return datetime.fromtimestamp(int(args[0]), tz=zoneinfo.ZoneInfo('UTC')).astimezone(tz).strftime(args[1])
 
-  def VERSION(self, *args: list[Any]) -> str:
+  def VERSION(self: Self, *args: Any) -> str:
     """VERSION function"""
     if len(args) > 0:
       return INVALID_NUMBER_OF_PARAMS.format(expected=0, received=len(args))

{layrz_sdk-4.0.8.dist-info → layrz_sdk-4.0.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: layrz-sdk
-Version: 4.0.8
+Version: 4.0.10
 Summary: Layrz SDK for Python
 Author-email: "Golden M, Inc." <software@goldenm.com>
 Maintainer-email: Kenny Mochizuki <kenny@goldenm.com>, Luis Reyes <lreyes@goldenm.com>, Kasen Li <kli@goldenm.com>, Miguel Zauzich <miguel@goldenm.com>, Angel Prieto <aprieto@goldenm.com>
@@ -12,17 +12,18 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: requests
-Requires-Dist: xlsxwriter
-Requires-Dist: tzdata
+Requires-Dist: xlsxwriter<4.0.0,>=3.2.5
 Requires-Dist: pydantic>=2.10.6
-Requires-Dist: typing-extensions>=4.10.0
 Requires-Dist: geopy>=2.4.1
 Requires-Dist: shapely>=2.1.1
 Requires-Dist: strenum>=0.4.15
+Requires-Dist: requests>=2.32.4
+Requires-Dist: tzdata>=2025.2
 Dynamic: license-file
 
 # Layrz SDK

{layrz_sdk-4.0.8.dist-info → layrz_sdk-4.0.10.dist-info}/RECORD

@@ -13,7 +13,7 @@ layrz_sdk/entities/asset_operation_mode.py,sha256=umvmRb8W3kEDUd9dqyKhJ745xe3wss
 layrz_sdk/entities/ats_entry.py,sha256=wtrw3F9Pkirn0uGIvWyxbSqf36GWu2CRfqXuc5legmQ,669
 layrz_sdk/entities/ats_exit_history.py,sha256=qfeOQcMQqoGEYk0Tp1Oe5K7M_nld7JxpX09rPUQl7hc,1457
 layrz_sdk/entities/ats_possible_entry.py,sha256=M3eWsKvzE4V2YdP2udB5Kih_8hSHw923jG16YYT_gtw,1461
-layrz_sdk/entities/ats_possible_exit.py,sha256=imOw_KMMYtjUcj5uxmLaYR3i5MQ-fWPINiWmofgHHvs,1832
+layrz_sdk/entities/ats_possible_exit.py,sha256=gCibHlXicrs7dsACVWIBZ-I7RqEbdbKJQllxkjHNHoY,1822
 layrz_sdk/entities/ats_reception.py,sha256=DuZSsH92wP3cJE-q6g2hxyd4d-tN06hruS6P1pg2FBY,946
 layrz_sdk/entities/case.py,sha256=4ufVTeVRNpLOe0cx2vUWLsraP4mePq8gNl8mt7-XFPo,1782
 layrz_sdk/entities/case_ignored_status.py,sha256=B7HDz6MAD3lQAab2gx5w6wcG_Yp6DRc2VXpeS2M45fw,429
@@ -31,19 +31,19 @@ layrz_sdk/entities/function.py,sha256=rmUkw0QxD9NpKb1eL42aSsvEa6zPN41MpD86aIKjyB
 layrz_sdk/entities/geofence.py,sha256=AORR54bX1mCHCqfvy4iXb3BkeZ1zsf8rcuH7rIET8Mo,338
 layrz_sdk/entities/geofence_category.py,sha256=h9elE_NqDXeOPGGjtwI2AQacl2ijCJP05_cXBnUXf_4,900
 layrz_sdk/entities/last_message.py,sha256=QNgF0xCQ6uLFDMmKQCjSRhGS1Bq7akw5pv6ZIiFlwfY,268
-layrz_sdk/entities/message.py,sha256=uCfnrDcgZfnfcnRaE2djJcLJK75frIeF3aUhXPj7zco,997
+layrz_sdk/entities/message.py,sha256=UXXIdfJTmf2070_FsrHc2a_nQ5RcXMYQqvNyyKcaHMM,1415
 layrz_sdk/entities/notification_type.py,sha256=WTAFt8cOczXHsIk4RIDbakbtW_JqlvAg7PdW8EVqDew,669
-layrz_sdk/entities/operation.py,sha256=VTUWDEXAOO6M1FGHt158CabU4JX011AMOe9tg-oUySQ,6220
+layrz_sdk/entities/operation.py,sha256=n2WM2hnvzFznXY5HZWRWQwCymQl9DCHrjUrDepDtf7k,6557
 layrz_sdk/entities/operation_case_payload.py,sha256=NSsZbtP_Iz1At7ok4xlVFzk40Vx_-7wBYMgYNV5Ftu8,2520
-layrz_sdk/entities/operation_payload.py,sha256=jOCdBR91WTkX-W7y4VDa6LS5ul4lv5S6sWgAOvJD5DU,8585
+layrz_sdk/entities/operation_payload.py,sha256=2tDWeDuV76KqlzrPI9hPjKGs60Rd9WDQZVCa0DEqlFg,8904
 layrz_sdk/entities/operation_type.py,sha256=NAe_suR3Zfazu5KsYsPya8AtkSaNNjh78XPBEIqMTQU,939
 layrz_sdk/entities/outbound_service.py,sha256=mDtMwTql8sHmFayP1AnGdMgegF6tsvu-xSC2ftGVNJo,663
 layrz_sdk/entities/platform.py,sha256=fJQXFwRhG_L9h2h7lm_KYqpssJgYtRbfTWPy7BqOnOE,626
-layrz_sdk/entities/position.py,sha256=_KwiEeJ2NVDTc-eGLJwk5oxbEt9CeglZfQ3OQfMC9X8,2902
+layrz_sdk/entities/position.py,sha256=kbq3xrlHVtSUBx0qI9lXrL7cLdg-vps5g3x9u7anHtE,2973
 layrz_sdk/entities/presence_type.py,sha256=1p_MVREYkB7pey_TUf51QXQdlY5okZpkbiEd_l6oa04,335
 layrz_sdk/entities/preset.py,sha256=1SKTdV2JM1d3vr0cgQyzmtYswtu3JQwkERfpC2Rkt_w,705
-layrz_sdk/entities/report.py,sha256=Xk3frxFowbyAwDw4vMMY7nQulJSQwrX1lVxCVpXlxPY,9014
-layrz_sdk/entities/report_col.py,sha256=ZhzO2zosYxAvAzSxgbq0oNPk-nD70vZt1fA9kocYp8c,1254
+layrz_sdk/entities/report.py,sha256=uuK8Sw5jdstr-fzxpNBITHZQyPOysqiptPTtEA7-bxc,9271
+layrz_sdk/entities/report_col.py,sha256=IJds9joY6Wqn187tgcb8LKCRJNCbQ9tassSYdv3jlXI,1317
 layrz_sdk/entities/report_configuration.py,sha256=USgpkEBr40nzS3LW9jd1MF34pFDN1XckgAHsfdJcFTA,236
 layrz_sdk/entities/report_data_type.py,sha256=hIsvSzdfjXQnivj6fI0csmVZtCKbvMGod2-h99RQ428,414
 layrz_sdk/entities/report_format.py,sha256=FzEt1gC-Nwcz8AZAF5tANpocy0qzjxf2TB-tt3VtjKc,399
@@ -103,14 +103,14 @@ layrz_sdk/entities/modbus/schema.py,sha256=gyL0VyGSXTZWzsamjLUGoW5cqhn7MfXisCbH_
 layrz_sdk/entities/modbus/status.py,sha256=VnsWAR7C2dz7Y6_dPCnvS3CBaMaP7odZSu6db2KaTlE,611
 layrz_sdk/entities/modbus/wait.py,sha256=n3p_miYfGde1sxo4OznqWJAOb_WKblOnwFRib3RY_uM,4031
 layrz_sdk/entities/telemetry/__init__.py,sha256=hfyekj-4_iB-aEbw43DXtSuMLBtMR1uoL8vvkRa_nJg,149
-layrz_sdk/entities/telemetry/assetmessage.py,sha256=u0nk7ajKJoK7Fj4CHi01K4r9jHukdK-ZZn1pDPWEX7s,5137
+layrz_sdk/entities/telemetry/assetmessage.py,sha256=vKnuOiKLRnHRfp0FAr-ZaSd_eSx4GBEvURxuomZsFk8,5149
 layrz_sdk/entities/telemetry/devicemessage.py,sha256=1IQFUWZMBXLo-RSYYIxHdFX-fLSqplSiraUCjVH4-b4,3176
 layrz_sdk/helpers/__init__.py,sha256=5iW3z2m3jrYhvTfxX-p-QTkR9X9oTKfEsbtVOg9jFFY,115
 layrz_sdk/helpers/color.py,sha256=dlpMafbM-4Wd9D9hMbbnZJf4ALkpie_ZmBR2Vz_YCmM,1203
 layrz_sdk/lcl/__init__.py,sha256=U967AWANkL3u_YVxMNAYlh8jkZ6hqHfStacz7yz6sOA,89
-layrz_sdk/lcl/core.py,sha256=T80A3hL7SeqRNSfl5SrPAgwIEf-enoAVv9ldwJNzqsA,24786
-layrz_sdk-4.0.8.dist-info/licenses/LICENSE,sha256=d5ZrU--lIPER7QByXDKcrtOTOMk1JvN_9FdYDuoWi7Y,1057
-layrz_sdk-4.0.8.dist-info/METADATA,sha256=C9kVr0FxQ5OFc_avd0JWfohXjxiZ4abOUVrvyUitStk,1955
-layrz_sdk-4.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-layrz_sdk-4.0.8.dist-info/top_level.txt,sha256=yUTMMzfdZ0HDWQH5TaSlFM4xtwmP1fSGxmlL1dmu4l4,10
-layrz_sdk-4.0.8.dist-info/RECORD,,
+layrz_sdk/lcl/core.py,sha256=_3uK05I0iwJl63cVWKxt-qFkq0DWggCj5M680GHH5uQ,25161
+layrz_sdk-4.0.10.dist-info/licenses/LICENSE,sha256=d5ZrU--lIPER7QByXDKcrtOTOMk1JvN_9FdYDuoWi7Y,1057
+layrz_sdk-4.0.10.dist-info/METADATA,sha256=DF3b0HJ5tkQhzCHLFzLLZNGPwUpEcQG7gULrmiKLAN8,2045
+layrz_sdk-4.0.10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+layrz_sdk-4.0.10.dist-info/top_level.txt,sha256=yUTMMzfdZ0HDWQH5TaSlFM4xtwmP1fSGxmlL1dmu4l4,10
+layrz_sdk-4.0.10.dist-info/RECORD,,