libyajl2 0.0.1

data/ext/libyajl2/vendor/yajl/ChangeLog

@@ -0,0 +1,189 @@
+2.1.0
+     * @nonodename, @patperry - fixed some compiler warnings
+     * @yep, @emaste - documentation improvements
+     * @sgravrock - build fix for NetBSD (and whenever sh != bash)
+     * @rotty, @brimstone3, @lloyd - allow client to reset generator
+     * @sgravrock - remove bash dependencies
+     * @lloyd - add api tests
+     * @rflynn - remove ruby dependency
+     * @cloderic - nmake install works on windows
+     * @shahbag - build fix for qnx
+     * @breese - debugging improvements
+     * @lloyd - json_verify supports -s flag for stream processing
+     * @lloyd - json_reformat supports -s flag for stream processing
+
+2.0.4
+     * @jcekstrom - additional checking in integer parsing
+     * @jcekstrom - fix a bug in yajl_tree that would cause valid json integersto fail to parse
+     * @plaguemorin - fix a memory leak in yajl_tree (error strings were being leaked)
+     * @7AC - reset errno
+     * @ConradIrwin - include flags to reformatter to allow toggling of escape solidus option
+
+2.0.3
+     * John Stamp generation of a pkgconfig file at build time.
+     * @robzuber bugfix in yajl_tree_get()
+     * @lloyd - fix for compilation on 64 bit windows
+
+2.0.2
+     * lth fix typos in yajl_tree.h macros YAJL_IS_INTEGER and YAJL_IS_DOUBLE,
+	contributed by Artem S Vybornov.
+     * lth add #ifdef __cplusplus wrappers to yajl_tree to allow proper
+	usage from many populer C++ compilers.
+
+2.0.1
+     * lth generator flag to allow client to specify they want
+	escaped solidi '/'.  issue #28
+     * lth crash fix when yajl_parse() is never called. issue #27
+
+2.0.0
+     * lth YAJL is now ISC licensed: http://en.wikipedia.org/wiki/ISC_license
+     * lth 20-35% (osx and linux respectively) parsing performance
+	improvement attained by tweaking string scanning (idea: @michaelrhanson).
+     * Florian Forster & lth - yajl_tree interface introduced as a higher level
+	interface to the parser (eats JSON, poops a memory representation)
+     * lth require a C99 compiler
+     * lth integers are now represented with long long (64bit+) on all platforms.
+     * lth size_t now used throughout to represent buffer lengths, so you can
+	safely manage buffers greater than 4GB.
+     * gno semantic improvements to yajl's API regarding partial value parsing and
+	trailing garbage
+     * lth new configuration mechanism for yajl, see yajl_config() and
+	yajl_gen_config()
+     * gno more allocation checking in more places
+     * gno remove usage of strtol, replace with custom implementation that cares
+	not about your locale.
+     * lth yajl_parse_complete renamed to yajl_complete_parse.
+     * lth add a switch to validate utf8 strings as they are generated.
+     * lth tests are a lot quieter in their output.
+     * lth addition of a little in tree performance benchmark, `perftest` in
+	perf/perftest.c
+
+1.0.12
+     * Conrad Irwin - Parse null bytes correctly
+     * Mirek Rusin - fix LLVM warnings
+     * gno - Don't generate numbers for keys. closes #13
+     * lth - various win32 fixes, including build documentation improvements
+     * John Stamp - Don't export private symbols.
+     * John Stamp - Install yajl_version.h, not the template.
+     * John Stamp - Don't use -fPIC for static lib.  Cmake will automatically add it for the shared.
+     * lth 0 fix paths embedded in dylib upon installation on osx.  closes #11
+
+1.0.11
+     * lth remove -Wno-missing-field-initializers for greater gcc compat (3.4.6)
+
+1.0.10
+     * Brian Maher - yajl is now buildable without a c++ compiler present
+     * Brian Maher - fix header installation on OSX with cmake 2.8.0 installed
+     * lth & vitali - allow builder to specify alternate lib directory
+	for installation (i.e. lib64) 
+     * Vitali Lovich - yajl version number now programatically accessible
+     * lth - prevent cmake from embedding rpaths in binaries.  Static linking
+	makes this unneccesary.
+
+1.0.9
+     * lth - fix inverted logic causing yajl_gen_double() to always fail on
+	win32 (thanks to Fredrik Kihlander for the report) 
+
+1.0.8
+     * Randall E. Barker - move dllexport defnitions so dlls with proper
+	exports can again be generated on windows 
+     * lth - add yajl_get_bytes_consumed() which allows the client to
+	determine the offset as an error, as well as determine how
+	many bytes of an input buffer were consumed.
+     * lth - fixes to keep "error offset" up to date (like when the
+	client callback returns 0)
+     * Brian Maher - allow client to specify a printing function in
+       generation
+
+1.0.7
+     * lth fix win32 build (isinf and isnan)
+
+1.0.6
+     * lth fix several compiler warnings
+     * lth fix generation of invalid json from yajl_gen_double
+	(NaN is not JSON)
+     * jstamp support for combining short options in tools
+     * jstamp exit properly on errors from tools
+     * octo test success no longer depends on integer size
+     * max fix configure --prefix
+
+1.0.5
+     * lth several performance improvements related to function
+	inlinin'
+
+1.0.4
+     * lth fix broken utf8 validation for three & four byte represenations.
+	thanks to http://github.com/brianmario and
+	http://github.com/technoweenie
+
+1.0.3
+     * lth fix syntax error in cplusplus extern "C" statements for wider
+	compiler support
+
+1.0.2
+     * lth update doxygen documentation with new sample code, passing NULL
+	for allocation functions added in 1.0.0
+
+1.0.1
+     * lth resolve crash in json_reformatter due to incorrectly ordered
+	parameters.
+
+1.0.0
+     * lth add 'make install' rules, thaks to Andrei Soroker for the
+	contribution.
+     * lth client may override allocation routines at generator or parser
+	allocation time
+     * tjw add yajl_parse_complete routine to allow client to explicitly
+	specify end-of-input, solving the "lonely number" case, where
+	json text consists only of an element with no explicit syntactic
+	end.
+     * tjw many new test cases	
+     * tjw cleanup of code for symmetry and ease of reading
+     * lth integration of patches from Robert Varga which cleanup
+	compilation warnings on 64 bit linux
+
+0.4.0
+     * lth buffer overflow bug in yajl_gen_double s/%lf/%g/ - thanks to
+	Eric Bergstrome
+     * lth yajl_number callback to allow passthrough of arbitrary precision
+	numbers to client.  Thanks to Hatem Nassrat.
+     * lth yajl_integer now deals in long, instead of long long.  This
+	combined with yajl_number improves compiler compatibility while
+	maintaining precision.
+     * lth better ./configure && make experience (still requires cmake and
+	ruby)
+     * lth fix handling of special characters hex 0F and 1F in yajl_encode
+	(thanks to Robert Geiger)
+     * lth allow leading zeros in exponents (thanks to Hatem Nassrat)
+
+0.3.0
+     * lth doxygen documentation (html & man) generated as part of the
+	build
+     * lth many documentation updates.
+     * lth fix to work with older versions of cmake (don't use LOOSE_LOOP
+	constructs)
+     * lth work around different behavior of freebsd 4 scanf.  initialize
+	parameter to scanf to zero.
+     * lth all tests run 32x with ranging buffer sizes to stress stream
+        parsing
+     * lth yajl_test accepts -b option to allow read buffer size to be
+        set
+     * lth option to validate UTF8 added to parser (argument in
+        yajl_parser_cfg)
+     * lth fix buffer overrun when chunk ends inside \u escaped text
+     * lth support client cancelation
+
+0.2.2
+     * lth on windows build debug with C7 symbols and no pdb files.
+
+0.2.1
+     * fix yajl_reformat and yajl_verify to work on arbitrarily sized
+        inputs.
+     * fix win32 build break, clean up all errors and warnings.
+     * fix optimized build flags.
+
+0.2.0
+     * optionally support comments in input text
+
+0.1.0
+     * Initial release

data/ext/libyajl2/vendor/yajl/README

@@ -0,0 +1,74 @@
+**********************************************************************
+        This is YAJL 2.  For the legacy version of YAJL see
+              https://github.com/lloyd/yajl/tree/1.x
+**********************************************************************
+
+Welcome to Yet Another JSON Library (YAJL)
+
+## Why does the world need another C library for parsing JSON?  
+
+Good question.  In a review of current C JSON parsing libraries I was 
+unable to find one that satisfies my requirements.  Those are, 
+0. written in C
+1. portable
+2. robust -- as close to "crash proof" as possible
+3. data representation independent
+4. fast
+5. generates verbose, useful error messages including context of where
+   the error occurs in the input text.
+6. can parse JSON data off a stream, incrementally
+7. simple to use
+8. tiny
+
+Numbers 3, 5, 6, and 7 were particularly hard to find, and were what 
+caused me to ultimately create YAJL.  This document is a tour of some
+of the more important aspects of YAJL.
+
+## YAJL is Free.
+
+Permissive licensing means you can use it in open source and
+commercial products alike without any fees.  My request beyond the
+licensing is that if you find bugs drop me a email, or better yet,
+fork and fix.
+
+Porting YAJL should be trivial, the implementation is ANSI C.  If you
+port to new systems I'd love to hear of it and integrate your patches.
+
+## YAJL is data representation independent.
+
+BYODR!  Many JSON libraries impose a structure based data representation
+on you.  This is a benefit in some cases and a drawback in others.
+YAJL uses callbacks to remain agnostic of the in-memory representation.
+So if you wish to build up an in-memory representation, you may do so
+using YAJL, but you must bring the code that defines and populates the
+in memory structure.
+
+This also means that YAJL can be used by other (higher level) JSON
+libraries if so desired.
+
+## YAJL supports stream parsing
+
+This means you do not need to hold the whole JSON representation in
+textual form in memory.  This makes YAJL ideal for filtering projects,
+where you're converting YAJL from one form to another (i.e. XML).  The
+included JSON pretty printer is an example of such a filter program.
+
+## YAJL is fast
+
+Minimal memory copying is performed.  YAJL, when possible, returns
+pointers into the client provided text (i.e. for strings that have no
+embedded escape chars, hopefully the common case).  I've put a lot of
+effort into profiling and tuning performance, but I have ignored a
+couple possible performance improvements to keep the interface clean,
+small, and flexible.  My hope is that YAJL will perform comparably to
+the fastest JSON parser out there.
+
+YAJL should impose both minimal CPU and memory requirements on your
+application.
+
+## YAJL is tiny.
+
+Fat free.  No whip.
+
+enjoy,
+Lloyd - July, 2007 

data/ext/libyajl2/vendor/yajl/TODO

@@ -0,0 +1,9 @@
+* add a test for 0x1F bug
+* numeric overflow in integers and double
+* line and char offsets in the lexer and in error messages
+* testing:
+  a. the permuter
+  b. some performance comparison against json_checker.
+* investigate pull instead of push parsing
+* Handle memory allocation failures gracefully
+* cygwin/msys support on win32

data/ext/libyajl2/vendor/yajl/YAJLDoc.cmake

@@ -0,0 +1,26 @@
+FIND_PROGRAM(doxygenPath doxygen)
+
+IF (doxygenPath)
+  SET (YAJL_VERSION ${YAJL_MAJOR}.${YAJL_MINOR}.${YAJL_MICRO})
+  SET(yajlDirName yajl-${YAJL_VERSION})
+  SET(docPath
+      "${CMAKE_CURRENT_BINARY_DIR}/${yajlDirName}/share/doc/${yajlDirName}")
+  MESSAGE("** using doxygen at: ${doxygenPath}")
+  MESSAGE("** documentation output to: ${docPath}")
+
+  CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/src/YAJL.dxy
+                 ${CMAKE_CURRENT_BINARY_DIR}/YAJL.dxy @ONLY)
+
+  FILE(MAKE_DIRECTORY "${docPath}")
+
+  ADD_CUSTOM_TARGET(doc
+                    ${doxygenPath} YAJL.dxy   
+                    WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
+
+ELSE (doxygenPath)
+  MESSAGE("!! doxygen not found, not generating documentation")     
+  ADD_CUSTOM_TARGET(
+    doc
+    echo doxygen not installed, not generating documentation
+  )
+ENDIF (doxygenPath)

data/ext/libyajl2/vendor/yajl/configure

@@ -0,0 +1,81 @@
+#!/bin/sh
+#
+# Copyright (c) 2007-2014, Lloyd Hilaiel <me@lloyd.io>
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+prefix="/usr/local"
+if [ "$1" = "--help" ]
+then
+    cat <<EOS
+Usage: configure [options]
+    -p, --prefix PATH                Set installation prefix
+    -h, --help                       Output usage summary
+EOS
+    exit 0
+fi
+if [ "$1" = "-p" ]; then
+    if [ "$#" != 2 ]; then
+        ./configure.sh --help
+        exit 1
+    fi
+    prefix="$2"
+fi
+
+echo "== removing old build files"
+rm -rf build
+rm -f Makefile
+echo "== running CMake in build directory"
+mkdir build || exit 1
+cd build || exit 1
+cmake -DCMAKE_INSTALL_PREFIX="$prefix" .. ||
+{
+    echo "The \"cmake\" program is required to configure yajl."
+    echo "It's available from most ports/packaging systems and http://cmake.org"
+    exit 1
+}
+cd ..
+
+echo "== Generating Makefile"
+cat > ./Makefile <<EOS
+.PHONY: all clean distclean install package test distro
+all: distro doc test test-api
+
+distro:
+	@cd build && make
+
+doc:
+	@cd build && make doc
+
+test:
+	@cd build && make test
+
+test-api:
+	@cd build && make test-api
+
+clean:
+	@cd build && make clean
+
+distclean:
+	@rm -rf Makefile build
+	@rm -f yajl-*.tgz
+
+install: distro doc
+	@cd build && make install
+
+package: all
+	@echo \"compressing to $(basename build/yajl-*).tgz\"
+	@cd build && tar czf ../$(basename yajl-*).tgz yajl-*
+EOS
+
+echo "== Configured with installation prefix: $prefix"

data/ext/libyajl2/vendor/yajl/example/CMakeLists.txt

@@ -0,0 +1,23 @@
+# Copyright (c) 2007-2014, Lloyd Hilaiel <me@lloyd.io>
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+SET (SRCS parse_config.c)
+
+# use the library we build, duh.
+INCLUDE_DIRECTORIES(${CMAKE_CURRENT_BINARY_DIR}/../${YAJL_DIST_NAME}/include)
+LINK_DIRECTORIES(${CMAKE_CURRENT_BINARY_DIR}/../${YAJL_DIST_NAME}/lib)
+
+ADD_EXECUTABLE(parse_config ${SRCS})
+
+TARGET_LINK_LIBRARIES(parse_config yajl_s)

data/ext/libyajl2/vendor/yajl/example/README.md

@@ -0,0 +1,7 @@
+This directory holds an example of how one might use yajl in the
+simplest possible way, to do something like parse and extract values
+from a configuration file.
+
+Note that use of the yajl_tree.h utility is completely optional, and
+yajl_parse.h offers a lower level stream parsing API that is more
+efficient and flexible at the cost of some complexity.

data/ext/libyajl2/vendor/yajl/example/parse_config.c

@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2007-2014, Lloyd Hilaiel <me@lloyd.io>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ */
+
+#include <stdio.h>
+#include <string.h>
+
+#include "yajl/yajl_tree.h"
+
+static unsigned char fileData[65536];
+
+int
+main(void)
+{
+    size_t rd;
+    yajl_val node;
+    char errbuf[1024];
+
+    /* null plug buffers */
+    fileData[0] = errbuf[0] = 0;
+
+    /* read the entire config file */
+    rd = fread((void *) fileData, 1, sizeof(fileData) - 1, stdin);
+
+    /* file read error handling */
+    if (rd == 0 && !feof(stdin)) {
+        fprintf(stderr, "error encountered on file read\n");
+        return 1;
+    } else if (rd >= sizeof(fileData) - 1) {
+        fprintf(stderr, "config file too big\n");
+        return 1;
+    }
+
+    /* we have the whole config file in memory.  let's parse it ... */
+    node = yajl_tree_parse((const char *) fileData, errbuf, sizeof(errbuf));
+
+    /* parse error handling */
+    if (node == NULL) {
+        fprintf(stderr, "parse_error: ");
+        if (strlen(errbuf)) fprintf(stderr, " %s", errbuf);
+        else fprintf(stderr, "unknown error");
+        fprintf(stderr, "\n");
+        return 1;
+    }
+
+    /* ... and extract a nested value from the config file */
+    {
+        const char * path[] = { "Logging", "timeFormat", (const char *) 0 };
+        yajl_val v = yajl_tree_get(node, path, yajl_t_string);
+        if (v) printf("%s/%s: %s\n", path[0], path[1], YAJL_GET_STRING(v));
+        else   printf("no such node: %s/%s\n", path[0], path[1]);
+    }
+
+    yajl_tree_free(node);
+
+    return 0;
+}