c0b0e12dce
"Pray I do not alter it any further." On a serious note, I could not find a good reason to keep the old behaviour. It was niche at best, and class libraries tend to ultimately depend on `setmetatable` anyway, which just returns the original table, which has been mutated. Now the return value of `deserializer` is simply ignored, and it is presumed the original table *is* the instance. |
||
|---|---|---|
| cases | ||
| examples | ||
| rockspecs | ||
| spec | ||
| .gitignore | ||
| bitser.lua | ||
| conf.lua | ||
| EXTENSION_API.md | ||
| LICENSE.txt | ||
| main.lua | ||
| README.md | ||
| setuptest.sh | ||
| test.sh | ||
| USAGE.md | ||
bitser
Serializes and deserializes Lua values with LuaJIT.
local bitser = require 'bitser'
bitser.register('someResource', someResource)
bitser.registerClass(SomeClass)
serializedString = bitser.dumps(someValue)
someValue = bitser.loads(serializedString)
Documentation can be found in USAGE.md.
Pull requests, bug reports and other feedback welcome! ❤️
Bitser is released under the ISC license (functionally equivalent to the BSD 2-Clause and MIT licenses).
Please note that bitser requires LuaJIT for its ffi library and JIT compilation. Without JIT, it may or may not run, but it will be much slower than usual. This primarily affects Android and iOS, because JIT is disabled on those platforms.
⚠️ bitser is not endian-safe. If you intend to share serialized data across computers, please make sure they share endianness making sure ffi.abi 'le' has the same value on both the sending and receiving machine, or use another serialization library.
Why would I use this?
Because it's fast. Because it produces tiny output. Because the name means "snappier" or "unfriendlier" in Dutch. Because it's safe to use with untrusted data.
Because it's inspired by binser, which is great.
How do I use the benchmark thingy?
Download zero or more of binser.lua, ser.lua, smallfolk.lua, serpent.lua and MessagePack.lua, and run:
love .
You do need LÖVE for that.
You can add more cases in the folder cases/ (check out _new.lua), and add other
serializers to the benchmark in main.lua. If you do either of those things, please
send me a pull request!
You can register classes?
Yes. At the moment, bitser supports classes created using MiddleClass, SECL, hump.class, Slither, Moonscript and Classic (and probably some other class libraries by accident).