jansson

Go to file

W. Trevor King 1d513d063a pack_unpack: List unrecognized keys in strict unpacking Otherwise figuring out what's wrong with your JSON can be tricky, especially if you're using a single fmt string to validate a large, complicated schema. The comma delimiting will make separating keys that contain commas difficult. For example: {"foo, bar": true, "baz": false} will generate errors like: 2 object item(s) left unpacked: foo, bar, baz but that seems like a small enough corner case to not be worth much worrying. I wanted to find a way to handle this without have_unrecognized_keys, but the strbuffer tooling makes it look like I shouldn't be reaching in to do things like: strbuffer_t unrecognized_keys; unrecognized_keys.value = NULL; and then using 'unrecognized_keys.value == NULL' in place of have_unrecognized_keys.		2015-12-22 10:05:31 -08:00
android	Update copyrights for 2014	2014-01-28 09:16:05 +02:00
cmake	Buildable with MS Compiler version >= 1900	2015-08-31 23:43:29 +02:00
doc	doc: Fix a broken link	2015-10-20 10:21:08 +03:00
examples	examples/README.rst: Fix formatting	2014-12-30 08:56:07 +02:00
src	pack_unpack: List unrecognized keys in strict unpacking	2015-12-22 10:05:31 -08:00
test	pack_unpack: List unrecognized keys in strict unpacking	2015-12-22 10:05:31 -08:00
.gitignore	SmartOS build fix	2014-04-06 04:28:52 +00:00
.travis.yml	Add support for coverage/coveralls.io in cmake project.	2014-12-12 23:57:01 +01:00
Android.mk	Android.mk: Add -DHAVE_STDINT_H to LOCAL_CFLAGS	2014-07-31 07:50:31 +03:00
appveyor.yml	Added Windows CI support with appveyor	2014-09-24 18:08:45 +02:00
CHANGES	Update CHANGES for 2.7	2014-10-02 08:57:07 +03:00
CleanSpec.mk	Create Android.mk, preconfigured jansson_config.h and CleanSpec.mk for Android-like build systems.	2013-03-27 17:31:05 -07:00
CMakeLists.txt	Compile simple_parse example for CMake project.	2015-01-13 16:17:48 +01:00
configure.ac	Add Makefile.am for examples	2014-12-30 08:50:33 +02:00
jansson.pc.in	Add pkg-config support	2010-01-07 19:30:20 +02:00
LICENSE	Update copyrights for 2014	2014-01-28 09:16:05 +02:00
Makefile.am	Don't use GNU-make specific export for global AM_CFLAGS	2014-08-26 15:01:13 +02:00
README.rst	Add coveralls.io badge to README.rst	2014-12-15 08:14:57 +02:00
release.sh	Compress bz2 doc tarballs with bzip2 instead of gzip	2013-01-06 14:18:28 +02:00

README.rst

Jansson README
==============

.. image:: https://travis-ci.org/akheron/jansson.png
  :target: https://travis-ci.org/akheron/jansson
  
.. image:: https://ci.appveyor.com/api/projects/status/lmhkkc4q8cwc65ko
  :target: https://ci.appveyor.com/project/akheron/jansson

.. image:: https://coveralls.io/repos/akheron/jansson/badge.png?branch=master
  :target: https://coveralls.io/r/akheron/jansson?branch=master

Jansson_ is a C library for encoding, decoding and manipulating JSON
data. Its main features and design principles are:

- Simple and intuitive API and data model

- Comprehensive documentation

- No dependencies on other libraries

- Full Unicode support (UTF-8)

- Extensive test suite

Jansson is licensed under the `MIT license`_; see LICENSE in the
source distribution for details.


Compilation and Installation
----------------------------

If you obtained a source tarball, just use the standard autotools
commands::

   $ ./configure
   $ make
   $ make install

To run the test suite, invoke::

   $ make check

If the source has been checked out from a Git repository, the
./configure script has to be generated first. The easiest way is to
use autoreconf::

   $ autoreconf -i


Documentation
-------------

Documentation is available at http://jansson.readthedocs.org/en/latest/.

The documentation source is in the ``doc/`` subdirectory. To generate
HTML documentation, invoke::

   $ make html

Then, point your browser to ``doc/_build/html/index.html``. Sphinx_
1.0 or newer is required to generate the documentation.


.. _Jansson: http://www.digip.org/jansson/
.. _`MIT license`: http://www.opensource.org/licenses/mit-license.php
.. _Sphinx: http://sphinx.pocoo.org/