elemctl 0.2.0__tar.gz → 0.2.1__tar.gz

{elemctl-0.2.0 → elemctl-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elemctl
-Version: 0.2.0
+Version: 0.2.1
 Summary: CLI, MCP-сервер и библиотека для Console API v2 платформы 1С:Предприятие.Элемент (1cmycloud)
 Author: KeyFire
 License-Expression: MIT

{elemctl-0.2.0 → elemctl-0.2.1}/docs/SPEC.md

@@ -261,7 +261,10 @@ stderr и код возврата 1.
   `apps start [APP_ID]`, `apps stop [APP_ID]`.
   - `apps find` ищет по точному совпадению (без учёта регистра) имени среди
     полей `name`, `display-name`, `publication-context`; вывод
-    `{"id": ..., "found": true|false}`, код возврата 1 если не найдено.
+    `{"id": ..., "found": true|false}`, код возврата 0 в обоих случаях –
+    отсутствие приложения это ответ, а не ошибка. Ненулевой код возврата
+    означает сбой запроса и сопровождается JSON'ом с полем `error` в stderr.
+    В скриптах проверять поле `found`, а не код возврата.
   - `--latest-build` - взять источником последнюю сборку проекта (защита от
     пустого каркаса, п. 6.2); `--wait` - дождаться готовности (п. 6.4) и
     вывести финальную карточку.

{elemctl-0.2.0 → elemctl-0.2.1}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "elemctl"
-version = "0.2.0"
+version = "0.2.1"
 description = "CLI, MCP-сервер и библиотека для Console API v2 платформы 1С:Предприятие.Элемент (1cmycloud)"
 readme = "README.md"
 requires-python = ">=3.10"

{elemctl-0.2.0 → elemctl-0.2.1}/src/elemctl/__init__.py

@@ -11,7 +11,7 @@ from .client import ElementClient
 from .config import Config
 from .errors import ApiError, BuildError, ConfigError, ElemctlError, TransportError
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 
 __all__ = [
     "ApiError",

elemctl-0.2.1/src/elemctl/__main__.py

@@ -0,0 +1,14 @@
+"""Запуск пакета как модуля: python -m elemctl <аргументы>.
+
+Нужен тем, кто вызывает elemctl текущим интерпретатором, не полагаясь на
+консольную точку входа в PATH (например, обёртки в чужих репозиториях).
+"""
+
+from __future__ import annotations
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

{elemctl-0.2.0 → elemctl-0.2.1}/src/elemctl/cli.py

@@ -97,11 +97,17 @@ def cmd_apps_get(args):
 
 
 def cmd_apps_find(args):
+    """Поиск приложения по имени. Отсутствие приложения – это ответ, а не ошибка.
+
+    Код возврата 0 в обоих случаях: признак несёт поле found. Ненулевой код возврата
+    означает сбой запроса (нет доступа, сеть, конфигурация) и сопровождается JSON'ом
+    с полем error в stderr – иначе вызывающий не отличит "стенда нет" от "не смогли спросить".
+    """
     client = make_client(_config(args))
     app = client.find_app(args.name)
     if app is None:
         _emit({"id": None, "found": False})
-        return 1
+        return 0
     _emit({"id": app.get("id"), "found": True})
     return 0
 

{elemctl-0.2.0 → elemctl-0.2.1}/src/elemctl.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elemctl
-Version: 0.2.0
+Version: 0.2.1
 Summary: CLI, MCP-сервер и библиотека для Console API v2 платформы 1С:Предприятие.Элемент (1cmycloud)
 Author: KeyFire
 License-Expression: MIT

{elemctl-0.2.0 → elemctl-0.2.1}/src/elemctl.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ README.md
 pyproject.toml
 docs/SPEC.md
 src/elemctl/__init__.py
+src/elemctl/__main__.py
 src/elemctl/auth.py
 src/elemctl/build.py
 src/elemctl/cli.py

{elemctl-0.2.0 → elemctl-0.2.1}/tests/test_cli.py

@@ -3,11 +3,16 @@
 from __future__ import annotations
 
 import json
+import os
+import subprocess
+import sys
 from pathlib import Path
 
 import pytest
 
+import elemctl
 from elemctl import cli
+from elemctl.errors import ApiError
 
 
 @pytest.fixture(autouse=True)
@@ -29,7 +34,17 @@ def test_version_flag(capsys):
     with pytest.raises(SystemExit) as excinfo:
         cli.main(["--version"])
     assert excinfo.value.code == 0
-    assert "elemctl 0.2.0" in capsys.readouterr().out
+    assert f"elemctl {elemctl.__version__}" in capsys.readouterr().out
+
+
+def test_module_entry_point():
+    """python -m elemctl – запасной путь для вызывающих без консольной точки входа в PATH."""
+    import_root = Path(elemctl.__file__).resolve().parent.parent
+    env = {**os.environ, "PYTHONPATH": str(import_root)}
+    result = subprocess.run([sys.executable, "-m", "elemctl", "--version"],
+                            capture_output=True, text=True, env=env)
+    assert result.returncode == 0, result.stderr
+    assert f"elemctl {elemctl.__version__}" in result.stdout
 
 
 def test_build_command(project_factory, tmp_path, capsys):
@@ -77,11 +92,28 @@ def test_apps_find_found_and_not_found(monkeypatch, capsys):
     assert rc == 0
     assert json.loads(capsys.readouterr().out) == {"id": "app-42", "found": True}
 
+    # Отсутствие приложения – штатный ответ: код возврата 0, признак несёт поле found.
     rc = cli.main(["apps", "find", "нет-такого"])
-    assert rc == 1
+    assert rc == 0
     assert json.loads(capsys.readouterr().out) == {"id": None, "found": False}
 
 
+def test_apps_find_request_failure_is_an_error(monkeypatch, capsys):
+    """Сбой запроса отличим от "не найдено": ненулевой код и error в stderr."""
+
+    class FailingClient:
+        def find_app(self, name):
+            raise ApiError("нет доступа", status=403)
+
+    monkeypatch.setattr(cli, "make_client", lambda config: FailingClient())
+
+    rc = cli.main(["apps", "find", "site-dev"])
+    assert rc == 1
+    captured = capsys.readouterr()
+    assert captured.out == ""
+    assert "error" in json.loads(captured.err)
+
+
 def test_error_is_json_on_stderr(capsys):
     # app-id не задан ни аргументом, ни конфигурацией.
     rc = cli.main(["apps", "get"])