From e96d3938728297e286c8b7ace4a906eaddfebe5d Mon Sep 17 00:00:00 2001
From: Christian Basler <chrigu.meyer@gmail.com>
Date: Thu, 26 Jan 2017 07:31:27 +0100
Subject: [PATCH] Added README.md

---
 README.md | 73 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..adf8605
--- /dev/null
+++ b/README.md
@@ -0,0 +1,73 @@
+msgpack
+=======
+[![Maven Central](https://maven-badges.herokuapp.com/maven-central/ch.dissem.msgpack/msgpack/badge.svg)](https://maven-badges.herokuapp.com/maven-central/ch.dissem.msgpack/msgpack)
+[![Javadoc](https://javadoc-emblem.rhcloud.com/doc/ch.dissem.msgpack/msgpack/badge.svg)](http://www.javadoc.io/doc/ch.dissem.msgpack/msgpack)
+[![Apache 2](https://img.shields.io/badge/license-Apache_2.0-blue.svg)](https://raw.githubusercontent.com/Dissem/Jabit/master/LICENSE)
+
+This is a simple Java library for handling MessagePack data. It doesn't do any object mapping, but maps to special
+objects representing MessagePack types. To build, use command `./gradlew build`.
+
+For most cases you might be better off using `org.msgpack:msgpack`, but I found that I needed something that generically
+represents the internal structure of the data.
+
+msgpack uses Semantic Versioning, meaning as long as the major version doesn't change, nothing should break if you
+update. Be aware though that this doesn't necessarily applies for SNAPSHOT builds and the development branch.
+
+
+Limitations
+--------------
+
+* There is no fallback to BigInteger for large integer type numbers, so there might be an integer overflow when reading
+  too large numbers
+* `MPFloat` uses the data type you're using to decide on precision (float 32 or 64) - not the actual value. E.g. 0.5
+  could be saved perfectly as a float 42, but if you provide a double value, it will be stored as float 64, wasting
+  4 bytes.
+
+Setup
+-----
+
+Add msgpack as Gradle dependency:
+```Gradle
+compile "ch.dissem.msgpack:msgpack:1.0.0"
+```
+
+Usage
+-----
+
+### Serialize Data
+
+First, you'll need to create some msgpack objects to serialize:
+```Java
+MPMap<MPString, MPType<?>> object = new MPMap<>();
+object.put(new MPString("compact"), new MPBoolean(true));
+object.put(new MPString("schema"), new MPInteger(0));
+```
+or the shorthand version for simple types:
+```Java
+import static ch.dissem.msgpack.types.Utils.mp;
+
+MPMap<MPString, MPType<?>> object = new MPMap<>();
+object.put(mp("compact"), mp(true));
+object.put(mp("schema"), mp(0));
+```
+then just use `pack(OutputStream)`:
+```Java
+OutputStream out = ...;
+object.pack(out);
+```
+
+
+### Deserialize Data
+
+For deserializing data there is the reader object:
+```Java
+Reader reader = Reader.getInstance()
+```
+just use `reader.read(InputStream)`. Unfortunately you'll need to make sure you got what you expected, the following
+example might result in `ClassCastException` at weird places:
+```Java
+InputStream in = ...;
+MPType read = reader.read(in);
+MPMap<MPString, MPString> map = (MPMap<MPString, MPString>) read;
+String value = map.get(mp("key")).getValue();
+```
\ No newline at end of file