b79498cb40
* Removes unecessary verbosity. I tried to wrap the `INFO` calls in a lua function to remove some of the `print()` statements, but it turns out Catch relies on the macros heavily, so that fails. |
||
---|---|---|
Catch@3b4edd7a48 | ||
docs | ||
examples | ||
Optional@45112c085a | ||
single/sol | ||
sol | ||
.gitignore | ||
.gitmodules | ||
.travis.yml | ||
bootstrap.py | ||
CONTRIBUTING.md | ||
install.deps.sh | ||
LICENSE.txt | ||
ninja_syntax.py | ||
README.md | ||
single.py | ||
sol.hpp | ||
test_coroutines.cpp | ||
test_customizations.cpp | ||
test_functions.cpp | ||
test_overflow.cpp | ||
test_simple_usertypes.cpp | ||
test_stack_guard.hpp | ||
test_strings.cpp | ||
test_tables.cpp | ||
test_usertypes.cpp | ||
tests.cpp |
Sol 2.10
Sol is a C++ library binding to Lua. It currently supports all Lua versions 5.1+ (LuaJIT 2.x included). Sol aims to be easy to use and easy to add to a project. The library is header-only for easy integration with projects.
Documentation
Find it here. A run-through kind of tutorial is here! The API documentation goes over most cases (particularly, the "api/usertype" and "api/proxy" and "api/function" sections) that should still get you off your feet and going, and there's an examples directory here as well.
Sneak Peek
#include <sol.hpp>
#include <cassert>
int main() {
sol::state lua;
int x = 0;
lua.set_function("beep", [&x]{ ++x; });
lua.script("beep()");
assert(x == 1);
}
#include <sol.hpp>
#include <cassert>
struct vars {
int boop = 0;
};
int main() {
sol::state lua;
lua.new_usertype<vars>("vars", "boop", &vars::boop);
lua.script("beep = vars.new()\n"
"beep.boop = 1");
assert(lua.get<vars>("beep").boop == 1);
}
More examples are given in the examples directory.
Creating a single header
You can grab a single header out of the library here. For stable version, check the releases tab on github for a provided single header file for maximum ease of use. A script called single.py
is provided in the repository if there's some bleeding edge change that hasn't been published on the releases page. You can run this script to create a single file version of the library so you can only include that part of it. Check single.py --help
for more info.
Features
- Fastest in the land (see: sol2 graph and table entries).
- Supports retrieval and setting of multiple types including
std::string
andstd::map/unordered_map
. - Lambda, function, and member function bindings are supported.
- Intermediate type for checking if a variable exists.
- Simple API that completely abstracts away the C stack API, including
protected_function
with the ability to use an error-handling function. operator[]
-style manipulation of tables- C++ type representations in lua userdata as
usertype
s with guaranteed cleanup. - Customization points to allow your C++ objects to be pushed and retrieved from Lua as multiple consecutive objects, or anything else you desire!
- Overloaded function calls:
my_function(1); my_function("Hello")
in the same lua script route to different function calls based on parameters - Support for tables, nested tables, table iteration with
table.for_each
/begin()
andend()
iterators.
Supported Compilers
Sol makes use of C++11/14 features. GCC 4.9 and Clang 3.4 (with std=c++1z and appropriate standard library) or higher should be able to compile without problems. However, the officially supported and CI-tested compilers are:
- GCC 4.9.0+
- Clang 3.5+
- Visual Studio 2015 Community (Visual C++ 14.0)+
License
Sol is distributed with an MIT License. You can see LICENSE.txt for more info.