Module model 

Typed models for kopia --json output (kopia 0.23).

These structs are modeled against the actual JSON kopia emits, captured by round-tripping a filesystem repository. Field names match kopia’s keys exactly via #[serde(rename_all = "camelCase")] (plus explicit renames where kopia diverges, e.g. uniqueIDHex). None of these use deny_unknown_fields: kopia adds fields across releases and we must tolerate them. Times are chrono::DateTime<Utc>.

Note on stdout vs stderr: kopia prints its progress (Snapshotting ..., Restored N files) to stderr and the machine-readable --json result to stdout. The client parses stdout only.

Structs

BlobRetention

Blob retention as reported by kopia repository status --json → blobRetention.

ClientOptions

Client identity options reported by kopia repository status.

ContentFormat

Content format block from kopia repository status.

DirEntry

One entry of a kopia directory manifest (kopia show <dir-object-id>).

DirManifest

A kopia directory manifest: what kopia show <dir-object-id> emits — {"stream":"kopia:directory","entries":[…]}. (kopia show on a file object streams the file’s raw bytes instead, so callers must check DirEntry::entry_type before showing an object as a directory.)

DirSummary

Directory summary embedded under a root entry (summ). Carries the aggregate counts kopia computed while walking the tree.

DirSummaryLite

The aggregate subtree counters under a directory entry’s summ block — the subset of DirSummary a directory listing renders. All optional: kopia may extend or omit counters across releases.

EntryError

One {path, error} entry from a snapshot’s rootEntry.summ.errors. Kopia records the source-relative path and the full error string for every entry it could not include.

EpochParameters

kopia’s epoch-manager parameters, as reported inside repository status --json → contentFormat.epochParameters.

IndexBlobEntry

One entry from kopia index list --json — a single content-index blob.

MaintenanceCadence

A maintenance cadence block (quick / full) from maintenance info.

MaintenanceInfo

Result of kopia maintenance info --json.

MaintenanceSchedule

The schedule block: when maintenance next runs. The detailed per-task runs history is left as a raw value (its shape is large and unstable).

RepositoryStatus

Result of kopia repository status --json.

RootEntry

The rootEntry of a snapshot — the top directory object plus its summary.

SnapshotCreateResult

Result of kopia snapshot create <path> --json.

SnapshotListEntry

One entry from kopia snapshot list --json.

SnapshotSource

Kopia’s snapshot identity triple: userName@host:path. Present on both snapshot-create results and snapshot-list entries.

SnapshotStats

The stats block present on each kopia snapshot list --json entry. These are the new/modified/unchanged-style counters.

StorageInfo

Storage backend block from kopia repository status. config is left as a raw JSON value because its shape is backend-specific (filesystem path vs S3 bucket/endpoint vs …).

Enums

SnapshotCreateOutcome

What a kopia snapshot create actually did.

Functions

user_tags

Strip kopia’s tag: manifest-key prefix from a snapshot tags map, yielding the tags under the keys the CLI was given (--tags key:value → manifest tag:key).