Porting to LDE

LDE now supports Luarocks packages. But the experience is ultimately not as great as fully native LDE packages, which you might prefer to avoid file copies and get better LuaCATs typing experience.

This guide will tell you how to port your projects to LDE.

File Structure

Move all of your files into a ./src/ directory at the top level of your project. At build time, this will be moved into ./target/<dependency name>/*.

Requires

Change your require pattern to be absolute, and include the name of your package.

For example, a project with ./src/foo/qux.lua named redestro, with an entrypoint at ./src/init.lua that requires that file would do so via require("redestro.foo.qux").

Native Modules

Create a build.lua file and use all the tools lua provides at your disposal to attempt to build your code into LDE_OUTPUT_DIR which will be placed inside of ./target/<dependency name>/*.

For example, this can be as simple as an os.execute("make") and then an os.rename of your output binary into the output directory.

For more info, read about C Module Support.

Publishing to LDE

Refer to the Publishing to LDE guide!