2 releases
0.1.2 | Mar 5, 2024 |
---|---|
0.1.1 | Mar 2, 2024 |
0.1.0 |
|
#23 in #file-exists
31 downloads per month
6KB
include_file_path
macro library
This Rust project provides a procedural macro include_file_path!
that returns the absolute path of a file or directory. The macro accepts both relative and absolute paths, and it will panic if the specified file does not exist.
Usage
Add the following to your Cargo.toml
:
[dependencies]
include_file_path = { path = "0.1" }
Then, in your Rust code, you can use the include_file_path! macro as follows:
const FILE: &'static str = include_file_path!("src/main.rs");
This will set FILE
to the absolute path of the src/main.rs
file relative to the file where the macro is called.
How It Works
The include_file_path!
macro works by parsing the input path and checking if it's absolute. If it is, it returns the path as is. If it's not, it concatenates the path with the directory of the file where the macro is called to get the absolute path.
The macro uses the proc_macro::Span::call_site().source_file().path()
function to get the path of the file where the macro is called. Currently this function is available as of this writing only on nightly via proc_macro_span
feature
Before returning the path, the macro checks if the file exists. If the file does not exist, it panics with a message indicating the file does not exist.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Dependencies
~300–760KB
~18K SLoC