ffilupa 3.0.1

For Python Users

$ pip install git+https://github.com/TitanSnow/ffilupa.git

For Lua Users

Make sure you have installed luarocks.

$ git clone https://github.com/TitanSnow/ffilupa.git
$ cd ffilupa
$ luarocks make

How to deal with the exception ‘Required lua lib not found’?

Please check the installation of Lua. ffilupa currently only supports Lua 5.2 and 5.3. Then reinstall ffilupa in order to find the recently installed Lua libraries.

Does ffilupa support Windows?

ffilupa can support Windows, but not now. It might support Windows in next minor release.

A Brief Look

>>> import ffilupa
>>> lua = ffilupa.LuaRuntime()
>>> lua_func = lua.eval('''
...     function(a, b) -- a plus b
...         return a + b
...     end
... ''')
>>> lua_func(22, 33)
55

Access Globals of Lua

>>> def greeting(name='World'): # greeting someone
...     print('Hello, {}!'.format(name))
>>> lua._G.greeting = greeting
>>> lua.execute('greeting()')
Hello, World!
>>> lua.execute('greeting("John")')
Hello, John!

Zero-copy Data Sharing

>>> poem = {
...     'the': 'quick',
...     'brown': 'fox',
...     'jumps': 'over',
... }
>>> lua_func = lua.eval('''
...     function(poem) -- finish the poem
...         poem['lazy'] = 'doges'
...     end
... ''')
>>> lua_func(poem)
>>> poem['lazy']
'doges'

Deal with Lua Table

>>> table = lua.table_from(poem)
>>> lua_func = lua.eval('''
...     function(poem) -- shuffle the poem
...         local new_poem = {}
...         for k, v in pairs(poem) do
...             new_poem[v] = k
...         end
...         return new_poem
...     end
... ''')
>>> new_poem = lua_func(table)
>>> for k in sorted(new_poem):
...     print(k, new_poem[k], end=' ')
doges lazy fox brown over jumps quick the

A Brief Look

ffilupa = require 'ffilupa'
Fraction = ffilupa.import_module('fractions').Fraction
a = Fraction(1, 2)
b = Fraction(1, 3)
c = a + b    -- c == 5/6

Extend Lua’s Abilities

Path = ffilupa.import_module('pathlib').Path
p = Path('.')
p = p / 'ffilupa'
for _, filename in pairs(p:iterdir()) do
    print(filename)    -- print all filename in ./ffilupa
end