#directory #module #source-file #automatic #pull #macro #testing

macro no-std automod

Pull in every source file in a directory as a module

21 releases (stable)

1.0.14 Jan 2, 2024
1.0.13 Oct 19, 2023
1.0.12 Jul 21, 2023
1.0.8 Mar 18, 2023
0.1.1 Feb 28, 2019

#141 in Filesystem

Download history 18333/week @ 2024-07-21 18190/week @ 2024-07-28 18019/week @ 2024-08-04 18929/week @ 2024-08-11 22620/week @ 2024-08-18 21910/week @ 2024-08-25 23965/week @ 2024-09-01 22607/week @ 2024-09-08 18944/week @ 2024-09-15 21079/week @ 2024-09-22 18677/week @ 2024-09-29 21274/week @ 2024-10-06 23246/week @ 2024-10-13 20640/week @ 2024-10-20 20022/week @ 2024-10-27 18127/week @ 2024-11-03

83,888 downloads per month
Used in 159 crates (41 directly)

MIT/Apache

10KB
120 lines

Automod

github crates.io docs.rs build status

Pull in every source file in a directory as a module.

[dependencies]
automod = "1.0"

Syntax

automod::dir!("path/to/directory");

This macro expands to one or more mod items, one for each source file in the specified directory.

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: automod::dir!(pub "path/to/directory").

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

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. Automod solves this by adding tests/regression.rs containing:

mod regression {
    automod::dir!("tests/regression");
}

The macro invocation expands to:

mod issue1;
mod issue2;
/* ... */
mod issue128;

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~255–710KB
~17K SLoC