Search and filter in the guest table #29

2026-11-03T00:42:23+01:00

Duckboot commented

2026-11-03 00:42:23 +01:00

What

/ opens a filter box under the guest table, and the table filters as you type.

The filter is a list of space-separated terms. A guest is shown only if it matches every term, and case is ignored:

a plain term matches part of the name, the VMID or a tag
is:running / is:stopped match the status
type:lxc / type:ct and type:vm / type:qemu match the guest type

Enter keeps the filter and returns focus to the table. Escape clears the filter, both from the box and from the table. The frame shows "· filter: <text> · N of M". Actions only ever see the visible rows, and the filter survives reloads and context switches.

Review fixes

Crash on markup: typing [/b] or [/] crashed the app. The filter text went into the border subtitle, which Textual parses as markup. The subtitle is now plain text, so [red] is also shown literally.
Escape on the table: it now clears a filter that was applied with Enter.
Missing values: guest_matches no longer fails when the status or type is None.

Verification

491 tests pass, including a hypothesis property: an empty query matches everything, and adding a term never widens the result.
ruff check and ruff format --check report no issues.
betterleaks found no secrets.
Read-only live check on mainframe:

Filter Result

debian 104

type:vm 108

community-script is:running 14 of 19

is:stopped 0 of 19

This PR is stacked on #28 → #27.

Closes #16

Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com

## What `/` opens a filter box under the guest table, and the table filters as you type. The filter is a list of space-separated terms. A guest is shown only if it matches every term, and case is ignored: - a plain term matches part of the name, the VMID or a tag - `is:running` / `is:stopped` match the status - `type:lxc` / `type:ct` and `type:vm` / `type:qemu` match the guest type Enter keeps the filter and returns focus to the table. Escape clears the filter, both from the box and from the table. The frame shows "· filter: <text> · N of M". Actions only ever see the visible rows, and the filter survives reloads and context switches. ## Review fixes - **Crash on markup:** typing `[/b]` or `[/]` crashed the app. The filter text went into the border subtitle, which Textual parses as markup. The subtitle is now plain text, so `[red]` is also shown literally. - **Escape on the table:** it now clears a filter that was applied with Enter. - **Missing values:** `guest_matches` no longer fails when the status or type is `None`. ## Verification - 491 tests pass, including a hypothesis property: an empty query matches everything, and adding a term never widens the result. - `ruff check` and `ruff format --check` report no issues. - `betterleaks` found no secrets. - Read-only live check on mainframe: | Filter | Result | |---|---| | `debian` | 104 | | `type:vm` | 108 | | `community-script is:running` | 14 of 19 | | `is:stopped` | 0 of 19 | This PR is stacked on #28 → #27. Closes #16 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Duckboot added 3 commits 2026-11-03 00:42:23 +01:00

Warn on an untested cv4pve-cli version at startup

CI / pytest and ruff (pull_request) Successful in 4m42s

Details

CI / pytest and ruff (push) Has been cancelled

Details

e7569a7bf7

At startup the app runs `cv4pve-cli --version`. If it differs from
cli.TESTED_VERSION (2.4.0), a warning says which version was found
and which one was tested. The app parses output formats that are not
a stable API: the config list text, prune-backups as a JSON string,
the CT ip-addresses JSON string and the exit codes with --wait. A
newer cv4pve-cli could break them in confusing ways.

If cv4pve-cli cannot be run at all, an error says so once, instead of
every later call failing without explanation. The README notes the
tested version.

Closes #14

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Document installing cv4pve-tui as a uv tool

CI / pytest and ruff (pull_request) Successful in 4m40s

Details

CI / pytest and ruff (push) Has been cancelled

Details

ff6345c80f

The README gets an "Install" section: install with uv tool from the
Gitea repo or from a local checkout, then upgrade and uninstall. The
"Run" section says to use `cv4pve-tui` when installed and
`uv run cv4pve-tui` from a checkout.

Verified by installing into throwaway tool dirs (UV_TOOL_DIR and
UV_TOOL_BIN_DIR under /tmp): `uv tool install .` gave a cv4pve-tui
binary. Started from /tmp in a pseudo-terminal, it drew the guest
frame and ran until it was stopped. The pyproject metadata (entry
point, readme, requires-python) was already enough.

Closes #17

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Add search and filter to the guest table

CI / pytest and ruff (pull_request) Successful in 4m48s

Details

CI / pytest and ruff (push) Has been cancelled

Details

d97ad22c78

/ opens a filter box under the guest table, and the table filters as
you type. Terms are separated by spaces, all must match, and case is
ignored:

- a plain term matches part of the name, the VMID or a tag
- is:running and is:stopped match the status
- type:lxc/ct and type:vm/qemu match the guest type

Enter keeps the filter and goes back to the table. Escape clears it,
from the box or from the table. The frame shows
"· filter: <text> · N of M". Actions only ever see the visible rows,
and the filter survives reloads and context switches.

Review fixes:
- Typing "[/b]" or "[/]" crashed the app, because the filter text went
  into the border subtitle, which Textual parses as markup. The
  subtitle is now plain text, so "[red]" is also shown literally.
- Escape on the table now clears a filter that was applied with Enter.
- guest_matches tolerates a None status or type.

Read-only live check on mainframe: "debian" gives 104, "type:vm" gives
108, "community-script is:running" gives 14 of 19, and "is:stopped"
gives 0 of 19.

Closes #16

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Duckboot referenced this pull request

2026-11-03 00:55:11 +01:00

Edit autostart, startup order and tags #30

Duckboot referenced this pull request

2026-11-03 01:08:40 +01:00

Run fstrim in a VM via the guest agent #31

Duckboot referenced this pull request

2026-11-03 01:32:17 +01:00

Restore a guest from a backup in the backup list #32

Duckboot merged commit d97ad22c78 into main

2026-11-03 01:33:06 +01:00

Sign in to join this conversation.