Expand description
Pull in every source file in a directory as a module and optionally re-export their contents.
§Syntax
automoduse::dir!("path/to/directory" pub use);This macro expands to one or more mod items, one for each source file in
specified directory, and its contents re-exported with pub use.
The path is given relative to the directory containing Cargo.toml.
It is an error if the given directory contains no source files.
The macro takes an optional visibility to apply on the generated modules:
automoduse::dir!(pub "path/to/directory" use).
§Example
Suppose that we would like to keep a directory of regression tests for individual numbered issues:
- tests/
- regression/
- issue1.rs
- issue2.rs
- …
- issue128.rs
- regression/
We would like to be able to toss files in this directory and have them automatically tested, without listing them in some explicit list of modules. Automoduse solves this by adding tests/regression.rs containing:
mod regression {
automoduse::dir!("tests/regression" pub use);
}The macro invocation expands to:
mod issue1;
pub use issue1::*;
mod issue2;
pub use issue2::*;
/* ... */
mod issue128;
pub use issue128::*;