proxcli 0.16.1__tar.gz → 0.16.2__tar.gz

{proxcli-0.16.1 → proxcli-0.16.2}/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.16.2] - 2026-06-30
+
+### Added
+- **``proxmox update``**: self-upgrade proxcli from PyPI. Queries the PyPI JSON
+  API to check for new versions and uses ``uv tool install proxcli --reinstall``
+  to upgrade in-place. ``--check`` flag reports available updates without
+  installing. ``--pre`` includes pre-release versions.
+
 ## [0.16.1] - 2026-06-30
 
 ### Added
@@ -355,6 +363,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - CSRF ticket auto-refresh on 401.
 - AI-agent-friendly: default JSON output, strict exit codes, `--dry-run` mode.
 
+[0.16.2]: https://github.com/xezpeleta/proxcli/releases/tag/v0.16.2
 [0.16.1]: https://github.com/xezpeleta/proxcli/releases/tag/v0.16.1
 [0.16.0]: https://github.com/xezpeleta/proxcli/releases/tag/v0.16.0
 [0.15.0]: https://github.com/xezpeleta/proxcli/releases/tag/v0.15.0

{proxcli-0.16.1 → proxcli-0.16.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxcli
-Version: 0.16.1
+Version: 0.16.2
 Summary: A CLI tool to interact with Proxmox VE nodes and clusters via the REST API
 Author-email: Xabi Ezpeleta <xezpeleta@gmail.com>
 License: MIT
@@ -192,6 +192,14 @@ proxmox auth setup             # Create recommended roles + ACLs (needs Administ
 proxmox auth check             # Live permission test table (39 checks)
 ```
 
+### Self-update
+
+```bash
+proxmox update              # Check for updates and install the latest version
+proxmox update --check      # Only check (no install)
+proxmox update --pre        # Include pre-release versions
+```
+
 ### Completion
 
 ```bash

{proxcli-0.16.1 → proxcli-0.16.2}/README.md

@@ -169,6 +169,14 @@ proxmox auth setup             # Create recommended roles + ACLs (needs Administ
 proxmox auth check             # Live permission test table (39 checks)
 ```
 
+### Self-update
+
+```bash
+proxmox update              # Check for updates and install the latest version
+proxmox update --check      # Only check (no install)
+proxmox update --pre        # Include pre-release versions
+```
+
 ### Completion
 
 ```bash

{proxcli-0.16.1 → proxcli-0.16.2}/TODO.md

@@ -29,6 +29,7 @@ Completed items are marked with a check. Implementation notes are preserved for
 - [x] **API coverage doc** — `docs/api-coverage.md` tracking all implemented and remaining endpoints.
 - [x] **VM disk import from URL** — `vm disk import --url` downloads, uploads, and imports a disk image from a remote URL in one command. `--image` for local PVE node paths.
 - [x] **Cloud-init auto serial console** — `vm create` with cloud-init flags now auto-adds `serial0=socket` and `vga=serial0`, required by Debian generic cloud images.
+- [x] **Self-update** — `proxmox update` checks PyPI for newer versions and upgrades via `uv tool install --reinstall`. `--check` for dry-run, `--pre` for pre-releases.
 
 ## v1.1 — Polish & Usability
 

{proxcli-0.16.1 → proxcli-0.16.2}/proxmox/cli/main.py

@@ -74,6 +74,7 @@ def build_root_parser() -> argparse.ArgumentParser:
     from proxmox.cli.role import register_role_parser
     from proxmox.cli.storage import register_storage_parser
     from proxmox.cli.tasks import register_task_parser
+    from proxmox.cli.update import register_update_parser
     from proxmox.cli.user import register_user_parser
     from proxmox.cli.vm import register_vm_parser
 
@@ -93,6 +94,7 @@ def build_root_parser() -> argparse.ArgumentParser:
     register_task_parser(subparsers)
     register_role_parser(subparsers)
     register_user_parser(subparsers)
+    register_update_parser(subparsers)
 
     return parser
 
@@ -224,7 +226,7 @@ GLOBAL_FLAGS_WITH_VALUE = {"--url", "--username", "--password", "--api-token", "
 def _hint_global_flags_order(argv: list[str]) -> None:
     """If user placed global flags after the resource, show a helpful hint."""
     resource_pos = -1
-    resources = {"acl", "api", "auth", "backup", "ceph", "vm", "node", "pool", "container", "storage", "cluster", "completion", "task", "user", "role", "network"}
+    resources = {"acl", "api", "auth", "backup", "ceph", "vm", "node", "pool", "container", "storage", "cluster", "completion", "task", "user", "role", "network", "update"}
     for i, arg in enumerate(argv):
         if arg in resources:
             resource_pos = i
@@ -297,7 +299,7 @@ def main(argv: list[str] | None = None) -> None:
 
     try:
         # auth status (without --permissions) and completion don't need a client
-        if args.resource == "completion" or (
+        if args.resource == "completion" or args.resource == "update" or (
             args.resource == "auth"
             and args.action == "status"
             and not getattr(args, "permissions", False)

proxcli-0.16.2/proxmox/cli/update.py

@@ -0,0 +1,154 @@
+"""proxmox update — self-upgrade proxcli from PyPI."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import subprocess
+import sys
+import urllib.request
+from importlib.metadata import version
+
+from proxmox.utils.logging import log_error
+
+
+def register_update_parser(subparsers: argparse._SubParsersAction) -> None:
+    update_parser = subparsers.add_parser("update", help="Check for and install proxcli updates")
+    update_parser.add_argument(
+        "--check",
+        action="store_true",
+        help="Only check if an update is available (do not install)",
+    )
+    update_parser.add_argument(
+        "--pre",
+        action="store_true",
+        help="Include pre-release versions when checking",
+    )
+    update_parser.set_defaults(func=_update, output_format="table")
+
+
+def _get_latest_version(include_pre: bool = False) -> str:
+    """Fetch the latest version tag from PyPI."""
+    url = "https://pypi.org/pypi/proxcli/json"
+    try:
+        with urllib.request.urlopen(url, timeout=10) as resp:
+            data = json.loads(resp.read().decode())
+    except Exception as exc:
+        raise RuntimeError(f"Failed to query PyPI: {exc}") from exc
+
+    versions = list(data.get("releases", {}).keys())
+
+    if not versions:
+        raise RuntimeError("No releases found on PyPI")
+
+    if not include_pre:
+        versions = [v for v in versions if _is_stable(v)]
+        if not versions:
+            raise RuntimeError("No stable releases found on PyPI")
+
+    return max(versions, key=_version_key)
+
+
+def _is_stable(ver: str) -> bool:
+    """Return True if version looks like a stable release (no dev/pre markers)."""
+    # Strip epoch if present
+    v = ver
+    # Simple check: no a/b/rc/dev/post markers
+    for marker in ("a", "b", "rc", "dev", "post"):
+        if marker in v:
+            return False
+    return True
+
+
+def _version_key(ver: str) -> tuple:
+    """Parse a version string into a comparable tuple."""
+    parts = ver.split(".")
+    result = []
+    for p in parts:
+        # Try int first
+        try:
+            result.append(int(p))
+        except ValueError:
+            result.append(p)
+    return tuple(result)
+
+
+def _update(args: argparse.Namespace, client: object | None = None) -> dict | str:
+    """Check for updates and optionally install them.
+
+    Returns a dict for the output formatter.
+    """
+    current = version("proxcli")
+
+    try:
+        latest = _get_latest_version(include_pre=args.pre)
+    except RuntimeError as exc:
+        return {"error": str(exc)}
+
+    up_to_date = _version_key(current) >= _version_key(latest)
+
+    if args.check:
+        if up_to_date:
+            return {
+                "current": current,
+                "latest": latest,
+                "status": "up-to-date",
+                "message": f"proxcli {current} is the latest version.",
+            }
+        else:
+            return {
+                "current": current,
+                "latest": latest,
+                "status": "update-available",
+                "message": f"proxcli {latest} is available (you have {current}). Run 'proxmox update' to upgrade.",
+            }
+
+    if up_to_date:
+        return {
+            "current": current,
+            "latest": latest,
+            "status": "up-to-date",
+            "message": f"proxcli {current} is already the latest version.",
+        }
+
+    # Run uv tool install
+    log_error(f"Upgrading proxcli from {current} to {latest}...", file=sys.stderr)
+    try:
+        result = subprocess.run(
+            ["uv", "tool", "install", "proxcli", "--reinstall"],
+            capture_output=True,
+            text=True,
+            timeout=120,
+        )
+        if result.returncode != 0:
+            error_msg = result.stderr.strip() or result.stdout.strip() or f"exit code {result.returncode}"
+            log_error(error_msg)
+            return {
+                "current": current,
+                "latest": latest,
+                "status": "error",
+                "message": f"Upgrade failed: {error_msg}",
+            }
+    except FileNotFoundError:
+        return {
+            "current": current,
+            "latest": latest,
+            "status": "error",
+            "message": "uv not found in PATH. Install uv (https://docs.astral.sh/uv/) or upgrade manually with 'uv tool install proxcli --reinstall'.",
+        }
+    except subprocess.TimeoutExpired:
+        return {
+            "current": current,
+            "latest": latest,
+            "status": "error",
+            "message": "Upgrade timed out. Try again or upgrade manually.",
+        }
+
+    new_version = version("proxcli")
+    return {
+        "current": new_version,
+        "previous": current,
+        "latest": latest,
+        "status": "upgraded",
+        "message": f"proxcli upgraded from {current} to {new_version}.",
+    }

{proxcli-0.16.1 → proxcli-0.16.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "proxcli"
-version = "0.16.1"
+version = "0.16.2"
 description = "A CLI tool to interact with Proxmox VE nodes and clusters via the REST API"
 readme = "README.md"
 authors = [

{proxcli-0.16.1 → proxcli-0.16.2}/uv.lock

@@ -254,7 +254,7 @@ wheels = [
 
 [[package]]
 name = "proxcli"
-version = "0.16.1"
+version = "0.16.2"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },