homeconsole-cli 0.0.2__tar.gz → 0.0.3__tar.gz

{homeconsole_cli-0.0.2 → homeconsole_cli-0.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homeconsole-cli
-Version: 0.0.2
+Version: 0.0.3
 Summary: HomeConsole CLI (hc) — управление платформой через HTTP API
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -18,13 +18,42 @@ Requires-Dist: pytest>=8; extra == "dev"
 
 CLI-утилита для управления платформой HomeConsole **исключительно через HTTP API** CoreRuntime.
 
-## Установка (локально)
+## Установка
+
+### Рекомендуется — `pipx` (Debian / Ubuntu / Raspbian / OrangePi OS)
+
+`pipx` создаёт изолированный venv автоматически и регистрирует `hc` глобально:
+
+```bash
+apt install pipx          # или: pip install pipx --user
+pipx ensurepath           # добавляет ~/.local/bin в PATH (один раз)
+pipx install homeconsole-cli
+```
+
+После `pipx ensurepath` перезапусти шелл или выполни `source ~/.bashrc`.
+
+Обновление:
+```bash
+pipx upgrade homeconsole-cli
+```
+
+### Альтернатива — `pip --user`
+
+```bash
+pip install --user homeconsole-cli
+```
+
+Убедись, что `~/.local/bin` в `PATH`:
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
+```
+
+### Локальная разработка (из исходников)
 
 ```bash
 cd home-console-cli
 python -m venv .venv
 source .venv/bin/activate
-pip install -U pip
 pip install -e .
 ```
 

{homeconsole_cli-0.0.2 → homeconsole_cli-0.0.3}/README.md

@@ -2,13 +2,42 @@
 
 CLI-утилита для управления платформой HomeConsole **исключительно через HTTP API** CoreRuntime.
 
-## Установка (локально)
+## Установка
+
+### Рекомендуется — `pipx` (Debian / Ubuntu / Raspbian / OrangePi OS)
+
+`pipx` создаёт изолированный venv автоматически и регистрирует `hc` глобально:
+
+```bash
+apt install pipx          # или: pip install pipx --user
+pipx ensurepath           # добавляет ~/.local/bin в PATH (один раз)
+pipx install homeconsole-cli
+```
+
+После `pipx ensurepath` перезапусти шелл или выполни `source ~/.bashrc`.
+
+Обновление:
+```bash
+pipx upgrade homeconsole-cli
+```
+
+### Альтернатива — `pip --user`
+
+```bash
+pip install --user homeconsole-cli
+```
+
+Убедись, что `~/.local/bin` в `PATH`:
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
+```
+
+### Локальная разработка (из исходников)
 
 ```bash
 cd home-console-cli
 python -m venv .venv
 source .venv/bin/activate
-pip install -U pip
 pip install -e .
 ```
 

homeconsole_cli-0.0.3/hc/__init__.py

@@ -0,0 +1,10 @@
+from __future__ import annotations
+
+__all__ = ["__version__"]
+
+try:
+    from importlib.metadata import version as _pkg_version
+    __version__ = _pkg_version("homeconsole-cli")
+except Exception:
+    __version__ = "0.0.2"
+

{homeconsole_cli-0.0.2 → homeconsole_cli-0.0.3}/hc/client.py

@@ -20,6 +20,7 @@ class HCClient:
     auth: str = "auto"  # auto|bearer|api-key
     refresh_token: str = ""
     on_token_refreshed: Callable[[str], None] | None = field(default=None)
+    silent_connect: bool = False  # suppress "Core недоступен" during background probes
 
     def _auth_hint(self, status_code: int) -> None:
         console = Console()
@@ -59,11 +60,13 @@ class HCClient:
             ) as client:
                 return await client.request(method, path, headers=self._headers(), **kwargs)
         except httpx.ConnectError:
-            hostport = self.base_url.replace("http://", "").replace("https://", "")
-            console.print(f"[red]Ошибка: Core недоступен на {hostport}[/red]")
+            if not self.silent_connect:
+                hostport = self.base_url.replace("http://", "").replace("https://", "")
+                console.print(f"[red]Ошибка: Core недоступен на {hostport}[/red]")
             return None
         except httpx.RequestError as e:
-            console.print(f"[red]Ошибка: {e}[/red]")
+            if not self.silent_connect:
+                console.print(f"[red]Ошибка: {e}[/red]")
             return None
 
     async def _try_refresh(self) -> bool:

{homeconsole_cli-0.0.2 → homeconsole_cli-0.0.3}/hc/commands/_client_helpers.py

@@ -11,9 +11,10 @@ from hc.config import Config
 
 
 def _mute_auth_hints(client: HCClient) -> HCClient:
-    # Capabilities probe / фоновые операции не должны спамить подсказками при 403.
+    # Фоновые проbes не должны спамить ни auth-подсказками, ни "Core недоступен".
     client._auth_hint = lambda *a, **kw: None  # type: ignore[attr-defined]
     client._expired_session_hint = lambda: None  # type: ignore[attr-defined]
+    client.silent_connect = True
     return client
 
 

{homeconsole_cli-0.0.2 → homeconsole_cli-0.0.3}/hc/constants.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 from pathlib import Path
 
 APP_NAME = "HomeConsole CLI"
-APP_VERSION = "1.0"
 ENV_TOKEN = "HC_TOKEN"
 
 CONFIG_DIR = Path.home() / ".config" / "hc"

{homeconsole_cli-0.0.2 → homeconsole_cli-0.0.3}/hc/repl.py

@@ -14,6 +14,7 @@ from rich.console import Console
 
 from typer.main import get_command as _typer_get_command
 
+from hc import __version__
 from hc.config import Config
 from hc.constants import APP_NAME, HISTORY_PATH
 from hc.commands._client_helpers import require_client
@@ -229,32 +230,30 @@ def run_repl(app: typer.Typer) -> None:
     console = Console()
     cfg = Config.load()
     token = os.getenv("HC_TOKEN") or cfg.core.token
-    connected = bool(cfg.core.host.strip()) and bool(token.strip())
+    cfg_ok = bool(cfg.core.host.strip()) and bool(token.strip())
     hostport = f"{cfg.core.host}:{cfg.core.port}"
 
     plugins: list[str] = []
-    if connected:
-        client = require_client(console)
+    connected = False
+    if cfg_ok:
+        client = require_client(console, silent=True)
 
-        async def _get_names() -> list[str]:
+        async def _get_names() -> tuple[bool, list[str]]:
             # Пытаемся получить имена плагинов из inspector (админский источник истины).
             insp = await client.inspector_plugins()
             if isinstance(insp, dict):
                 arr = insp.get("plugins") or []
                 if isinstance(arr, list):
-                    names = []
-                    for p in arr:
-                        if isinstance(p, dict) and p.get("name"):
-                            names.append(str(p["name"]))
+                    names = [str(p["name"]) for p in arr if isinstance(p, dict) and p.get("name")]
                     if names:
-                        return names
+                        return True, names
             # Fallback на старый эндпоинт (если он есть).
             items = await client.get_plugins()
-            if not items:
-                return []
-            return [str(p.get("name", "")) for p in items if p.get("name")]
+            if items is not None:
+                return True, [str(p.get("name", "")) for p in items if p.get("name")]
+            return False, []
 
-        plugins = anyio.run(_get_names)
+        connected, plugins = anyio.run(_get_names)
 
     commands = [
         "connect",
@@ -290,7 +289,13 @@ def run_repl(app: typer.Typer) -> None:
 
     completer = _HCCompleter(app=app, commands=commands, plugins=plugins, get_group_ctx=_get_ctx)
 
-    console.print(f"{APP_NAME} 0.0.1 | " + (f"connected to {hostport}" if connected else "not connected"))
+    if connected:
+        status = f"connected to {hostport}"
+    elif cfg_ok:
+        status = f"offline • configured for {hostport}"
+    else:
+        status = "not connected"
+    console.print(f"{APP_NAME} {__version__} | {status}")
     console.print("Type 'help' or '?' for commands, 'exit' to quit")
 
     HISTORY_PATH.parent.mkdir(parents=True, exist_ok=True)

{homeconsole_cli-0.0.2 → homeconsole_cli-0.0.3}/homeconsole_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homeconsole-cli
-Version: 0.0.2
+Version: 0.0.3
 Summary: HomeConsole CLI (hc) — управление платформой через HTTP API
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -18,13 +18,42 @@ Requires-Dist: pytest>=8; extra == "dev"
 
 CLI-утилита для управления платформой HomeConsole **исключительно через HTTP API** CoreRuntime.
 
-## Установка (локально)
+## Установка
+
+### Рекомендуется — `pipx` (Debian / Ubuntu / Raspbian / OrangePi OS)
+
+`pipx` создаёт изолированный venv автоматически и регистрирует `hc` глобально:
+
+```bash
+apt install pipx          # или: pip install pipx --user
+pipx ensurepath           # добавляет ~/.local/bin в PATH (один раз)
+pipx install homeconsole-cli
+```
+
+После `pipx ensurepath` перезапусти шелл или выполни `source ~/.bashrc`.
+
+Обновление:
+```bash
+pipx upgrade homeconsole-cli
+```
+
+### Альтернатива — `pip --user`
+
+```bash
+pip install --user homeconsole-cli
+```
+
+Убедись, что `~/.local/bin` в `PATH`:
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
+```
+
+### Локальная разработка (из исходников)
 
 ```bash
 cd home-console-cli
 python -m venv .venv
 source .venv/bin/activate
-pip install -U pip
 pip install -e .
 ```
 

{homeconsole_cli-0.0.2 → homeconsole_cli-0.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "homeconsole-cli"
-version = "0.0.2"
+version = "0.0.3"
 description = "HomeConsole CLI (hc) — управление платформой через HTTP API"
 readme = "README.md"
 requires-python = ">=3.11"

homeconsole_cli-0.0.2/hc/__init__.py

@@ -1,6 +0,0 @@
-from __future__ import annotations
-
-__all__ = ["__version__"]
-
-__version__ = "0.0.1"
-