# proxmox-sdk v0.0.5

v0.0.5 — Proxmox Datacenter Manager (PDM) support

| Field |Value |
| --- | --- |
| Canonical URL | https://emersonfelipesp.com/proxmox-sdk/releases/v0.0.5 |
| GitHub URL | https://github.com/emersonfelipesp/proxmox-sdk/releases/tag/v0.0.5 |
| Tag | v0.0.5 |
| State | stable |
| Author | emersonfelipesp |
| Created | 2026-05-16 21:43 UTC |
| Published | 2026-05-16 21:43 UTC |
| Target | main |
| Synced | 2026-05-21 07:21 UTC |
| Assets | 0 |

## Release notes

## 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.

## Assets

No binary assets attached.

Source archives:

| Format |URL |
| --- | --- |
| zip | https://api.github.com/repos/emersonfelipesp/proxmox-sdk/zipball/v0.0.5 |
| tar.gz | https://api.github.com/repos/emersonfelipesp/proxmox-sdk/tarball/v0.0.5 |