pyezvizapi 1.0.3.6__py3-none-any.whl → 1.0.3.8__py3-none-any.whl

pyezvizapi/__main__.py

@@ -421,7 +421,7 @@ def _handle_devices_light(args: argparse.Namespace, client: EzvizClient) -> int:
 
 def _handle_pagelist(client: EzvizClient) -> int:
     """Output full pagelist (raw JSON) for exploration in editors like Notepad++."""
-    data = client._get_page_list()  # noqa: SLF001
+    data = client.get_page_list()
     _write_json(data)
     return 0
 
@@ -611,7 +611,7 @@ def main(argv: list[str] | None = None) -> int:
         return 2
     finally:
         if args.save_token and args.token_file:
-            _save_token_file(args.token_file, cast(dict[str, Any], client._token))  # noqa: SLF001
+            _save_token_file(args.token_file, client.export_token())
         client.close_session()
 
 

pyezvizapi/client.py

@@ -4398,6 +4398,16 @@ class EzvizClient:
             json_key=None,
         )
 
+    def get_page_list(self) -> Any:
+        """Return the full pagelist payload without filtering."""
+
+        return self._get_page_list()
+
+    def export_token(self) -> dict[str, Any]:
+        """Return a shallow copy of the current authentication token."""
+
+        return dict(self._token)
+
     def get_device(self) -> Any:
         """Get ezviz devices filter."""
         return self._api_get_pagelist(page_filter="CLOUD", json_key="deviceInfos")

pyezvizapi/constants.py

@@ -6,13 +6,23 @@ the Ezviz API to descriptive names.
 """
 
 from enum import Enum, unique
+from hashlib import md5
+import uuid
 
-from .utils import generate_unique_code
 
-FEATURE_CODE = generate_unique_code()
+def _generate_unique_code() -> str:
+    """Generate a deterministic unique code for this host."""
+
+    mac_int = uuid.getnode()
+    mac_str = ":".join(f"{(mac_int >> i) & 0xFF:02x}" for i in range(40, -1, -8))
+    return md5(mac_str.encode("utf-8")).hexdigest()
+
+
+FEATURE_CODE = _generate_unique_code()
 XOR_KEY = b"\x0c\x0eJ^X\x15@Rr"
 DEFAULT_TIMEOUT = 25
 MAX_RETRIES = 3
+HIK_ENCRYPTION_HEADER = b"hikencodepicture"
 REQUEST_HEADER = {
     "featureCode": FEATURE_CODE,
     "clientType": "3",

pyezvizapi/feature.py

@@ -5,22 +5,18 @@ from __future__ import annotations
 from collections.abc import Iterable, Iterator, Mapping, MutableMapping
 from typing import Any, cast
 
-from .utils import coerce_int, decode_json
+from .utils import WILDCARD_STEP, coerce_int, decode_json, first_nested
 
 
 def _feature_video_section(camera_data: Mapping[str, Any]) -> dict[str, Any]:
     """Return the nested Video feature section from feature info payload."""
 
-    feature = camera_data.get("FEATURE_INFO")
-    if not isinstance(feature, Mapping):
-        return {}
-
-    for group in feature.values():
-        if isinstance(group, Mapping):
-            video = group.get("Video")
-            if isinstance(video, MutableMapping):
-                return cast(dict[str, Any], video)
-
+    video = first_nested(
+        camera_data,
+        ("FEATURE_INFO", WILDCARD_STEP, "Video"),
+    )
+    if isinstance(video, MutableMapping):
+        return cast(dict[str, Any], video)
     return {}
 
 
@@ -192,8 +188,8 @@ def _normalize_port_list(value: Any) -> list[dict[str, Any]] | None:
         return None
 
     normalized: list[dict[str, Any]] = []
-    for entry in value:
-        entry = decode_json(entry)
+    for raw_entry in value:
+        entry = decode_json(raw_entry)
         if not isinstance(entry, Mapping):
             return None
         port = coerce_int(entry.get("portNo"))
@@ -209,57 +205,68 @@ def normalize_port_security(payload: Any) -> dict[str, Any]:
 
     seen: set[int] = set()
 
+    def _apply_hint(
+        candidate: dict[str, Any] | None, hint_value: bool | None
+    ) -> dict[str, Any] | None:
+        if (
+            candidate is not None
+            and "enabled" not in candidate
+            and isinstance(hint_value, bool)
+        ):
+            candidate["enabled"] = hint_value
+        return candidate
+
+    def _walk_mapping(obj: Mapping[str, Any], hint: bool | None) -> dict[str, Any] | None:
+        obj_id = id(obj)
+        if obj_id in seen:
+            return None
+        seen.add(obj_id)
+
+        enabled_local = obj.get("enabled")
+        if isinstance(enabled_local, bool):
+            hint = enabled_local
+
+        ports = _normalize_port_list(obj.get("portSecurityList"))
+        if ports is not None:
+            return {
+                "portSecurityList": ports,
+                "enabled": bool(enabled_local)
+                if isinstance(enabled_local, bool)
+                else bool(hint)
+                if isinstance(hint, bool)
+                else True,
+            }
+
+        for key in ("PortSecurity", "value", "data", "NetworkSecurityProtection"):
+            if key in obj:
+                candidate = _apply_hint(_walk(obj[key], hint), hint)
+                if candidate:
+                    return candidate
+
+        for value in obj.values():
+            candidate = _apply_hint(_walk(value, hint), hint)
+            if candidate:
+                return candidate
+
+        return None
+
+    def _walk_iterable(values: Iterable[Any], hint: bool | None) -> dict[str, Any] | None:
+        for item in values:
+            candidate = _walk(item, hint)
+            if candidate:
+                return candidate
+        return None
+
     def _walk(obj: Any, hint: bool | None = None) -> dict[str, Any] | None:
         obj = decode_json(obj)
         if obj is None:
             return None
 
         if isinstance(obj, Mapping):
-            obj_id = id(obj)
-            if obj_id in seen:
-                return None
-            seen.add(obj_id)
-
-            enabled_local = obj.get("enabled")
-            if isinstance(enabled_local, bool):
-                hint = enabled_local
-
-            ports = _normalize_port_list(obj.get("portSecurityList"))
-            if ports is not None:
-                return {
-                    "portSecurityList": ports,
-                    "enabled": bool(enabled_local)
-                    if isinstance(enabled_local, bool)
-                    else bool(hint)
-                    if isinstance(hint, bool)
-                    else True,
-                }
-
-            for key in (
-                "PortSecurity",
-                "value",
-                "data",
-                "NetworkSecurityProtection",
-            ):
-                if key in obj:
-                    candidate = _walk(obj[key], hint)
-                    if candidate:
-                        if "enabled" not in candidate and isinstance(hint, bool):
-                            candidate["enabled"] = hint
-                        return candidate
-
-            for value in obj.values():
-                candidate = _walk(value, hint)
-                if candidate:
-                    if "enabled" not in candidate and isinstance(hint, bool):
-                        candidate["enabled"] = hint
-                    return candidate
+            return _walk_mapping(obj, hint)
 
-        elif isinstance(obj, Iterable):
-            for item in obj:
-                candidate = _walk(item, hint)
-                if candidate:
-                    return candidate
+        if isinstance(obj, Iterable) and not isinstance(obj, (str, bytes, bytearray)):
+            return _walk_iterable(obj, hint)
 
         return None
 
@@ -318,10 +325,9 @@ def display_mode_value(camera_data: Mapping[str, Any]) -> int:
     display_mode = optionals.get("display_mode")
     display_mode = decode_json(display_mode)
 
-    if isinstance(display_mode, Mapping):
-        mode = display_mode.get("mode")
-    else:
-        mode = display_mode
+    mode = (
+        display_mode.get("mode") if isinstance(display_mode, Mapping) else display_mode
+    )
 
     if isinstance(mode, int) and mode in (1, 2, 3):
         return mode

pyezvizapi/light_bulb.py

@@ -176,7 +176,7 @@ class EzvizLightBulb:
     def set_brightness(self, value: int) -> bool:
         """Set the light bulb brightness.
 
-        The value must be in range 1–100. Returns True on success.
+        The value must be in range 1-100. Returns True on success.
 
         Raises:
             PyEzvizError: On API failures.

pyezvizapi/mqtt.py

@@ -83,7 +83,7 @@ class MqttData(TypedDict):
 # Payload decoding helpers
 # ---------------------------------------------------------------------------
 
-# Field names in the comma‑separated ``ext`` payload from EZVIZ.
+# Field names in the comma-separated ``ext`` payload from EZVIZ.
 EXT_FIELD_NAMES: Final[tuple[str, ...]] = (
     "channel_type",
     "time",
@@ -247,7 +247,7 @@ class MQTTClient:
                 # Stop background thread and disconnect
                 self.mqtt_client.loop_stop()
                 self.mqtt_client.disconnect()
-            except Exception as err:  # noqa: BLE001
+            except (OSError, ValueError, RuntimeError) as err:
                 _LOGGER.debug("MQTT disconnect failed: %s", err)
         # Always attempt to stop push on server side
         self._stop_ezviz_push()

pyezvizapi/test_cam_rtsp.py

@@ -4,11 +4,14 @@ from __future__ import annotations
 
 import base64
 import hashlib
+import logging
 import socket
 from typing import TypedDict
 
 from .exceptions import AuthTestResultFailed, InvalidHost
 
+_LOGGER = logging.getLogger(__name__)
+
 
 def genmsg_describe(url: str, seq: int, user_agent: str, auth_seq: str) -> str:
     """Generate RTSP DESCRIBE request message."""
@@ -110,15 +113,14 @@ class TestRTSPAuth:
         describe = genmsg_describe(
             url, seq, self._rtsp_details["defaultUserAgent"], auth_seq
         )
-        print(describe)
+        _LOGGER.debug("RTSP DESCRIBE (basic):\n%s", describe)
         session.send(describe.encode())
         msg1: bytes = session.recv(self._rtsp_details["bufLen"])
         seq += 1
 
         decoded = msg1.decode()
         if "200 OK" in decoded:
-            print(f"Basic auth result: {decoded}")
-            print("Basic Auth test passed. Credentials Valid!")
+            _LOGGER.info("Basic auth result: %s", decoded)
             return
 
         if "Unauthorized" in decoded:
@@ -140,20 +142,16 @@ class TestRTSPAuth:
             describe = genmsg_describe(
                 url, seq, self._rtsp_details["defaultUserAgent"], auth_seq
             )
-            print(describe)
+            _LOGGER.debug("RTSP DESCRIBE (digest):\n%s", describe)
             session.send(describe.encode())
             msg1 = session.recv(self._rtsp_details["bufLen"])
             decoded = msg1.decode()
-            print(f"Digest auth result: {decoded}")
+            _LOGGER.info("Digest auth result: %s", decoded)
 
             if "200 OK" in decoded:
-                print("Digest Auth test Passed. Credentials Valid!")
                 return
 
             if "401 Unauthorized" in decoded:
                 raise AuthTestResultFailed("Credentials not valid!!")
 
-        print("Basic Auth test passed. Credentials Valid!")
-
-
-# ruff: noqa: T201
+        _LOGGER.info("Basic Auth test passed. Credentials Valid!")

pyezvizapi/test_mqtt.py

@@ -20,13 +20,14 @@ from .client import EzvizClient
 from .exceptions import EzvizAuthVerificationCode, PyEzvizError
 
 logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
+_LOGGER = logging.getLogger(__name__)
 
 LOG_FILE = Path("mqtt_messages.jsonl")  # JSON Lines format
 
 
 def message_handler(msg: dict[str, Any]) -> None:
     """Handle new MQTT messages by printing and saving them to a file."""
-    print("📩 New MQTT message:", msg)
+    _LOGGER.info("📩 New MQTT message: %s", msg)
     with LOG_FILE.open("a", encoding="utf-8") as f:
         f.write(json.dumps(msg, ensure_ascii=False) + "\n")
 
@@ -40,7 +41,7 @@ def _load_token_file(path: str | None) -> dict[str, Any] | None:
     try:
         return cast(dict[str, Any], json.loads(p.read_text(encoding="utf-8")))
     except (OSError, json.JSONDecodeError):
-        logging.getLogger(__name__).warning("Failed to read token file: %s", p)
+        _LOGGER.warning("Failed to read token file: %s", p)
         return None
 
 
@@ -50,9 +51,9 @@ def _save_token_file(path: str | None, token: dict[str, Any]) -> None:
     p = Path(path)
     try:
         p.write_text(json.dumps(token, indent=2), encoding="utf-8")
-        logging.getLogger(__name__).info("Saved token to %s", p)
+        _LOGGER.info("Saved token to %s", p)
     except OSError:
-        logging.getLogger(__name__).warning("Failed to save token file: %s", p)
+        _LOGGER.warning("Failed to save token file: %s", p)
 
 
 def main(argv: list[str] | None = None) -> int:
@@ -87,7 +88,7 @@ def main(argv: list[str] | None = None) -> int:
 
     # If no token and missing username/password, prompt interactively
     if not token and (not username or not password):
-        print("No token found. Please enter Ezviz credentials.")
+        _LOGGER.info("No token found. Please enter Ezviz credentials")
         if not username:
             username = input("Username: ")
         if not password:
@@ -107,7 +108,7 @@ def main(argv: list[str] | None = None) -> int:
                 code_int = None
             client.login(sms_code=code_int)
         except PyEzvizError as exp:
-            print(f"Login failed: {exp}")
+            _LOGGER.error("Login failed: %s", exp)
             return 1
 
     # Start MQTT client
@@ -115,21 +116,20 @@ def main(argv: list[str] | None = None) -> int:
     mqtt_client.connect()
 
     try:
-        print("Listening for MQTT messages... (Ctrl+C to quit)")
+        _LOGGER.info("Listening for MQTT messages... (Ctrl+C to quit)")
         while True:
             time.sleep(1)
     except KeyboardInterrupt:
-        print("\nStopping...")
+        _LOGGER.info("Stopping listener (keyboard interrupt)")
     finally:
         mqtt_client.stop()
-        print("Stopped.")
+        _LOGGER.info("Listener stopped")
 
     if args.save_token and args.token_file:
-        _save_token_file(args.token_file, cast(dict[str, Any], client._token))  # noqa: SLF001
+        _save_token_file(args.token_file, client.export_token())
 
     return 0
 
 
 if __name__ == "__main__":
     sys.exit(main())
-# ruff: noqa: T201

pyezvizapi/utils.py

@@ -2,17 +2,18 @@
 
 from __future__ import annotations
 
+from collections.abc import Iterable, Iterator
 import datetime
 from hashlib import md5
 import json
 import logging
 import re as _re
 from typing import Any
-import uuid
 from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
 
 from Crypto.Cipher import AES
 
+from .constants import HIK_ENCRYPTION_HEADER
 from .exceptions import PyEzvizError
 
 _LOGGER = logging.getLogger(__name__)
@@ -62,18 +63,64 @@ def convert_to_dict(data: Any) -> Any:
 
 def string_to_list(data: Any, separator: str = ",") -> Any:
     """Convert a string representation of a list to a list."""
-    if isinstance(data, str):
-        if separator in data:
-            try:
-                # Attempt to convert the string into a list
-                return data.split(separator)
+    if isinstance(data, str) and separator in data:
+        try:
+            # Attempt to convert the string into a list
+            return data.split(separator)
 
-            except AttributeError:
-                return data
+        except AttributeError:
+            return data
 
     return data
 
 
+PathComponent = str | int
+WILDCARD_STEP = "*"
+_MISSING = object()
+MILLISECONDS_THRESHOLD = 1e11
+
+
+def iter_nested(data: Any, path: Iterable[PathComponent]) -> Iterator[Any]:
+    """Yield values reachable by following a dotted path with optional wildcards."""
+
+    current: list[Any] = [data]
+
+    for step in path:
+        next_level: list[Any] = []
+        for candidate in current:
+            if step == WILDCARD_STEP:
+                if isinstance(candidate, dict):
+                    next_level.extend(candidate.values())
+                elif isinstance(candidate, (list, tuple)):
+                    next_level.extend(candidate)
+                continue
+
+            if isinstance(candidate, dict) and step in candidate:
+                next_level.append(candidate[step])
+                continue
+
+            if (
+                isinstance(candidate, (list, tuple))
+                and isinstance(step, int)
+                and -len(candidate) <= step < len(candidate)
+            ):
+                next_level.append(candidate[step])
+
+        current = next_level
+        if not current:
+            break
+
+    yield from current
+
+
+def first_nested(
+    data: Any, path: Iterable[PathComponent], default: Any = None
+) -> Any:
+    """Return the first value produced by iter_nested or ``default``."""
+
+    return next(iter_nested(data, path), default)
+
+
 def fetch_nested_value(data: Any, keys: list, default_value: Any = None) -> Any:
     """Fetch the value corresponding to the given nested keys in a dictionary.
 
@@ -88,14 +135,8 @@ def fetch_nested_value(data: Any, keys: list, default_value: Any = None) -> Any:
         The value corresponding to the nested keys or the default value.
 
     """
-    try:
-        for key in keys:
-            data = data[key]
-
-    except (KeyError, TypeError):
-        return default_value
-
-    return data
+    value = first_nested(data, keys, _MISSING)
+    return default_value if value is _MISSING else value
 
 
 def decrypt_image(input_data: bytes, password: str) -> bytes:
@@ -116,8 +157,10 @@ def decrypt_image(input_data: bytes, password: str) -> bytes:
         raise PyEzvizError("Invalid image data")
 
     # check header
-    if input_data[:16] != b"hikencodepicture":
-        _LOGGER.debug("Image header doesn't contain 'hikencodepicture'")
+    header_len = len(HIK_ENCRYPTION_HEADER)
+
+    if input_data[:header_len] != HIK_ENCRYPTION_HEADER:
+        _LOGGER.debug("Image header doesn't contain %s", HIK_ENCRYPTION_HEADER)
         return input_data
 
     file_hash = input_data[16:48]
@@ -132,7 +175,7 @@ def decrypt_image(input_data: bytes, password: str) -> bytes:
     next_chunk = b""
     output_data = b""
     finished = False
-    i = 48  # offset hikencodepicture + hash
+    i = 48  # offset HIK header + hash
     chunk_size = 1024 * AES.block_size
     while not finished:
         chunk, next_chunk = next_chunk, cipher.decrypt(input_data[i : i + chunk_size])
@@ -195,30 +238,6 @@ def deep_merge(dict1: Any, dict2: Any) -> Any:
     return merged
 
 
-def generate_unique_code() -> str:
-    """Generate a deterministic, platform-agnostic unique code for the current host.
-
-    This function retrieves the host's MAC address using Python's standard
-    `uuid.getnode()` (works on Windows, Linux, macOS), converts it to a
-    canonical string representation, and then hashes it using MD5 to produce
-    a fixed-length hexadecimal string.
-
-    Returns:
-        str: A 32-character hexadecimal string uniquely representing
-        the host's MAC address. For example:
-        'a94e6756hghjgfghg49e0f310d9e44a'.
-
-    Notes:
-        - The output is deterministic: the same machine returns the same code.
-        - If the MAC address changes (e.g., different network adapter),
-          the output will change.
-        - MD5 is used here only for ID generation, not for security.
-    """
-    mac_int = uuid.getnode()
-    mac_str = ":".join(f"{(mac_int >> i) & 0xFF:02x}" for i in range(40, -1, -8))
-    return md5(mac_str.encode("utf-8")).hexdigest()
-
-
 # ---------------------------------------------------------------------------
 # Time helpers for alarm/motion handling
 # ---------------------------------------------------------------------------
@@ -255,7 +274,7 @@ def normalize_alarm_time(
     if epoch is not None:
         try:
             ts = float(epoch if not isinstance(epoch, str) else float(epoch))
-            if ts > 1e11:  # milliseconds
+            if ts > MILLISECONDS_THRESHOLD:  # milliseconds
                 ts /= 1000.0
             event_utc = datetime.datetime.fromtimestamp(ts, tz=datetime.UTC)
             alarm_dt_local = event_utc.astimezone(tzinfo)
@@ -322,10 +341,11 @@ def compute_motion_from_alarm(
     now_local = datetime.datetime.now(tz=tzinfo).replace(microsecond=0)
     now_utc = datetime.datetime.now(tz=datetime.UTC).replace(microsecond=0)
 
-    if alarm_dt_utc is not None:
-        delta = now_utc - alarm_dt_utc
-    else:
-        delta = now_local - alarm_dt_local
+    delta = (
+        now_utc - alarm_dt_utc
+        if alarm_dt_utc is not None
+        else now_local - alarm_dt_local
+    )
 
     seconds = float(delta.total_seconds())
     if seconds < 0:

pyezvizapi-1.0.3.8.dist-info/METADATA

@@ -0,0 +1,287 @@
+Metadata-Version: 2.4
+Name: pyezvizapi
+Version: 1.0.3.8
+Summary: EZVIZ API client for Home Assistant and CLI
+Home-page: https://github.com/RenierM26/pyEzvizApi/
+Author: Renier Moorcroft
+Author-email: RenierM26@users.github.com
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE.md
+Requires-Dist: requests
+Requires-Dist: aiohttp
+Requires-Dist: xmltodict
+Requires-Dist: pycryptodome
+Requires-Dist: paho-mqtt
+Requires-Dist: pandas
+Provides-Extra: dev
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Ezviz PyPi
+
+![Upload Python Package](https://github.com/RenierM26/pyEzvizApi/workflows/Upload%20Python%20Package/badge.svg)
+
+## Overview
+
+Pilot your Ezviz cameras (and light bulbs) with this module. It is used by:
+
+- The official Ezviz integration in Home Assistant
+- The EZVIZ (Beta) custom integration for Home Assistant
+
+You can also use it directly from the command line for quick checks and scripting.
+
+## Features
+
+- Inspect device and connection status in table or JSON form
+- Control cameras: PTZ, privacy/sleep/audio/IR/state LEDs, alarm settings
+- Control light bulbs: toggle, status, brightness and color temperature
+- Dump raw pagelist and device infos JSON for exploration/debugging
+- Reuse a saved session token (no credentials needed after first login)
+
+## Install
+
+From PyPI:
+
+```bash
+pip install pyezvizapi
+```
+
+After installation, a `pyezvizapi` command is available on your PATH.
+
+### Dependencies (development/local usage)
+
+If you are running from a clone of this repository or using the helper scripts directly, ensure these packages are available:
+
+```bash
+pip install requests paho-mqtt pycryptodome pandas
+```
+
+## Quick Start
+
+```bash
+# See available commands and options
+pyezvizapi --help
+
+# First-time login and save token for reuse
+pyezvizapi -u YOUR_EZVIZ_USERNAME -p YOUR_EZVIZ_PASSWORD --save-token devices status
+
+# Subsequent runs can reuse the saved token (no credentials needed)
+pyezvizapi devices status --json
+```
+
+## CLI Authentication
+
+- Username/password: `-u/--username` and `-p/--password`
+- Token file: `--token-file` (defaults to `ezviz_token.json` in the current directory)
+- Save token: `--save-token` writes the current token after login
+- MFA: The CLI prompts for a code if required by your account
+- Region: `-r/--region` overrides the default region (`apiieu.ezvizlife.com`)
+
+Examples:
+
+```bash
+# First-time login and save token locally
+pyezvizapi -u YOUR_EZVIZ_USERNAME -p YOUR_EZVIZ_PASSWORD --save-token devices status
+
+# Reuse saved token (no credentials)
+pyezvizapi devices status --json
+```
+
+## Output Modes
+
+- Default: human-readable tables (for list/status views)
+- JSON: add `--json` for easy parsing and editor-friendly exploration
+
+## CLI Commands
+
+All commands are subcommands of the module runner:
+
+```bash
+pyezvizapi <command> [options]
+```
+
+### devices
+
+- Actions: `device`, `status`, `switch`, `connection`
+- Examples:
+
+```bash
+# Table view
+pyezvizapi devices status
+
+# JSON view
+pyezvizapi devices status --json
+```
+
+Sample table columns include:
+
+```
+name | status | device_category | device_sub_category | sleep | privacy | audio | ir_led | state_led | local_ip | local_rtsp_port | battery_level | alarm_schedules_enabled | alarm_notify | Motion_Trigger
+```
+
+The CLI also computes a `switch_flags` map for each device (all switch states by name, e.g. `privacy`, `sleep`, `sound`, `infrared_light`, `light`, etc.).
+
+### camera
+
+Requires `--serial`.
+
+- Actions: `status`, `move`, `move_coords`, `unlock-door`, `unlock-gate`, `switch`, `alarm`, `select`
+- Examples:
+
+```bash
+# Camera status
+pyezvizapi camera --serial ABC123 status
+
+# PTZ move
+pyezvizapi camera --serial ABC123 move --direction up --speed 5
+
+# Move by coordinates
+pyezvizapi camera --serial ABC123 move_coords --x 0.4 --y 0.6
+
+# Switch setters
+pyezvizapi camera --serial ABC123 switch --switch privacy --enable 1
+
+# Alarm settings (push notify, sound level, do-not-disturb)
+pyezvizapi camera --serial ABC123 alarm --notify 1 --sound 2 --do_not_disturb 0
+
+# Battery camera work mode
+pyezvizapi camera --serial ABC123 select --battery_work_mode POWER_SAVE
+```
+
+### devices_light
+
+- Actions: `status`
+- Example:
+
+```bash
+pyezvizapi devices_light status
+```
+
+### home_defence_mode
+
+Set global defence mode for the account/home.
+
+```bash
+pyezvizapi home_defence_mode --mode HOME_MODE
+```
+
+### mqtt
+
+Connect to Ezviz MQTT push notifications using the current session token. Use `--debug` to see connection details.
+
+```bash
+pyezvizapi mqtt
+```
+
+#### MQTT push test script (standalone)
+
+For quick experimentation, a small helper script is included which can use a saved token file or prompt for credentials with MFA and save the session token:
+
+```bash
+# With a previously saved token file
+python config/custom_components/ezviz_cloud/pyezvizapi/test_mqtt.py --token-file ezviz_token.json
+
+# Interactive login, then save token for next time
+python config/custom_components/ezviz_cloud/pyezvizapi/test_mqtt.py --save-token
+
+# Explicit credentials (not recommended for shared terminals)
+python config/custom_components/ezviz_cloud/pyezvizapi/test_mqtt.py -u USER -p PASS --save-token
+```
+
+### pagelist
+
+Dump the complete raw pagelist JSON. Great for exploring unknown fields in an editor (e.g. Notepad++).
+
+```bash
+pyezvizapi pagelist > pagelist.json
+```
+
+### device_infos
+
+Dump the processed device infos mapping (what the integration consumes). Optionally filter to one serial:
+
+```bash
+# All devices
+pyezvizapi device_infos > device_infos.json
+
+# Single device
+pyezvizapi device_infos --serial ABC123 > ABC123.json
+```
+
+## Remote door and gate unlock (CS-HPD7)
+
+```bash
+pyezvizapi camera --serial BAXXXXXXX-BAYYYYYYY unlock-door
+pyezvizapi camera --serial BAXXXXXXX-BAYYYYYYY unlock-gate
+```
+
+## RTSP authentication test (Basic → Digest)
+
+Validate RTSP credentials by issuing a DESCRIBE request. Falls back from Basic to Digest auth automatically.
+
+```bash
+python -c "from config.custom_components.ezviz_cloud.pyezvizapi.test_cam_rtsp import TestRTSPAuth as T; T('<IP>', '<USER>', '<PASS>', '/Streaming/Channels/101').main()"
+```
+
+On success, the script prints a confirmation. On failure it raises one of:
+
+- `InvalidHost`: Hostname/IP or port issue
+- `AuthTestResultFailed`: Invalid credentials
+
+## Development
+
+Please format with Ruff and check typing with mypy.
+
+```bash
+ruff check .
+mypy config/custom_components/ezviz_cloud/pyezvizapi
+```
+
+Run style fixes where possible:
+
+```bash
+ruff check --fix config/custom_components/ezviz_cloud/pyezvizapi
+```
+
+Run tests with tox:
+
+```bash
+tox
+```
+
+## Side Notes
+
+There is no official API documentation. Much of this is based on reverse-engineering the Ezviz mobile app (Android/iOS). Some regions operate on separate endpoints; US example: `apiius.ezvizlife.com`.
+
+Example:
+
+```bash
+pyezvizapi -u username@domain.com -p PASS@123 -r apius.ezvizlife.com devices status
+```
+
+For advanced troubleshooting or new feature research, MITM proxy tools like mitmproxy/Charles/Fiddler can be used to inspect traffic from the app (see community guides for SSL unpinning and WSA usage).
+
+## Contributing
+
+Contributions are welcome — the API surface is large and there are many improvements possible.
+
+## Versioning
+
+We follow SemVer when publishing the library. See repository tags for released versions.
+
+## License
+
+Apache 2.0 — see `LICENSE.md`.
+
+---
+
+Draft versions: 0.0.x

pyezvizapi-1.0.3.8.dist-info/RECORD

@@ -0,0 +1,21 @@
+pyezvizapi/__init__.py,sha256=-OxHqxA9h0JZQW__GoZd1aByGquIHawCnNdeNlIg2Qo,3382
+pyezvizapi/__main__.py,sha256=6vFvkh8gCD-Mo4CXd1deZfDeaaHR-Kc8pOu9vkUjQf4,20878
+pyezvizapi/api_endpoints.py,sha256=2M5Vs4YB1VWZGcowT-4Fj2hhRNjFh976LT3jtRrqvrc,5754
+pyezvizapi/camera.py,sha256=Pl5oIEdrFcv1Hz5sQI1IyyJIDCMjOjQdtExgKzmLoK8,22102
+pyezvizapi/cas.py,sha256=3zHe-_a0KchCmGeAj1of-pV6oMPRUmSCIiDqBFsTK8A,6025
+pyezvizapi/client.py,sha256=CKSK7hdQFmJAD0p1GPgEaqw7QAtqyhqLN8soR_VmSeA,142146
+pyezvizapi/constants.py,sha256=6-AV7BvQPOQkSXrlrdOhnixDEF3eWiectV5jm5DtRSc,13115
+pyezvizapi/exceptions.py,sha256=8rmxEUQdrziqMe-M1SeeRd0HtP2IDQ2xpJVj7wvOQyo,976
+pyezvizapi/feature.py,sha256=m07s-6aEg0NijwjWZW4EAb23Rrr4RSRaBrYGQlqVwH0,16153
+pyezvizapi/light_bulb.py,sha256=7kuOJmKsmAmE6KGJaUScjrRSTic8IhuToYrMRM-Y76s,7795
+pyezvizapi/models.py,sha256=NQzwTP0yEe2IWU-Vc6nAn87xulpTuo0MX2Rcf0WxifA,4176
+pyezvizapi/mqtt.py,sha256=JGjO-uXdKtLidYN1wEZ_bxEKIlNLmnB82Ziiac6oxWs,22373
+pyezvizapi/test_cam_rtsp.py,sha256=pbuanoKs_Pryt2f5QctHIngzJG1nD6kv8nulQYh2yPc,5162
+pyezvizapi/test_mqtt.py,sha256=gBaurvo2bu-7sOe14AqNouepJHI-tPWzC3WTpDQbvHM,4155
+pyezvizapi/utils.py,sha256=WHGqI0bIy-G4yX6Vs7i_UDrr7dndx3yzbF_z7rDYGKE,13213
+pyezvizapi-1.0.3.8.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+pyezvizapi-1.0.3.8.dist-info/licenses/LICENSE.md,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+pyezvizapi-1.0.3.8.dist-info/METADATA,sha256=8H30gnNHkm2Yg0zmBL_rx5CMZ6mft0zvBMgzBDbFKQo,7609
+pyezvizapi-1.0.3.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyezvizapi-1.0.3.8.dist-info/top_level.txt,sha256=gMZTelIi8z7pXyTCQLLaIkxVRrDQ_lS2NEv0WgfHrHs,11
+pyezvizapi-1.0.3.8.dist-info/RECORD,,

pyezvizapi-1.0.3.6.dist-info/METADATA

@@ -1,27 +0,0 @@
-Metadata-Version: 2.4
-Name: pyezvizapi
-Version: 1.0.3.6
-Summary: Pilot your Ezviz cameras
-Home-page: https://github.com/RenierM26/pyEzvizApi/
-Author: Renier Moorcroft
-Author-email: RenierM26@users.github.com
-License: Apache Software License 2.0
-Requires-Python: >=3.11
-License-File: LICENSE
-License-File: LICENSE.md
-Requires-Dist: requests
-Requires-Dist: pandas
-Requires-Dist: paho-mqtt
-Requires-Dist: xmltodict
-Requires-Dist: pycryptodome
-Dynamic: author
-Dynamic: author-email
-Dynamic: description
-Dynamic: home-page
-Dynamic: license
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-Pilot your Ezviz cameras with this module. Please view readme on github

pyezvizapi-1.0.3.6.dist-info/RECORD

@@ -1,22 +0,0 @@
-pyezvizapi/__init__.py,sha256=-OxHqxA9h0JZQW__GoZd1aByGquIHawCnNdeNlIg2Qo,3382
-pyezvizapi/__main__.py,sha256=9uttTuOfO22tzyomJIV8ebFJ-G-YUNDYOadZ_0AgdNA,20925
-pyezvizapi/api_endpoints.py,sha256=2M5Vs4YB1VWZGcowT-4Fj2hhRNjFh976LT3jtRrqvrc,5754
-pyezvizapi/camera.py,sha256=Pl5oIEdrFcv1Hz5sQI1IyyJIDCMjOjQdtExgKzmLoK8,22102
-pyezvizapi/cas.py,sha256=3zHe-_a0KchCmGeAj1of-pV6oMPRUmSCIiDqBFsTK8A,6025
-pyezvizapi/client.py,sha256=LroaR4h_wYu8HB74l4_X6Vjq7rTiL88Idf18elUBj4A,141851
-pyezvizapi/constants.py,sha256=5AxJYfof6NvebBcFvPkoKI6xinpkwmCnaauUvhvBMDY,12810
-pyezvizapi/exceptions.py,sha256=8rmxEUQdrziqMe-M1SeeRd0HtP2IDQ2xpJVj7wvOQyo,976
-pyezvizapi/feature.py,sha256=inqqk14Jgo3HOzml2GRUgz-hxbne4kT5iJ3L6SJhU8s,15990
-pyezvizapi/light_bulb.py,sha256=9wgycG3dTvBbrsxQjQnXal-GA8VXPsIN1m-CTtRh8i0,7797
-pyezvizapi/models.py,sha256=NQzwTP0yEe2IWU-Vc6nAn87xulpTuo0MX2Rcf0WxifA,4176
-pyezvizapi/mqtt.py,sha256=aOL-gexZgYvCCaNQ03M4vZan91d5p2Fl_qsFykn9NW4,22365
-pyezvizapi/test_cam_rtsp.py,sha256=O9NHh-vcNFfnzNw8jbuhM9a_5TWfNZIMXaJP7Lmkaj4,5162
-pyezvizapi/test_mqtt.py,sha256=Orn-fwZPJIE4G5KROMX0MRAkLwU6nLb9LUtXyb2ZCQs,4147
-pyezvizapi/utils.py,sha256=ozGncEyaIJJ8VYw8f-xfM2OBmqR8eNYLq728FFvbvr8,12757
-pyezvizapi-1.0.3.6.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-pyezvizapi-1.0.3.6.dist-info/licenses/LICENSE.md,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-pyezvizapi-1.0.3.6.dist-info/METADATA,sha256=jp0jUC6j-BihBfzY79Qo_bdmk_yT6Db5wiJdlTHolmQ,695
-pyezvizapi-1.0.3.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pyezvizapi-1.0.3.6.dist-info/entry_points.txt,sha256=_BSJ3eNb2H_AZkRdsv1s4mojqWn3N7m503ujvg1SudA,56
-pyezvizapi-1.0.3.6.dist-info/top_level.txt,sha256=gMZTelIi8z7pXyTCQLLaIkxVRrDQ_lS2NEv0WgfHrHs,11
-pyezvizapi-1.0.3.6.dist-info/RECORD,,

pyezvizapi-1.0.3.6.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-pyezvizapi = pyezvizapi.__main__:main