include-lua is a crate that allows the embedding of a lua source tree into a Rust application binary. This tree can then be loaded into an rlua context, and code imported from it via require.

First, create an instance of the LuaModules struct via the macro include_lua!. This macro takes a string literal parameter specifying a directory, relative to your crate's src folder. All .lua files in this directory and its subdirectories will be included as loadable modules.

It is possible to specify a name to use for the LuaModules struct, though at the moment this will only appear in lua stacktraces. Simply invoke the macro like include_lua!("name": "path"), instead of just include_lua!("path").

Once you've created a LuaModules struct, you can import it into an rlua::Context by calling ctx.add_modules(modules). This is an extension method provided by a trait, so make sure you have a use include_lua::*; statement in your code. Once it has been called, any calls to require executed in that context will be able to load modules from the embedded source tree.

If you would like to load the modules in a custom environment for some reason, call ctx.add_modules_with_env(modules, env), where env is a table that will be used as the _ENV value of all modules within the source tree.

See example/main.rs for a working example of the macro's use.

Currently, this crate does not support paths that contain non-unicode characters. Any files along these paths will be omitted from an include_lua! call.