v0.12.1

What's Changed

• Lua 5.5 updated to 5.5.1
• Luau updated to 0.736
• Allow #[mlua::userdata_impl] to be used in a different module from #[derive(UserData)] (#726)
• Fix coroutine stack handling after yielding from hooks (#723)

Full Changelog: v0.12.0...v0.12.1

v0.12.0

Highlights

More ergonomic UserData building blocks

• Declaratively implement UserData with #[derive(UserData)] and register methods/fields with the new #[mlua::userdata_impl] attribute macro.
• UserDataOwned<T> wrapper takes ownership of userdata and implements FromLua
• UserDataMethods::add_method_once/add_async_method_once
• __todebugstring metamethod for pretty-printing userdata when debugging
• MaybeSync trait for userdata under the send feature

Reorganized public API

Types are now grouped into focused modules: chunk, debug, error, function, table, string, state, thread, userdata and luau.

Thread lifecycle callbacks

Hook into coroutine create/resume/yield events across all Lua versions (when using mlua API).

Luau improvements

Latest Luau with extended require-by-string support and JIT options.

Garbage-collector interface refactor

Lua::gc_inc / Lua::gc_gen are replaced by a Lua::gc_set_mode, with GcIncParams/GcGenParams for fine-grained tuning.

What's Changed (since v0.12.0-rc.2)

• Crate root re-exports are refactored (only essentials are re-exported, the rest is in the new submodules)
• Added ThreadStatus::Normal and Thread::is_normal (mimic coroutine.status)
• Added Lua::set_jit_options with support of Luau JIT inliner (Luau)
• Added Value::as_vector/Value::is_vector (Luau)
• Added Table::remove
• serde: tables with the array metatable are always encoded as arrays (incl. detect_mixed_tables option)
• impl Hash for BorrowedStr/BorrowedBytes
• Lua::current_thread resolves implicit async threads to their root owner (#706)
• Bugfixes and improvements

Full Changelog: v0.11.6...v0.12.0

v0.12.0-rc.2

The new stable version is almost ready and will be released after some testing

What's Changed

• Add #[derive(UserData)] and #[userdata_impl] macros
• Support thread create/resume/yield callbacks for all Lua versions (including Luau)
• Support to_alias_override/to_alias_fallback in Require trait (Luau)
• Prevent XRc overflow when dropping RawLua with foreign Lua state
• Implement Not for StdLib (#699)
• Fix String::to_pointer return NULL in Lua <5.4

Full Changelog: v0.12.0-rc.1...v0.12.0-rc.2

v0.12.0-rc.1

What's Changed

• Switch to Rust 2024 edition
• Removed Error::ToLuaConversionError variant as it was unused (and not practically useful)
• New modules to group data types: chunk, debug, error, function, table, string, state, thread, userdata, luau
• Support __todebugstring metamethod for pretty formatting userdata value (for debugging)
• New MaybeSync trait that is required for userdata types
• Removed lifetime from BorrowedStr and BorrowedBytes
• New Thread methods: is_resumable, is_running, is_finished, is_error
• Added Thread::state to get raw Lua state pointer
• Luau TextRequirer is renamed to FsRequirer
• GC interface refactor: Lua::gc_inc/Lua::gc_gen is replaced with gc_set_mode
• Added GcIncParams and GcGenParams for GC tuning
• New UserDataMethods::add_method_once and UserDataMethods::add_async_method_once
• Initial Luau integer64 type support
• Changed interface of Function::wrap/wrap_mut/wrap_async to support any Error type
• Changed AnyUserData::type_name to return LuaString instead
• Added UserDataOwned<T> wrapper to take ownership of userdata T and implements FromLua

Full Changelog: v0.11.6...v0.12.0-rc.1

v0.11.6

What's Changed

• Lua 5.5 support under the new lua55 feature flag
• Luau updated to 0.705+
• Added AnyUserData::is_proxy
• Added num_params, num_upvalues, is_vararg to FunctionInfo

Full Changelog: v0.11.5...v0.11.6

Lua 5.5 notes

Lua 5.5 support external strings and mlua enable this optimisation for impl IntoLua for String/BString (owned versions to move Drop into Lua).
Also the Lua::create_external_string function allow moving ownership to Lua for any Into<Vec<u8>> types.

v0.11.5

What's Changed

• Luau updated to 0.701
• Added Lua::set_memory_category and Lua::heap_dump functions to profile (Luau) memory
• Added Lua::type_metatable helper to get metatable of a primitive type
• Added Lua::traceback function to generate stack traces at different levels
• Added add_method_once /add_async_method_once UserData methods (experimental)
• Make AnyUserData::type_name public
• impl IntoLuaMulti for &MultiValue

Full Changelog: v0.11.4...v0.11.5

v0.11.4

What's Changed

• Make Value::to_serializable public
• Added new serde option detect_mixed_tables (to encode mixed array+map tables)
• Added ObjectLike::get_path helper (for tables and userdata) for easy access of nested data
• Added (experimental) __namecall optimization for Luau

Full Changelog: v0.11.3...v0.11.4

v0.11.3

What's Changed

• Added Lua::yield_with to use as coroutine.yield functional replacement in async functions for any Lua (see doc examples)
• Do not try to yield at non-yielable points in Luau interrupt (#632)
• Added Buffer::cursor method (Luau)
• Added Lua::create_buffer_with_capacity method (Luau)
• Make Lua reference values cheap to clone in Rust (only increments ref count)
• Fix panic on large (>67M entries) table creation

Full Changelog: v0.11.2...v0.11.3

v0.11.2

What's Changed

• Faster stack push for Variadic<T>
• Fix handling Windows paths with drive letter in Luau require (#623) by @piz-ewing
• Make Luau registered aliases ascii case-insensitive (#620)
• Fix deserializing negative zeros -0.0 (#618)

Full Changelog: v0.11.1...v0.11.2

v0.11.1

What's Changed

• Fixed bug exhausting Lua auxiliary stack and leaving it without reserve (#615)
• Lua::push_c_function now correctly handles OOM for Lua 5.1 and Luau

Full Changelog: v0.11.0...v0.11.1

v0.12.1

What's Changed

• Lua 5.5 updated to 5.5.1
• Luau updated to 0.736
• Allow #[mlua::userdata_impl] to be used in a different module from #[derive(UserData)] (#726)
• Fix coroutine stack handling after yielding from hooks (#723)

Full Changelog: v0.12.0...v0.12.1

v0.12.0

Highlights

More ergonomic UserData building blocks

• Declaratively implement UserData with #[derive(UserData)] and register methods/fields with the new #[mlua::userdata_impl] attribute macro.
• UserDataOwned<T> wrapper takes ownership of userdata and implements FromLua
• UserDataMethods::add_method_once/add_async_method_once
• __todebugstring metamethod for pretty-printing userdata when debugging
• MaybeSync trait for userdata under the send feature

Reorganized public API

Types are now grouped into focused modules: chunk, debug, error, function, table, string, state, thread, userdata and luau.

Thread lifecycle callbacks

Hook into coroutine create/resume/yield events across all Lua versions (when using mlua API).

Luau improvements

Latest Luau with extended require-by-string support and JIT options.

Garbage-collector interface refactor

Lua::gc_inc / Lua::gc_gen are replaced by a Lua::gc_set_mode, with GcIncParams/GcGenParams for fine-grained tuning.

What's Changed (since v0.12.0-rc.2)

• Crate root re-exports are refactored (only essentials are re-exported, the rest is in the new submodules)
• Added ThreadStatus::Normal and Thread::is_normal (mimic coroutine.status)
• Added Lua::set_jit_options with support of Luau JIT inliner (Luau)
• Added Value::as_vector/Value::is_vector (Luau)
• Added Table::remove
• serde: tables with the array metatable are always encoded as arrays (incl. detect_mixed_tables option)
• impl Hash for BorrowedStr/BorrowedBytes
• Lua::current_thread resolves implicit async threads to their root owner (#706)
• Bugfixes and improvements

Full Changelog: v0.11.6...v0.12.0

v0.12.0-rc.2

The new stable version is almost ready and will be released after some testing

What's Changed

• Add #[derive(UserData)] and #[userdata_impl] macros
• Support thread create/resume/yield callbacks for all Lua versions (including Luau)
• Support to_alias_override/to_alias_fallback in Require trait (Luau)
• Prevent XRc overflow when dropping RawLua with foreign Lua state
• Implement Not for StdLib (#699)
• Fix String::to_pointer return NULL in Lua <5.4

Full Changelog: v0.12.0-rc.1...v0.12.0-rc.2

v0.12.0-rc.1

What's Changed

• Switch to Rust 2024 edition
• Removed Error::ToLuaConversionError variant as it was unused (and not practically useful)
• New modules to group data types: chunk, debug, error, function, table, string, state, thread, userdata, luau
• Support __todebugstring metamethod for pretty formatting userdata value (for debugging)
• New MaybeSync trait that is required for userdata types
• Removed lifetime from BorrowedStr and BorrowedBytes
• New Thread methods: is_resumable, is_running, is_finished, is_error
• Added Thread::state to get raw Lua state pointer
• Luau TextRequirer is renamed to FsRequirer
• GC interface refactor: Lua::gc_inc/Lua::gc_gen is replaced with gc_set_mode
• Added GcIncParams and GcGenParams for GC tuning
• New UserDataMethods::add_method_once and UserDataMethods::add_async_method_once
• Initial Luau integer64 type support
• Changed interface of Function::wrap/wrap_mut/wrap_async to support any Error type
• Changed AnyUserData::type_name to return LuaString instead
• Added UserDataOwned<T> wrapper to take ownership of userdata T and implements FromLua

Full Changelog: v0.11.6...v0.12.0-rc.1

v0.11.6

What's Changed

• Lua 5.5 support under the new lua55 feature flag
• Luau updated to 0.705+
• Added AnyUserData::is_proxy
• Added num_params, num_upvalues, is_vararg to FunctionInfo

Full Changelog: v0.11.5...v0.11.6

Lua 5.5 notes

Lua 5.5 support external strings and mlua enable this optimisation for impl IntoLua for String/BString (owned versions to move Drop into Lua).
Also the Lua::create_external_string function allow moving ownership to Lua for any Into<Vec<u8>> types.

v0.11.5

What's Changed

• Luau updated to 0.701
• Added Lua::set_memory_category and Lua::heap_dump functions to profile (Luau) memory
• Added Lua::type_metatable helper to get metatable of a primitive type
• Added Lua::traceback function to generate stack traces at different levels
• Added add_method_once /add_async_method_once UserData methods (experimental)
• Make AnyUserData::type_name public
• impl IntoLuaMulti for &MultiValue

Full Changelog: v0.11.4...v0.11.5

v0.11.4

What's Changed

• Make Value::to_serializable public
• Added new serde option detect_mixed_tables (to encode mixed array+map tables)
• Added ObjectLike::get_path helper (for tables and userdata) for easy access of nested data
• Added (experimental) __namecall optimization for Luau

Full Changelog: v0.11.3...v0.11.4

v0.11.3

What's Changed

• Added Lua::yield_with to use as coroutine.yield functional replacement in async functions for any Lua (see doc examples)
• Do not try to yield at non-yielable points in Luau interrupt (#632)
• Added Buffer::cursor method (Luau)
• Added Lua::create_buffer_with_capacity method (Luau)
• Make Lua reference values cheap to clone in Rust (only increments ref count)
• Fix panic on large (>67M entries) table creation

Full Changelog: v0.11.2...v0.11.3

v0.11.2

What's Changed

• Faster stack push for Variadic<T>
• Fix handling Windows paths with drive letter in Luau require (#623) by @piz-ewing
• Make Luau registered aliases ascii case-insensitive (#620)
• Fix deserializing negative zeros -0.0 (#618)

Full Changelog: v0.11.1...v0.11.2

v0.11.1

What's Changed

• Fixed bug exhausting Lua auxiliary stack and leaving it without reserve (#615)
• Lua::push_c_function now correctly handles OOM for Lua 5.1 and Luau

Full Changelog: v0.11.0...v0.11.1

v0.12.1

What's Changed

• Lua 5.5 updated to 5.5.1
• Luau updated to 0.736
• Allow #[mlua::userdata_impl] to be used in a different module from #[derive(UserData)] (#726)
• Fix coroutine stack handling after yielding from hooks (#723)

Full Changelog: v0.12.0...v0.12.1

v0.12.0

Highlights

More ergonomic UserData building blocks

• Declaratively implement UserData with #[derive(UserData)] and register methods/fields with the new #[mlua::userdata_impl] attribute macro.
• UserDataOwned<T> wrapper takes ownership of userdata and implements FromLua
• UserDataMethods::add_method_once/add_async_method_once
• __todebugstring metamethod for pretty-printing userdata when debugging
• MaybeSync trait for userdata under the send feature

Reorganized public API

Types are now grouped into focused modules: chunk, debug, error, function, table, string, state, thread, userdata and luau.

Thread lifecycle callbacks

Hook into coroutine create/resume/yield events across all Lua versions (when using mlua API).

Luau improvements

Latest Luau with extended require-by-string support and JIT options.

Garbage-collector interface refactor

Lua::gc_inc / Lua::gc_gen are replaced by a Lua::gc_set_mode, with GcIncParams/GcGenParams for fine-grained tuning.

What's Changed (since v0.12.0-rc.2)

• Crate root re-exports are refactored (only essentials are re-exported, the rest is in the new submodules)
• Added ThreadStatus::Normal and Thread::is_normal (mimic coroutine.status)
• Added Lua::set_jit_options with support of Luau JIT inliner (Luau)
• Added Value::as_vector/Value::is_vector (Luau)
• Added Table::remove
• serde: tables with the array metatable are always encoded as arrays (incl. detect_mixed_tables option)
• impl Hash for BorrowedStr/BorrowedBytes
• Lua::current_thread resolves implicit async threads to their root owner (#706)
• Bugfixes and improvements

Full Changelog: v0.11.6...v0.12.0

v0.12.0-rc.2

The new stable version is almost ready and will be released after some testing

What's Changed

• Add #[derive(UserData)] and #[userdata_impl] macros
• Support thread create/resume/yield callbacks for all Lua versions (including Luau)
• Support to_alias_override/to_alias_fallback in Require trait (Luau)
• Prevent XRc overflow when dropping RawLua with foreign Lua state
• Implement Not for StdLib (#699)
• Fix String::to_pointer return NULL in Lua <5.4

Full Changelog: v0.12.0-rc.1...v0.12.0-rc.2

v0.12.0-rc.1

What's Changed

• Switch to Rust 2024 edition
• Removed Error::ToLuaConversionError variant as it was unused (and not practically useful)
• New modules to group data types: chunk, debug, error, function, table, string, state, thread, userdata, luau
• Support __todebugstring metamethod for pretty formatting userdata value (for debugging)
• New MaybeSync trait that is required for userdata types
• Removed lifetime from BorrowedStr and BorrowedBytes
• New Thread methods: is_resumable, is_running, is_finished, is_error
• Added Thread::state to get raw Lua state pointer
• Luau TextRequirer is renamed to FsRequirer
• GC interface refactor: Lua::gc_inc/Lua::gc_gen is replaced with gc_set_mode
• Added GcIncParams and GcGenParams for GC tuning
• New UserDataMethods::add_method_once and UserDataMethods::add_async_method_once
• Initial Luau integer64 type support
• Changed interface of Function::wrap/wrap_mut/wrap_async to support any Error type
• Changed AnyUserData::type_name to return LuaString instead
• Added UserDataOwned<T> wrapper to take ownership of userdata T and implements FromLua

Full Changelog: v0.11.6...v0.12.0-rc.1

v0.11.6

What's Changed

• Lua 5.5 support under the new lua55 feature flag
• Luau updated to 0.705+
• Added AnyUserData::is_proxy
• Added num_params, num_upvalues, is_vararg to FunctionInfo

Full Changelog: v0.11.5...v0.11.6

Lua 5.5 notes

Lua 5.5 support external strings and mlua enable this optimisation for impl IntoLua for String/BString (owned versions to move Drop into Lua).
Also the Lua::create_external_string function allow moving ownership to Lua for any Into<Vec<u8>> types.

v0.11.5

What's Changed

• Luau updated to 0.701
• Added Lua::set_memory_category and Lua::heap_dump functions to profile (Luau) memory
• Added Lua::type_metatable helper to get metatable of a primitive type
• Added Lua::traceback function to generate stack traces at different levels
• Added add_method_once /add_async_method_once UserData methods (experimental)
• Make AnyUserData::type_name public
• impl IntoLuaMulti for &MultiValue

Full Changelog: v0.11.4...v0.11.5

v0.11.4

What's Changed

• Make Value::to_serializable public
• Added new serde option detect_mixed_tables (to encode mixed array+map tables)
• Added ObjectLike::get_path helper (for tables and userdata) for easy access of nested data
• Added (experimental) __namecall optimization for Luau

Full Changelog: v0.11.3...v0.11.4

v0.11.3

What's Changed

• Added Lua::yield_with to use as coroutine.yield functional replacement in async functions for any Lua (see doc examples)
• Do not try to yield at non-yielable points in Luau interrupt (#632)
• Added Buffer::cursor method (Luau)
• Added Lua::create_buffer_with_capacity method (Luau)
• Make Lua reference values cheap to clone in Rust (only increments ref count)
• Fix panic on large (>67M entries) table creation

Full Changelog: v0.11.2...v0.11.3

v0.11.2

What's Changed

• Faster stack push for Variadic<T>
• Fix handling Windows paths with drive letter in Luau require (#623) by @piz-ewing
• Make Luau registered aliases ascii case-insensitive (#620)
• Fix deserializing negative zeros -0.0 (#618)

Full Changelog: v0.11.1...v0.11.2

v0.11.1

What's Changed

• Fixed bug exhausting Lua auxiliary stack and leaving it without reserve (#615)
• Lua::push_c_function now correctly handles OOM for Lua 5.1 and Luau

Full Changelog: v0.11.0...v0.11.1

v0.12.1

What's Changed

• Lua 5.5 updated to 5.5.1
• Luau updated to 0.736
• Allow #[mlua::userdata_impl] to be used in a different module from #[derive(UserData)] (#726)
• Fix coroutine stack handling after yielding from hooks (#723)

Full Changelog: v0.12.0...v0.12.1

v0.12.0

Highlights

More ergonomic UserData building blocks

• Declaratively implement UserData with #[derive(UserData)] and register methods/fields with the new #[mlua::userdata_impl] attribute macro.
• UserDataOwned<T> wrapper takes ownership of userdata and implements FromLua
• UserDataMethods::add_method_once/add_async_method_once
• __todebugstring metamethod for pretty-printing userdata when debugging
• MaybeSync trait for userdata under the send feature

Reorganized public API

Types are now grouped into focused modules: chunk, debug, error, function, table, string, state, thread, userdata and luau.

Thread lifecycle callbacks

Hook into coroutine create/resume/yield events across all Lua versions (when using mlua API).

Luau improvements

Latest Luau with extended require-by-string support and JIT options.

Garbage-collector interface refactor

Lua::gc_inc / Lua::gc_gen are replaced by a Lua::gc_set_mode, with GcIncParams/GcGenParams for fine-grained tuning.

What's Changed (since v0.12.0-rc.2)

• Crate root re-exports are refactored (only essentials are re-exported, the rest is in the new submodules)
• Added ThreadStatus::Normal and Thread::is_normal (mimic coroutine.status)
• Added Lua::set_jit_options with support of Luau JIT inliner (Luau)
• Added Value::as_vector/Value::is_vector (Luau)
• Added Table::remove
• serde: tables with the array metatable are always encoded as arrays (incl. detect_mixed_tables option)
• impl Hash for BorrowedStr/BorrowedBytes
• Lua::current_thread resolves implicit async threads to their root owner (#706)
• Bugfixes and improvements

Full Changelog: v0.11.6...v0.12.0

v0.12.0-rc.2

The new stable version is almost ready and will be released after some testing

What's Changed

• Add #[derive(UserData)] and #[userdata_impl] macros
• Support thread create/resume/yield callbacks for all Lua versions (including Luau)
• Support to_alias_override/to_alias_fallback in Require trait (Luau)
• Prevent XRc overflow when dropping RawLua with foreign Lua state
• Implement Not for StdLib (#699)
• Fix String::to_pointer return NULL in Lua <5.4

Full Changelog: v0.12.0-rc.1...v0.12.0-rc.2

v0.12.0-rc.1

What's Changed

• Switch to Rust 2024 edition
• Removed Error::ToLuaConversionError variant as it was unused (and not practically useful)
• New modules to group data types: chunk, debug, error, function, table, string, state, thread, userdata, luau
• Support __todebugstring metamethod for pretty formatting userdata value (for debugging)
• New MaybeSync trait that is required for userdata types
• Removed lifetime from BorrowedStr and BorrowedBytes
• New Thread methods: is_resumable, is_running, is_finished, is_error
• Added Thread::state to get raw Lua state pointer
• Luau TextRequirer is renamed to FsRequirer
• GC interface refactor: Lua::gc_inc/Lua::gc_gen is replaced with gc_set_mode
• Added GcIncParams and GcGenParams for GC tuning
• New UserDataMethods::add_method_once and UserDataMethods::add_async_method_once
• Initial Luau integer64 type support
• Changed interface of Function::wrap/wrap_mut/wrap_async to support any Error type
• Changed AnyUserData::type_name to return LuaString instead
• Added UserDataOwned<T> wrapper to take ownership of userdata T and implements FromLua

Full Changelog: v0.11.6...v0.12.0-rc.1

v0.11.6

What's Changed

• Lua 5.5 support under the new lua55 feature flag
• Luau updated to 0.705+
• Added AnyUserData::is_proxy
• Added num_params, num_upvalues, is_vararg to FunctionInfo

Full Changelog: v0.11.5...v0.11.6

Lua 5.5 notes

Lua 5.5 support external strings and mlua enable this optimisation for impl IntoLua for String/BString (owned versions to move Drop into Lua).
Also the Lua::create_external_string function allow moving ownership to Lua for any Into<Vec<u8>> types.

v0.11.5

What's Changed

• Luau updated to 0.701
• Added Lua::set_memory_category and Lua::heap_dump functions to profile (Luau) memory
• Added Lua::type_metatable helper to get metatable of a primitive type
• Added Lua::traceback function to generate stack traces at different levels
• Added add_method_once /add_async_method_once UserData methods (experimental)
• Make AnyUserData::type_name public
• impl IntoLuaMulti for &MultiValue

Full Changelog: v0.11.4...v0.11.5

v0.11.4

What's Changed

• Make Value::to_serializable public
• Added new serde option detect_mixed_tables (to encode mixed array+map tables)
• Added ObjectLike::get_path helper (for tables and userdata) for easy access of nested data
• Added (experimental) __namecall optimization for Luau

Full Changelog: v0.11.3...v0.11.4

v0.11.3

What's Changed

• Added Lua::yield_with to use as coroutine.yield functional replacement in async functions for any Lua (see doc examples)
• Do not try to yield at non-yielable points in Luau interrupt (#632)
• Added Buffer::cursor method (Luau)
• Added Lua::create_buffer_with_capacity method (Luau)
• Make Lua reference values cheap to clone in Rust (only increments ref count)
• Fix panic on large (>67M entries) table creation

Full Changelog: v0.11.2...v0.11.3

v0.11.2

What's Changed

• Faster stack push for Variadic<T>
• Fix handling Windows paths with drive letter in Luau require (#623) by @piz-ewing
• Make Luau registered aliases ascii case-insensitive (#620)
• Fix deserializing negative zeros -0.0 (#618)

Full Changelog: v0.11.1...v0.11.2

v0.11.1

What's Changed

• Fixed bug exhausting Lua auxiliary stack and leaving it without reserve (#615)
• Lua::push_c_function now correctly handles OOM for Lua 5.1 and Luau

Full Changelog: v0.11.0...v0.11.1

v0.12.1

What's Changed

• Lua 5.5 updated to 5.5.1
• Luau updated to 0.736
• Allow #[mlua::userdata_impl] to be used in a different module from #[derive(UserData)] (#726)
• Fix coroutine stack handling after yielding from hooks (#723)

Full Changelog: v0.12.0...v0.12.1

v0.12.0

Highlights

More ergonomic UserData building blocks

• Declaratively implement UserData with #[derive(UserData)] and register methods/fields with the new #[mlua::userdata_impl] attribute macro.
• UserDataOwned<T> wrapper takes ownership of userdata and implements FromLua
• UserDataMethods::add_method_once/add_async_method_once
• __todebugstring metamethod for pretty-printing userdata when debugging
• MaybeSync trait for userdata under the send feature

Reorganized public API

Types are now grouped into focused modules: chunk, debug, error, function, table, string, state, thread, userdata and luau.

Thread lifecycle callbacks

Hook into coroutine create/resume/yield events across all Lua versions (when using mlua API).

Luau improvements

Latest Luau with extended require-by-string support and JIT options.

Garbage-collector interface refactor

Lua::gc_inc / Lua::gc_gen are replaced by a Lua::gc_set_mode, with GcIncParams/GcGenParams for fine-grained tuning.

What's Changed (since v0.12.0-rc.2)

• Crate root re-exports are refactored (only essentials are re-exported, the rest is in the new submodules)
• Added ThreadStatus::Normal and Thread::is_normal (mimic coroutine.status)
• Added Lua::set_jit_options with support of Luau JIT inliner (Luau)
• Added Value::as_vector/Value::is_vector (Luau)
• Added Table::remove
• serde: tables with the array metatable are always encoded as arrays (incl. detect_mixed_tables option)
• impl Hash for BorrowedStr/BorrowedBytes
• Lua::current_thread resolves implicit async threads to their root owner (#706)
• Bugfixes and improvements

Full Changelog: v0.11.6...v0.12.0

v0.12.0-rc.2

The new stable version is almost ready and will be released after some testing

What's Changed

• Add #[derive(UserData)] and #[userdata_impl] macros
• Support thread create/resume/yield callbacks for all Lua versions (including Luau)
• Support to_alias_override/to_alias_fallback in Require trait (Luau)
• Prevent XRc overflow when dropping RawLua with foreign Lua state
• Implement Not for StdLib (#699)
• Fix String::to_pointer return NULL in Lua <5.4

Full Changelog: v0.12.0-rc.1...v0.12.0-rc.2

v0.12.0-rc.1

What's Changed

• Switch to Rust 2024 edition
• Removed Error::ToLuaConversionError variant as it was unused (and not practically useful)
• New modules to group data types: chunk, debug, error, function, table, string, state, thread, userdata, luau
• Support __todebugstring metamethod for pretty formatting userdata value (for debugging)
• New MaybeSync trait that is required for userdata types
• Removed lifetime from BorrowedStr and BorrowedBytes
• New Thread methods: is_resumable, is_running, is_finished, is_error
• Added Thread::state to get raw Lua state pointer
• Luau TextRequirer is renamed to FsRequirer
• GC interface refactor: Lua::gc_inc/Lua::gc_gen is replaced with gc_set_mode
• Added GcIncParams and GcGenParams for GC tuning
• New UserDataMethods::add_method_once and UserDataMethods::add_async_method_once
• Initial Luau integer64 type support
• Changed interface of Function::wrap/wrap_mut/wrap_async to support any Error type
• Changed AnyUserData::type_name to return LuaString instead
• Added UserDataOwned<T> wrapper to take ownership of userdata T and implements FromLua

Full Changelog: v0.11.6...v0.12.0-rc.1

v0.11.6

What's Changed

• Lua 5.5 support under the new lua55 feature flag
• Luau updated to 0.705+
• Added AnyUserData::is_proxy
• Added num_params, num_upvalues, is_vararg to FunctionInfo

Full Changelog: v0.11.5...v0.11.6

Lua 5.5 notes

Lua 5.5 support external strings and mlua enable this optimisation for impl IntoLua for String/BString (owned versions to move Drop into Lua).
Also the Lua::create_external_string function allow moving ownership to Lua for any Into<Vec<u8>> types.

v0.11.5

What's Changed

• Luau updated to 0.701
• Added Lua::set_memory_category and Lua::heap_dump functions to profile (Luau) memory
• Added Lua::type_metatable helper to get metatable of a primitive type
• Added Lua::traceback function to generate stack traces at different levels
• Added add_method_once /add_async_method_once UserData methods (experimental)
• Make AnyUserData::type_name public
• impl IntoLuaMulti for &MultiValue

Full Changelog: v0.11.4...v0.11.5

v0.11.4

What's Changed

• Make Value::to_serializable public
• Added new serde option detect_mixed_tables (to encode mixed array+map tables)
• Added ObjectLike::get_path helper (for tables and userdata) for easy access of nested data
• Added (experimental) __namecall optimization for Luau

Full Changelog: v0.11.3...v0.11.4

v0.11.3

What's Changed

• Added Lua::yield_with to use as coroutine.yield functional replacement in async functions for any Lua (see doc examples)
• Do not try to yield at non-yielable points in Luau interrupt (#632)
• Added Buffer::cursor method (Luau)
• Added Lua::create_buffer_with_capacity method (Luau)
• Make Lua reference values cheap to clone in Rust (only increments ref count)
• Fix panic on large (>67M entries) table creation

Full Changelog: v0.11.2...v0.11.3

v0.11.2

What's Changed

• Faster stack push for Variadic<T>
• Fix handling Windows paths with drive letter in Luau require (#623) by @piz-ewing
• Make Luau registered aliases ascii case-insensitive (#620)
• Fix deserializing negative zeros -0.0 (#618)

Full Changelog: v0.11.1...v0.11.2

v0.11.1

What's Changed

• Fixed bug exhausting Lua auxiliary stack and leaving it without reserve (#615)
• Lua::push_c_function now correctly handles OOM for Lua 5.1 and Luau

Full Changelog: v0.11.0...v0.11.1

v0.12.1

What's Changed

• Lua 5.5 updated to 5.5.1
• Luau updated to 0.736
• Allow #[mlua::userdata_impl] to be used in a different module from #[derive(UserData)] (#726)
• Fix coroutine stack handling after yielding from hooks (#723)

Full Changelog: v0.12.0...v0.12.1

v0.12.0

Highlights

More ergonomic UserData building blocks

• Declaratively implement UserData with #[derive(UserData)] and register methods/fields with the new #[mlua::userdata_impl] attribute macro.
• UserDataOwned<T> wrapper takes ownership of userdata and implements FromLua
• UserDataMethods::add_method_once/add_async_method_once
• __todebugstring metamethod for pretty-printing userdata when debugging
• MaybeSync trait for userdata under the send feature

Reorganized public API

Types are now grouped into focused modules: chunk, debug, error, function, table, string, state, thread, userdata and luau.

Thread lifecycle callbacks

Hook into coroutine create/resume/yield events across all Lua versions (when using mlua API).

Luau improvements

Latest Luau with extended require-by-string support and JIT options.

Garbage-collector interface refactor

Lua::gc_inc / Lua::gc_gen are replaced by a Lua::gc_set_mode, with GcIncParams/GcGenParams for fine-grained tuning.

What's Changed (since v0.12.0-rc.2)

• Crate root re-exports are refactored (only essentials are re-exported, the rest is in the new submodules)
• Added ThreadStatus::Normal and Thread::is_normal (mimic coroutine.status)
• Added Lua::set_jit_options with support of Luau JIT inliner (Luau)
• Added Value::as_vector/Value::is_vector (Luau)
• Added Table::remove
• serde: tables with the array metatable are always encoded as arrays (incl. detect_mixed_tables option)
• impl Hash for BorrowedStr/BorrowedBytes
• Lua::current_thread resolves implicit async threads to their root owner (#706)
• Bugfixes and improvements

Full Changelog: v0.11.6...v0.12.0

v0.12.0-rc.2

The new stable version is almost ready and will be released after some testing

What's Changed

• Add #[derive(UserData)] and #[userdata_impl] macros
• Support thread create/resume/yield callbacks for all Lua versions (including Luau)
• Support to_alias_override/to_alias_fallback in Require trait (Luau)
• Prevent XRc overflow when dropping RawLua with foreign Lua state
• Implement Not for StdLib (#699)
• Fix String::to_pointer return NULL in Lua <5.4

Full Changelog: v0.12.0-rc.1...v0.12.0-rc.2

v0.12.0-rc.1

What's Changed

• Switch to Rust 2024 edition
• Removed Error::ToLuaConversionError variant as it was unused (and not practically useful)
• New modules to group data types: chunk, debug, error, function, table, string, state, thread, userdata, luau
• Support __todebugstring metamethod for pretty formatting userdata value (for debugging)
• New MaybeSync trait that is required for userdata types
• Removed lifetime from BorrowedStr and BorrowedBytes
• New Thread methods: is_resumable, is_running, is_finished, is_error
• Added Thread::state to get raw Lua state pointer
• Luau TextRequirer is renamed to FsRequirer
• GC interface refactor: Lua::gc_inc/Lua::gc_gen is replaced with gc_set_mode
• Added GcIncParams and GcGenParams for GC tuning
• New UserDataMethods::add_method_once and UserDataMethods::add_async_method_once
• Initial Luau integer64 type support
• Changed interface of Function::wrap/wrap_mut/wrap_async to support any Error type
• Changed AnyUserData::type_name to return LuaString instead
• Added UserDataOwned<T> wrapper to take ownership of userdata T and implements FromLua

Full Changelog: v0.11.6...v0.12.0-rc.1

v0.11.6

What's Changed

• Lua 5.5 support under the new lua55 feature flag
• Luau updated to 0.705+
• Added AnyUserData::is_proxy
• Added num_params, num_upvalues, is_vararg to FunctionInfo

Full Changelog: v0.11.5...v0.11.6

Lua 5.5 notes

Lua 5.5 support external strings and mlua enable this optimisation for impl IntoLua for String/BString (owned versions to move Drop into Lua).
Also the Lua::create_external_string function allow moving ownership to Lua for any Into<Vec<u8>> types.

v0.11.5

What's Changed

• Luau updated to 0.701
• Added Lua::set_memory_category and Lua::heap_dump functions to profile (Luau) memory
• Added Lua::type_metatable helper to get metatable of a primitive type
• Added Lua::traceback function to generate stack traces at different levels
• Added add_method_once /add_async_method_once UserData methods (experimental)
• Make AnyUserData::type_name public
• impl IntoLuaMulti for &MultiValue

Full Changelog: v0.11.4...v0.11.5

v0.11.4

What's Changed

• Make Value::to_serializable public
• Added new serde option detect_mixed_tables (to encode mixed array+map tables)
• Added ObjectLike::get_path helper (for tables and userdata) for easy access of nested data
• Added (experimental) __namecall optimization for Luau

Full Changelog: v0.11.3...v0.11.4

v0.11.3

What's Changed

• Added Lua::yield_with to use as coroutine.yield functional replacement in async functions for any Lua (see doc examples)
• Do not try to yield at non-yielable points in Luau interrupt (#632)
• Added Buffer::cursor method (Luau)
• Added Lua::create_buffer_with_capacity method (Luau)
• Make Lua reference values cheap to clone in Rust (only increments ref count)
• Fix panic on large (>67M entries) table creation

Full Changelog: v0.11.2...v0.11.3

v0.11.2

What's Changed

• Faster stack push for Variadic<T>
• Fix handling Windows paths with drive letter in Luau require (#623) by @piz-ewing
• Make Luau registered aliases ascii case-insensitive (#620)
• Fix deserializing negative zeros -0.0 (#618)

Full Changelog: v0.11.1...v0.11.2

v0.11.1

What's Changed

• Fixed bug exhausting Lua auxiliary stack and leaving it without reserve (#615)
• Lua::push_c_function now correctly handles OOM for Lua 5.1 and Luau

Full Changelog: v0.11.0...v0.11.1

v0.12.1

What's Changed

• Lua 5.5 updated to 5.5.1
• Luau updated to 0.736
• Allow #[mlua::userdata_impl] to be used in a different module from #[derive(UserData)] (#726)
• Fix coroutine stack handling after yielding from hooks (#723)

Full Changelog: v0.12.0...v0.12.1

v0.12.0

Highlights

More ergonomic UserData building blocks

• Declaratively implement UserData with #[derive(UserData)] and register methods/fields with the new #[mlua::userdata_impl] attribute macro.
• UserDataOwned<T> wrapper takes ownership of userdata and implements FromLua
• UserDataMethods::add_method_once/add_async_method_once
• __todebugstring metamethod for pretty-printing userdata when debugging
• MaybeSync trait for userdata under the send feature

Reorganized public API

Types are now grouped into focused modules: chunk, debug, error, function, table, string, state, thread, userdata and luau.

Thread lifecycle callbacks

Hook into coroutine create/resume/yield events across all Lua versions (when using mlua API).

Luau improvements

Latest Luau with extended require-by-string support and JIT options.

Garbage-collector interface refactor

Lua::gc_inc / Lua::gc_gen are replaced by a Lua::gc_set_mode, with GcIncParams/GcGenParams for fine-grained tuning.

What's Changed (since v0.12.0-rc.2)

• Crate root re-exports are refactored (only essentials are re-exported, the rest is in the new submodules)
• Added ThreadStatus::Normal and Thread::is_normal (mimic coroutine.status)
• Added Lua::set_jit_options with support of Luau JIT inliner (Luau)
• Added Value::as_vector/Value::is_vector (Luau)
• Added Table::remove
• serde: tables with the array metatable are always encoded as arrays (incl. detect_mixed_tables option)
• impl Hash for BorrowedStr/BorrowedBytes
• Lua::current_thread resolves implicit async threads to their root owner (#706)
• Bugfixes and improvements

Full Changelog: v0.11.6...v0.12.0

v0.12.0-rc.2

The new stable version is almost ready and will be released after some testing

What's Changed

• Add #[derive(UserData)] and #[userdata_impl] macros
• Support thread create/resume/yield callbacks for all Lua versions (including Luau)
• Support to_alias_override/to_alias_fallback in Require trait (Luau)
• Prevent XRc overflow when dropping RawLua with foreign Lua state
• Implement Not for StdLib (#699)
• Fix String::to_pointer return NULL in Lua <5.4

Full Changelog: v0.12.0-rc.1...v0.12.0-rc.2

v0.12.0-rc.1

What's Changed

• Switch to Rust 2024 edition
• Removed Error::ToLuaConversionError variant as it was unused (and not practically useful)
• New modules to group data types: chunk, debug, error, function, table, string, state, thread, userdata, luau
• Support __todebugstring metamethod for pretty formatting userdata value (for debugging)
• New MaybeSync trait that is required for userdata types
• Removed lifetime from BorrowedStr and BorrowedBytes
• New Thread methods: is_resumable, is_running, is_finished, is_error
• Added Thread::state to get raw Lua state pointer
• Luau TextRequirer is renamed to FsRequirer
• GC interface refactor: Lua::gc_inc/Lua::gc_gen is replaced with gc_set_mode
• Added GcIncParams and GcGenParams for GC tuning
• New UserDataMethods::add_method_once and UserDataMethods::add_async_method_once
• Initial Luau integer64 type support
• Changed interface of Function::wrap/wrap_mut/wrap_async to support any Error type
• Changed AnyUserData::type_name to return LuaString instead
• Added UserDataOwned<T> wrapper to take ownership of userdata T and implements FromLua

Full Changelog: v0.11.6...v0.12.0-rc.1

v0.11.6

What's Changed

• Lua 5.5 support under the new lua55 feature flag
• Luau updated to 0.705+
• Added AnyUserData::is_proxy
• Added num_params, num_upvalues, is_vararg to FunctionInfo

Full Changelog: v0.11.5...v0.11.6

Lua 5.5 notes

Lua 5.5 support external strings and mlua enable this optimisation for impl IntoLua for String/BString (owned versions to move Drop into Lua).
Also the Lua::create_external_string function allow moving ownership to Lua for any Into<Vec<u8>> types.

v0.11.5

What's Changed

• Luau updated to 0.701
• Added Lua::set_memory_category and Lua::heap_dump functions to profile (Luau) memory
• Added Lua::type_metatable helper to get metatable of a primitive type
• Added Lua::traceback function to generate stack traces at different levels
• Added add_method_once /add_async_method_once UserData methods (experimental)
• Make AnyUserData::type_name public
• impl IntoLuaMulti for &MultiValue

Full Changelog: v0.11.4...v0.11.5

v0.11.4

What's Changed

• Make Value::to_serializable public
• Added new serde option detect_mixed_tables (to encode mixed array+map tables)
• Added ObjectLike::get_path helper (for tables and userdata) for easy access of nested data
• Added (experimental) __namecall optimization for Luau

Full Changelog: v0.11.3...v0.11.4

v0.11.3

What's Changed

• Added Lua::yield_with to use as coroutine.yield functional replacement in async functions for any Lua (see doc examples)
• Do not try to yield at non-yielable points in Luau interrupt (#632)
• Added Buffer::cursor method (Luau)
• Added Lua::create_buffer_with_capacity method (Luau)
• Make Lua reference values cheap to clone in Rust (only increments ref count)
• Fix panic on large (>67M entries) table creation

Full Changelog: v0.11.2...v0.11.3

v0.11.2

What's Changed

• Faster stack push for Variadic<T>
• Fix handling Windows paths with drive letter in Luau require (#623) by @piz-ewing
• Make Luau registered aliases ascii case-insensitive (#620)
• Fix deserializing negative zeros -0.0 (#618)

Full Changelog: v0.11.1...v0.11.2

v0.11.1

What's Changed

• Fixed bug exhausting Lua auxiliary stack and leaving it without reserve (#615)
• Lua::push_c_function now correctly handles OOM for Lua 5.1 and Luau

Full Changelog: v0.11.0...v0.11.1

v0.12.1

What's Changed

• Lua 5.5 updated to 5.5.1
• Luau updated to 0.736
• Allow #[mlua::userdata_impl] to be used in a different module from #[derive(UserData)] (#726)
• Fix coroutine stack handling after yielding from hooks (#723)

Full Changelog: v0.12.0...v0.12.1

v0.12.0

Highlights

More ergonomic UserData building blocks

• Declaratively implement UserData with #[derive(UserData)] and register methods/fields with the new #[mlua::userdata_impl] attribute macro.
• UserDataOwned<T> wrapper takes ownership of userdata and implements FromLua
• UserDataMethods::add_method_once/add_async_method_once
• __todebugstring metamethod for pretty-printing userdata when debugging
• MaybeSync trait for userdata under the send feature

Reorganized public API

Types are now grouped into focused modules: chunk, debug, error, function, table, string, state, thread, userdata and luau.

Thread lifecycle callbacks

Hook into coroutine create/resume/yield events across all Lua versions (when using mlua API).

Luau improvements

Latest Luau with extended require-by-string support and JIT options.

Garbage-collector interface refactor

Lua::gc_inc / Lua::gc_gen are replaced by a Lua::gc_set_mode, with GcIncParams/GcGenParams for fine-grained tuning.

What's Changed (since v0.12.0-rc.2)

• Crate root re-exports are refactored (only essentials are re-exported, the rest is in the new submodules)
• Added ThreadStatus::Normal and Thread::is_normal (mimic coroutine.status)
• Added Lua::set_jit_options with support of Luau JIT inliner (Luau)
• Added Value::as_vector/Value::is_vector (Luau)
• Added Table::remove
• serde: tables with the array metatable are always encoded as arrays (incl. detect_mixed_tables option)
• impl Hash for BorrowedStr/BorrowedBytes
• Lua::current_thread resolves implicit async threads to their root owner (#706)
• Bugfixes and improvements

Full Changelog: v0.11.6...v0.12.0

v0.12.0-rc.2

The new stable version is almost ready and will be released after some testing

What's Changed

• Add #[derive(UserData)] and #[userdata_impl] macros
• Support thread create/resume/yield callbacks for all Lua versions (including Luau)
• Support to_alias_override/to_alias_fallback in Require trait (Luau)
• Prevent XRc overflow when dropping RawLua with foreign Lua state
• Implement Not for StdLib (#699)
• Fix String::to_pointer return NULL in Lua <5.4

Full Changelog: v0.12.0-rc.1...v0.12.0-rc.2

v0.12.0-rc.1

What's Changed

• Switch to Rust 2024 edition
• Removed Error::ToLuaConversionError variant as it was unused (and not practically useful)
• New modules to group data types: chunk, debug, error, function, table, string, state, thread, userdata, luau
• Support __todebugstring metamethod for pretty formatting userdata value (for debugging)
• New MaybeSync trait that is required for userdata types
• Removed lifetime from BorrowedStr and BorrowedBytes
• New Thread methods: is_resumable, is_running, is_finished, is_error
• Added Thread::state to get raw Lua state pointer
• Luau TextRequirer is renamed to FsRequirer
• GC interface refactor: Lua::gc_inc/Lua::gc_gen is replaced with gc_set_mode
• Added GcIncParams and GcGenParams for GC tuning
• New UserDataMethods::add_method_once and UserDataMethods::add_async_method_once
• Initial Luau integer64 type support
• Changed interface of Function::wrap/wrap_mut/wrap_async to support any Error type
• Changed AnyUserData::type_name to return LuaString instead
• Added UserDataOwned<T> wrapper to take ownership of userdata T and implements FromLua

Full Changelog: v0.11.6...v0.12.0-rc.1

v0.11.6

What's Changed

• Lua 5.5 support under the new lua55 feature flag
• Luau updated to 0.705+
• Added AnyUserData::is_proxy
• Added num_params, num_upvalues, is_vararg to FunctionInfo

Full Changelog: v0.11.5...v0.11.6

Lua 5.5 notes

Lua 5.5 support external strings and mlua enable this optimisation for impl IntoLua for String/BString (owned versions to move Drop into Lua).
Also the Lua::create_external_string function allow moving ownership to Lua for any Into<Vec<u8>> types.

v0.11.5

What's Changed

• Luau updated to 0.701
• Added Lua::set_memory_category and Lua::heap_dump functions to profile (Luau) memory
• Added Lua::type_metatable helper to get metatable of a primitive type
• Added Lua::traceback function to generate stack traces at different levels
• Added add_method_once /add_async_method_once UserData methods (experimental)
• Make AnyUserData::type_name public
• impl IntoLuaMulti for &MultiValue

Full Changelog: v0.11.4...v0.11.5

v0.11.4

What's Changed

• Make Value::to_serializable public
• Added new serde option detect_mixed_tables (to encode mixed array+map tables)
• Added ObjectLike::get_path helper (for tables and userdata) for easy access of nested data
• Added (experimental) __namecall optimization for Luau

Full Changelog: v0.11.3...v0.11.4

v0.11.3

What's Changed

• Added Lua::yield_with to use as coroutine.yield functional replacement in async functions for any Lua (see doc examples)
• Do not try to yield at non-yielable points in Luau interrupt (#632)
• Added Buffer::cursor method (Luau)
• Added Lua::create_buffer_with_capacity method (Luau)
• Make Lua reference values cheap to clone in Rust (only increments ref count)
• Fix panic on large (>67M entries) table creation

Full Changelog: v0.11.2...v0.11.3

v0.11.2

What's Changed

• Faster stack push for Variadic<T>
• Fix handling Windows paths with drive letter in Luau require (#623) by @piz-ewing
• Make Luau registered aliases ascii case-insensitive (#620)
• Fix deserializing negative zeros -0.0 (#618)

Full Changelog: v0.11.1...v0.11.2

v0.11.1

What's Changed

• Fixed bug exhausting Lua auxiliary stack and leaving it without reserve (#615)
• Lua::push_c_function now correctly handles OOM for Lua 5.1 and Luau

Full Changelog: v0.11.0...v0.11.1