Bump to version 0.4.0

Changes:
  - Improve table vs. array detection
  - Improve packing +-inf
  - Add multiple pack/unpack support
  - Add cmsgpack.safe module variant
  - Add local build infrastructure for easier testing
  - Add user-controlled unpack support limiting returned objects
  - Add Lua 5.3 compatibility
  - Remove an unnecessary malloc
  - Use Lua memory allocator instead of malloc for buffer creation

Issues involved:
  - closes #16 - allow multi pack/unpack by default
  - closes #10 - unpack one/limit API added
  - closes #13 and closes #20 - use Lua allocator
  - closes #15 - (included in #16)
  - ignores #22 because it's confusing
  - closes #23 - fixed elsewhere
  - closes #26 - extracted some useful parts from a difficult commit
  - closes #28 - we started tagging versions again recently
  - closes #27 - that failure case works for me now
  - closes #31 - fix comment typos

I merged commits with original author information where possible, but
each commit required manual cleanup of one or more of:
formatting fixes (no tabs, please), commit message fixes (more details
please), extracting contents from a single 300 line commit with 5
different logical changes merged together, and general correctness
checking after merging with newer code.

As of this commit, all tests pass on Lua 5.1.5 and Lua 5.3-work2.

Author: mattsta

README.md

@@ -2,7 +2,7 @@ README for lua-cmsgpack.c
 ===
 
 Lua-cmsgpack is a [MessagePack](http://msgpack.org) implementation and bindings for
-Lua 5.1/5.2 in a self contained C file without external dependencies.
+Lua 5.1/5.2/5.3 in a self contained C file without external dependencies.
 
 This library is open source software licensed under the BSD two-clause license.
 
@@ -33,10 +33,33 @@ interpreter:
 USAGE
 ---
 
-The exported API is very simple, consisting in two functions:
+The exported API is very simple, consisting of four functions:
 
-    msgpack = cmsgpack.pack(lua_object)
-    lua_object = cmsgpack.unpack(msgpack)
+Basic API:
+
+    msgpack = cmsgpack.pack(lua_object1, lua_object2, ..., lua_objectN)
+    lua_object1, lua_object2, ..., lua_objectN = cmsgpack.unpack(msgpack)
+
+Detailed API giving you more control over unpacking multiple values:
+
+    resume_offset, lua_object1 = cmsgpack.unpack_one(msgpack)
+    resume_offset1, lua_object2 = cmsgpack.unpack_one(msgpack, resume_offset)
+    ...
+    -1, lua_objectN = cmsgpack.unpack_one(msgpack, resume_offset_previous)
+
+    resume_offset, lua_object1, lua_object2 = cmsgpack.unpack_limit(msgpack, 2)
+    resume_offset2, lua_object3 = cmsgpack.unpack_limit(msgpack, 1, resume_offset1)
+
+Functions:
+
+  - `pack(arg1, arg2, ..., argn)` - pack any number of lua objects into one msgpack stream.  returns: msgpack
+  - `unpack(msgpack)` - unpack all objects in msgpack to individual return values. returns: object1, object2, ..., objectN
+  - `unpack_one(msgpack); unpack_one(msgpack, offset)` - unpacks the first object after offset. returns: offset, object
+  - `unpack_limit(msgpack, limit); unpack_limit(msgpack, limit, offset)` - unpacks the first `limit` objects and returns: offset, object1, objet2, ..., objectN (up to limit, but may return fewer than limit if not that many objects remain to be unpacked)
+
+When you reach the end of your input stream with `unpack_one` or `unpack_limit`, an offset of `-1` is returned.
+
+You may `require "msgpack"` or you may `require "msgpack.safe"`.  The safe version returns errors as (nil, errstring).
 
 However because of the nature of Lua numerical and table type a few behavior
 of the library must be well understood to avoid problems:
@@ -50,6 +73,16 @@ maps.
 * When a Lua number is converted to float or double, the former is preferred if there is no loss of precision compared to the double representation.
 * When a MessagePack big integer (64 bit) is converted to a Lua number it is possible that the resulting number will not represent the original number but just an approximation. This is unavoidable because the Lua numerical type is usually a double precision floating point type.
 
+TESTING
+---
+
+Build and test:
+
+    mkdir build; cd build
+    cmake ..
+    make
+    lua ../test.lua
+
 NESTED TABLES
 ---
 Nested tables are handled correctly up to `LUACMSGPACK_MAX_NESTING` levels of

lua_cmsgpack.c

@@ -9,7 +9,7 @@
 
 #define LUACMSGPACK_NAME        "cmsgpack"
 #define LUACMSGPACK_SAFE_NAME   "cmsgpack_safe"
-#define LUACMSGPACK_VERSION     "lua-cmsgpack 0.3.1"
+#define LUACMSGPACK_VERSION     "lua-cmsgpack 0.4.0"
 #define LUACMSGPACK_COPYRIGHT   "Copyright (C) 2012, Salvatore Sanfilippo"
 #define LUACMSGPACK_DESCRIPTION "MessagePack C implementation for Lua"
 
@@ -53,6 +53,7 @@
  * 20-Feb-2012 (ver 0.2.1): Minor bug fixing.
  * 20-Feb-2012 (ver 0.3.0): Module renamed lua-cmsgpack (was lua-msgpack).
  * 04-Apr-2014 (ver 0.3.1): Lua 5.2 support and minor bug fix.
+ * 07-Apr-2014 (ver 0.4.0): Multiple pack/unpack, lua allocator, efficiency.
  * ========================================================================== */
 
 /* -------------------------- Endian conversion --------------------------------

rockspec/lua-cmsgpack-0.4.0-0.rockspec

@@ -0,0 +1,25 @@
+package = "lua-cmsgpack"
+version = "0.4.0-0"
+source = {
+   url = "git://github.com/antirez/lua-cmsgpack.git",
+   tag = "0.4.0"
+}
+description = {
+   summary = "MessagePack C implementation and bindings for Lua 5.1/5.2/5.3",
+   homepage = "http://github.com/antirez/lua-cmsgpack",
+   license = "Two-clause BSD",
+   maintainer = "Salvatore Sanfilippo <[email protected]>"
+}
+dependencies = {
+   "lua >= 5.1"
+}
+build = {
+   type = "builtin",
+   modules = {
+      cmsgpack = {
+         sources = {
+            "lua_cmsgpack.c"
+         }
+      }
+   }
+}