Crate conserve

source ·
Expand description

Conserve backup system.

Re-exports

Modules

  • “Apaths” (for archive paths) are platform-independent relative file paths used inside archive snapshots.
  • Archives holding backup material.
  • Make a backup by walking a source directory and copying the contents into an archive.
  • Bands are identified by a string like b0001, represented by a BandId object.
  • Block hash address type.
  • A change to an entry during backup, diff, restore, etc.
  • Data compression algorithms.
  • An entry representing a file, directory, etc, in either a stored tree or local tree.
  • Conserve error types.
  • Exclude files from operations based on globs, etc.
  • Index lists the files in a band in the archive.
  • An entry representing a file, directory, etc, in either a stored tree or local tree.
  • Access a “live” on-disk tree as a source for backups, destination for restores, etc.
  • A metrics recorder that just keeps atomic values in memory, so they can be logged or inspected at the end of the process, or potentially earlier.
  • Generally useful functions.
  • Stores the user and group as Strings in the archive. There is potentially a more efficient way to do this, but this approach works better than just saving the uid and gid, so that backups may potentially be restored on a different system.
  • Generic progress bar indications.
  • Restore from the archive to the filesystem.
  • Text output formats for structured data.
  • Count the number of tracing errors and warnings.
  • Filesystem abstraction to read and write local and remote archives.
  • Generic UI layer.
  • Discretionary Access Control permissions for archived files.
  • Times relative to the Unix epoch.

Structs

  • Each backup makes a new band containing an index directory.
  • A readable, writable directory within a band holding data blocks.
  • Zip together entries from two trees, into an iterator of [MatchedEntries].
  • Read index and file contents for a version stored in the archive.
  • The measured size of a tree.

Enums

Constants

Traits

  • Read a file as a series of blocks of bytes.
  • Abstract Tree that may be either on the real filesystem or stored in an archive.

Functions

  • Generate an iter of per-entry diffs between two trees.

Type Definitions