From 7bb1d1808c42bbb20db2e095d566a881f7bcffef Mon Sep 17 00:00:00 2001
From: Kenneth Reitz <me@kennethreitz.com>
Date: Mon, 21 Feb 2011 14:03:23 -0500
Subject: [PATCH] GitHub-like readmes

---
 README.rst | 59 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 README.rst

diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..ef8eaa1
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,59 @@
+##############################
+anyjson - JSON library wrapper
+##############################
+
+Overview
+--------
+
+Anyjson loads whichever is the fastest JSON module installed and provides
+a uniform API regardless of which JSON implementation is used.
+
+Originally part of carrot (http://github.com/ask/carrot/)
+
+Examples
+--------
+
+To serialize a python object to a JSON string, call the `serialize` function:
+
+>>> import anyjson
+>>> anyjson.serialize(["test", 1, {"foo": 3.141592}, "bar"])
+'["test", 1, {"foo": 3.141592}, "bar"]'
+
+Conversion the other way is done with the `deserialize` call.
+
+>>> anyjson.deserialize("""["test", 1, {"foo": 3.141592}, "bar"]""")
+['test', 1, {'foo': 3.1415920000000002}, 'bar']
+
+Regardless of the JSON implementation used, the exceptions will be the same.
+This means that trying to serialize something not compatible with JSON
+raises a TypeError:
+
+>>> anyjson.serialize([object()])
+Traceback (most recent call last):
+  <snipped traceback>
+TypeError: object is not JSON encodable
+
+And deserializing a JSON string with invalid JSON raises a ValueError:
+
+>>> anyjson.deserialize("""['missing square brace!""")
+Traceback (most recent call last):
+  <snipped traceback>
+ValueError: cannot parse JSON description
+
+
+Contact
+-------
+
+The module is maintaned by Rune F. Halvorsen <runefh@gmail.com>.
+The project resides at http://bitbucket.org/runeh/anyjson . Bugs and feature
+requests can be submitted there. Patches are also very welcome.
+
+Changelog
+---------
+
+See CHANGELOG file
+
+License
+-------
+
+see the LICENSE file