fumis 0.1.0__py3-none-any.whl

fumis/__init__.py

@@ -0,0 +1,58 @@
+"""Asynchronous Python client for the Fumis WiRCU API."""
+
+from __future__ import annotations
+
+from .const import StoveModelInfo, StoveStatus
+from .exceptions import (
+    FumisAuthenticationError,
+    FumisConnectionError,
+    FumisConnectionTimeoutError,
+    FumisError,
+    FumisResponseError,
+    FumisStoveOfflineError,
+)
+from .fumis import Fumis
+from .models import (
+    Antifreeze,
+    Controller,
+    Diagnostic,
+    DiagnosticItem,
+    EcoMode,
+    Fan,
+    Fuel,
+    Hybrid,
+    Info,
+    Power,
+    Statistic,
+    Temperature,
+    TimerProgram,
+    Unit,
+    WeekSchedule,
+)
+
+__all__ = [
+    "Antifreeze",
+    "Controller",
+    "Diagnostic",
+    "DiagnosticItem",
+    "EcoMode",
+    "Fan",
+    "Fuel",
+    "Fumis",
+    "FumisAuthenticationError",
+    "FumisConnectionError",
+    "FumisConnectionTimeoutError",
+    "FumisError",
+    "FumisResponseError",
+    "FumisStoveOfflineError",
+    "Hybrid",
+    "Info",
+    "Power",
+    "Statistic",
+    "StoveModelInfo",
+    "StoveStatus",
+    "Temperature",
+    "TimerProgram",
+    "Unit",
+    "WeekSchedule",
+]

fumis/_cli.py

@@ -0,0 +1,36 @@
+"""Entry point shim for the optional Fumis CLI.
+
+Kept as a standalone module so the console script remains importable
+regardless of whether the ``cli`` extra is installed: if the CLI
+dependencies (``typer``, ``rich``) are missing we raise a friendly
+``SystemExit`` with an install hint instead of a bare ``ImportError``.
+"""
+
+from __future__ import annotations
+
+_CLI_EXTRA_MODULES = frozenset({"typer", "rich", "textual", "textual_plotext"})
+
+
+def main() -> None:
+    """Invoke the Typer CLI with a graceful error if extras are missing."""
+    try:
+        # Deferred import so the console script remains importable even
+        # when the optional ``cli`` extra is not installed.
+        # pylint: disable-next=import-outside-toplevel
+        from fumis.cli import cli  # noqa: PLC0415
+    except ModuleNotFoundError as err:  # pragma: no cover
+        # Only convert to a friendly install hint when the *optional* deps
+        # are missing. Anything else (e.g. a renamed internal module) must
+        # still surface as a real error for debugging.
+        # pylint chokes on the type of ModuleNotFoundError.name, so silence
+        # the spurious no-member warning on the split() call below.
+        missing_module: str = err.name or ""
+        missing_root = missing_module.split(".", 1)[0]  # pylint: disable=no-member
+        if missing_root not in _CLI_EXTRA_MODULES:
+            raise
+        msg = (
+            "The Fumis CLI requires the 'cli' extra. "
+            "Install it with: pip install 'fumis[cli]'"
+        )
+        raise SystemExit(msg) from err
+    cli()