organicmaps/jansson
13
Fork 0
mirror of https://github.com/akheron/jansson.git synced 2025-04-05 21:45:04 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions

Merge branch 'master' into c++-docs

Browse source
This commit is contained in:
Sean Middleditch 2010-02-09 17:27:46 -08:00
commit ca97184080
41 changed files with 1029 additions and 856 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
doc/apiref.rst
View file

@ -493,6 +493,16 @@ The following functions implement an iteration protocol for objects:
Returns an opaque iterator which can be used to iterate over all
key-value pairs in *object*, or *NULL* if *object* is empty.
.. cfunction:: void *json_object_iter_at(json_t *object, const char *key)
Like :cfunc:`json_object_iter()`, but returns an iterator to the
key-value pair in *object* whose key is equal to *key*, or NULL if
*key* is not found in *object*. Iterating forward to the end of
*object* only yields all key-value pairs of the object if *key*
happens to be the first key in the underlying hash table.
.. versionadded:: 1.3
.. cfunction:: void *json_object_iter_next(json_t *object, void *iter)
Returns an iterator pointing to the next key-value pair in *object*
@ -509,6 +519,21 @@ The following functions implement an iteration protocol for objects:
Extract the associated value from *iter*.
.. cfunction:: int json_object_iter_set(json_t *object, void *iter, json_t *value)
Set the value of the key-value pair in *object*, that is pointed to
by *iter*, to *value*.
.. versionadded:: 1.3
.. cfunction:: int json_object_iter_set_new(json_t *object, void *iter, json_t *value)
Like :cfunc:`json_object_iter_set()`, but steals the reference to
*value*. This is useful when *value* is newly created and not used
after the call.
.. versionadded:: 1.3
The iteration protocol can be used for example as follows::
/* obj is a JSON object */

2
doc/conf.py
View file

@ -43,7 +43,7 @@ master_doc = 'index'
# General information about the project.
project = u'Jansson'
copyright = u'2009, Petri Lehtinen'
copyright = u'2009, 2010 Petri Lehtinen'
# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the

2
doc/ext/refcounting.py
View file

@ -19,7 +19,7 @@
<description of the json_object function>
:copyright: Copyright 2009 Petri Lehtinen <petri@digip.org>
:copyright: Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
:license: MIT, see LICENSE for details.
"""

2
doc/github_commits.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
src/Makefile.am
View file

@ -1,4 +1,4 @@
include_HEADERS = jansson.h jansson.hpp jansson-impl.hpp
include_HEADERS = jansson.h jansson.hpp jansson.ipp
lib_LTLIBRARIES = libjansson.la
libjansson_la_SOURCES = \

2
src/dump.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

28
src/hashtable.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* This library is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.
@ -318,6 +318,22 @@ void *hashtable_iter(hashtable_t *hashtable)
return hashtable_iter_next(hashtable, &hashtable->list);
}
void *hashtable_iter_at(hashtable_t *hashtable, const void *key)
{
pair_t *pair;
unsigned int hash;
bucket_t *bucket;
hash = hashtable->hash_key(key);
bucket = &hashtable->buckets[hash % num_buckets(hashtable)];
pair = hashtable_find_pair(hashtable, bucket, key, hash);
if(!pair)
return NULL;
return &pair->list;
}
void *hashtable_iter_next(hashtable_t *hashtable, void *iter)
{
list_t *list = (list_t *)iter;
@ -337,3 +353,13 @@ void *hashtable_iter_value(void *iter)
pair_t *pair = list_to_pair((list_t *)iter);
return pair->value;
}
void hashtable_iter_set(hashtable_t *hashtable, void *iter, void *value)
{
pair_t *pair = list_to_pair((list_t *)iter);
if(hashtable->free_value)
hashtable->free_value(pair->value);
pair->value = value;
}

21
src/hashtable.h
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* This library is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.
@ -160,6 +160,17 @@ void hashtable_clear(hashtable_t *hashtable);
*/
void *hashtable_iter(hashtable_t *hashtable);
/**
* hashtable_iter - Return an iterator at a specific key
*
* @hashtable: The hashtable object
* @key: The key that the iterator should point to
*
* Like hashtable_iter() but returns an iterator pointing to a
* specific key.
*/
void *hashtable_iter_at(hashtable_t *hashtable, const void *key);
/**
* hashtable_iter_next - Advance an iterator
*
@ -185,4 +196,12 @@ void *hashtable_iter_key(void *iter);
*/
void *hashtable_iter_value(void *iter);
/**
* hashtable_iter_set - Set the value pointed by an iterator
*
* @iter: The iterator
* @value: The value to set
*/
void hashtable_iter_set(hashtable_t *hashtable, void *iter, void *value);
#endif

469
src/jansson-impl.hpp
View file

@ -1,469 +0,0 @@
// Copyright (c) 2010 Sean Middleditch <sean@middleditch.us>
//
// Jansson is free software; you can redistribute it and/or modify
// it under the terms of the MIT license. See LICENSE for details.
#if !defined(IN_JANSSON_HPP)
# error "jansson-impl.hpp may only by included from jansson.hpp"
#endif
namespace json {
namespace _private {
// assignment operator
template <typename _Base>
ValueBase<_Base>& ValueBase<_Base>::operator=(const Value& value) {
_Base::operator=(value);
return *this;
}
// check value type
template <typename _Base>
bool ValueBase<_Base>::is_undefined() const {
return _Base::as_json() == 0;
}
template <typename _Base>
bool ValueBase<_Base>::is_object() const {
return json_is_object(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_array() const {
return json_is_array(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_string() const {
return json_is_string(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_integer() const {
return json_is_integer(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_real() const {
return json_is_real(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_number() const {
return json_is_number(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_true() const {
return json_is_true(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_false() const {
return json_is_false(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_boolean() const {
return json_is_boolean(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_null() const {
return json_is_null(_Base::as_json());
}
// get size of array or object
template <typename _Base>
unsigned int ValueBase<_Base>::size() const {
if (is_object())
return json_object_size(_Base::as_json());
else
return json_array_size(_Base::as_json());
}
// get value at array index (const version)
template <typename _Base>
const Value ValueBase<_Base>::at(unsigned int index) const {
return Value(json_array_get(_Base::as_json(), index));
}
template <typename _Base>
const Value ValueBase<_Base>::operator[](signed int index) const { return at(index); }
template <typename _Base>
const Value ValueBase<_Base>::operator[](unsigned int index) const { return at(index); }
template <typename _Base>
const Value ValueBase<_Base>::operator[](signed short index) const { return at(index); }
template <typename _Base>
const Value ValueBase<_Base>::operator[](unsigned short index) const { return at(index); }
template <typename _Base>
const Value ValueBase<_Base>::operator[](signed long index) const { return at(index); }
template <typename _Base>
const Value ValueBase<_Base>::operator[](unsigned long index) const { return at(index); }
// get value at array index (non-const version)
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::at(unsigned int index) {
return ElementProxy(_Base::as_json(), index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](signed int index) {
return at(index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](unsigned int index) {
return at(index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](signed short index) {
return at(index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](unsigned short index) {
return at(index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](signed long index) {
return at(index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](unsigned long index) {
return at(index);
}
// get object property (const version)
template <typename _Base>
const Value ValueBase<_Base>::get(const char* key) const {
return Value(json_object_get(_Base::as_json(), key));
}
template <typename _Base>
const Value ValueBase<_Base>::get(const std::string& key) const {
return get(key.c_str());
}
template <typename _Base>
const Value ValueBase<_Base>::operator[](const char* key) const {
return get(key);
}
template <typename _Base>
const Value ValueBase<_Base>::operator[](const std::string& key) const {
return get(key.c_str());
}
// get object property (non-const version)
template <typename _Base>
ValueBase<PropertyProxy> ValueBase<_Base>::get(const char* key) {
return PropertyProxy(_Base::as_json(), key);
}
template <typename _Base>
ValueBase<PropertyProxy> ValueBase<_Base>::get(const std::string& key) {
return get(key.c_str());
}
template <typename _Base>
ValueBase<PropertyProxy> ValueBase<_Base>::operator[](const char* key) {
return get(key);
}
template <typename _Base>
ValueBase<PropertyProxy> ValueBase<_Base>::operator[](const std::string& key) {
return get(key.c_str());
}
// clear all array/object values
template <typename _Base>
void ValueBase<_Base>::clear() {
if (is_object())
json_object_clear(_Base::as_json());
else
json_array_clear(_Base::as_json());
}
// get value cast to specified type
template <typename _Base>
const char* ValueBase<_Base>::as_cstring() const {
return json_string_value(_Base::as_json());
}
template <typename _Base>
std::string ValueBase<_Base>::as_string() const {
const char* tmp = as_cstring();
return tmp == 0 ? "" : tmp;
}
template <typename _Base>
int ValueBase<_Base>::as_integer() const {
return json_integer_value(_Base::as_json());
}
template <typename _Base>
double ValueBase<_Base>::as_real() const {
return json_real_value(_Base::as_json());
}
template <typename _Base>
double ValueBase<_Base>::as_number() const {
return json_number_value(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::as_boolean() const {
return is_true();
}
// set an object property (converts value to object is not one already)
template <typename _Base>
_Base& ValueBase<_Base>::set_key(const char* key, const Value& value) {
json_object_set(_Base::as_json(), key, value._Base::as_json());
return *this;
}
template <typename _Base>
_Base& ValueBase<_Base>::set_key(const std::string& key, const Value& value) {
return set_key(key.c_str(), value);
}
// set an array index (converts value to object is not one already)
template <typename _Base>
_Base& ValueBase<_Base>::set_at(unsigned int index, const Value& value) {
if (index == size())
json_array_append(_Base::as_json(), value._Base::as_json());
else
json_array_set(_Base::as_json(), index, value._Base::as_json());
return *this;
}
// delete an object key
template <typename _Base>
_Base& ValueBase<_Base>::del_key(const char* key) {
json_object_del(_Base::as_json(), key);
return *this;
}
template <typename _Base>
_Base& ValueBase<_Base>::del_key(const std::string& key) {
return del_key(key.c_str());
}
// delete an item from an array by index
template <typename _Base>
_Base& ValueBase<_Base>::del_at(unsigned int index) {
json_array_remove(_Base::as_json(), index);
return *this;
}
// insert an item into an array at a given index
template <typename _Base>
_Base& ValueBase<_Base>::insert_at(unsigned int index, const Value& value) {
json_array_insert(_Base::as_json(), index, value._Base::as_json());
return *this;
}
// write the value to a file
template <typename _Base>
int ValueBase<_Base>::save_file(const char* path, int flags) const {
return json_dump_file(_Base::as_json(), path, flags);
}
// write the value to a string (caller must deallocate with free()!)
template <typename _Base>
char* ValueBase<_Base>::save_string(int flags) const {
return json_dumps(_Base::as_json(), flags);
}
Basic::~Basic() {
json_decref(_value);
}
// copy an existing Value
Basic& Basic::operator=(const Basic& e) {
if (&e != this) {
json_decref(_value);
_value = json_incref(e._value);
}
return *this;
}
// get the underlying json_t
json_t* Basic::as_json() const {
return _value;
}
// take ownership of a json_t (does not increase reference count)
Basic Basic::take_ownership(json_t* json) {
Basic v;
v._value = json;
return v;
}
// assign value to proxied array element
ElementProxy& ElementProxy::operator=(const Value& value) {
json_array_set(_array, _index, value.as_json());
return *this;
}
// get the proxied element
json_t* ElementProxy::as_json() const {
return json_array_get(_array, _index);
}
// assign value to proxied object property
PropertyProxy& PropertyProxy::operator=(const Value& value) {
json_object_set(_object, _key, value.as_json());
return *this;
}
json_t* PropertyProxy::as_json() const {
return json_object_get(_object, _key);
}
} // namespace json::_private
// construct Value::Value input
Value::Value(const char* value) {
_value = json_string(value);
}
Value::Value(const std::string& value) {
_value = json_string(value.c_str());
}
Value::Value(bool value) {
_value = value ? json_true() : json_false();
}
Value::Value(signed int value) {
_value = json_integer(value);
}
Value::Value(unsigned int value) {
_value = json_integer(value);
}
Value::Value(signed short value) {
_value = json_integer(value);
}
Value::Value(unsigned short value) {
_value = json_integer(value);
}
Value::Value(signed long value) {
_value = json_integer(value);
}
Value::Value(unsigned long value) {
_value = json_integer(value);
}
Value::Value(float value) {
_value = json_real(value);
}
Value::Value(double value) {
_value = json_real(value);
}
// construct a new iterator for a given object
Iterator::Iterator(const Value& value) : _object(value), _iter(0) {
_iter = json_object_iter(_object.as_json());
}
// construct a new iterator for a given object
Iterator::Iterator(const _private::ValueBase<_private::PropertyProxy>& value) :
_object(value.as_json()), _iter(0) {
_iter = json_object_iter(_object.as_json());
}
// increment iterator
void Iterator::next() {
_iter = json_object_iter_next(_object.as_json(), _iter);
}
Iterator& Iterator::operator++() { next(); return *this; }
// test if iterator is still valid
bool Iterator::valid() const {
return _iter != 0;
}
Iterator::operator bool() const {
return valid();
}
// get key
const char* Iterator::ckey() const {
return json_object_iter_key(_iter);
}
std::string Iterator::key() const {
return ckey();
}
// get value
const Value Iterator::value() const {
return Value(json_object_iter_value(_iter));
}
// dereference value
const Value Iterator::operator*() const {
return value();
}
// create a new empty object
Value object() {
return Value::take_ownership(json_object());
}
// create a new empty array
Value array() {
return Value::take_ownership(json_array());
}
// create a new null value
Value null() {
return Value::take_ownership(json_null());
}
// load a file as a JSON value
Value load_file(const char* path, json_error_t* error) {
return Value::take_ownership(json_load_file(path, error));
}
// load a string as a JSON value
Value load_string(const char* string, json_error_t* error) {
return Value::take_ownership(json_loads(string, error));
}
} // namespace json
// stream JSON value out
std::ostream& operator<<(std::ostream& os, const json::Value& value) {
// get the temporary serialize string
char* tmp = value.save_string();
if (tmp != 0) {
// stream temp string out and release it
os << tmp;
free(tmp);
}
return os;
}
// read JSON value
std::istream& operator>>(std::istream& is, json::Value& value) {
// buffer the remaining bytes into a single string for Jansson
std::stringstream tmp;
while (is)
tmp << static_cast<char>(is.get());
// parse the buffered string
value = json::load_string(tmp.str().c_str());
return is;
}

10
src/jansson.h
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.
@ -83,9 +83,11 @@ int json_object_del(json_t *object, const char *key);
int json_object_clear(json_t *object);
int json_object_update(json_t *object, json_t *other);
void *json_object_iter(json_t *object);
void *json_object_iter_at(json_t *object, const char *key);
void *json_object_iter_next(json_t *object, void *iter);
const char *json_object_iter_key(void *iter);
json_t *json_object_iter_value(void *iter);
int json_object_iter_set_new(json_t *object, void *iter, json_t *value);
static inline
int json_object_set(json_t *object, const char *key, json_t *value)
@ -99,6 +101,12 @@ int json_object_set_nocheck(json_t *object, const char *key, json_t *value)
return json_object_set_new_nocheck(object, key, json_incref(value));
}
static inline
int json_object_iter_set(json_t *object, void *iter, json_t *value)
{
return json_object_iter_set_new(object, iter, json_incref(value));
}
unsigned int json_array_size(const json_t *array);
json_t *json_array_get(const json_t *array, unsigned int index);
int json_array_set_new(json_t *array, unsigned int index, json_t *value);

463
src/jansson.hpp
View file

@ -1,293 +1,302 @@
// Copyright (c) 2010 Sean Middleditch <sean@middleditch.us>
// Copyright (c) 2010 Petri Lehtinen <petri@digip.org>
//
// Jansson is free software; you can redistribute it and/or modify
// it under the terms of the MIT license. See LICENSE for details.
#if !defined(JANSSON_HPP)
#define JANSSON_HPP 1
#ifndef JANSSON_HPP
#define JANSSON_HPP
#include <string>
#include <ostream>
#include <istream>
#include <sstream>
// Included so that standard functions don't end up in namespace json
#include <cstdio>
// For free()
#include <cstdlib>
namespace json {
// include Jansson C library into the json namespace
#include <jansson.h>
class Iterator;
class Value;
// implementation details; do not use directly
namespace _private {
class ElementProxy;
class PropertyProxy;
// include Jansson C library into the json namespace
# include <jansson.h>
class Iterator;
class Value;
// implementation details; do not use directly
namespace detail {
class ElementProxy;
class PropertyProxy;
// base class for JSON value interface
template <typename _Base>
class ValueBase : public _Base {
public:
// empty constructor
ValueBase() : _Base() {}
// copy constructor
ValueBase(const _Base& base) : _Base(base) {}
// create reference to value
ValueBase(json_t* json) : _Base(json) {}
// assignment operator
inline ValueBase& operator=(const Value& value);
// base class for JSON value interface
template <typename _Base>
class ValueBase : public _Base {
public:
// empty constructor
ValueBase() : _Base() {}
// copy constructor
ValueBase(const _Base& base) : _Base(base) {}
// create reference to value
ValueBase(json_t* json) : _Base(json) {}
// assignment operator
inline ValueBase& operator=(const Value& value);
// check value type
inline bool is_undefined() const;
inline bool is_object() const;
inline bool is_array() const;
inline bool is_string() const;
inline bool is_integer() const;
inline bool is_real() const;
inline bool is_number() const;
inline bool is_true() const;
inline bool is_false() const;
inline bool is_boolean() const;
inline bool is_null() const;
// check value type
inline bool is_undefined() const;
inline bool is_object() const;
inline bool is_array() const;
inline bool is_string() const;
inline bool is_integer() const;
inline bool is_real() const;
inline bool is_number() const;
inline bool is_true() const;
inline bool is_false() const;
inline bool is_boolean() const;
inline bool is_null() const;
// get size of array or object
inline unsigned int size() const;
// get size of array or object
inline unsigned int size() const;
// get value at array index (const version)
inline const Value at(unsigned int index) const;
// get value at array index (const version)
inline const Value at(unsigned int index) const;
inline const Value operator[](signed int index) const;
inline const Value operator[](unsigned int index) const;
inline const Value operator[](signed short index) const;
inline const Value operator[](unsigned short index) const;
inline const Value operator[](signed long index) const;
inline const Value operator[](unsigned long index) const;
inline const Value operator[](signed int index) const;
inline const Value operator[](unsigned int index) const;
inline const Value operator[](signed short index) const;
inline const Value operator[](unsigned short index) const;
inline const Value operator[](signed long index) const;
inline const Value operator[](unsigned long index) const;
// get value at array index (non-const version)
inline ValueBase<ElementProxy> at(unsigned int index);
// get value at array index (non-const version)
inline ValueBase<ElementProxy> at(unsigned int index);
inline ValueBase<ElementProxy> operator[](signed int index);
inline ValueBase<ElementProxy> operator[](unsigned int index);
inline ValueBase<ElementProxy> operator[](signed short index);
inline ValueBase<ElementProxy> operator[](unsigned short index);
inline ValueBase<ElementProxy> operator[](signed long index);
inline ValueBase<ElementProxy> operator[](unsigned long index);
inline ValueBase<ElementProxy> operator[](signed int index);
inline ValueBase<ElementProxy> operator[](unsigned int index);
inline ValueBase<ElementProxy> operator[](signed short index);
inline ValueBase<ElementProxy> operator[](unsigned short index);
inline ValueBase<ElementProxy> operator[](signed long index);
inline ValueBase<ElementProxy> operator[](unsigned long index);
// get object property (const version)
inline const Value get(const char* key) const;
// get object property (const version)
inline const Value get(const char* key) const;
inline const Value get(const std::string& key) const;
inline const Value operator[](const char* key) const;
inline const Value operator[](const std::string& key) const;
inline const Value get(const std::string& key) const;
inline const Value operator[](const char* key) const;
inline const Value operator[](const std::string& key) const;
// get object property (non-const version)
inline ValueBase<PropertyProxy> get(const char* key);
// get object property (non-const version)
inline ValueBase<PropertyProxy> get(const char* key);
inline ValueBase<PropertyProxy> get(const std::string& key);
inline ValueBase<PropertyProxy> operator[](const char* key);
inline ValueBase<PropertyProxy> operator[](const std::string& key);
inline ValueBase<PropertyProxy> get(const std::string& key);
inline ValueBase<PropertyProxy> operator[](const char* key);
inline ValueBase<PropertyProxy> operator[](const std::string& key);
// clear all array/object values
inline void clear();
// clear all array/object values
inline void clear();
// get value cast to specified type
inline const char* as_cstring() const;
inline std::string as_string() const;
inline int as_integer() const;
inline double as_real() const;
inline double as_number() const;
inline bool as_boolean() const;
// get value cast to specified type
inline const char* as_cstring() const;
inline std::string as_string() const;
inline int as_integer() const;
inline double as_real() const;
inline double as_number() const;
inline bool as_boolean() const;
// set an object property (converts value to object is not one already)
inline _Base& set_key(const char* key, const Value& value);
// set an object property (converts value to object is not one already)
inline _Base& set_key(const char* key, const Value& value);
inline _Base& set_key(const std::string& key, const Value& value);
// set an array index (converts value to object is not one already)
inline _Base& set_at(unsigned int index, const Value& value);
// delete an object key
inline _Base& del_key(const char* key);
inline _Base& del_key(const std::string& key);
// delete an item from an array by index
inline _Base& del_at(unsigned int index);
// insert an item into an array at a given index
inline _Base& insert_at(unsigned int index, const Value& value);
// write the value to a file
inline int save_file(const char* path, int flags = 0) const;
// write the value to a string (caller must deallocate with free()!)
inline char* save_string(int flags = 0) const;
};
// represents any JSON value, private base
class Basic {
public:
// construct new Value with an undefined value
Basic() : _value(0) {}
// copy constructor
Basic(const Basic& value) : _value(json_incref(value._value)) {}
// make a reference to an existing json_t value
explicit Basic(json_t* value) : _value(json_incref(value)) {}
// free Value resources
inline ~Basic();
// copy an existing Value
inline Basic& operator=(const Basic& e);
// get the underlying json_t
inline json_t* as_json() const;
inline _Base& set_key(const std::string& key, const Value& value);
// set an array index (converts value to object is not one already)
inline _Base& set_at(unsigned int index, const Value& value);
// delete an object key
inline _Base& del_key(const char* key);
inline _Base& del_key(const std::string& key);
// delete an item from an array by index
inline _Base& del_at(unsigned int index);
// insert an item into an array at a given index
inline _Base& insert_at(unsigned int index, const Value& value);
// write the value to a file
inline int dump_file(const char* path, int flags = 0) const;
inline int dump_file(const std::string& path, int flags = 0) const;
// write the value to a string (caller must deallocate with free()!)
inline char* dumps(int flags = 0) const;
};
// represents any JSON value, private base
class Basic {
public:
// construct new Value with an undefined value
Basic() : _value(0) {}
// copy constructor
Basic(const Basic& value) : _value(json_incref(value._value)) {}
// make a reference to an existing json_t value
explicit Basic(json_t* value) : _value(json_incref(value)) {}
// free Value resources
inline ~Basic();
// copy an existing Value
inline Basic& operator=(const Basic& e);
// take ownership of a json_t (does not increase reference count)
inline static Basic take_ownership(json_t* json);
// get the underlying json_t
inline json_t* as_json() const;
protected:
// internal value pointer
json_t* _value;
};
// take ownership of a json_t (does not increase reference count)
inline static Basic take_ownership(json_t* json);
// proxies an array element
class ElementProxy {
public:
// constructor
ElementProxy(json_t* array, unsigned int index) : _array(array), _index(index) {}
protected:
// internal value pointer
json_t* _value;
};
// assign to the proxied element
inline ElementProxy& operator=(const Value& value);
// proxies an array element
class ElementProxy {
public:
// constructor
ElementProxy(json_t* array, unsigned int index) : _array(array), _index(index) {}
// get the proxied element
inline json_t* as_json() const;
// assign to the proxied element
inline ElementProxy& operator=(const Value& value);
private:
// array object we wrap
json_t* _array;
// get the proxied element
inline json_t* as_json() const;
// index of property
unsigned int _index;
};
private:
// array object we wrap
json_t* _array;
// proxies an object property
class PropertyProxy {
public:
// constructor
PropertyProxy(json_t* array, const char* key) : _object(array), _key(key) {}
// index of property
unsigned int _index;
};
// assign to the proxied element
inline PropertyProxy& operator=(const Value& value);
// proxies an object property
class PropertyProxy {
public:
// constructor
PropertyProxy(json_t* array, const char* key) : _object(array), _key(key) {}
// get the proxied element
inline json_t* as_json() const;
// assign to the proxied element
inline PropertyProxy& operator=(const Value& value);
private:
// array object we wrap
json_t* _object;
// get the proxied element
inline json_t* as_json() const;
// key of property
const char* _key;
};
private:
// array object we wrap
json_t* _object;
} // namespace json::_private
// key of property
const char* _key;
};
// represents any JSON value
class Value : public _private::ValueBase<_private::Basic> {
public:
// construct Value from input
explicit inline Value(const char* value);
explicit inline Value(const std::string& value);
explicit inline Value(bool value);
explicit inline Value(signed int value);
explicit inline Value(unsigned int value);
explicit inline Value(signed short value);
explicit inline Value(unsigned short value);
explicit inline Value(signed long value);
explicit inline Value(unsigned long value);
explicit inline Value(float value);
explicit inline Value(double value);
} // namespace json::detail
// empty constructor
Value() : _private::ValueBase<_private::Basic>() {}
// represents any JSON value
class Value : public detail::ValueBase<detail::Basic> {
public:
// construct Value from input
explicit inline Value(const char* value);
explicit inline Value(const std::string& value);
explicit inline Value(bool value);
explicit inline Value(signed int value);
explicit inline Value(unsigned int value);
explicit inline Value(signed short value);
explicit inline Value(unsigned short value);
explicit inline Value(signed long value);
explicit inline Value(unsigned long value);
explicit inline Value(float value);
explicit inline Value(double value);
// copy constructor for base
Value(const _private::Basic& value) : _private::ValueBase<_private::Basic>(value) {}
// copy constructor for base
Value(const _private::ValueBase<_private::Basic>& value) : _private::ValueBase<_private::Basic>(value) {}
// empty constructor
Value() : detail::ValueBase<detail::Basic>() {}
// copy constructor
Value(const Value& value) : _private::ValueBase<_private::Basic>(value) {}
// copy constructor for base
Value(const detail::Basic& value) : detail::ValueBase<detail::Basic>(value) {}
// create reference to value
explicit Value(json_t* json) : _private::ValueBase<_private::Basic>(json) {}
};
// copy constructor for base
Value(const detail::ValueBase<detail::Basic>& value) : detail::ValueBase<detail::Basic>(value) {}
// iterators over a JSON object
class Iterator {
public:
// construct a new iterator for a given object
inline Iterator(const Value& value);
// copy constructor
Value(const Value& value) : detail::ValueBase<detail::Basic>(value) {}
// construct a new iterator for a given object
inline Iterator(const _private::ValueBase<_private::PropertyProxy>& value);
// create reference to value
explicit Value(json_t* json) : detail::ValueBase<detail::Basic>(json) {}
};
// increment iterator
inline void next();
// iterators over a JSON object
class Iterator {
public:
// construct a new iterator for a given object
inline Iterator(const Value& value);
inline Iterator& operator++();
// construct a new iterator for a given object
inline Iterator(const detail::ValueBase<detail::PropertyProxy>& value);
// test if iterator is still valid
inline bool valid() const;
// increment iterator
inline void next();
inline operator bool() const;
inline Iterator& operator++();
// get key
inline const char* ckey() const;
// test if iterator is still valid
inline bool valid() const;
inline std::string key() const;
inline operator bool() const;
// get value
inline const Value value() const;
// get key
inline const char* ckey() const;
// dereference value
inline const Value operator*() const;
inline std::string key() const;
private:
// disallow copying
Iterator(const Iterator&);
Iterator& operator=(const Iterator&);
// get value
inline const Value value() const;
// object being iterated over
Value _object;
// dereference value
inline const Value operator*() const;
// iterator value
void* _iter;
};
private:
// disallow copying
Iterator(const Iterator&);
Iterator& operator=(const Iterator&);
// create a new empty object
inline Value object();
// object being iterated over
Value _object;
// create a new empty array
inline Value array();
// iterator value
void* _iter;
};
// create a new null value
inline Value null();
// create a new empty object
inline Value object();
// load a file as a JSON value
inline Value load_file(const char* path, json_error_t* error = 0);
// create a new empty array
inline Value array();
// load a string as a JSON value
inline Value load_string(const char* string, json_error_t* error = 0);
// create a new null value
inline Value null();
} // namespace json
// load a file as a JSON value
inline Value load_file(const char* path, json_error_t* error = 0);
inline Value load_file(const std::string& path, json_error_t* error = 0);
// load a string as a JSON value
inline Value loads(const char* string, json_error_t* error = 0);
inline Value loads(const std::string& string, json_error_t* error = 0);
} // namespace json
// stream JSON value out -- inefficient and not recommended for production use
inline std::ostream& operator<<(std::ostream& os, const json::Value& value);
@ -296,8 +305,8 @@ inline std::ostream& operator<<(std::ostream& os, const json::Value& value);
inline std::istream& operator>>(std::istream& is, json::Value& value);
// include implementation code
#define IN_JANSSON_HPP 1
#include "jansson-impl.hpp"
#define IN_JANSSON_HPP
#include "jansson.ipp"
#undef IN_JANSSON_HPP
#endif // defined(JANSSON_HPP)

483
src/jansson.ipp Normal file
View file

@ -0,0 +1,483 @@
// Copyright (c) 2010 Sean Middleditch <sean@middleditch.us>
// Copyright (c) 2010 Petri Lehtinen <petri@digip.org>
//
// Jansson is free software; you can redistribute it and/or modify
// it under the terms of the MIT license. See LICENSE for details.
#ifndef IN_JANSSON_HPP
#error "jansson.ipp may only be included from jansson.hpp"
#endif
namespace json {
namespace detail {
// assignment operator
template <typename _Base>
ValueBase<_Base>& ValueBase<_Base>::operator=(const Value& value) {
_Base::operator=(value);
return *this;
}
// check value type
template <typename _Base>
bool ValueBase<_Base>::is_undefined() const {
return _Base::as_json() == 0;
}
template <typename _Base>
bool ValueBase<_Base>::is_object() const {
return json_is_object(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_array() const {
return json_is_array(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_string() const {
return json_is_string(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_integer() const {
return json_is_integer(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_real() const {
return json_is_real(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_number() const {
return json_is_number(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_true() const {
return json_is_true(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_false() const {
return json_is_false(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_boolean() const {
return json_is_boolean(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::is_null() const {
return json_is_null(_Base::as_json());
}
// get size of array or object
template <typename _Base>
unsigned int ValueBase<_Base>::size() const {
if (is_object())
return json_object_size(_Base::as_json());
else
return json_array_size(_Base::as_json());
}
// get value at array index (const version)
template <typename _Base>
const Value ValueBase<_Base>::at(unsigned int index) const {
return Value(json_array_get(_Base::as_json(), index));
}
template <typename _Base>
const Value ValueBase<_Base>::operator[](signed int index) const { return at(index); }
template <typename _Base>
const Value ValueBase<_Base>::operator[](unsigned int index) const { return at(index); }
template <typename _Base>
const Value ValueBase<_Base>::operator[](signed short index) const { return at(index); }
template <typename _Base>
const Value ValueBase<_Base>::operator[](unsigned short index) const { return at(index); }
template <typename _Base>
const Value ValueBase<_Base>::operator[](signed long index) const { return at(index); }
template <typename _Base>
const Value ValueBase<_Base>::operator[](unsigned long index) const { return at(index); }
// get value at array index (non-const version)
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::at(unsigned int index) {
return ElementProxy(_Base::as_json(), index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](signed int index) {
return at(index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](unsigned int index) {
return at(index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](signed short index) {
return at(index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](unsigned short index) {
return at(index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](signed long index) {
return at(index);
}
template <typename _Base>
ValueBase<ElementProxy> ValueBase<_Base>::operator[](unsigned long index) {
return at(index);
}
// get object property (const version)
template <typename _Base>
const Value ValueBase<_Base>::get(const char* key) const {
return Value(json_object_get(_Base::as_json(), key));
}
template <typename _Base>
const Value ValueBase<_Base>::get(const std::string& key) const {
return get(key.c_str());
}
template <typename _Base>
const Value ValueBase<_Base>::operator[](const char* key) const {
return get(key);
}
template <typename _Base>
const Value ValueBase<_Base>::operator[](const std::string& key) const {
return get(key.c_str());
}
// get object property (non-const version)
template <typename _Base>
ValueBase<PropertyProxy> ValueBase<_Base>::get(const char* key) {
return PropertyProxy(_Base::as_json(), key);
}
template <typename _Base>
ValueBase<PropertyProxy> ValueBase<_Base>::get(const std::string& key) {
return get(key.c_str());
}
template <typename _Base>
ValueBase<PropertyProxy> ValueBase<_Base>::operator[](const char* key) {
return get(key);
}
template <typename _Base>
ValueBase<PropertyProxy> ValueBase<_Base>::operator[](const std::string& key) {
return get(key.c_str());
}
// clear all array/object values
template <typename _Base>
void ValueBase<_Base>::clear() {
if (is_object())
json_object_clear(_Base::as_json());
else
json_array_clear(_Base::as_json());
}
// get value cast to specified type
template <typename _Base>
const char* ValueBase<_Base>::as_cstring() const {
return json_string_value(_Base::as_json());
}
template <typename _Base>
std::string ValueBase<_Base>::as_string() const {
const char* tmp = as_cstring();
return tmp == 0 ? "" : tmp;
}
template <typename _Base>
int ValueBase<_Base>::as_integer() const {
return json_integer_value(_Base::as_json());
}
template <typename _Base>
double ValueBase<_Base>::as_real() const {
return json_real_value(_Base::as_json());
}
template <typename _Base>
double ValueBase<_Base>::as_number() const {
return json_number_value(_Base::as_json());
}
template <typename _Base>
bool ValueBase<_Base>::as_boolean() const {
return is_true();
}
// set an object property (converts value to object is not one already)
template <typename _Base>
_Base& ValueBase<_Base>::set_key(const char* key, const Value& value) {
json_object_set(_Base::as_json(), key, value._Base::as_json());
return *this;
}
template <typename _Base>
_Base& ValueBase<_Base>::set_key(const std::string& key, const Value& value) {
return set_key(key.c_str(), value);
}
// set an array index (converts value to object is not one already)
template <typename _Base>
_Base& ValueBase<_Base>::set_at(unsigned int index, const Value& value) {
if (index == size())
json_array_append(_Base::as_json(), value._Base::as_json());
else
json_array_set(_Base::as_json(), index, value._Base::as_json());
return *this;
}
// delete an object key
template <typename _Base>
_Base& ValueBase<_Base>::del_key(const char* key) {
json_object_del(_Base::as_json(), key);
return *this;
}
template <typename _Base>
_Base& ValueBase<_Base>::del_key(const std::string& key) {
return del_key(key.c_str());
}
// delete an item from an array by index
template <typename _Base>
_Base& ValueBase<_Base>::del_at(unsigned int index) {
json_array_remove(_Base::as_json(), index);
return *this;
}
// insert an item into an array at a given index
template <typename _Base>
_Base& ValueBase<_Base>::insert_at(unsigned int index, const Value& value) {
json_array_insert(_Base::as_json(), index, value._Base::as_json());
return *this;
}
// write the value to a file
template <typename _Base>
int ValueBase<_Base>::dump_file(const char* path, int flags) const {
return json_dump_file(_Base::as_json(), path, flags);
}
template <typename _Base>
int ValueBase<_Base>::dump_file(const std::string& path, int flags) const {
return dump_file(path.c_str(), flags);
}
// write the value to a string (caller must deallocate with free()!)
template <typename _Base>
char* ValueBase<_Base>::dumps(int flags) const {
return json_dumps(_Base::as_json(), flags);
}
Basic::~Basic() {
json_decref(_value);
}
// copy an existing Value
Basic& Basic::operator=(const Basic& e) {
if (&e != this) {
json_decref(_value);
_value = json_incref(e._value);
}
return *this;
}
// get the underlying json_t
json_t* Basic::as_json() const {
return _value;
}
// take ownership of a json_t (does not increase reference count)
Basic Basic::take_ownership(json_t* json) {
Basic v;
v._value = json;
return v;
}
// assign value to proxied array element
ElementProxy& ElementProxy::operator=(const Value& value) {
json_array_set(_array, _index, value.as_json());
return *this;
}
// get the proxied element
json_t* ElementProxy::as_json() const {
return json_array_get(_array, _index);
}
// assign value to proxied object property
PropertyProxy& PropertyProxy::operator=(const Value& value) {
json_object_set(_object, _key, value.as_json());
return *this;
}
json_t* PropertyProxy::as_json() const {
return json_object_get(_object, _key);
}
} // namespace json::detail
// construct Value::Value input
Value::Value(const char* value) {
_value = json_string(value);
}
Value::Value(const std::string& value) {
_value = json_string(value.c_str());
}
Value::Value(bool value) {
_value = value ? json_true() : json_false();
}
Value::Value(signed int value) {
_value = json_integer(value);
}
Value::Value(unsigned int value) {
_value = json_integer(value);
}
Value::Value(signed short value) {
_value = json_integer(value);
}
Value::Value(unsigned short value) {
_value = json_integer(value);
}
Value::Value(signed long value) {
_value = json_integer(value);
}
Value::Value(unsigned long value) {
_value = json_integer(value);
}
Value::Value(float value) {
_value = json_real(value);
}
Value::Value(double value) {
_value = json_real(value);
}
// construct a new iterator for a given object
Iterator::Iterator(const Value& value) : _object(value), _iter(0) {
_iter = json_object_iter(_object.as_json());
}
// construct a new iterator for a given object
Iterator::Iterator(const detail::ValueBase<detail::PropertyProxy>& value) :
_object(value.as_json()), _iter(0) {
_iter = json_object_iter(_object.as_json());
}
// increment iterator
void Iterator::next() {
_iter = json_object_iter_next(_object.as_json(), _iter);
}
Iterator& Iterator::operator++() { next(); return *this; }
// test if iterator is still valid
bool Iterator::valid() const {
return _iter != 0;
}
Iterator::operator bool() const {
return valid();
}
// get key
const char* Iterator::ckey() const {
return json_object_iter_key(_iter);
}
std::string Iterator::key() const {
return ckey();
}
// get value
const Value Iterator::value() const {
return Value(json_object_iter_value(_iter));
}
// dereference value
const Value Iterator::operator*() const {
return value();
}
// create a new empty object
Value object() {
return Value::take_ownership(json_object());
}
// create a new empty array
Value array() {
return Value::take_ownership(json_array());
}
// create a new null value
Value null() {
return Value::take_ownership(json_null());
}
// load a file as a JSON value
Value load_file(const char* path, json_error_t* error) {
return Value::take_ownership(json_load_file(path, error));
}
Value load_file(const std::string& path, json_error_t* error) {
return load_file(path.c_str(), error);
}
// load a string as a JSON value
Value loads(const char* string, json_error_t* error) {
return Value::take_ownership(json_loads(string, error));
}
Value loads(const std::string& string, json_error_t* error) {
return loads(string.c_str(), error);
}
} // namespace json
// stream JSON value out
std::ostream& operator<<(std::ostream& os, const json::Value& value) {
// get the temporary serialize string
char* tmp = value.dumps();
if (tmp != 0) {
// stream temp string out and release it
os << tmp;
free(tmp);
}
return os;
}
// read JSON value
std::istream& operator>>(std::istream& is, json::Value& value) {
// buffer the remaining bytes into a single string for Jansson
std::stringstream tmp;
while (is)
tmp << static_cast<char>(is.get());
// parse the buffered string
value = json::loads(tmp.str().c_str());
return is;
}

2
src/jansson_private.h
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
src/load.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
src/strbuffer.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
src/strbuffer.h
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
src/utf.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
src/utf.h
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
src/util.h
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

26
src/value.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.
@ -190,6 +190,17 @@ void *json_object_iter(json_t *json)
return hashtable_iter(&object->hashtable);
}
void *json_object_iter_at(json_t *json, const char *key)
{
json_object_t *object;
if(!key || !json_is_object(json))
return NULL;
object = json_to_object(json);
return hashtable_iter_at(&object->hashtable, key);
}
void *json_object_iter_next(json_t *json, void *iter)
{
json_object_t *object;
@ -217,6 +228,19 @@ json_t *json_object_iter_value(void *iter)
return (json_t *)hashtable_iter_value(iter);
}
int json_object_iter_set_new(json_t *json, void *iter, json_t *value)
{
json_object_t *object;
if(!json_is_object(json) || !iter || !value)
return -1;
object = json_to_object(json);
hashtable_iter_set(&object->hashtable, iter, value);
return 0;
}
static int json_object_equal(json_t *object1, json_t *object2)
{
void *iter;

2
test/bin/json_process.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
test/scripts/run-tests.sh
View file

@ -1,4 +1,4 @@
# Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
# Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
#
# Jansson is free software; you can redistribute it and/or modify
# it under the terms of the MIT license. See LICENSE for details.

2
test/scripts/valgrind.sh
View file

@ -1,4 +1,4 @@
# Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
# Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
#
# Jansson is free software; you can redistribute it and/or modify
# it under the terms of the MIT license. See LICENSE for details.

2
test/suites/api/check-exports
View file

@ -39,9 +39,11 @@ json_object_del
json_object_clear
json_object_update
json_object_iter
json_object_iter_at
json_object_iter_next
json_object_iter_key
json_object_iter_value
json_object_iter_set_new
json_dumps
json_dumpf
json_dump_file

25
test/suites/api/run
View file

@ -1,21 +1,34 @@
#!/bin/sh
#
# Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
# Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
#
# Jansson is free software; you can redistribute it and/or modify
# it under the terms of the MIT license. See LICENSE for details.
is_test() {
[ "${test_name%.c}" != "$test_name" ] && return 0
[ -x $test_path -a ! -f $test_path.c ] && return 0
return 1
case "$test_name" in
*.c|*.cpp|check-exports)
return 0
;;
*)
return 1
;;
esac
}
run_test() {
if [ -x $test_path ]; then
if [ "$test_name" = "check-exports" ]; then
test_log=$test_log $test_path >$test_log/stdout 2>$test_log/stderr
else
$test_runner $suite_builddir/${test_name%.c} \
case "$test_name" in
*.c)
test_bin=${test_name%.c}
;;
*.cpp)
test_bin=${test_name%.cpp}
;;
esac
$test_runner $suite_builddir/$test_bin \
>$test_log/stdout \
2>$test_log/stderr \
|| return 1

2
test/suites/api/test_array.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
test/suites/api/test_copy.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

239
test/suites/api/test_cpp.cpp
View file

@ -1,159 +1,162 @@
#include <iostream>
#include <iomanip>
#include <malloc.h>
#include "jansson.hpp"
#define ASSERT_OP(lhs, rhs, op, m) \
do { \
if(!((lhs) op (rhs))) { \
std::cerr << std::boolalpha; \
std::cerr << __FILE__ << '[' << __LINE__ << "]: ERROR: " << (m) << std::endl; \
std::cerr << "\ttest: " << #lhs << ' ' << #op << ' ' << #rhs << std::endl; \
std::cerr << "\tresult: " << (lhs) << ' ' << #op << ' ' << (rhs) << std::endl; \
return 1; \
} \
} while(0)
#define ASSERT_OP(lhs, rhs, op, m) \
do { \
if(!((lhs) op (rhs))) { \
std::cerr << std::boolalpha; \
std::cerr << __FILE__ << '[' << __LINE__ << "]: ERROR: " \
<< (m) << std::endl; \
std::cerr << "\ttest: " << #lhs << ' ' << #op << ' ' \
<< #rhs << std::endl; \
std::cerr << "\tresult: " << (lhs) << ' ' << #op << ' ' \
<< (rhs) << std::endl; \
return 1; \
} \
} while(0)
#define ASSERT_EQ(lhs, rhs, m) ASSERT_OP(lhs, rhs, ==, m)
#define ASSERT_NE(lhs, rhs, m) ASSERT_OP(lhs, rhs, !=, m)
#define ASSERT_TRUE(p, m) ASSERT_OP(p, true, ==, m)
#define ASSERT_FALSE(p, m) ASSERT_OP(p, true, !=, m)
int main() {
json::Value e1(json::load_file("suites/api/test.json"));
json::Value e2(e1);
json::Value e3;
json::Value e4(json::load_string("{\"foo\": true, \"bar\": \"test\"}"));
std::string top_srcdir = getenv("top_srcdir");
json::Value e1(json::load_file(top_srcdir + "/test/suites/api/test_cpp.json"));
json::Value e2(e1);
json::Value e3;
json::Value e4(json::loads("{\"foo\": true, \"bar\": \"test\"}"));
ASSERT_TRUE(e1.is_object(), "e1 is not an object");
ASSERT_TRUE(e2.is_object(), "e2 is not an object");
ASSERT_TRUE(e3.is_undefined(), "e3 has a defined value");
ASSERT_TRUE(e4.is_object(), "e4 is not an object");
ASSERT_TRUE(e1.is_object(), "e1 is not an object");
ASSERT_TRUE(e2.is_object(), "e2 is not an object");
ASSERT_TRUE(e3.is_undefined(), "e3 has a defined value");
ASSERT_TRUE(e4.is_object(), "e4 is not an object");
ASSERT_EQ(e1.size(), 1, "e1 has too many properties");
ASSERT_EQ(e2.size(), 1, "e2 has too many properties");
ASSERT_EQ(e4.size(), 2, "e4 does not have 2 elements");
ASSERT_EQ(e1.size(), 1, "e1 has too many properties");
ASSERT_EQ(e2.size(), 1, "e2 has too many properties");
ASSERT_EQ(e4.size(), 2, "e4 does not have 2 elements");
ASSERT_TRUE(e1.get("web-app").is_object(), "e1[0].web-app is not an object");
ASSERT_EQ(e1.get("web-app").get("servlet").at(0).get("servlet-class").as_string(), "org.cofax.cds.CDSServlet", "property has incorrect value");
ASSERT_EQ(e1["web-app"]["servlet"][0]["servlet-class"].as_string(), "org.cofax.cds.CDSServlet", "property has incorrect value");
ASSERT_TRUE(e1.get("web-app").is_object(), "e1[0].web-app is not an object");
ASSERT_EQ(e1.get("web-app").get("servlet").at(0).get("servlet-class").as_string(), "org.cofax.cds.CDSServlet", "property has incorrect value");
ASSERT_EQ(e1["web-app"]["servlet"][0]["servlet-class"].as_string(), "org.cofax.cds.CDSServlet", "property has incorrect value");
ASSERT_EQ(e4["foo"].as_boolean(), true, "property has incorrect value");
ASSERT_EQ(e4["foo"].as_boolean(), true, "property has incorrect value");
json::Iterator i(e1.get("web-app"));
ASSERT_EQ(i.key(), "taglib", "first iterator result has incorrect key");
i.next();
ASSERT_EQ(i.key(), "servlet", "first iterator result has incorrect key");
i.next();
ASSERT_EQ(i.key(), "servlet-mapping", "first iterator result has incorrect key");
i.next();
ASSERT_FALSE(i.valid(), "iterator has more values than expected");
json::Iterator i(e1.get("web-app"));
ASSERT_EQ(i.key(), "taglib", "first iterator result has incorrect key");
i.next();
ASSERT_EQ(i.key(), "servlet", "first iterator result has incorrect key");
i.next();
ASSERT_EQ(i.key(), "servlet-mapping", "first iterator result has incorrect key");
i.next();
ASSERT_FALSE(i.valid(), "iterator has more values than expected");
json::Value e5(json::Value(12.34));
ASSERT_TRUE(e5.is_number(), "e5 is not a number after assignment");
ASSERT_EQ(e5.as_real(), 12.34, "e5 has incorrect value after assignment");
json::Value e5(json::Value(12.34));
ASSERT_TRUE(e5.is_number(), "e5 is not a number after assignment");
ASSERT_EQ(e5.as_real(), 12.34, "e5 has incorrect value after assignment");
json::Value e6(json::Value(true));
ASSERT_TRUE(e6.is_boolean(), "e6 is not a boolean after assignment");
ASSERT_EQ(e6.as_boolean(), true, "e6 has incorrect value after assignment");
json::Value e6(json::Value(true));
ASSERT_TRUE(e6.is_boolean(), "e6 is not a boolean after assignment");
ASSERT_EQ(e6.as_boolean(), true, "e6 has incorrect value after assignment");
json::Value e7(json::Value("foobar"));
ASSERT_TRUE(e7.is_string(), "e7 is not a string after assignment");
ASSERT_EQ(e7.as_string(), "foobar", "e7 has incorrect value after assignment");
json::Value e7(json::Value("foobar"));
ASSERT_TRUE(e7.is_string(), "e7 is not a string after assignment");
ASSERT_EQ(e7.as_string(), "foobar", "e7 has incorrect value after assignment");
json::Value e8(json::object());
ASSERT_TRUE(e8.is_object(), "e8 is not an object after assignment");
json::Value e8(json::object());
ASSERT_TRUE(e8.is_object(), "e8 is not an object after assignment");
json::Value e9(json::null());
ASSERT_TRUE(e9.is_null(), "e9 is not null after assignment");
json::Value e9(json::null());
ASSERT_TRUE(e9.is_null(), "e9 is not null after assignment");
json::Value e10(json::array());
ASSERT_TRUE(e10.is_array(), "e10 is not an array after index assignment");
json::Value e10(json::array());
ASSERT_TRUE(e10.is_array(), "e10 is not an array after index assignment");
e10.set_at(0, json::Value("foobar"));
ASSERT_EQ(e10.size(), 1, "e10 has incorrect number of elements after assignment");
ASSERT_EQ(e10[0].as_string(), "foobar", "e10[0] has incorrect value after assignment");
e10.set_at(0, json::Value("foobar"));
ASSERT_EQ(e10.size(), 1, "e10 has incorrect number of elements after assignment");
ASSERT_EQ(e10[0].as_string(), "foobar", "e10[0] has incorrect value after assignment");
e10.set_at(1, json::Value("foobar"));
ASSERT_TRUE(e10.is_array(), "e10 is not an array after index assignment");
ASSERT_EQ(e10.size(), 2, "e10 has incorrect number of elements after assignment");
ASSERT_EQ(e10[1].as_string(), "foobar", "e10[0] has incorrect value after assignment");
e10.set_at(1, json::Value("foobar"));
ASSERT_TRUE(e10.is_array(), "e10 is not an array after index assignment");
ASSERT_EQ(e10.size(), 2, "e10 has incorrect number of elements after assignment");
ASSERT_EQ(e10[1].as_string(), "foobar", "e10[0] has incorrect value after assignment");
e10.set_at(0, json::Value("barfoo"));
ASSERT_TRUE(e10.is_array(), "e10 is not an array after index assignment");
ASSERT_EQ(e10.size(), 2, "e10 has incorrect number of elements after assignment");
ASSERT_EQ(e10[0].as_string(), "barfoo", "e10[0] has incorrect value after assignment");
e10.set_at(0, json::Value("barfoo"));
ASSERT_TRUE(e10.is_array(), "e10 is not an array after index assignment");
ASSERT_EQ(e10.size(), 2, "e10 has incorrect number of elements after assignment");
ASSERT_EQ(e10[0].as_string(), "barfoo", "e10[0] has incorrect value after assignment");
e10.set_at(100, json::null());
ASSERT_TRUE(e10.is_array(), "e10 is not an array after index assignment");
ASSERT_EQ(e10.size(), 2, "e10 has incorrect number of elements after assignment");
e10.set_at(100, json::null());
ASSERT_TRUE(e10.is_array(), "e10 is not an array after index assignment");
ASSERT_EQ(e10.size(), 2, "e10 has incorrect number of elements after assignment");
e10.insert_at(1, json::Value("new"));
ASSERT_EQ(e10.size(), 3, "e10 has incorrect size after insert");
ASSERT_EQ(e10[1].as_string(), "new", "e10[1] has incorrect value after insert");
ASSERT_EQ(e10[2].as_string(), "foobar", "e10[2] has incorrect value after insert");
e10.insert_at(1, json::Value("new"));
ASSERT_EQ(e10.size(), 3, "e10 has incorrect size after insert");
ASSERT_EQ(e10[1].as_string(), "new", "e10[1] has incorrect value after insert");
ASSERT_EQ(e10[2].as_string(), "foobar", "e10[2] has incorrect value after insert");
e10.del_at(0);
ASSERT_EQ(e10.size(), 2, "e10 has incorrect size after delete");
ASSERT_EQ(e10[1].as_string(), "foobar", "e10[1] has incorrect value after delete");
e10.del_at(0);
ASSERT_EQ(e10.size(), 2, "e10 has incorrect size after delete");
ASSERT_EQ(e10[1].as_string(), "foobar", "e10[1] has incorrect value after delete");
e10.clear();
ASSERT_EQ(e10.size(), 0, "e10 has incorrect number of elements after clear");
e10.clear();
ASSERT_EQ(e10.size(), 0, "e10 has incorrect number of elements after clear");
json::Value e11(json::object());
ASSERT_TRUE(e11.is_object(), "e11 is not an object after property assignment");
json::Value e11(json::object());
ASSERT_TRUE(e11.is_object(), "e11 is not an object after property assignment");
e11.set_key("foo", json::Value("test"));
ASSERT_EQ(e11.size(), 1, "e11 has incorrect number of properties after assignment");
ASSERT_EQ(e11["foo"].as_string(), "test", "e11.foo has incorrect value after assignment");
e11.set_key("foo", json::Value("test"));
ASSERT_EQ(e11.size(), 1, "e11 has incorrect number of properties after assignment");
ASSERT_EQ(e11["foo"].as_string(), "test", "e11.foo has incorrect value after assignment");
e11.set_key("foo", json::Value("again"));
ASSERT_TRUE(e11.is_object(), "e11 is not an object after property assignment");
ASSERT_EQ(e11.size(), 1, "e11 has incorrect number of properties after assignment");
ASSERT_EQ(e11["foo"].as_string(), "again", "e11.foo has incorrect value after assignment");
e11.set_key("foo", json::Value("again"));
ASSERT_TRUE(e11.is_object(), "e11 is not an object after property assignment");
ASSERT_EQ(e11.size(), 1, "e11 has incorrect number of properties after assignment");
ASSERT_EQ(e11["foo"].as_string(), "again", "e11.foo has incorrect value after assignment");
e11.set_key("bar", json::Value("test"));
ASSERT_TRUE(e11.is_object(), "e11 is not an object after property assignment");
ASSERT_EQ(e11.size(), 2, "e11 has incorrect number of properties after assignment");
ASSERT_EQ(e11["bar"].as_string(), "test", "e11.foo has incorrect value after assignment");
e11.set_key("bar", json::Value("test"));
ASSERT_TRUE(e11.is_object(), "e11 is not an object after property assignment");
ASSERT_EQ(e11.size(), 2, "e11 has incorrect number of properties after assignment");
ASSERT_EQ(e11["bar"].as_string(), "test", "e11.foo has incorrect value after assignment");
e11.clear();
ASSERT_EQ(e11.size(), 0, "e11 has incorrect number of properties after clear");
e11.clear();
ASSERT_EQ(e11.size(), 0, "e11 has incorrect number of properties after clear");
json::Value e12(json::object());
e12.set_key("foo", json::Value("test"));
e12.set_key("bar", json::Value(3));
char* out_cstr = e12.save_string(0);
std::string out(out_cstr);
free(out_cstr);
ASSERT_EQ(out, "{\"bar\": 3, \"foo\": \"test\"}", "object did not serialize as expected");
json::Value e12(json::object());
e12.set_key("foo", json::Value("test"));
e12.set_key("bar", json::Value(3));
char* out_cstr = e12.dumps(0);
std::string out(out_cstr);
free(out_cstr);
ASSERT_EQ(out, "{\"bar\": 3, \"foo\": \"test\"}", "object did not serialize as expected");
std::istringstream instr(out);
instr >> e12;
ASSERT_TRUE(e12.is_object(), "e12 is not an object after stream read");
ASSERT_EQ(e12.size(), 2, "e12 has wrong size after stream read");
ASSERT_EQ(e12.get("bar").as_integer(), 3, "e12.bar has incorrect value after stream read");
ASSERT_EQ(e12.get("foo").as_string(), "test", "ee12.test has incorrect value after stream read");
std::istringstream instr(out);
instr >> e12;
ASSERT_TRUE(e12.is_object(), "e12 is not an object after stream read");
ASSERT_EQ(e12.size(), 2, "e12 has wrong size after stream read");
ASSERT_EQ(e12.get("bar").as_integer(), 3, "e12.bar has incorrect value after stream read");
ASSERT_EQ(e12.get("foo").as_string(), "test", "ee12.test has incorrect value after stream read");
std::ostringstream outstr;
outstr << e12;
ASSERT_EQ(instr.str(), "{\"bar\": 3, \"foo\": \"test\"}", "object did not serialize as expected");
std::ostringstream outstr;
outstr << e12;
ASSERT_EQ(instr.str(), "{\"bar\": 3, \"foo\": \"test\"}", "object did not serialize as expected");
const json::Value e13(e12);
ASSERT_EQ(e13["bar"].as_integer(), 3, "e13.bar has incorrect value after copy");
const json::Value e13(e12);
ASSERT_EQ(e13["bar"].as_integer(), 3, "e13.bar has incorrect value after copy");
json::Value e14(json::object());
ASSERT_TRUE(e14.is_object(), "e14 is not an object after construction");
e14.set_key("foo", json::object());
ASSERT_TRUE(e14["foo"].is_object(), "e14.foo is not an object after assignment");
e14["foo"]["bar"] = json::Value(42);
ASSERT_EQ(e14["foo"]["bar"].as_integer(), 42, "e14.foo.bar has incorrect value after assignment");
json::Value e14(json::object());
ASSERT_TRUE(e14.is_object(), "e14 is not an object after construction");
e14.set_key("foo", json::object());
ASSERT_TRUE(e14["foo"].is_object(), "e14.foo is not an object after assignment");
e14["foo"]["bar"] = json::Value(42);
ASSERT_EQ(e14["foo"]["bar"].as_integer(), 42, "e14.foo.bar has incorrect value after assignment");
json::Value e15(json::array());
ASSERT_TRUE(e15.is_array(), "e15 is not an array after construction");
e15.set_at(0, json::Value(42));
ASSERT_EQ(e15[0].as_integer(), 42, "e15[0] has incorrect value after assignment");
e15[0] = json::Value("foo");
ASSERT_EQ(e15[0].as_string(), "foo", "e15[0] has incorrecy value after assignment");
return 0;
json::Value e15(json::array());
ASSERT_TRUE(e15.is_array(), "e15 is not an array after construction");
e15.set_at(0, json::Value(42));
ASSERT_EQ(e15[0].as_integer(), 42, "e15[0] has incorrect value after assignment");
e15[0] = json::Value("foo");
ASSERT_EQ(e15[0].as_string(), "foo", "e15[0] has incorrecy value after assignment");
return 0;
}

6
test/suites/api/test.json → test/suites/api/test_cpp.json
View file

@ -1,5 +1,5 @@
{"web-app": {
"servlet": [
"servlet": [
{
"servlet-name": "cofaxCDS",
"servlet-class": "org.cofax.cds.CDSServlet",
@ -55,7 +55,7 @@
{
"servlet-name": "cofaxAdmin",
"servlet-class": "org.cofax.cds.AdminServlet"},
{
"servlet-name": "fileServlet",
"servlet-class": "org.cofax.cds.FileServlet"},
@ -82,7 +82,7 @@
"cofaxAdmin": "/admin/*",
"fileServlet": "/static/*",
"cofaxTools": "/tools/*"},
"taglib": {
"taglib-uri": "cofax.tld",
"taglib-location": "/WEB-INF/tlds/cofax.tld"}}}

2
test/suites/api/test_equal.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
test/suites/api/test_load.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
test/suites/api/test_number.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

32
test/suites/api/test_object.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.
@ -258,6 +258,36 @@ static void test_iterators()
if(json_object_iter_next(object, iter) != NULL)
fail("able to iterate over the end");
if(json_object_iter_at(object, "foo"))
fail("json_object_iter_at() succeeds for non-existent key");
iter = json_object_iter_at(object, "b");
if(!iter)
fail("json_object_iter_at() fails for an existing key");
if(strcmp(json_object_iter_key(iter), "b"))
fail("iterating failed: wrong key");
if(json_object_iter_value(iter) != bar)
fail("iterating failed: wrong value");
iter = json_object_iter_next(object, iter);
if(!iter)
fail("unable to increment iterator");
if(strcmp(json_object_iter_key(iter), "c"))
fail("iterating failed: wrong key");
if(json_object_iter_value(iter) != baz)
fail("iterating failed: wrong value");
if(json_object_iter_set(object, iter, bar))
fail("unable to set value at iterator");
if(strcmp(json_object_iter_key(iter), "c"))
fail("json_object_iter_key() fails after json_object_iter_set()");
if(json_object_iter_value(iter) != bar)
fail("json_object_iter_value() fails after json_object_iter_set()");
if(json_object_get(object, "c") != bar)
fail("json_object_get() fails after json_object_iter_set()");
json_decref(object);
json_decref(foo);
json_decref(bar);

2
test/suites/api/test_simple.c
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
test/suites/api/util.h
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
* Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
*
* Jansson is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.

2
test/suites/encoding-flags/run
View file

@ -1,6 +1,6 @@
#!/bin/sh
#
# Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
# Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
#
# Jansson is free software; you can redistribute it and/or modify
# it under the terms of the MIT license. See LICENSE for details.

2
test/suites/invalid-strip/run
View file

@ -1,6 +1,6 @@
#!/bin/sh
#
# Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
# Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
#
# Jansson is free software; you can redistribute it and/or modify
# it under the terms of the MIT license. See LICENSE for details.

2
test/suites/invalid-unicode/run
View file

@ -1,6 +1,6 @@
#!/bin/sh
#
# Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
# Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
#
# Jansson is free software; you can redistribute it and/or modify
# it under the terms of the MIT license. See LICENSE for details.

2
test/suites/invalid/run
View file

@ -1,6 +1,6 @@
#!/bin/sh
#
# Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
# Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
#
# Jansson is free software; you can redistribute it and/or modify
# it under the terms of the MIT license. See LICENSE for details.

2
test/suites/valid-strip/run
View file

@ -1,6 +1,6 @@
#!/bin/sh
#
# Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
# Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
#
# Jansson is free software; you can redistribute it and/or modify
# it under the terms of the MIT license. See LICENSE for details.

2
test/suites/valid/run
View file

@ -1,6 +1,6 @@
#!/bin/sh
#
# Copyright (c) 2009 Petri Lehtinen <petri@digip.org>
# Copyright (c) 2009, 2010 Petri Lehtinen <petri@digip.org>
#
# Jansson is free software; you can redistribute it and/or modify
# it under the terms of the MIT license. See LICENSE for details.