lua-sys
| Crates.io | lua-sys |
| lib.rs | lua-sys |
| version | 0.2.0 |
| source | src |
| created_at | 2017-02-16 15:20:48.896693 |
| updated_at | 2019-10-31 01:52:26.922068 |
| description | Raw Lua 5.3 bindings for Rust, used by Pollua |
| homepage | |
| repository | https://github.com/MisterPeModder/Pollua |
| max_upload_size | |
| id | 8543 |
| size | 768,059 |
Yanis Guaye (MisterPeModder)
documentation
README
Lua-sys
Lua 5.x bindings for the Rust programming language.
Release Support
The current supported releases of Lua are 5.1, 5.2 and 5.3. Lua 5.0 support upcoming.
Usage
Add this to your Cargo.toml:
[dependencies]
lua-sys = "^0.2.0"
Crate Features
- std: Uses stdlib.
- va-list: Defines bindings for functions that have
va-listin their arguments, a dependency on the va_list crate. - embedded-lua: Links againsts the embedded Lua library.
- system-lua: Attempts to link against the system Lua library.
conflicts with
embedded-lua - lua-compat: Enables compatibilty for Lua versions 5.1 and 5.2.
Features std, embedded-lua and va-list are enabled by default.
When feature system-lua is enabled, lua-sys will search for the Lua library using pkg-config on Unix and vcpkg on Windows.
Lua Configuration
Properties of the Lua library can be changed by defining the following environment variables: LUA_CONF_PREFIX
LUA_32BITSEnables Lua with 32-bit integers and 32-bit floats.LUA_C89_NUMBERSEnsures that Lua uses the largest types available for C89.LUA_USE_C89Controls the use of non-ISO-C89 features.LUA_NOCVTN2SDefine to turn off automatic coercion from numbers to strings.LUA_NOCVTS2NDefine LUA_NOCVTS2N to turn off automatic coercion from strings to numbers.LUA_INT_TYPE="LUA_INT_INT" | "LUA_INT_LONG" | "LUA_INT_LONGLONG"Defines the type for Lua integers.LUA_FLOAT_TYPE="LUA_FLOAT_FLOAT" | "LUA_FLOAT_DOUBLE" | "LUA_FLOAT_LONGDOUBLE"Defines the type for Lua floats.LUA_VERSION="<major>.<minor>.<patch>"Sets the system Lua version, defaults to"5.3.5".
Example:
$ export LUA_32BITS=1
$ export LUA_INT_TYPE="LUA_INT_INT"
$ export LUA_VERSION="5.2.0"
$ cargo build --no-default-features --features "system-lua va-list"
The LUA_CONF_PREFIX variable can be used to change the name of the above variable:
$ LUA_CONF_PREFIX="MY_CONF_" MY_CONF_LUA_USE_C89=1 cargo build
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.