Powered by

snapdir revisions

List snapshot IDs created on a location (store or absolute path).

revisions prints the snapshot IDs the catalog has recorded for a given location — a store URI or an absolute path — newest history first. The default catalog is used when --catalog is unset. Pass --catalog none to disable catalog queries; the command prints a disabled message instead of silently returning an empty result. See the History guide.

Usage

snapdir revisions [OPTIONS]

Options

revisions takes no positional arguments.

Option Description
--catalog <NAME> Catalog adapter to use. Env: SNAPDIR_CATALOG; unset uses the default catalog, none disables the query.
--location <DIR\|STORE> Context (directory or store) for catalog queries.
--id <ID> Snapshot ID to operate on.
--store <URI> Store URI fallback for catalog locations. Env: SNAPDIR_STORE.
--cache-dir <DIR> Directory where the object cache and default catalog are stored. Env: SNAPDIR_CACHE_DIR.
-q, --quiet / --no-progress / --color <WHEN> / --verbose Universal output-control options.

Examples

List the revisions recorded on an absolute path:

snapdir revisions --location /srv/project

List the revisions recorded on a store:

snapdir revisions --location s3://my-bucket/snapshots

Disable catalog querying explicitly:

snapdir revisions --location s3://my-bucket/snapshots --catalog none

See also