The hslua package

[Tags:library, mit, test]

The Foreign.Lua module is a wrapper of Lua language interpreter as described on lua.org.

This package contains a full Lua interpreter version 5.3.4. If you want to link it with a system-wide Lua installation, use the system-lua flag.

Example programs are available in a separate repository.


[Skip to Readme]

Properties

Versions 0.1, 0.2, 0.3, 0.3.2, 0.3.3, 0.3.4, 0.3.5, 0.3.6, 0.3.6.1, 0.3.7, 0.3.8, 0.3.9, 0.3.10, 0.3.11, 0.3.12, 0.3.13, 0.4.0, 0.4.1, 0.5.0, 0.6.0, 0.7.0, 0.7.1, 0.8.0
Change log CHANGELOG.md
Dependencies base (>=4.7 && <5), bytestring (>=0.10.2 && <0.11), containers (==0.5.*), exceptions (==0.8.*), fail (>=4.9 && <5), mtl (==2.2.*), text [details]
License MIT
Copyright © 2007–2012 Gracjan Polak © 2012–2016 Ömer Sinan Ağacan © 2016–2017 Albert Krewinkel
Author Gracjan Polak, Ömer Sinan Ağacan
Maintainer albert+hslua@zeitkraut.de
Category Foreign
Source repository head: git clone https://github.com/osa1/hslua.git
Uploaded Sun Aug 13 10:17:53 UTC 2017 by tarleb
Distributions Arch:0.4.1, Debian:0.4.1, Fedora:0.4.1, FreeBSD:0.4.0, LTSHaskell:0.4.1, NixOS:0.6.0, Stackage:0.8.0, Tumbleweed:0.4.1
Downloads 64555 total (1321 in the last 30 days)
Votes
1 []
Status Docs available [build log]
Last success reported on 2017-08-13 [all 1 reports]
Hackage Matrix CI

Modules

[Index]

Flags

NameDescriptionDefaultType
system-lua

Use the system-wide Lua instead of the bundled copy.

DisabledAutomatic
apicheck

Compile Lua with -DLUA_USE_APICHECK.

DisabledAutomatic
luajit

Link with LuaJIT. This implies flag system-lua as well.

DisabledAutomatic
lua501

Build against lua 5.1.

DisabledAutomatic
lua502

Build against lua 5.2.

DisabledAutomatic
use-pkgconfig

Build using pkg-config to discover library and include paths. This is only used with system-lua and luajit.

DisabledAutomatic

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

For package maintainers and hackage trustees

Readme for hslua

Readme for hslua-0.7.0

hslua – Lua interpreter interface for Haskell

Build Status Coverage Status Hackage

Hslua provides bindings, wrappers, types, and helper functions to bridge haskell and lua.

Using a different lua version

To use system-wide installed Lua/LuaJIT when linking hslua as a dependency, build/install your package using --constraint="hslua +system-lua" or for LuaJIT: --constraint="hslua +system-lua +luajit". For example, you can install Pandoc with hslua that uses system-wide LuaJIT like this:

cabal install pandoc --constraint="hslua +system-lua +luajit"

FAQ

Where are the coroutine related functions? Yielding from a coroutine works via longjmp, which plays very badly with Haskell's RTS. Tests to get coroutines working with HsLua were unsuccessful. No coroutine related functions are exported from the default module for that reason. However, raw bindings to the C API functions are still provided in Foreign.Lua.RawBindings. If you get coroutines to work, or just believe that there should be wrapper functions for other reasons, we'd love to hear from you.