= rufus-lua

Lua embedded in Ruby, via Ruby FFI

Tested with Ruby 1.8.6, Ruby 1.9.1p0 and JRuby 1.1.6


== Lua

from

http://www.lua.org/
http://www.lua.org/about.html

"""
Lua is a powerful, fast, lightweight, embeddable scripting language.

Lua combines simple procedural syntax with powerful data description constructs based on associative arrays and extensible semantics. Lua is dynamically typed, runs by interpreting bytecode for a register-based virtual machine, and has automatic memory management with incremental garbage collection, making it ideal for configuration, scripting, and rapid prototyping.
"""


== other Ruby and Lua bridges / connectors


http://rubyluabridge.rubyforge.org/
http://raa.ruby-lang.org/project/ruby-lua


== using rufus-lua

If you don't have liblua.dylib on your system, scroll until "compiling liblua.dylib" to learn how to get it.

sudo gem install rufus-lua

then

require 'rubygems'
require 'rufus/lua'

s = Rufus::Lua::State.new

puts s.eval("return table.concat({ 'hello', 'from', 'Lua' }, ' ')")
#
# => "Hello from Lua"

s.close

rufus-lua's rdoc is at http://rufus.rubyforge.org/rufus-lua/


== compiling liblua.dylib

original instructions by Adrian Perez at :

http://lua-users.org/lists/lua-l/2006-09/msg00894.html

get the source at

http://www.lua.org/ftp/lua-5.1.4.tar.gz

then

tar xzvf lua-5.1.4.tar.gz
cd lua-5.1.4

modify the file src/Makefile as per http://lua-users.org/lists/lua-l/2006-09/msg00894.html

make
make masocx # or make linux ...
make -C src src liblua.dylib

sudo cp src/liblua.dylib /usr/local/lib/


== build dependencies

You need to add the github gems to your gem sources
gem sources -a http://gems.github.com

The following gems are needed to run the specs
mislav-hanna
install bacon


== dependencies

the ruby gem 'ffi'


== mailing list

On the rufus-ruby list :

http://groups.google.com/group/rufus-ruby


== issue tracker

http://rubyforge.org/tracker/?atid=18584&group_id=4812&func=browse


== irc

irc.freenode.net #ruote


== source

http://github.com/jmettraux/rufus-lua

git clone git://github.com/jmettraux/rufus-lua.git


== credits

many thanks to the authors of Ruby FFI, and of Lua

http://kenai.com/projects/ruby-ffi/
http://lua.org/


== authors

John Mettraux, [email protected], http://jmettraux.wordpress.com
Alain Hoang, http://blogs.law.harvard.edu/hoanga/


== the rest of Rufus

http://rufus.rubyforge.org


== license

MIT

Lua itself is licensed under the MIT license as well :

http://www.lua.org/license.html