# bitser

[![Build Status](https://travis-ci.org/gvx/bitser.svg?branch=master)](https://travis-ci.org/gvx/bitser)
[![Coverage Status](https://coveralls.io/repos/github/gvx/bitser/badge.svg?branch=master)](https://coveralls.io/github/gvx/bitser?branch=master)

Serializes and deserializes Lua values with LuaJIT.

    local bitser = require 'bitser'

    bitser.register('someResource', someResource)
    bitser.registerClass(SomeClass)

    serializedData = bitser.dumps(someData)
    someData = bitser.loads(serializedData)

Pull requests, bug reports and other feedback welcome! :heart:

## 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](https://github.com/bakpakin/binser), which is great.

## How do I use the benchmark thingy?

Download zero or more of [binser.lua](https://github.com/bakpakin/binser/master/binser.lua),
[ser.lua](https://github.com.com/gvx/Ser/master/ser.lua),
[smallfolk.lua](https://github.com/gvx/Smallfolk/raw/master/smallfolk.lua) and
[serpent.lua](https://github.com/pkulchenko/serpent/raw/master/src/serpent.lua), and run:

    love .

You do need [LÖVE](https://love2d.org/) 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 MiddleClass, SECL, hump.class and Slither (and
probably some other class libraries by accident).

## What license is this under?

None yet. It will be open source (probably MIT license) in the near future, but it
needs more testing before it's production ready.