inline-mod

Inline modules at macro expansion time!

Note

Initial declaration requires a path attribute relative to the project root because on stable it is impossible to get the path of the file where the macro is invoked.
Every nested module with a path attribute will also be treated relative to the project root, although that might change in a future update.
If a path attribute is not present on a nested non-inlined module, the macro will try to resolve it the same way the Rust compiler does - look for module_name.rs or module_name/mod.rs file relative to the current module.

Why?

Currently, even if you are on nighly and can use an attribute macro on a non-inlined module, you will not accomplish anything because the items get inlined after macro expansion. This macro inlines the module for you, so you can use macros on non-inlined (even nested) modules.

Example

// main.rs
use inline_mod::inline_mod;

inline_mod! {
	#[my_attr]
	#[path = "src/foo.rs"]
	mod foo;
}

// foo.rs
struct Bar(i32);

pub mod baz;

// foo/baz/mod.rs
pub struct Hi;

Will get expanded to

#[my_attr]
mod foo {
	struct Bar(i32);

	pub mod baz {
		pub struct Hi;
	}
}

All before my_attr gets executed.