repo_path

Access paths in your repository, with compile-time checks.
This is useful in particular when you're writing your CI code in Rust, e.g. via the cargo-xtask pattern.

use repo_path::repo_path;

let readme = repo_path!("README.md");
let ui_tests = repo_path!("tests/ui/");
let repo_root = repo_path!(); //equivalent to repo_path!(".")

The macro checks whether the path exists and constructs a PathBuf containing an absolute path. If the path does not exist, the compiler will error during compilation:

use repo_path::repo_path;

let non_existent = repo_path!("non/existent/path.txt");

This allows you to move files around without having to worry that a reference silently breaks, similar to the way std::include_str!() works.

How it works

During compilation, the macro looks for the .git directory to determine the root of your repository.
Then it joins the path you specified to the root and checks if the resulting path exists.

The path of your repository root is cached during compilation, so that you can use repo_path!() many times without a significant compile-time burden.

Usage in a library

Because the macro fetches the path during compilation, you cannot use it in libraries that want to access your user's repository (it will return paths for your own repository).
For that purpose, use the repo_path_lib crate instead.

Changelog

See the changelog here: https://codeberg.org/trem/repo_path/src/branch/main/CHANGELOG.md