2
[ ~/proxmox-sdk/releases/v0.0.5 ]tty0

emerson@netdevops:~/proxmox-sdk$ gh release view v0.0.5 --repo emersonfelipesp/proxmox-sdk

back to releases / back to project

v0.0.5 — Proxmox Datacenter Manager (PDM) support

[open on GitHub]
tag=v0.0.5state=stablepublished=2026-05-16synced=2026-05-21 07:21 UTC
author
emersonfelipesp
created
2026-05-16 21:43 UTC
target
main
downloads
0

emerson@netdevops:~/proxmox-sdk$ cat RELEASE_NOTES.md

Highlights

Full Proxmox Datacenter Manager (PDM) support delivered across four merged PRs (#51, #52, #53, #54). PDM joins PVE, PMG, and PBS as a first-class service in the SDK.

SDK — proxmox_sdk/pdm/

  • PDMClient (async) and SyncPDMClient composing the existing ProxmoxSDK transport on service="PDM", port 8443, with the PDMAuthCookie / PDMAPIToken auth flow.
  • Eight typed domain helpers: remotes, pve (qemu/lxc lifecycle, migrate, remote-migrate, nodes, RRD, tasks, resources), pbs (datastores, snapshots with namespace filter, tasks, RRD), resources (global), subscriptions, metrics, access (users/ACL/TFA/tokens), views.
  • Hand-coded Pydantic v2 models for every PDM API entity (extra="allow" so forward-compatible PDM additions don't break parsing).

CLI — proxmox pdm …

Typer subcommand tree mirroring every SDK operation: remote, pve.qemu/lxc/node, pbs.datastore/snapshot/node/tasks, resources, subscriptions, metrics, access.user/acl/tfa, views, tui. The bridge defaults to port 8443 when --service PDM is used.

TUI — proxmox pdm tui

Three-pane Textual app (remote tree • resource table + JSON detail • action panel) with ConfirmModal gating on destructive actions. Key bindings: r refresh, d dashboard, q quit.

Mock — proxmox-sdk-pdm-mock

Hand-coded FastAPI mock server mirroring every PDM SDK code path, plus /mock/{seed,export,import,reset} management endpoints for tests. Bundled realistic seed: 3 remotes (2 PVE + 1 PBS), 16 VMs, 5 CTs, 2 datastores, 3 snapshots, 3 users, 5 ACLs, 2 views. Configurable via PROXMOX_PDM_MOCK_HOST/PORT/SEED_FILE env vars.

Install

```bash
pip install proxmox-sdk==0.0.5

or with PDM extras (currently empty but reserved):

pip install 'proxmox-sdk[pdm]==0.0.5'
```

See issue #17 for the full implementation summary and per-phase breakdown.

emerson@netdevops:~/proxmox-sdk$ gh release download --pattern '*'

assets

no binary assets attached

source code