logics-manager 2.3.0__tar.gz → 2.3.2__tar.gz

{logics_manager-2.3.0 → logics_manager-2.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logics-manager
-Version: 2.3.0
+Version: 2.3.2
 Summary: Canonical Logics CLI
 Requires-Python: >=3.10
 License-File: LICENSE

{logics_manager-2.3.0 → logics_manager-2.3.2}/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/AlexAgo83/logics-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/AlexAgo83/logics-manager/actions/workflows/ci.yml)
 [![License](https://img.shields.io/github/license/AlexAgo83/logics-manager)](LICENSE)
-![Version](https://img.shields.io/badge/version-v2.3.0-4C8BF5)
+![Version](https://img.shields.io/badge/version-v2.3.2-4C8BF5)
 ![VS Code](https://img.shields.io/badge/VS%20Code-1.86.0-007ACC?logo=visualstudiocode&logoColor=white)
 ![TypeScript](https://img.shields.io/badge/TypeScript-5.3.3-3178C6?logo=typescript&logoColor=white)
 ![Vitest](https://img.shields.io/badge/Vitest-2.1.8-6E9F18?logo=vitest&logoColor=white)
@@ -58,6 +58,15 @@ python3.11 -m pip install .
 logics-manager --help
 ```
 
+On Debian, Ubuntu, or WSL environments where Python is externally managed, use `pipx` instead of installing into the system Python:
+
+```bash
+sudo apt update
+sudo apt install pipx python3-venv
+pipx ensurepath
+pipx install logics-manager
+```
+
 Or install the npm package:
 
 ```bash
@@ -197,6 +206,38 @@ To update the installed CLI later:
 logics-manager self-update
 ```
 
+If `self-update` reports an externally managed Python environment, migrate the Python install through `pipx`:
+
+```bash
+sudo apt update
+sudo apt install pipx python3-venv
+pipx ensurepath
+pipx install --force logics-manager
+```
+
+If `logics-manager` is already installed through `pipx`, update that managed environment directly:
+
+```bash
+pipx upgrade logics-manager
+```
+
+For npm installs, update with:
+
+```bash
+npm install -g @grifhinz/logics-manager@latest
+```
+
+If npm reports a successful update but `logics-manager --version` still shows an older version, another installation is earlier on `PATH`. Diagnose it with:
+
+```bash
+command -v -a logics-manager
+npm prefix -g
+npm list -g @grifhinz/logics-manager --depth=0
+"$(npm prefix -g)/bin/logics-manager" --version
+```
+
+If the direct npm binary shows the expected version, remove the older Python install or move the npm global `bin` directory earlier on `PATH`.
+
 ## VS Code Extension
 
 The VS Code extension is the human cockpit around the same runtime. It helps you:

{logics_manager-2.3.0 → logics_manager-2.3.2}/logics_manager/cli.py

@@ -1,9 +1,12 @@
 from __future__ import annotations
 
 import argparse
+import json
+import os
 from importlib import metadata
 import subprocess
 import sys
+import sysconfig
 from shutil import which
 from pathlib import Path
 
@@ -133,6 +136,104 @@ def get_cli_version() -> str:
     return "0.0.0"
 
 
+def _is_running_inside_venv() -> bool:
+    return sys.prefix != getattr(sys, "base_prefix", sys.prefix)
+
+
+def _is_externally_managed_python() -> bool:
+    if _is_running_inside_venv():
+        return False
+    stdlib = sysconfig.get_path("stdlib")
+    return bool(stdlib and (Path(stdlib) / "EXTERNALLY-MANAGED").exists())
+
+
+def _is_running_from_pipx(package_name: str = DEFAULT_SELF_UPDATE_PY_PACKAGE) -> bool:
+    expected = package_name.replace("_", "-").lower()
+    candidates = [Path(sys.prefix), Path(sys.executable)]
+    for candidate in candidates:
+        parts = [part.lower() for part in candidate.parts]
+        for index, part in enumerate(parts[:-2]):
+            if part == "pipx" and parts[index + 1] == "venvs" and parts[index + 2] == expected:
+                return True
+    return False
+
+
+def _is_running_from_npm_package() -> bool:
+    package_json = Path(__file__).resolve().parents[1] / "package.json"
+    try:
+        payload = json.loads(package_json.read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return False
+    return payload.get("name") == DEFAULT_SELF_UPDATE_PACKAGE
+
+
+def _find_executable_paths(command: str) -> list[str]:
+    paths: list[str] = []
+    seen: set[str] = set()
+    names = [command]
+    if sys.platform == "win32":
+        extensions = [suffix.lower() for suffix in os.environ.get("PATHEXT", ".COM;.EXE;.BAT;.CMD").split(";") if suffix]
+        if Path(command).suffix.lower() not in extensions:
+            names = [command + extension for extension in extensions]
+    for directory in os.environ.get("PATH", "").split(os.pathsep):
+        if not directory:
+            continue
+        for name in names:
+            candidate = Path(directory) / name
+            try:
+                resolved = str(candidate.resolve())
+            except OSError:
+                resolved = str(candidate)
+            if resolved in seen:
+                continue
+            if candidate.exists() and os.access(candidate, os.X_OK):
+                seen.add(resolved)
+                paths.append(str(candidate))
+    return paths
+
+
+def _print_path_conflict_guidance(paths: list[str]) -> None:
+    if len(paths) <= 1:
+        return
+    print(
+        "\n".join(
+            [
+                "",
+                "Multiple logics-manager executables are on PATH. If --version still shows an older release, an earlier install is taking precedence.",
+                "Diagnose with:",
+                "  command -v -a logics-manager",
+                "  pipx list",
+                "  npm list -g @grifhinz/logics-manager --depth=0",
+            ]
+        )
+    )
+
+
+def _print_externally_managed_update_guidance(package_name: str) -> None:
+    print(
+        "\n".join(
+            [
+                "This Python installation is externally managed, so pip cannot safely update logics-manager in the system environment.",
+                "",
+                "If this command was installed with pipx, update it with:",
+                f"  pipx upgrade {package_name}",
+                "",
+                "Otherwise migrate the Python install through pipx:",
+                "  sudo apt update",
+                "  sudo apt install pipx python3-venv",
+                "  pipx ensurepath",
+                f"  pipx install --force {package_name}",
+                "",
+                "If you installed the npm package instead, run:",
+                f"  npm install -g {DEFAULT_SELF_UPDATE_PACKAGE}@latest",
+                "",
+                "Advanced override, at your own risk:",
+                f"  logics-manager self-update --manager pip --break-system-packages",
+            ]
+        )
+    )
+
+
 def _is_json_mode(argv: list[str]) -> bool:
     return "--json" in argv or any(argv[index] == "--format" and index + 1 < len(argv) and argv[index + 1] == "json" for index in range(len(argv)))
 
@@ -205,23 +306,40 @@ def main(argv: list[str] | None = None) -> int:
         return 0 if payload["ok"] else 1
     if command == "self-update":
         parser = argparse.ArgumentParser(prog="logics-manager self-update", add_help=False)
-        parser.add_argument("--manager", choices=("auto", "pip", "npm"), default="auto")
+        parser.add_argument("--manager", choices=("auto", "pip", "pipx", "npm"), default="auto")
         parser.add_argument("--package", default=DEFAULT_SELF_UPDATE_PACKAGE)
         parser.add_argument("--python-package", default=DEFAULT_SELF_UPDATE_PY_PACKAGE)
+        parser.add_argument("--break-system-packages", action="store_true")
         parser.add_argument("--dry-run", action="store_true")
         parsed = parser.parse_args(rest)
 
         manager = parsed.manager
         if manager == "auto":
-            try:
-                metadata.version(parsed.python_package)
-            except metadata.PackageNotFoundError:
-                manager = "npm" if which("npm") else "pip"
+            if _is_running_from_npm_package() and which("npm"):
+                manager = "npm"
+            elif _is_running_from_pipx(parsed.python_package) and which("pipx"):
+                manager = "pipx"
             else:
-                manager = "pip"
+                try:
+                    metadata.version(parsed.python_package)
+                except metadata.PackageNotFoundError:
+                    manager = "npm" if which("npm") else "pip"
+                else:
+                    manager = "pip"
 
         if manager == "pip":
+            if _is_externally_managed_python() and not parsed.break_system_packages:
+                _print_externally_managed_update_guidance(parsed.python_package)
+                return 1
             command = [sys.executable, "-m", "pip", "install", "--upgrade", parsed.python_package]
+            if parsed.break_system_packages:
+                command.append("--break-system-packages")
+        elif manager == "pipx":
+            pipx = which("pipx")
+            if not pipx:
+                print("pipx was not found on PATH. Install pipx or update with --manager pip/npm.")
+                return 1
+            command = [pipx, "upgrade", parsed.python_package]
         else:
             npm = which("npm")
             if not npm:
@@ -236,7 +354,11 @@ def main(argv: list[str] | None = None) -> int:
         result = subprocess.run(command, check=False)
         if result.returncode == 0:
             target = parsed.python_package if manager == "pip" else parsed.package
+            if manager == "pipx":
+                target = parsed.python_package
             print(f"Updated {target} via {manager}.")
+            if manager == "npm":
+                _print_path_conflict_guidance(_find_executable_paths("logics-manager"))
         return result.returncode
     if command == "flow" and (rest[:1] in (["new"], ["list"], ["companion"], ["deliver"], ["validate-closeout"], ["repair"], ["closeout"], ["promote"], ["split"], ["close"], ["finish"]) or rest[:1] in HELP_ARGV):
         from .flow import main as flow_main

{logics_manager-2.3.0 → logics_manager-2.3.2}/logics_manager.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logics-manager
-Version: 2.3.0
+Version: 2.3.2
 Summary: Canonical Logics CLI
 Requires-Python: >=3.10
 License-File: LICENSE

{logics_manager-2.3.0 → logics_manager-2.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "logics-manager"
-version = "2.3.0"
+version = "2.3.2"
 description = "Canonical Logics CLI"
 requires-python = ">=3.10"