4 Jansson_ is a C library for encoding, decoding and manipulating JSON
5 data. Its main features and design principles are:
7 - Simple and intuitive API and data model
9 - Comprehensive documentation
11 - No dependencies on other libraries
13 - Full Unicode support (UTF-8)
15 - Extensive test suite
17 Jansson is licensed under the `MIT license`_; see LICENSE in the
18 source distribution for details.
21 Compilation and Installation
22 ----------------------------
24 If you obtained a source tarball, just use the standard autotools
27 $ ./configure && make && make install
29 If the source has been checked out from a Git repository, the
30 ./configure script has to be generated fist. The easiest way is to use
35 To run the test suite, invoke::
39 Python_ is required to run the tests.
45 Documentation is in the ``doc/`` subdirectory. It's written in
46 reStructuredText_ with Sphinx_ annotations, so reading it in plain may
47 be inconvenient. For this reason, prebuilt HTML documentation is
48 available at http://www.digip.org/jansson/doc/.
50 To generate HTML documentation yourself, invoke::
53 sphinx-build . .build/html
55 ... and point your browser to ``.build/html/index.html``. Sphinx_ is
56 required to generate the documentation.
59 .. _Jansson: http://www.digip.org/jansson/
60 .. _`MIT license`: http://www.opensource.org/licenses/mit-license.php
61 .. _Python: http://www.python.org/
62 .. _reStructuredText: http://docutils.sourceforge.net/rst.html
63 .. _Sphinx: http://sphinx.pocoo.org/