Crate manifest_dir_macros

Manifest Dir Macros

This crate provides function-like macros to check or operate paths relative to CARGO_MANIFEST_DIR at compile time.

Examples

#[macro_use] extern crate manifest_dir_macros;

println!(path!("Cargo.toml"));
println!(path!("src/lib.rs"));
println!(path!("src", "lib.rs"));
println!(path!("src", "lib.rs", "/bin"));
println!(path!("/usr"));

println!(exist_path!("Cargo.toml"));
println!(directory_path!("src"));
println!(not_directory_path!("Cargo.toml"));
println!(file_path!("Cargo.toml"));

println!(relative_path!("Cargo.toml"));
println!(directory_relative_path!("src"));
println!(not_directory_relative_path!("Cargo.toml"));
println!(file_relative_path!("Cargo.toml"));

// The `tuple` feature let these macros support to input nested literal string tuples, which is useful when you want to use these macros inside a `macro_rule!` macro and concatenate with other literal strings.
// `$x:expr` matchers can be used in these macros thus.
#[cfg(feature = "tuple")]
{
    println!(path!(("foo",)));
    println!(path!(("foo", "bar")));
    println!(path!("a", ("foo", "bar")));
    println!(path!(("foo", "bar"), "a"));
    println!(path!(("foo", "bar"), ("a", "b")));
    println!(path!(("foo", "bar", ("a", "b")), ("c", "d")));
}

Macros

absolute_path	Allows input a absolute path. Checks and returns the absolute path.
directory_absolute_path	Allows input a absolute path. Checks whether it is a directory and returns the absolute path.
directory_path	Allows input an absolute path, or a relative path. If a relative path is input, it will be relative to the CARGO_MANIFEST_DIR (a directory where your Cargo.toml located). Returns an absolute path, and it must be an existing directory.
directory_relative_path	Allows input a relative path. It will be relative to the CARGO_MANIFEST_DIR (a directory where your Cargo.toml located). Returns an absolute path, and it must be a directory.
exist_absolute_path	Allows input a absolute path. Checks whether it exists and returns the absolute path.
exist_path	Allows input an absolute path, or a relative path. (multiple components are supported) If a relative path is input, it will be relative to the CARGO_MANIFEST_DIR (a directory where your Cargo.toml located). Returns an absolute path, and it must exist.
exist_relative_path	Allows input a relative path. It will be relative to the CARGO_MANIFEST_DIR (a directory where your Cargo.toml located). Returns an absolute path, and it must exist.
file_absolute_path	Allows input a absolute path. Checks whether it is a file and returns the absolute path.
file_path	Allows input an absolute path, or a relative path. If a relative path is input, it will be relative to the CARGO_MANIFEST_DIR (a directory where your Cargo.toml located). Returns an absolute path, and it must be an existing file.
file_relative_path	Allows input a relative path. It will be relative to the CARGO_MANIFEST_DIR (a directory where your Cargo.toml located). Returns an absolute path, and it must be a file.
not_directory_absolute_path	Allows input a absolute path. Checks whether it is not a directory and returns the absolute path.
not_directory_path	Allows input an absolute path, or a relative path. If a relative path is input, it will be relative to the CARGO_MANIFEST_DIR (a directory where your Cargo.toml located). Returns an absolute path, and it must not be an existing directory.
not_directory_relative_path	Allows input a relative path. It will be relative to the CARGO_MANIFEST_DIR (a directory where your Cargo.toml located). Returns an absolute path, and it must not be a directory.
path	Allows input an absolute path, or a relative path. If a relative path is input, it will be relative to the CARGO_MANIFEST_DIR (a directory where your Cargo.toml located). Returns an absolute path.
relative_path	Allows input a relative path. It will be relative to the CARGO_MANIFEST_DIR (a directory where your Cargo.toml located). Returns an absolute path.