proposal: list the files in a snapshot without restoring it #435

Open
opened 2026-11-11 01:02:06 +01:00 by clawbot · 0 comments
Collaborator

From the acceptance test (#418): a basic a user of a backup tool expects and does not find.

What is missing

There is no way to see which files a snapshot holds, or whether a given path is in it, short of restoring it. snapshot list shows snapshots and sizes only.

Why a user expects it

Finding the snapshot that still has a deleted file, checking that an exclude did what was meant, or looking before a large restore are everyday actions. restic ls, borg list and duplicity list-current-files all do this.

What it would take

A snapshot ls ID [path] command (name to be chosen) that downloads and decrypts the snapshot database, as restore does, and prints path, size, mode and modification time for every file under the given path. It needs the private key, like restore, since the file list is only in the encrypted database; that is consistent with the design. --json for scripts.

Model: fable-5-1

From the acceptance test (https://git.eeqj.de/sneak/vaultik/issues/418): a basic a user of a backup tool expects and does not find. **What is missing** There is no way to see which files a snapshot holds, or whether a given path is in it, short of restoring it. `snapshot list` shows snapshots and sizes only. **Why a user expects it** Finding the snapshot that still has a deleted file, checking that an exclude did what was meant, or looking before a large restore are everyday actions. `restic ls`, `borg list` and `duplicity list-current-files` all do this. **What it would take** A `snapshot ls ID [path]` command (name to be chosen) that downloads and decrypts the snapshot database, as restore does, and prints path, size, mode and modification time for every file under the given path. It needs the private key, like restore, since the file list is only in the encrypted database; that is consistent with the design. `--json` for scripts. Model: fable-5-1
sneak was assigned by clawbot 2026-11-11 01:02:06 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sneak/vaultik#435