lua-msgpack

This is a simple implementation of MessagePack for Lua.

MessagePack is a very simple and powerful serialization format for many platforms and languages.

lua-msgpack runs almost same as: luajit-msgpack, luajit-msgpack-pure, but it doesn't require LuaJIT and FFI, nor any native libs. Only requires Lua 5.1 runtime.

Why

Now Moai SDK isn't based on LuaJIT so I had to delete dependencies on LuaJIT. Special thanks to luajit-msgpack-pure! Tests are almost same as its.

Usage

In your app:

local mp = require( "msgpack" )
local tbl = { a=123, b="any", c={"ta","bl","e",1,2,3} }
local packed = mp.pack(tbl)
local unpacked_table = mp.unpack(packed)

On Moai and Lua5.1, put luabit.lua and msgpack.lua in your project directory. On LuaJIT, you need only msgpack.lua.

Compatibility

Tested on lua5.1, luajit2-beta8, Moai beta 0.8

Limitations

Currently int64, uint64, float types are not implemented. these types are converted into double.
Performance. It runs about 20x ~ 1000x slower than luajit-msgpack-pure, so don't usable for server side, but it's totally enough for client-side game dev.

For details, try bench.lua for benchmarking:

luajit2:

empty	0.0029920000000001	sec	1671122.9946523	times/sec
iary1	0.006181	sec	808930.59375506	times/sec
iary10	0.024651	sec	202831.52813273	times/sec
iary100	0.019591	sec	25521.923332142	times/sec
iary1000	0.027691	sec	1805.6408219277	times/sec
iary10000	0.038497	sec	129.88025040912	times/sec
dary1	0.001633	sec	61236.987140233	times/sec
dary10	0.0049349999999999	sec	10131.712259372	times/sec
dary100	0.0066330000000001	sec	753.80672395597	times/sec
dary1000	0.053496	sec	93.46493195753	times/sec
str1	0.011589	sec	431443.61032013	times/sec
str10	0.008448	sec	591856.06060606	times/sec
str100	0.014457	sec	345853.21989348	times/sec
str1000	0.014576	sec	343029.6377607	times/sec
str10000	0.0046630000000001	sec	107227.10701265	times/sec
str20000	0.0087540000000002	sec	57116.746630111	times/sec
str30000	0.012676	sec	39444.619753866	times/sec
str40000	0.002127	sec	23507.28725905	times/sec
str80000	0.0042070000000001	sec	11884.953648681	times/sec

moai sdk:

empty	0.019725	sec	253485.42458808	times/sec
iary1	0.034026	sec	146946.45271263	times/sec
iary10	0.15399	sec	32469.640885772	times/sec
iary100	0.117005	sec	4273.3216529208	times/sec
iary1000	0.147932	sec	337.99313197956	times/sec
iary10000	0.198838	sec	25.146098834227	times/sec
dary1	0.272365	sec	367.15437005489	times/sec
dary10	1.207196	sec	41.418294957902	times/sec
dary100	1.230383	sec	4.0637752634749	times/sec
dary1000	12.397338	sec	0.40331238851437	times/sec
str1	0.054717	sec	91379.278834731	times/sec
str10	0.044854000000001	sec	111472.77834753	times/sec
str100	0.053418999999998	sec	93599.655553271	times/sec
str1000	0.048525999999999	sec	103037.54688209	times/sec
str10000	0.0071469999999998	sec	69959.423534352	times/sec
str20000	0.010031999999999	sec	49840.510366831	times/sec
str30000	0.0091239999999999	sec	54800.526085051	times/sec
str40000	0.0011280000000014	sec	44326.241134699	times/sec
str80000	0.0017399999999981	sec	28735.63218394	times/sec

on mac book pro i5 2.53GHz.

TODO

int64, uint64, float

License

Apache License 2.0. see LICENSE.txt.

orswn / lua-msgpack