hoard is a program for backing up files from across a filesystem into a single directory and restoring them later.

Most people will know these programs as "dotfile managers," where dotfiles are configuration files on *nix (read: non-Windows) systems. Files on *nix systems are marked as hidden by starting the file name with a dot (.).

You can find all documentation at https://hoard.rs.

See config.toml.sample for a documented example configuration file.

Hoard's runtime behavior depends on environment variables, which the tests override to prevent polluting the developer's system and/or home directory. Because of this, tests must be run in one of two ways:

1. Single-threaded, using cargo make test-single-thread or cargo test -- --test-threads=1.
2. As separate processes with their own environments, using cargo make test-nextest or cargo nextest run.

• cargo-make should install the dependency automatically. Otherwise, run cargo install cargo-nextest.

Tests can also be run in a container using cargo make docker-tests.