topdata-sdk 0.1.0__tar.gz → 0.2.2__tar.gz

topdata_sdk-0.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tulio Amancio / Tsuriu Tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: topdata-sdk
-Version: 0.1.0
+Version: 0.2.2
 Summary: A production-ready asynchronous Python SDK for Topdata facial reader devices (AiFace, Catraca Fit, Revolution, Box, Inner Ponto 4, Inner Acesso 2). WebSocket server model — the device connects to you.
 Author-email: Tulio Amancio <root@tsuriu.com.br>
 License-Expression: MIT
@@ -19,12 +19,19 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Hardware
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: websockets>=12.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: Pillow>=10.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Dynamic: license-file
 
 # Topdata Python SDK
 

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "topdata-sdk"
-version = "0.1.0"
+version = "0.2.2"
 authors = [
   { name="Tulio Amancio", email="root@tsuriu.com.br" },
 ]
@@ -35,6 +35,11 @@ dependencies = [
 dev = [
     "pytest>=7.0.0",
     "pytest-asyncio>=0.21.0",
+    "pytest-cov>=5.0.0",
+    "build>=1.0.0",
+    "twine>=4.0.0",
+    "black>=23.0.0",
+    "flake8>=6.0.0",
 ]
 
 [project.urls]

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata/__init__.py

@@ -1,6 +1,12 @@
 from . import constants
-from .server import TopdataServer
-from .session import TopdataDeviceSession
+from .constants import (
+    AdminLevel,
+    AuthMode,
+    BackupNum,
+    CardFormat,
+    ServerVerify,
+    VerifyMode,
+)
 from .exceptions import (
     CommandTimeoutError,
     DeviceDisconnectedError,
@@ -8,7 +14,10 @@ from .exceptions import (
     ProtocolError,
     TopdataError,
 )
+from .image import prepare_image_record, validate_and_normalize
 from .models import (
+    DaySection,
+    DayZone,
     DeviceInfo,
     LogEvent,
     LogRecord,
@@ -17,8 +26,12 @@ from .models import (
     SendlogResponse,
     UserInfo,
     UserListItem,
+    UserLockRecord,
+    WeekDay,
+    WeekZone,
 )
-from .image import prepare_image_record, validate_and_normalize
+from .server import TopdataServer
+from .session import TopdataDeviceSession
 from .wiegand import (
     format_wiegand10,
     parse_wiegand10,
@@ -26,14 +39,20 @@ from .wiegand import (
     wiegand26_to_wiegand10,
 )
 
-__version__ = "0.1.0"
+__version__ = "0.2.2"
 
 __all__ = [
     # Core classes
     "TopdataServer",
     "TopdataDeviceSession",
-    # Constants module
+    # Constants
     "constants",
+    "AdminLevel",
+    "AuthMode",
+    "BackupNum",
+    "CardFormat",
+    "ServerVerify",
+    "VerifyMode",
     # Exceptions
     "TopdataError",
     "CommandTimeoutError",
@@ -49,6 +68,11 @@ __all__ = [
     "SendlogResponse",
     "UserInfo",
     "UserListItem",
+    "DaySection",
+    "DayZone",
+    "WeekDay",
+    "WeekZone",
+    "UserLockRecord",
     # Image utilities
     "prepare_image_record",
     "validate_and_normalize",

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata/constants.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 """
 Constants for the Topdata Facial Reader SDK.
 """
@@ -8,24 +9,27 @@ from enum import IntEnum
 # ─── Backup Number (data type selector for setuserinfo/getuserinfo/deleteuser) ─
 class BackupNum(IntEnum):
     """Backup number values used in setuserinfo, getuserinfo, and deleteuser commands."""
-    ALL = 0                 # All data (no photo in setuserinfo; all data in getuserinfo/deleteuser)
-    PASSWORD = 10           # Password only
-    CARD = 11               # Card only
+
+    ALL = 0  # All data (no photo in setuserinfo; all data in getuserinfo/deleteuser)
+    PASSWORD = 10  # Password only
+    CARD = 11  # Card only
     ALL_EXCEPT_BIOMETRY = 13  # All data except biometry (photo)
-    FACE = 50               # Face photo only
+    FACE = 50  # Face photo only
 
 
 # ─── Admin Level ───────────────────────────────────────────────────────────────
 class AdminLevel(IntEnum):
     """User privilege levels on the device."""
-    USER = 0                # Standard user (facial recognition only)
-    ADMIN = 1               # Administrator (device menu access)
-    SUPER_USER = 2          # Super user (not recommended by manufacturer)
+
+    USER = 0  # Standard user (facial recognition only)
+    ADMIN = 1  # Administrator (device menu access)
+    SUPER_USER = 2  # Super user (not recommended by manufacturer)
 
 
 # ─── Authentication Mode (mode field in sendlog) ──────────────────────────────
 class AuthMode(IntEnum):
     """Authentication method used in access events (sendlog.record.mode)."""
+
     PASSWORD = 2
     CARD = 3
     FACE = 8
@@ -34,42 +38,48 @@ class AuthMode(IntEnum):
 # ─── Verify Mode (verifymode in setdevinfo / setuserlock) ─────────────────────
 class VerifyMode(IntEnum):
     """Verification mode for device/user access configuration."""
-    FACE_CARD_OR_PWD = 0    # Face, Card, or Password
-    PWD_ONLY = 2            # Password only
-    CARD_ONLY = 3           # Card only
-    FACE_ONLY = 8           # Face only
-    FACE_AND_PWD = 9        # Face and Password
-    CARD_AND_FACE = 10      # Card and Face
-    CARD_AND_PWD = 11       # Card and Password
+
+    FACE_CARD_OR_PWD = 0  # Face, Card, or Password
+    PWD_ONLY = 2  # Password only
+    CARD_ONLY = 3  # Card only
+    FACE_ONLY = 8  # Face only
+    FACE_AND_PWD = 9  # Face and Password
+    CARD_AND_FACE = 10  # Card and Face
+    CARD_AND_PWD = 11  # Card and Password
     FACE_AND_CARD_OR_PWD = 14  # Face and (Card or Password)
 
 
 # ─── Server Verify Mode (server_verify in setdevinfo) ─────────────────────────
 class ServerVerify(IntEnum):
     """Server verification mode for online/offline operation."""
-    OFFLINE = 0             # Offline only (device decides access)
-    ONLINE = 1              # Online only (server decides access)
-    AUTO = 2                # Auto switch between online and offline
+
+    OFFLINE = 0  # Offline only (device decides access)
+    ONLINE = 1  # Online only (server decides access)
+    AUTO = 2  # Auto switch between online and offline
 
 
 # ─── Image Validation Limits ──────────────────────────────────────────────────
-MAX_IMAGE_BYTES = 150 * 1024           # 150 KB
-MIN_RESOLUTION = (240, 320)            # width, height
-MAX_RESOLUTION = (800, 1280)           # width, height
-RECOMMENDED_RESOLUTION = (480, 640)    # width, height
+MAX_IMAGE_BYTES = 150 * 1024  # 150 KB
+MIN_RESOLUTION = (240, 320)  # width, height
+MAX_RESOLUTION = (800, 1280)  # width, height
+RECOMMENDED_RESOLUTION = (480, 640)  # width, height
+
 
 # ─── Protocol Defaults ────────────────────────────────────────────────────────
 DEFAULT_WS_PORT = 7792
 DEFAULT_WS_PATH = "/pub/chat"
-DEFAULT_COMMAND_TIMEOUT = 10.0         # seconds
+DEFAULT_COMMAND_TIMEOUT = 10.0  # seconds
+
 
 # ─── Special Values ───────────────────────────────────────────────────────────
-UNKNOWN_ENROLLID = 99999999            # enrollid used by firmware for unrecognized faces
-MAX_ENROLLID = 999_999_999_999         # 12-digit maximum enrollid
+UNKNOWN_ENROLLID = 99999999  # enrollid used by firmware for unrecognized faces
+MAX_ENROLLID = 999_999_999_999  # 12-digit maximum enrollid
+
 
 # ─── Card Format (setdevlock.cardformat) ──────────────────────────────────────
 class CardFormat(IntEnum):
     """Card number display format on the device."""
+
     DECIMAL = 0
     WIEGAND = 1
     HEXADECIMAL = 2

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata/exceptions.py

@@ -3,11 +3,13 @@ from __future__ import annotations
 
 class TopdataError(Exception):
     """Base exception for the Topdata SDK."""
+
     pass
 
 
 class CommandTimeoutError(TopdataError):
     """Raised when a command sent to the device does not receive a response within the timeout."""
+
     def __init__(self, command: str, timeout: float):
         self.command = command
         self.timeout = timeout
@@ -16,6 +18,7 @@ class CommandTimeoutError(TopdataError):
 
 class DeviceDisconnectedError(TopdataError):
     """Raised when the WebSocket connection to the device is lost during an operation."""
+
     def __init__(self, sn: str | None = None, message: str | None = None):
         self.sn = sn
         msg = message or f"Device '{sn}' disconnected"
@@ -28,6 +31,7 @@ class InvalidImageError(TopdataError):
     Possible reasons: not JPEG, file too large (>150KB after processing),
     resolution outside 240x320 – 800x1280, or other quality issues.
     """
+
     pass
 
 
@@ -39,6 +43,7 @@ class ProtocolError(TopdataError):
         reason: The numeric reason code, if present.
         msg: The human-readable error message from the device, if present.
     """
+
     def __init__(self, command: str, reason: int | None = None, msg: str | None = None):
         self.command = command
         self.reason = reason

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata/image.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 """
 Image validation and normalization for Topdata facial readers.
 
@@ -15,7 +16,12 @@ import io
 
 from PIL import Image
 
-from .constants import MAX_IMAGE_BYTES, MAX_RESOLUTION, MIN_RESOLUTION, RECOMMENDED_RESOLUTION
+from .constants import (
+    MAX_IMAGE_BYTES,
+    MAX_RESOLUTION,
+    MIN_RESOLUTION,
+    RECOMMENDED_RESOLUTION,
+)
 from .exceptions import InvalidImageError
 
 
@@ -49,13 +55,13 @@ def validate_and_normalize(image_data: bytes) -> bytes:
 
     # Check JPEG format
     if img.format and img.format.upper() not in ("JPEG", "JPG"):
-        raise InvalidImageError(
-            f"Image must be JPEG format, got '{img.format}'"
-        )
+        raise InvalidImageError(f"Image must be JPEG format, got '{img.format}'")
 
     # Even if format is None (raw bytes), check if it's a valid JPEG by magic bytes
-    if not image_data[:2] == b'\xff\xd8':
-        raise InvalidImageError("Image data does not start with JPEG magic bytes (FFD8)")
+    if not image_data[:2] == b"\xff\xd8":
+        raise InvalidImageError(
+            "Image data does not start with JPEG magic bytes (FFD8)"
+        )
 
     width, height = img.size
 

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata/models.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
-from datetime import datetime
+
 from typing import Optional
+
 from pydantic import BaseModel, Field
 
 
@@ -11,6 +12,7 @@ class DeviceInfo(BaseModel):
     Fields not applicable to facial readers (fpsize, usedfp, fpalgo,
     intercom, floors, useosdp) are kept for protocol completeness.
     """
+
     modelname: str
     usersize: int = 0
     facesize: int = 0
@@ -45,6 +47,7 @@ class UserListItem(BaseModel):
     Each item represents one data type for a user (e.g., enrollid with
     backupnum=10 means that user has a password, backupnum=50 means face, etc.).
     """
+
     enrollid: int
     admin: str | int = "0"
     backupnum: int = 0
@@ -52,15 +55,16 @@ class UserListItem(BaseModel):
 
 class UserInfo(BaseModel):
     """Detailed user information from getuserinfo response."""
+
     enrollid: int
     name: Optional[str] = None
     admin: int = 0
     card: Optional[int] = None
     pwd: Optional[int] = None
-    faceflag: Optional[int] = None         # 1 = has face data, 0 = no
-    enable: Optional[int] = None           # 1 = enabled, 0 = disabled
+    faceflag: Optional[int] = None  # 1 = has face data, 0 = no
+    enable: Optional[int] = None  # 1 = enabled, 0 = disabled
     backupnum: Optional[int] = None
-    record: Optional[str] = None           # Raw record value (photo base64 or other data)
+    record: Optional[str] = None  # Raw record value (photo base64 or other data)
     # Error fields (present when result=false)
     result: bool = True
     reason: Optional[int] = None
@@ -69,17 +73,19 @@ class UserInfo(BaseModel):
 
 class LogRecord(BaseModel):
     """A single access log record from sendlog or getalllog responses."""
+
     enrollid: int
     name: Optional[str] = None
-    time: str                              # "yyyy-MM-dd HH:mm:ss"
-    mode: int = 0                          # 2=password, 3=card, 8=face
-    inout: Optional[int] = None            # 0=entry, 1=exit (may vary)
-    event: int = 0                         # Event type code
-    image: Optional[str] = None            # Base64 photo (if use_logphoto=1)
+    time: str  # "yyyy-MM-dd HH:mm:ss"
+    mode: int = 0  # 2=password, 3=card, 8=face
+    inout: Optional[int] = None  # 0=entry, 1=exit (may vary)
+    event: int = 0  # Event type code
+    image: Optional[str] = None  # Base64 photo (if use_logphoto=1)
 
 
 class LogEvent(BaseModel):
     """Full sendlog message from the device."""
+
     sn: str
     count: int = 1
     logindex: int = 0
@@ -88,6 +94,7 @@ class LogEvent(BaseModel):
 
 class RegMessage(BaseModel):
     """Parsed 'reg' command from the device."""
+
     cmd: str = "reg"
     sn: str
     devinfo: DeviceInfo
@@ -95,43 +102,50 @@ class RegMessage(BaseModel):
 
 class RegResponse(BaseModel):
     """Response to the 'reg' command."""
+
     ret: str = "reg"
     result: bool = True
-    cloudtime: str                         # "yyyy-MM-dd HH:mm:ss"
+    cloudtime: str  # "yyyy-MM-dd HH:mm:ss"
 
 
 class SendlogResponse(BaseModel):
     """Response to the 'sendlog' event (for online mode)."""
+
     ret: str = "sendlog"
     result: bool = True
-    cloudtime: str                         # "yyyy-MM-dd HH:mm:ss"
-    message: Optional[str] = None          # Custom message for device display
-    access: Optional[bool] = None          # True=grant, False=deny (online mode)
+    cloudtime: str  # "yyyy-MM-dd HH:mm:ss"
+    message: Optional[str] = None  # Custom message for device display
+    access: Optional[bool] = None  # True=grant, False=deny (online mode)
 
 
 class DaySection(BaseModel):
     """A time section within a dayzone."""
-    section: str                           # "HH:MM~HH:MM"
+
+    section: str  # "HH:MM~HH:MM"
 
 
 class DayZone(BaseModel):
     """A day zone containing time sections."""
+
     day: list[DaySection] = Field(default_factory=list)
 
 
 class WeekDay(BaseModel):
     """A day reference within a weekzone."""
-    day: int                               # dayzone index (1-based)
+
+    day: int  # dayzone index (1-based)
 
 
 class WeekZone(BaseModel):
     """A week zone containing 7 day references (Sun-Sat)."""
+
     week: list[WeekDay] = Field(default_factory=list)
 
 
 class UserLockRecord(BaseModel):
     """A user access lock record for setuserlock."""
+
     enrollid: int
-    weekzone: int                          # weekzone ID
-    starttime: str                         # "yyyy-MM-dd HH:mm:ss"
-    endtime: str                           # "yyyy-MM-dd HH:mm:ss"
+    weekzone: int  # weekzone ID
+    starttime: str  # "yyyy-MM-dd HH:mm:ss"
+    endtime: str  # "yyyy-MM-dd HH:mm:ss"

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata/server.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 """
 TopdataServer — WebSocket server that accepts connections from Topdata facial readers.
 
@@ -25,7 +26,6 @@ Usage::
     await server.start()
 """
 
-import asyncio
 import json
 import logging
 from datetime import datetime
@@ -35,9 +35,7 @@ import websockets
 from websockets.asyncio.server import Server, ServerConnection
 
 from .constants import DEFAULT_COMMAND_TIMEOUT, DEFAULT_WS_PATH, DEFAULT_WS_PORT
-from .exceptions import TopdataError
 from .models import DeviceInfo, LogEvent, LogRecord
-
 from .session import TopdataDeviceSession
 
 logger = logging.getLogger("topdata.server")
@@ -72,9 +70,7 @@ class TopdataServer:
         self.on_device_connected: Optional[
             Callable[[TopdataDeviceSession], Awaitable[None]]
         ] = None
-        self.on_device_disconnected: Optional[
-            Callable[[str], Awaitable[None]]
-        ] = None
+        self.on_device_disconnected: Optional[Callable[[str], Awaitable[None]]] = None
         self.on_event: Optional[
             Callable[[TopdataDeviceSession, LogEvent], Awaitable[dict | None]]
         ] = None
@@ -124,7 +120,9 @@ class TopdataServer:
                         raw_message = raw_message.decode("utf-8")
                     data = json.loads(raw_message)
                 except (json.JSONDecodeError, UnicodeDecodeError) as e:
-                    logger.warning("topdata.server.invalid_json", extra={"error": str(e)})
+                    logger.warning(
+                        "topdata.server.invalid_json", extra={"error": str(e)}
+                    )
                     continue
 
                 # Route by message type
@@ -161,11 +159,13 @@ class TopdataServer:
 
                         # Respond to reg (mandatory — device loops reg until it gets this)
                         now = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
-                        reg_response = json.dumps({
-                            "ret": "reg",
-                            "result": True,
-                            "cloudtime": now,
-                        })
+                        reg_response = json.dumps(
+                            {
+                                "ret": "reg",
+                                "result": True,
+                                "cloudtime": now,
+                            }
+                        )
                         await websocket.send(reg_response)
 
                         logger.info(
@@ -242,11 +242,15 @@ class TopdataServer:
                             continue
 
                         now = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
-                        await websocket.send(json.dumps({
-                            "ret": "senduser",
-                            "result": True,
-                            "cloudtime": now,
-                        }))
+                        await websocket.send(
+                            json.dumps(
+                                {
+                                    "ret": "senduser",
+                                    "result": True,
+                                    "cloudtime": now,
+                                }
+                            )
+                        )
 
                         if self.on_user_sent:
                             try:

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata/session.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 """
 TopdataDeviceSession — per-device connection handler.
 
@@ -11,7 +12,6 @@ operations.
 import asyncio
 import json
 import logging
-from datetime import datetime
 from typing import Any, Optional
 
 from .constants import BackupNum, AdminLevel, MAX_ENROLLID
@@ -19,10 +19,17 @@ from .exceptions import (
     CommandTimeoutError,
     DeviceDisconnectedError,
     ProtocolError,
-    TopdataError,
 )
 from .image import prepare_image_record
-from .models import DeviceInfo, LogRecord, UserInfo, UserListItem
+from .models import (
+    DayZone,
+    DeviceInfo,
+    LogRecord,
+    UserInfo,
+    UserListItem,
+    UserLockRecord,
+    WeekZone,
+)
 from .wiegand import wiegand10_to_wiegand26, wiegand26_to_wiegand10
 
 logger = logging.getLogger("topdata.session")
@@ -74,9 +81,7 @@ class TopdataDeviceSession:
         self._connected = False
         # Cancel any pending command
         if self._pending_future and not self._pending_future.done():
-            self._pending_future.set_exception(
-                DeviceDisconnectedError(self._sn)
-            )
+            self._pending_future.set_exception(DeviceDisconnectedError(self._sn))
 
     def _handle_response(self, data: dict) -> None:
         """Called by the server when a 'ret' message is received for this session.
@@ -125,7 +130,9 @@ class TopdataDeviceSession:
             except asyncio.TimeoutError:
                 raise CommandTimeoutError(cmd_name, effective_timeout)
             except Exception as e:
-                if isinstance(e, (CommandTimeoutError, DeviceDisconnectedError, ProtocolError)):
+                if isinstance(
+                    e, (CommandTimeoutError, DeviceDisconnectedError, ProtocolError)
+                ):
                     raise
                 raise DeviceDisconnectedError(self._sn, str(e))
             finally:
@@ -224,11 +231,13 @@ class TopdataDeviceSession:
         Returns:
             UserInfo with the requested data fields populated.
         """
-        resp = await self._send_command({
-            "cmd": "getuserinfo",
-            "enrollid": enrollid,
-            "backupnum": int(backup_num),
-        })
+        resp = await self._send_command(
+            {
+                "cmd": "getuserinfo",
+                "enrollid": enrollid,
+                "backupnum": int(backup_num),
+            }
+        )
         return UserInfo.model_validate(resp)
 
     async def set_user(
@@ -335,11 +344,13 @@ class TopdataDeviceSession:
         Returns:
             True if successful.
         """
-        resp = await self._send_command({
-            "cmd": "deleteuser",
-            "enrollid": enrollid,
-            "backupnum": int(backup_num),
-        })
+        resp = await self._send_command(
+            {
+                "cmd": "deleteuser",
+                "enrollid": enrollid,
+                "backupnum": int(backup_num),
+            }
+        )
         return resp.get("result", False)
 
     async def delete_all_users(self) -> bool:
@@ -368,9 +379,15 @@ class TopdataDeviceSession:
         """
         payload: dict[str, Any] = {"cmd": "setdevinfo"}
         for key in (
-            "door_opentime", "door_password", "verifymode",
-            "access_denied_nolog", "volume", "stranger_lock",
-            "server_verify", "use_logphoto", "stranger_photo",
+            "door_opentime",
+            "door_password",
+            "verifymode",
+            "access_denied_nolog",
+            "volume",
+            "stranger_lock",
+            "server_verify",
+            "use_logphoto",
+            "stranger_photo",
         ):
             if key in kwargs:
                 payload[key] = kwargs[key]
@@ -381,8 +398,8 @@ class TopdataDeviceSession:
     async def set_device_lock(
         self,
         card_format: int | None = None,
-        day_zones: list[dict] | None = None,
-        week_zones: list[dict] | None = None,
+        day_zones: list[dict | DayZone] | None = None,
+        week_zones: list[dict | WeekZone] | None = None,
     ) -> bool:
         """Configure device lock settings (card format, day/week zones).
 
@@ -396,18 +413,23 @@ class TopdataDeviceSession:
         """
         payload: dict[str, Any] = {"cmd": "setdevlock"}
         if card_format is not None:
-            payload["cardformat"] = card_format
+            payload["cardformat"] = int(card_format)
         if day_zones is not None:
-            payload["dayzone"] = day_zones
+            payload["dayzone"] = [
+                dz.model_dump() if hasattr(dz, "model_dump") else dz for dz in day_zones
+            ]
         if week_zones is not None:
-            payload["weekzone"] = week_zones
+            payload["weekzone"] = [
+                wz.model_dump() if hasattr(wz, "model_dump") else wz
+                for wz in week_zones
+            ]
 
         resp = await self._send_command(payload)
         return resp.get("result", False)
 
     async def set_user_lock(
         self,
-        records: list[dict],
+        records: list[dict | UserLockRecord],
         verify_mode: int = 0,
     ) -> bool:
         """Configure per-user access time restrictions (setuserlock).
@@ -419,12 +441,17 @@ class TopdataDeviceSession:
         Returns:
             True if successful.
         """
-        resp = await self._send_command({
-            "cmd": "setuserlock",
-            "count": len(records),
-            "verifymode": verify_mode,
-            "record": records,
-        })
+        serialized_records = [
+            r.model_dump() if hasattr(r, "model_dump") else r for r in records
+        ]
+        resp = await self._send_command(
+            {
+                "cmd": "setuserlock",
+                "count": len(serialized_records),
+                "verifymode": int(verify_mode),
+                "record": serialized_records,
+            }
+        )
         return resp.get("result", False)
 
     async def get_all_logs(

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata/wiegand.py

@@ -1,4 +1,5 @@
 from __future__ import annotations
+
 """
 Wiegand format conversion utilities for Topdata card numbers.
 
@@ -85,9 +86,7 @@ def parse_wiegand10(value: str) -> tuple[int, int]:
     """
     value = value.strip()
     if len(value) != 8 or not value.isdigit():
-        raise ValueError(
-            f"Wiegand 10 value must be exactly 8 digits, got '{value}'"
-        )
+        raise ValueError(f"Wiegand 10 value must be exactly 8 digits, got '{value}'")
     facility_code = int(value[:3])
     card_number = int(value[3:])
     return facility_code, card_number

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: topdata-sdk
-Version: 0.1.0
+Version: 0.2.2
 Summary: A production-ready asynchronous Python SDK for Topdata facial reader devices (AiFace, Catraca Fit, Revolution, Box, Inner Ponto 4, Inner Acesso 2). WebSocket server model — the device connects to you.
 Author-email: Tulio Amancio <root@tsuriu.com.br>
 License-Expression: MIT
@@ -19,12 +19,19 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Hardware
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: websockets>=12.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: Pillow>=10.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Dynamic: license-file
 
 # Topdata Python SDK
 

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata_sdk.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+LICENSE
 README.md
 pyproject.toml
 src/topdata/__init__.py

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/src/topdata_sdk.egg-info/requires.txt

@@ -5,3 +5,8 @@ Pillow>=10.0.0
 [dev]
 pytest>=7.0.0
 pytest-asyncio>=0.21.0
+pytest-cov>=5.0.0
+build>=1.0.0
+twine>=4.0.0
+black>=23.0.0
+flake8>=6.0.0

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/tests/test_image.py

@@ -1,4 +1,5 @@
 """Tests for image validation and normalization."""
+
 import io
 import pytest
 from PIL import Image
@@ -46,7 +47,7 @@ class TestValidateAndNormalize:
         data = _make_jpeg(480, 640)
         result = validate_and_normalize(data)
         assert len(result) <= MAX_IMAGE_BYTES
-        assert result[:2] == b'\xff\xd8'  # JPEG magic bytes
+        assert result[:2] == b"\xff\xd8"  # JPEG magic bytes
 
     def test_empty_data_raises(self):
         with pytest.raises(InvalidImageError, match="empty"):
@@ -102,11 +103,12 @@ class TestPrepareImageRecord:
 
     def test_base64_is_valid(self):
         import base64
+
         data = _make_jpeg()
         result = prepare_image_record(data)
         b64_part = result.split(",", 1)[1]
         decoded = base64.b64decode(b64_part)
-        assert decoded[:2] == b'\xff\xd8'
+        assert decoded[:2] == b"\xff\xd8"
 
     def test_invalid_image_raises(self):
         with pytest.raises(InvalidImageError):

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/tests/test_session.py

@@ -2,6 +2,7 @@
 
 Uses a mock WebSocket transport to simulate device responses without real hardware.
 """
+
 import asyncio
 import json
 import pytest
@@ -52,7 +53,9 @@ class MockWebSocket:
         return {}
 
 
-def _make_session(ws: MockWebSocket = None, timeout: float = 2.0) -> TopdataDeviceSession:
+def _make_session(
+    ws: MockWebSocket = None, timeout: float = 2.0
+) -> TopdataDeviceSession:
     """Create a session with a mock WebSocket and test device info."""
     if ws is None:
         ws = MockWebSocket()
@@ -65,8 +68,11 @@ def _make_session(ws: MockWebSocket = None, timeout: float = 2.0) -> TopdataDevi
     )
 
 
-async def _send_with_response(session: TopdataDeviceSession, ws: MockWebSocket, response: dict):
+async def _send_with_response(
+    session: TopdataDeviceSession, ws: MockWebSocket, response: dict
+):
     """Helper: schedule a response delivery after a brief delay, simulating device latency."""
+
     async def deliver():
         await asyncio.sleep(0.05)
         session._handle_response(response)
@@ -332,7 +338,6 @@ class TestCommandSerialization:
         assert execution_order.index("done1") < execution_order.index("resp2")
 
 
-
 class TestCommandTimeout:
     @pytest.mark.asyncio
     async def test_timeout_raises(self):

{topdata_sdk-0.1.0 → topdata_sdk-0.2.2}/tests/test_wiegand.py

@@ -1,4 +1,5 @@
 """Tests for Wiegand conversion utilities."""
+
 import pytest
 from topdata.wiegand import (
     format_wiegand10,