proxcli 0.8.0__tar.gz → 0.8.2__tar.gz

{proxcli-0.8.0 → proxcli-0.8.2}/.github/workflows/ci.yml

@@ -70,4 +70,4 @@ jobs:
           name: dist
           path: dist/
 
-      - run: uv publish --token "${{ secrets.PYPI_TOKEN }}"
+      - run: uv publish --token "${{ secrets.PYPI_TOKEN }}" --check-url https://pypi.org/simple

{proxcli-0.8.0 → proxcli-0.8.2}/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.2] - 2026-06-20
+
+### Added
+- **vm agent interfaces** — query QEMU guest agent for network interface
+  and IP information via ``proxmox vm agent interfaces <vmid>``.
+  Requires ``qemu-guest-agent`` in the VM.
+
+### Fixed
+- CI publish job now uses ``uv publish --check-url https://pypi.org/simple``
+  to skip already-published versions instead of failing with "File already
+  exists".
+
+## [0.8.1] - 2026-06-20
+
+### Added
+- **vm snapshot** management: ``list``, ``create``, ``show``, ``rollback``,
+  ``delete``.  Wraps ``/nodes/{node}/qemu/{vmid}/snapshot`` endpoints.
+
 ## [0.8.0] - 2026-06-20
 
 ### Fixed
@@ -118,6 +136,8 @@ 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.8.2]: https://github.com/xezpeleta/proxcli/releases/tag/v0.8.2
+[0.8.1]: https://github.com/xezpeleta/proxcli/releases/tag/v0.8.1
 [0.8.0]: https://github.com/xezpeleta/proxcli/releases/tag/v0.8.0
 [0.7.2]: https://github.com/xezpeleta/proxcli/releases/tag/v0.7.2
 [0.7.1]: https://github.com/xezpeleta/proxcli/releases/tag/v0.7.1

{proxcli-0.8.0 → proxcli-0.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxcli
-Version: 0.8.0
+Version: 0.8.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
@@ -177,7 +177,9 @@ proxmox completion fish > ~/.config/fish/completions/proxmox.fish
 ```bash
 proxmox vm list [--node <node>]
 proxmox vm show <vmid> [--node <node>]
-proxmox vm create --node <node> --vmid <id> --memory <mb> [--cores <n>] [--name <name>] [--storage <name>] [--net <config>]
+proxmox vm create --node <node> --memory <mb> [--vmid <id>] [--cores <n>] \
+    [--name <name>] [--cdrom <iso>] [--net <config>] [--disk <size>] \
+    [--scsihw <type>] [--bios seabios|ovmf] [--machine <type>] [--boot <order>]
 proxmox vm start <vmid> [--node <node>]
 proxmox vm stop <vmid> [--node <node>]
 proxmox vm reboot <vmid> [--node <node>]
@@ -185,6 +187,16 @@ proxmox vm suspend <vmid> [--node <node>]
 proxmox vm resume <vmid> [--node <node>]
 proxmox vm delete <vmid> [--node <node>] [--force] [--purge]
 
+# VM snapshots
+proxmox vm snapshot list <vmid> [--node <node>]
+proxmox vm snapshot create <vmid> <snapname> [--description <text>] [--vmstate 1]
+proxmox vm snapshot show <vmid> <snapname> [--node <node>]
+proxmox vm snapshot rollback <vmid> <snapname> [--start 1]
+proxmox vm snapshot delete <vmid> <snapname> [--force 1]
+
+# VM guest agent
+proxmox vm agent interfaces <vmid> [--node <node>]
+
 # VM firewall
 proxmox vm firewall options <vmid> [--node <node>]
 proxmox vm firewall enable <vmid> [--node <node>]

{proxcli-0.8.0 → proxcli-0.8.2}/README.md

@@ -154,7 +154,9 @@ proxmox completion fish > ~/.config/fish/completions/proxmox.fish
 ```bash
 proxmox vm list [--node <node>]
 proxmox vm show <vmid> [--node <node>]
-proxmox vm create --node <node> --vmid <id> --memory <mb> [--cores <n>] [--name <name>] [--storage <name>] [--net <config>]
+proxmox vm create --node <node> --memory <mb> [--vmid <id>] [--cores <n>] \
+    [--name <name>] [--cdrom <iso>] [--net <config>] [--disk <size>] \
+    [--scsihw <type>] [--bios seabios|ovmf] [--machine <type>] [--boot <order>]
 proxmox vm start <vmid> [--node <node>]
 proxmox vm stop <vmid> [--node <node>]
 proxmox vm reboot <vmid> [--node <node>]
@@ -162,6 +164,16 @@ proxmox vm suspend <vmid> [--node <node>]
 proxmox vm resume <vmid> [--node <node>]
 proxmox vm delete <vmid> [--node <node>] [--force] [--purge]
 
+# VM snapshots
+proxmox vm snapshot list <vmid> [--node <node>]
+proxmox vm snapshot create <vmid> <snapname> [--description <text>] [--vmstate 1]
+proxmox vm snapshot show <vmid> <snapname> [--node <node>]
+proxmox vm snapshot rollback <vmid> <snapname> [--start 1]
+proxmox vm snapshot delete <vmid> <snapname> [--force 1]
+
+# VM guest agent
+proxmox vm agent interfaces <vmid> [--node <node>]
+
 # VM firewall
 proxmox vm firewall options <vmid> [--node <node>]
 proxmox vm firewall enable <vmid> [--node <node>]

{proxcli-0.8.0 → proxcli-0.8.2}/TODO.md

@@ -11,12 +11,13 @@ Completed items are marked with a check. Implementation notes are preserved for
 - [x] **Firewall management** — cluster, node, VM, and container. Options, enable/disable, policy, rules (CRUD), aliases (cluster), ipsets with CIDR mgmt (cluster), refs.
 - [x] **Pool management** — `proxmox pool`: list, show, create, update, delete. Wraps `/pools`.
 - [x] **Shell completions** — `proxmox completion bash|zsh|fish`. Dynamic, introspects the parser tree.
+- [x] **VM snapshot management** — `proxmox vm snapshot`: list, create, show, rollback, delete. Wraps `/nodes/{node}/qemu/{vmid}/snapshot`.
+- [x] **QEMU guest agent interfaces** — `proxmox vm agent interfaces <vmid>`. Wraps `/nodes/{node}/qemu/{vmid}/agent/network-get-interfaces`.
+- [x] **Streaming task logs** — `proxmox task log <upid> [--follow]`. Polls `/nodes/{node}/tasks/{upid}/log`.
+- [x] **Global flag hint** — If user places `--output` / `--dry-run` / etc. after the resource, a hint suggests the correct order.
 
 ## v1.1 — Polish & Usability
 
-- [ ] **Streaming task logs (`--follow`)**
-  - `proxmox task log <upid> --follow` that streams task output in real time (like `tail -f`). Requires httpx streaming.
-
 - [ ] **Startup time optimization**
   - Current `proxmox --help` takes ~350ms. Lazy-load subcommand modules so only the requested resource's code is imported. Move `import rich`, `import yaml` inside formatter functions. Target: <200ms.
 

{proxcli-0.8.0 → proxcli-0.8.2}/proxmox/cli/vm.py

@@ -84,6 +84,55 @@ def register_vm_parser(subparsers: argparse._SubParsersAction) -> None:
     vm_delete.add_argument("--purge", action="store_true", help="Purge VM from all configurations")
     vm_delete.set_defaults(func=_vm_delete)
 
+    # --- snapshot ---
+    snap = vm_sub.add_parser("snapshot", help="Manage VM snapshots")
+    snap_sub = snap.add_subparsers(dest="snap_action", title="snapshot actions", required=True)
+
+    snap_list = snap_sub.add_parser("list", help="List snapshots")
+    snap_list.add_argument("vmid", type=vmid_type, help="VM ID")
+    snap_list.add_argument("--node", help="Node name (auto-detected if omitted)")
+    snap_list.set_defaults(func=_vm_snapshot_list)
+
+    snap_create = snap_sub.add_parser("create", help="Create a snapshot")
+    snap_create.add_argument("vmid", type=vmid_type, help="VM ID")
+    snap_create.add_argument("snapname", help="Snapshot name")
+    snap_create.add_argument("--node", help="Node name (auto-detected if omitted)")
+    snap_create.add_argument("--description", default=None, help="Snapshot description")
+    snap_create.add_argument("--vmstate", type=int, choices=[0, 1], default=0,
+                             help="Include RAM state (1=yes, 0=no, default: 0)")
+    snap_create.set_defaults(func=_vm_snapshot_create)
+
+    snap_show = snap_sub.add_parser("show", help="Show snapshot details")
+    snap_show.add_argument("vmid", type=vmid_type, help="VM ID")
+    snap_show.add_argument("snapname", help="Snapshot name")
+    snap_show.add_argument("--node", help="Node name (auto-detected if omitted)")
+    snap_show.set_defaults(func=_vm_snapshot_show)
+
+    snap_rollback = snap_sub.add_parser("rollback", help="Rollback to a snapshot")
+    snap_rollback.add_argument("vmid", type=vmid_type, help="VM ID")
+    snap_rollback.add_argument("snapname", help="Snapshot name")
+    snap_rollback.add_argument("--node", help="Node name (auto-detected if omitted)")
+    snap_rollback.add_argument("--start", type=int, choices=[0, 1], default=0,
+                               help="Start VM after rollback (1=yes, 0=no, default: 0)")
+    snap_rollback.set_defaults(func=_vm_snapshot_rollback)
+
+    snap_delete = snap_sub.add_parser("delete", help="Delete a snapshot")
+    snap_delete.add_argument("vmid", type=vmid_type, help="VM ID")
+    snap_delete.add_argument("snapname", help="Snapshot name")
+    snap_delete.add_argument("--node", help="Node name (auto-detected if omitted)")
+    snap_delete.add_argument("--force", type=int, choices=[0, 1], default=0,
+                             help="Force removal (1=yes, 0=no, default: 0)")
+    snap_delete.set_defaults(func=_vm_snapshot_delete)
+
+    # --- agent ---
+    agent = vm_sub.add_parser("agent", help="Query QEMU guest agent")
+    agent_sub = agent.add_subparsers(dest="agent_action", title="agent actions", required=True)
+
+    agent_ifaces = agent_sub.add_parser("interfaces", help="List network interfaces via guest agent")
+    agent_ifaces.add_argument("vmid", type=vmid_type, help="VM ID")
+    agent_ifaces.add_argument("--node", help="Node name (auto-detected if omitted)")
+    agent_ifaces.set_defaults(func=_vm_agent_interfaces)
+
     # --- firewall ---
     fw = vm_sub.add_parser("firewall", help="Manage VM firewall")
     fw_sub = fw.add_subparsers(dest="fw_resource", title="resources", required=True)
@@ -325,6 +374,98 @@ def _vm_delete(args: argparse.Namespace, client: ProxmoxClient) -> dict:
     return result if isinstance(result, dict) else {"data": result}
 
 
+# ---------------------------------------------------------------------------
+# VM guest agent handlers
+# ---------------------------------------------------------------------------
+
+def _vm_agent_interfaces(args: argparse.Namespace, client: ProxmoxClient) -> dict | list:
+    """Retrieve network interfaces via QEMU guest agent.
+
+    Requires qemu-guest-agent installed in the VM and agent enabled in VM options.
+    """
+    node = _resolve_node(client, args.node, args.vmid)
+    if not node:
+        return {"error": f"VM {args.vmid} not found"}
+    result = client.get(f"/nodes/{node}/qemu/{args.vmid}/agent/network-get-interfaces")
+    # The result is a list of interfaces, each with 'name', 'ip-addresses', etc.
+    if isinstance(result, list):
+        for iface in result:
+            if isinstance(iface, dict):
+                iface["_node"] = node
+                iface["_vmid"] = args.vmid
+    return result
+
+
+# ---------------------------------------------------------------------------
+# VM snapshot handlers
+# ---------------------------------------------------------------------------
+
+def _vm_snapshot_list(args: argparse.Namespace, client: ProxmoxClient) -> dict | list:
+    node = _resolve_node(client, args.node, args.vmid)
+    if not node:
+        return {"error": f"VM {args.vmid} not found"}
+    result = client.get(f"/nodes/{node}/qemu/{args.vmid}/snapshot")
+    # Add _node for consistency
+    if isinstance(result, list):
+        for snap in result:
+            if isinstance(snap, dict):
+                snap["_node"] = node
+                snap["_vmid"] = args.vmid
+    return result
+
+
+def _vm_snapshot_create(args: argparse.Namespace, client: ProxmoxClient) -> dict:
+    node = _resolve_node(client, args.node, args.vmid)
+    if not node:
+        return {"error": f"VM {args.vmid} not found"}
+    data: dict = {"snapname": args.snapname}
+    if args.description:
+        data["description"] = args.description
+    if args.vmstate:
+        data["vmstate"] = args.vmstate
+    result = client.post(f"/nodes/{node}/qemu/{args.vmid}/snapshot", data=data)
+    return result if isinstance(result, dict) else {"data": result}
+
+
+def _vm_snapshot_show(args: argparse.Namespace, client: ProxmoxClient) -> dict:
+    node = _resolve_node(client, args.node, args.vmid)
+    if not node:
+        return {"error": f"VM {args.vmid} not found"}
+    result = client.get(f"/nodes/{node}/qemu/{args.vmid}/snapshot/{args.snapname}")
+    if isinstance(result, dict):
+        result["_node"] = node
+        result["_vmid"] = args.vmid
+    return result
+
+
+def _vm_snapshot_rollback(args: argparse.Namespace, client: ProxmoxClient) -> dict:
+    node = _resolve_node(client, args.node, args.vmid)
+    if not node:
+        return {"error": f"VM {args.vmid} not found"}
+    data: dict = {}
+    if args.start:
+        data["start"] = args.start
+    result = client.post(
+        f"/nodes/{node}/qemu/{args.vmid}/snapshot/{args.snapname}/rollback",
+        data=data or None,
+    )
+    return result if isinstance(result, dict) else {"data": result}
+
+
+def _vm_snapshot_delete(args: argparse.Namespace, client: ProxmoxClient) -> dict:
+    node = _resolve_node(client, args.node, args.vmid)
+    if not node:
+        return {"error": f"VM {args.vmid} not found"}
+    params: dict = {}
+    if args.force:
+        params["force"] = args.force
+    result = client.delete(
+        f"/nodes/{node}/qemu/{args.vmid}/snapshot/{args.snapname}",
+        params=params or None,
+    )
+    return result if isinstance(result, dict) else {"data": result}
+
+
 # ---------------------------------------------------------------------------
 # VM firewall handlers
 # ---------------------------------------------------------------------------

{proxcli-0.8.0 → proxcli-0.8.2}/pyproject.toml

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

{proxcli-0.8.0 → proxcli-0.8.2}/uv.lock

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