🚀 Released 2020-10-16.
🚀 Upgrade included Lua version to new bug-fix release 5.3.6. See
📚 the upstream documentation https://www.lua.org/bugs.html#5.3.5
🛠 for the bugs which have been fixed.
Foreign.Lua.Raw.Auxiliary. Both values are defined only if the
HARDCODE_REG_KEYSis disabled, leading to compilation
errors when the flag is enabled.
➕ Add new function
peekStringyto Peek module. It allows to peek
a value of any
IsStringtype from an UTF-8 encoded string.
Various improvements to the continuous integration setup,
including cleanup of the config files, version bumps to the
👕 ghc/cabal versions used for testing, and running the linter in a
dedicated GitHub Action.
🚀 Released 2020-08-15
🆕 New module
Foreign.Lua.Call: the module offers an alternative
method of exposing Haskell functions to Lua. The focus is on
maintainability: types and marshaling methods are made explicit;
📚 the possibility of adding documentation and parameter names
👌 improves error messages and allows for automatic documentation
Work on this module is ongoing; the interface is likely to
🔄 change. Suggestions and feedback are welcome.
🆕 New types
Field, and new functions
Foreign.Lua.Module: this builds on the new
👍 allows the creation of documented modules as well as automatic
📚 generation of Markdown-formatted module documentation.
Export new items
topfrom Foreign.Lua.Core and
Foreign.Lua. They are short-hands for
🐎 Performance improvements: Calling of Lua functions and creation
of Haskell data wrapping userdata has been sped up by about 10%.
This is mostly due to using of previously missed optimization
🚚 All foreign imports have been moved to into the new
Foreign.Lua.Rawmodule. This module will replace the current
Foreign.Lua.Coremodule in the future and will be distributed
🚀 as a separate package (likely starting with the 2.0 release);
the remaining parts of the current
Coremodule will be
promoted one level in the module hierarchy.
Rawmodule can be used whenever the full power of HsLua is
🚦 Error-signaling of API wrapper functions has been changed:
instead of returning special integer values, functions now take
an additional pointer argument, which is set to the status
result of the computation.
Failabletype in Core.Error is no longer needed and has
🚚 been removed.
🏗 CI builds now include GHC 8.8 and GHC 8.10, ensuring that all
👍 GHC 8.* versions are supported.
🚀 Released 2020-06-27
⏪ Revert signature of function
pushListto it's proper 1.1.0
🚀 value. This fixes a mistake which caused the 1.1.1 release
to be in violation of the PVP versioning policy.
Module Foreign.Lua.Peek: add function
🚀 Released 2020-06-02
⚠ WARNING: This version does not conform to the PVP versioning policy, due to a unintended signature change of function
pushList. It is recommended not to use this version.
- 🆕 New module Foreign.Lua.Push: provides functions which marshal and push Haskell values onto Lua's stack.
Most functions in Foreign.Lua.Types.Pushable are now defined using functions from this module.
- 🆕 New module Foreign.Lua.Peek: provides functions which unmarshal
and retrieve Haskell values from Lua's stack. Contrary to
peekfrom Foreign.Lua.Types.Peekable, the peeker functions in this module will never throw errors, but use an
Eithertype to signal retrieval failure.
The error type
PeekErrorshould not be considered final and will likely be subject to change in later versions.
Module Foreign.Lua.Utf8: never throw errors when decoding UTF-8 strings. Invalid UTF-8 input bytes no longer cause exceptions, but are replaced with the Unicode replacement character U+FFFD.
🛠 Fixed missing and faulty Haddock documentation.
🛠 Fixed a bug which caused unnecessary use of strings to represent floating point numbers under certain configurations.
🚀 Released 2020-03-25.
⚠ WARNING: The changes in this release are experimental. It is 🚀 recommended to skip this release unless the newly introduced 🔋 features are required.
👍 Allow custom error handling: conversion of Lua errors to Haskell exceptions and back is made configurable. Users can define their own exception/error handling strategies, even opening up the option to pass arbitrary exceptions through Lua.
New types exported from
ErrorConversion: defines the ways in which exceptions and errors are handled and converted.
LuaEnvironment: environment in which Lua computations are evaluated. Contains the Lua interpreter state and the error conversion strategy.
The environment of the
Luatype is changed from a plain Lua
Stateto the above mentioned
run'is exported from
Foreign.Lua: it is analogous to
run, but allows to run computations with a custom error conversion strategy.
run', but takes a custom state.
Foreign.Lua.Core; runs a computation without proper error handling.
Foreign.Lua.Core: extract the error conversion strategy from the Lua type.
Foreign.Lua.Core: throws a Lua error as Haskell exception, using the current error conversion strategy.
runWithis moved from module
Foreign.Lua.Utf8is now exported.
🚀 Released 2019-05-04.
🆕 New module
Foreign.Lua.Module, containing helper functions to define and load modules from Haskell.
👌 Improve documentation of
open<lib>(many thanks to Christian Charukiewicz.)
🚀 Released 2019-08-21.
- ➕ Added flag to use hardcoded values for registry keys: The names of the registry keys used to store package information are available as CPP values from file lauxlib.h since Lua 5.3.4; compiling HsLua against older Lua versions was not possible, as those values were expected to exist.
The respective values are now hardcoded into HsLua, and a new flag
hardcode-reg-keyis introduced, which will cause the use of these hardcoded values instead of those defined in lauxlib.h. Using this flag makes it possible to compile hslua against all Lua 5.3.* versions.
- ➕ Added missing C files for benchmarking to list of extra-source-files.
🚀 Released 2019-05-08.
- Prevent filenames being treated as strings in debug messages.
sourcedescription as an argument, which is used for debug messages. The
loadfilefunction now adds a special prefix (
source, thus marking it as a filename.
- Prevent filenames being treated as strings in debug messages. Lua's
🚀 Released 2019-01-05.
🛠 Fixed cross-compilation: placement of C import declarations were fixed, thereby resolving issues with cross-compilation. (Vanessa McHale and Faraz Maleknia)
➕ Added .gitattributes file, fixing the wrong language classification of the GitHub repository. (Vanessa McHale)
toHaskellFunctiondocumentation. The documentation is now more specific on which Haskell exceptions are caught and which will lead to crashes.