LuaSingleUnity

LuaSingleUnity is a implementation of lua that provides Lua in a single file format for easy integration into projects. It offers two main variants of implementation files along with a header file.

Releases

Item	Description
lua_single_unity.h	Header file
lua_single_unity_classic_onelua.c	single Unity definitions
lua_single_unity_custom_onelua.c	exactly the same as the classic, but with some macro renamings on onelua.c

Macros

Flag	Description
LUA_SINGLE_UNITY_GUESS_OS	guess the os, if defined, it will use the default os check guess_os.h
LUA_SINGLE_UNITY_EMBED_MODE	use these if you want to embed lua into your C code, otherwise will raise redefinition of main
LUA_SINGLE_UNITY_IMPLEMENT_MATH	(implements math.h) use these if you dont have the -lm available on your os
LUA_SINGLE_UNITY_IMPLEMENT_LUAC	use these if you want to compile the luac (lua bytecode generator)
LUA_SINGLE_UNITY_MAKE_LUA	(its default if LUA_SINGLE_UNITY_EMBED_MODE and LUA_SINGLE_UNITY_IMPLEMENT_LUAC are not defined) use these if you want to compile the lua runtime
LUA_SINGLE_UNITY_CLASSIC_ONE_LUA_COMPATIBILITY	it is only useful on lua_single_unity_custom_onelua.c, with these flag will emulate the classic onelua.c

Key Differences

• lua_single_unity_classic_onelua.c and lua_single_unity_custom_onelua.c are essentially identical, with the latter renaming certain macros for compatibility:
  • MAKE_LIB to LUA_SINGLE_UNITY_EMBED_MODE
  • MAKE_LUAC to LUA_SINGLE_UNITY_IMPLEMENT_LUAC
  • MAKE_LUA to LUA_SINGLE_UNITY_MAKE_LUA

Embedding Lua

Single Compilation

For embedding Lua in single compilation, use:

#define LUA_SINGLE_UNITY_EMBED_MODE
#define LUA_SINGLE_UNITY_GUESS_OS
#include "lua_single_unity_classic_onelua.c"
int main() {

    lua_State *L = luaL_newstate();
    const char *expr = "return 3 +3 + 5"; 
    if (luaL_dostring(L, expr) == LUA_OK) {
        if (lua_isnumber(L, -1)) { 
            double result = lua_tonumber(L, -1);
            printf("result: %f\n", result);
        }
    } else {
        printf("Error: %s\n", lua_tostring(L, -1)); 
    }
    lua_close(L); 
    return 0;
}

Multi Compilation

For multi-compilation embedding:

#include "lua_single_unity.h"
int main() {
    // Your Lua code here
}

Compile with:

cc -c lua_single_unity_classic_onelua.c -DLUA_SINGLE_UNITY_GUESS_OS -DLUA_SINGLE_UNITY_EMBED_MODE
cc test.c lua_single_unity_classic_onelua.o -lm

Loading Native Libraries

Native libraries are included in the amalgamation. Load them using:

luaL_openlibs(L);

Note: This function can be dangerous if used in low-security contexts.

Compiling Lua Runtime

To compile the Lua runtime:

cc lua_single_unity_classic_onelua.c -DLUA_SINGLE_UNITY_GUESS_OS -lm -o lua_runtime

Compiling Lua Bytecode Compiler (luac)

To compile luac:

cc lua_single_unity_classic_onelua.c -DLUA_SINGLE_UNITY_GUESS_OS -DLUA_SINGLE_UNITY_IMPLEMENT_LUAC -lm -o luac

Generate bytecode:

./luac -o test.luac test.lua

Run bytecode:

./lua_runtime test.luac

Building from Scratch

Tools Required:

• tar
• Darwin v0.2.1

Default Build

darwin run_blueprint darwinconf.lua --version 5.4.7

Custom Build

darwin run_blueprint darwinconf.lua --source https://www.lua.org/ftp/lua-5.4.7.tar.gz --onelua https://raw.githubusercontent.com/lua/lua/refs/heads/master/onelua.c

Offline Build

Place a lua directory with onelua.c in the repo directory, then:

darwin run_blueprint darwinconf.lua

Licenses and Attributions

Lua and lua Github

Lua is free software distributed under the terms of the MIT license reproduced here. Lua may be used for any purpose, including commercial purposes, at absolutely no cost. No paperwork, no royalties, no GNU-like "copyleft" restrictions, either. Just download it and use it.

Lua is certified Open Source software. [Open Source Initiative Approved License]Its license is simple and liberal and is compatible with GPL. Lua is not in the public domain and PUC-Rio keeps its copyright.

The spirit of the Lua license is that you are free to use Lua for any purpose at no cost without having to ask us. The only requirement is that if you do use Lua, then you should give us credit by including the copyright notice somewhere in your product or its documentation. A nice, but optional, way to give us further credit is to include a Lua logo and a link to our site in a web page for your product.

The Lua language is entirely designed, implemented, and maintained by a team at PUC-Rio in Brazil. The implementation is not derived from licensed software.

Darwin

MIT License

Copyright (c) 2024 OUI

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.