yajl-ruby 0.5.5

data/ext/yajl_bytestack.h

@@ -0,0 +1,85 @@
+/*
+ * Copyright 2009, Lloyd Hilaiel.
+ * 
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ * 
+ *  1. Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ * 
+ *  2. Redistributions in binary form must reproduce the above copyright
+ *     notice, this list of conditions and the following disclaimer in
+ *     the documentation and/or other materials provided with the
+ *     distribution.
+ * 
+ *  3. Neither the name of Lloyd Hilaiel nor the names of its
+ *     contributors may be used to endorse or promote products derived
+ *     from this software without specific prior written permission.
+ * 
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */ 
+
+/*
+ * A header only implementation of a simple stack of bytes, used in YAJL
+ * to maintain parse state.
+ */
+
+#ifndef __YAJL_BYTESTACK_H__
+#define __YAJL_BYTESTACK_H__
+
+#include "api/yajl_common.h"
+
+#define YAJL_BS_INC 128
+
+typedef struct yajl_bytestack_t
+{
+    unsigned char * stack;
+    unsigned int size;
+    unsigned int used;
+    yajl_alloc_funcs * yaf;
+} yajl_bytestack;
+
+/* initialize a bytestack */
+#define yajl_bs_init(obs, _yaf) {               \
+        (obs).stack = NULL;                     \
+        (obs).size = 0;                         \
+        (obs).used = 0;                         \
+        (obs).yaf = (_yaf);                     \
+    }                                           \
+
+
+/* initialize a bytestack */
+#define yajl_bs_free(obs)                 \
+    if ((obs).stack) (obs).yaf->free((obs).yaf->ctx, (obs).stack);   
+
+#define yajl_bs_current(obs)               \
+    (assert((obs).used > 0), (obs).stack[(obs).used - 1])
+
+#define yajl_bs_push(obs, byte) {                       \
+    if (((obs).size - (obs).used) == 0) {               \
+        (obs).size += YAJL_BS_INC;                      \
+        (obs).stack = (obs).yaf->realloc((obs).yaf->ctx,\
+                                         (void *) (obs).stack, (obs).size);\
+    }                                                   \
+    (obs).stack[((obs).used)++] = (byte);               \
+}
+    
+/* removes the top item of the stack, returns nothing */
+#define yajl_bs_pop(obs) { ((obs).used)--; }
+
+#define yajl_bs_set(obs, byte)                          \
+    (obs).stack[((obs).used) - 1] = (byte);             
+    
+
+#endif

data/ext/yajl_encode.c

@@ -0,0 +1,179 @@
+/*
+ * Copyright 2007-2009, Lloyd Hilaiel.
+ * 
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ * 
+ *  1. Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ * 
+ *  2. Redistributions in binary form must reproduce the above copyright
+ *     notice, this list of conditions and the following disclaimer in
+ *     the documentation and/or other materials provided with the
+ *     distribution.
+ * 
+ *  3. Neither the name of Lloyd Hilaiel nor the names of its
+ *     contributors may be used to endorse or promote products derived
+ *     from this software without specific prior written permission.
+ * 
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */ 
+
+#include "yajl_encode.h"
+
+#include <assert.h>
+#include <stdlib.h>
+#include <string.h>
+#include <stdio.h>
+
+static void CharToHex(unsigned char c, char * hexBuf)
+{
+    const char * hexchar = "0123456789ABCDEF";
+    hexBuf[0] = hexchar[c >> 4];
+    hexBuf[1] = hexchar[c & 0x0F];
+}
+
+void
+yajl_string_encode(yajl_buf buf, const unsigned char * str,
+                   unsigned int len)
+{
+    unsigned int beg = 0;
+    unsigned int end = 0;    
+    char hexBuf[7];
+    hexBuf[0] = '\\'; hexBuf[1] = 'u'; hexBuf[2] = '0'; hexBuf[3] = '0';
+    hexBuf[6] = 0;
+
+    while (end < len) {
+        const char * escaped = NULL;
+        switch (str[end]) {
+            case '\r': escaped = "\\r"; break;
+            case '\n': escaped = "\\n"; break;
+            case '\\': escaped = "\\\\"; break;
+            /* case '/': escaped = "\\/"; break; */
+            case '"': escaped = "\\\""; break;
+            case '\f': escaped = "\\f"; break;
+            case '\b': escaped = "\\b"; break;
+            case '\t': escaped = "\\t"; break;
+            default:
+                if ((unsigned char) str[end] < 32) {
+                    CharToHex(str[end], hexBuf + 4);
+                    escaped = hexBuf;
+                }
+                break;
+        }
+        if (escaped != NULL) {
+            yajl_buf_append(buf, str + beg, end - beg);
+            yajl_buf_append(buf, escaped, strlen(escaped));
+            beg = ++end;
+        } else {
+            ++end;
+        }
+    }
+    yajl_buf_append(buf, str + beg, end - beg);
+}
+
+static void hexToDigit(unsigned int * val, const unsigned char * hex)
+{
+    unsigned int i;
+    for (i=0;i<4;i++) {
+        unsigned char c = hex[i];
+        if (c >= 'A') c = (c & ~0x20) - 7;
+        c -= '0';
+        assert(!(c & 0xF0));
+        *val = (*val << 4) | c;
+    }
+}
+
+static void Utf32toUtf8(unsigned int codepoint, char * utf8Buf) 
+{
+    if (codepoint < 0x80) {
+        utf8Buf[0] = (char) codepoint;
+        utf8Buf[1] = 0;
+    } else if (codepoint < 0x0800) {
+        utf8Buf[0] = (char) ((codepoint >> 6) | 0xC0);
+        utf8Buf[1] = (char) ((codepoint & 0x3F) | 0x80);
+        utf8Buf[2] = 0;
+    } else if (codepoint < 0x10000) {
+        utf8Buf[0] = (char) ((codepoint >> 12) | 0xE0);
+        utf8Buf[1] = (char) (((codepoint >> 6) & 0x3F) | 0x80);
+        utf8Buf[2] = (char) ((codepoint & 0x3F) | 0x80);
+        utf8Buf[3] = 0;
+    } else if (codepoint < 0x200000) {
+        utf8Buf[0] =(char)((codepoint >> 18) | 0xF0);
+        utf8Buf[1] =(char)(((codepoint >> 12) & 0x3F) | 0x80);
+        utf8Buf[2] =(char)(((codepoint >> 6) & 0x3F) | 0x80);
+        utf8Buf[3] =(char)((codepoint & 0x3F) | 0x80);
+        utf8Buf[4] = 0;
+    } else {
+        utf8Buf[0] = '?';
+        utf8Buf[1] = 0;
+    }
+}
+
+void yajl_string_decode(yajl_buf buf, const unsigned char * str,
+                        unsigned int len)
+{
+    unsigned int beg = 0;
+    unsigned int end = 0;    
+
+    while (end < len) {
+        if (str[end] == '\\') {
+            char utf8Buf[5];
+            const char * unescaped = "?";
+            yajl_buf_append(buf, str + beg, end - beg);
+            switch (str[++end]) {
+                case 'r': unescaped = "\r"; break;
+                case 'n': unescaped = "\n"; break;
+                case '\\': unescaped = "\\"; break;
+                case '/': unescaped = "/"; break;
+                case '"': unescaped = "\""; break;
+                case 'f': unescaped = "\f"; break;
+                case 'b': unescaped = "\b"; break;
+                case 't': unescaped = "\t"; break;
+                case 'u': {
+                    unsigned int codepoint = 0;
+                    hexToDigit(&codepoint, str + ++end);
+                    end+=3;
+                    /* check if this is a surrogate */
+                    if ((codepoint & 0xFC00) == 0xD800) {
+                        end++;
+                        if (str[end] == '\\' && str[end + 1] == 'u') {
+                            unsigned int surrogate = 0;
+                            hexToDigit(&surrogate, str + end + 2);
+                            codepoint =
+                                (((codepoint & 0x3F) << 10) | 
+                                 ((((codepoint >> 6) & 0xF) + 1) << 16) | 
+                                 (surrogate & 0x3FF));
+                            end += 5;
+                        } else {
+                            unescaped = "?";
+                            break;
+                        }
+                    }
+                    
+                    Utf32toUtf8(codepoint, utf8Buf);
+                    unescaped = utf8Buf;
+                    break;
+                }
+                default:
+                    assert("this should never happen" == NULL);
+            }
+            yajl_buf_append(buf, unescaped, strlen(unescaped));
+            beg = ++end;
+        } else {
+            end++;
+        }
+    }
+    yajl_buf_append(buf, str + beg, end - beg);
+}

data/ext/yajl_encode.h

@@ -0,0 +1,44 @@
+/*
+ * Copyright 2007-2009, Lloyd Hilaiel.
+ * 
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ * 
+ *  1. Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer.
+ * 
+ *  2. Redistributions in binary form must reproduce the above copyright
+ *     notice, this list of conditions and the following disclaimer in
+ *     the documentation and/or other materials provided with the
+ *     distribution.
+ * 
+ *  3. Neither the name of Lloyd Hilaiel nor the names of its
+ *     contributors may be used to endorse or promote products derived
+ *     from this software without specific prior written permission.
+ * 
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */ 
+
+#ifndef __YAJL_ENCODE_H__
+#define __YAJL_ENCODE_H__
+
+#include "yajl_buf.h"
+
+void yajl_string_encode(yajl_buf buf, const unsigned char * str,
+                        unsigned int length);
+
+void yajl_string_decode(yajl_buf buf, const unsigned char * str,
+                        unsigned int length);
+
+#endif

data/ext/yajl_ext.c

@@ -0,0 +1,774 @@
+#include "yajl_ext.h"
+
+// Helpers for building objects
+inline void yajl_check_and_fire_callback(void * ctx) {
+    struct yajl_parser_wrapper * wrapper;
+    GetParser((VALUE)ctx, wrapper);
+    
+    // No need to do any of this if the callback isn't even setup
+    if (wrapper->parse_complete_callback != Qnil) {
+        int len = RARRAY_LEN(wrapper->builderStack);
+        if (len == 1 && wrapper->nestedArrayLevel == 0 && wrapper->nestedHashLevel == 0) {
+            rb_funcall(wrapper->parse_complete_callback, intern_call, 1, rb_ary_pop(wrapper->builderStack));
+        }
+    } else {
+        int len = RARRAY_LEN(wrapper->builderStack);
+        if (len == 1 && wrapper->nestedArrayLevel == 0 && wrapper->nestedHashLevel == 0) {
+            wrapper->objectsFound++;
+            if (wrapper->objectsFound > 1) {
+                rb_raise(cParseError, "%s", "Found multiple JSON objects in the stream but no block or the on_parse_complete callback was assigned to handle them.");
+            }
+        }
+    }
+}
+
+inline void yajl_set_static_value(void * ctx, VALUE val) {
+    struct yajl_parser_wrapper * wrapper;
+    VALUE lastEntry, hash;
+    int len;
+    
+    GetParser((VALUE)ctx, wrapper);
+    
+    len = RARRAY_LEN(wrapper->builderStack);
+    if (len > 0) {
+        lastEntry = rb_ary_entry(wrapper->builderStack, len-1);
+        switch (TYPE(lastEntry)) {
+            case T_ARRAY:
+                rb_ary_push(lastEntry, val);
+                if (TYPE(val) == T_HASH || TYPE(val) == T_ARRAY) {
+                    rb_ary_push(wrapper->builderStack, val);
+                }
+                break;
+            case T_HASH:
+                rb_hash_aset(lastEntry, val, Qnil);
+                rb_ary_push(wrapper->builderStack, val);
+                break;
+            case T_STRING:
+            case T_SYMBOL:
+                hash = rb_ary_entry(wrapper->builderStack, len-2);
+                if (TYPE(hash) == T_HASH) {
+                    rb_hash_aset(hash, lastEntry, val);
+                    rb_ary_pop(wrapper->builderStack);
+                    if (TYPE(val) == T_HASH || TYPE(val) == T_ARRAY) {
+                        rb_ary_push(wrapper->builderStack, val);
+                    }
+                }
+                break;
+        }
+    } else {
+        rb_ary_push(wrapper->builderStack, val);
+    }
+}
+
+void yajl_encode_part(yajl_gen hand, VALUE obj, VALUE io) {
+    VALUE str, outBuff, otherObj;
+    yajl_gen_status status;
+    int idx = 0;
+    const unsigned char * buffer;
+    unsigned int len;
+    
+    if (io != Qnil) {
+        status = yajl_gen_get_buf(hand, &buffer, &len);
+        if (len >= WRITE_BUFSIZE) {
+            outBuff = rb_str_new((const char *)buffer, len);
+            rb_io_write(io, outBuff);
+            yajl_gen_clear(hand);
+        }
+    }
+    
+    switch (TYPE(obj)) {
+        case T_HASH:
+            status = yajl_gen_map_open(hand);
+            
+            // TODO: itterate through keys in the hash
+            VALUE keys = rb_funcall(obj, intern_keys, 0);
+            VALUE entry, keyStr;
+            for(idx=0; idx<RARRAY_LEN(keys); idx++) {
+                entry = rb_ary_entry(keys, idx);
+                keyStr = rb_funcall(entry, intern_to_s, 0); // key must be a string
+                // the key
+                yajl_encode_part(hand, keyStr, io);
+                // the value
+                yajl_encode_part(hand, rb_hash_aref(obj, entry), io);
+            }
+            
+            status = yajl_gen_map_close(hand);
+            break;
+        case T_ARRAY:
+            status = yajl_gen_array_open(hand);
+            for(idx=0; idx<RARRAY_LEN(obj); idx++) {
+                otherObj = rb_ary_entry(obj, idx);
+                yajl_encode_part(hand, otherObj, io);
+            }
+            status = yajl_gen_array_close(hand);
+            break;
+        case T_NIL:
+            status = yajl_gen_null(hand);
+            break;
+        case T_TRUE:
+            status = yajl_gen_bool(hand, 1);
+            break;
+        case T_FALSE:
+            status = yajl_gen_bool(hand, 0);
+            break;
+        case T_FIXNUM:
+        case T_FLOAT:
+        case T_BIGNUM:
+            str = rb_funcall(obj, intern_to_s, 0);
+            status = yajl_gen_number(hand, RSTRING_PTR(str), (unsigned int)RSTRING_LEN(str));
+            break;
+        case T_STRING:
+            status = yajl_gen_string(hand, (const unsigned char *)RSTRING_PTR(obj), (unsigned int)RSTRING_LEN(obj));
+            break;
+        default:
+            if (rb_respond_to(obj, intern_to_json)) {
+                str = rb_funcall(obj, intern_to_json, 0);
+            } else {
+                str = rb_funcall(obj, intern_to_s, 0);
+            }
+            status = yajl_gen_string(hand, (const unsigned char *)RSTRING_PTR(str), (unsigned int)RSTRING_LEN(str));
+            break;
+    }
+}
+
+void yajl_parser_wrapper_free(void * wrapper) {
+    struct yajl_parser_wrapper * w = wrapper;
+    yajl_free(w->parser);
+    free(w);
+}
+
+void yajl_parser_wrapper_mark(void * wrapper) {
+    struct yajl_parser_wrapper * w = wrapper;
+    rb_gc_mark(w->builderStack);
+    rb_gc_mark(w->parse_complete_callback);
+}
+
+void yajl_parse_chunk(const unsigned char * chunk, unsigned int len, yajl_handle parser) {
+    yajl_status stat;
+    
+    stat = yajl_parse(parser, chunk, len);
+    
+    if (stat != yajl_status_ok && stat != yajl_status_insufficient_data) {
+        unsigned char * str = yajl_get_error(parser, 1, chunk, len);
+        rb_raise(cParseError, "%s", (const char *) str);
+        yajl_free_error(parser, str);
+    }
+}
+
+// YAJL Callbacks
+static int yajl_found_null(void * ctx) {
+    yajl_set_static_value(ctx, Qnil);
+    yajl_check_and_fire_callback(ctx);
+    return 1;
+}
+
+static int yajl_found_boolean(void * ctx, int boolean) {
+    yajl_set_static_value(ctx, boolean ? Qtrue : Qfalse);
+    yajl_check_and_fire_callback(ctx);
+    return 1;
+}
+
+static int yajl_found_number(void * ctx, const char * numberVal, unsigned int numberLen) {
+    VALUE subString = rb_str_new(numberVal, numberLen);
+    char * cSubString = RSTRING_PTR(subString);
+    
+    if (strstr(cSubString, ".") != NULL || strstr(cSubString, "e") != NULL || strstr(cSubString, "E") != NULL) {
+            yajl_set_static_value(ctx, rb_Float(subString));
+    } else {
+        yajl_set_static_value(ctx, rb_Integer(subString));
+    }
+    yajl_check_and_fire_callback(ctx);
+    return 1;
+}
+
+static int yajl_found_string(void * ctx, const unsigned char * stringVal, unsigned int stringLen) {
+    yajl_set_static_value(ctx, rb_str_new((const char *)stringVal, stringLen));
+    yajl_check_and_fire_callback(ctx);
+    return 1;
+}
+
+static int yajl_found_hash_key(void * ctx, const unsigned char * stringVal, unsigned int stringLen) {
+    struct yajl_parser_wrapper * wrapper;
+    GetParser((VALUE)ctx, wrapper);
+    VALUE keyStr = rb_str_new((const char *)stringVal, stringLen);
+    
+    if (wrapper->symbolizeKeys) {
+        ID key = rb_intern(RSTRING_PTR(keyStr));
+        yajl_set_static_value(ctx, ID2SYM(key));
+    } else {
+        yajl_set_static_value(ctx, keyStr);
+    }
+    yajl_check_and_fire_callback(ctx);
+    return 1;
+}
+
+static int yajl_found_start_hash(void * ctx) {
+    struct yajl_parser_wrapper * wrapper;
+    GetParser((VALUE)ctx, wrapper);
+    wrapper->nestedHashLevel++;
+    yajl_set_static_value(ctx, rb_hash_new());
+    return 1;
+}
+
+static int yajl_found_end_hash(void * ctx) {
+    struct yajl_parser_wrapper * wrapper;
+    GetParser((VALUE)ctx, wrapper);
+    wrapper->nestedHashLevel--;
+    if (RARRAY_LEN(wrapper->builderStack) > 1) {
+        rb_ary_pop(wrapper->builderStack);
+    }
+    yajl_check_and_fire_callback(ctx);
+    return 1;
+}
+
+static int yajl_found_start_array(void * ctx) {
+    struct yajl_parser_wrapper * wrapper;
+    GetParser((VALUE)ctx, wrapper);
+    wrapper->nestedArrayLevel++;
+    yajl_set_static_value(ctx, rb_ary_new());
+    return 1;
+}
+
+static int yajl_found_end_array(void * ctx) {
+    struct yajl_parser_wrapper * wrapper;
+    GetParser((VALUE)ctx, wrapper);
+    wrapper->nestedArrayLevel--;
+    if (RARRAY_LEN(wrapper->builderStack) > 1) {
+        rb_ary_pop(wrapper->builderStack);
+    }
+    yajl_check_and_fire_callback(ctx);
+    return 1;
+}
+
+
+// Ruby Interface
+
+/*
+ * Document-class: Yajl::Parser
+ *
+ * This class contains methods for parsing JSON directly from an IO object.
+ * The only basic requirment currently is that the IO object respond to #read(len) and #eof?
+ * The IO is parsed until a complete JSON object has been read and a ruby object will be returned.
+ */
+ 
+/*
+ * Document-method: new
+ *
+ * call-seq: new([:symbolize_keys => true, [:allow_comments => false[, :check_utf8 => false]]])
+ *
+ * :symbolize_keys will turn hash keys into Ruby symbols, defaults to false.
+ *
+ * :allow_comments will turn on/off the check for comments inside the JSON stream, defaults to true.
+ *
+ * :check_utf8 will validate UTF8 characters found in the JSON stream, defaults to true.
+ */
+static VALUE rb_yajl_parser_new(int argc, VALUE * argv, VALUE klass) {
+    struct yajl_parser_wrapper * wrapper;
+    yajl_parser_config cfg;
+    VALUE opts, obj;
+    int allowComments = 1, checkUTF8 = 1, symbolizeKeys = 0;
+    
+    // Scan off config vars
+    if (rb_scan_args(argc, argv, "01", &opts) == 1) {
+        Check_Type(opts, T_HASH);
+        
+        if (rb_hash_aref(opts, ID2SYM(sym_allow_comments)) == Qfalse) {
+            allowComments = 0;
+        }
+        if (rb_hash_aref(opts, ID2SYM(sym_check_utf8)) == Qfalse) {
+            checkUTF8 = 0;
+        }
+        if (rb_hash_aref(opts, ID2SYM(sym_symbolize_keys)) == Qtrue) {
+            symbolizeKeys = 1;
+        }
+    }
+    cfg = (yajl_parser_config){allowComments, checkUTF8};
+    
+    obj = Data_Make_Struct(klass, struct yajl_parser_wrapper, yajl_parser_wrapper_mark, yajl_parser_wrapper_free, wrapper);
+    wrapper->parser = yajl_alloc(&callbacks, &cfg, NULL, (void *)obj);
+    wrapper->nestedArrayLevel = 0;
+    wrapper->nestedHashLevel = 0;
+    wrapper->objectsFound = 0;
+    wrapper->symbolizeKeys = symbolizeKeys;
+    wrapper->builderStack = rb_ary_new();
+    wrapper->parse_complete_callback = Qnil;
+    rb_obj_call_init(obj, 0, 0);
+    return obj;
+}
+
+/*
+ * Document-method: initialize
+ *
+ * call-seq: new([:symbolize_keys => true, [:allow_comments => false[, :check_utf8 => false]]])
+ *
+ * :symbolize_keys will turn hash keys into Ruby symbols, defaults to false.
+ *
+ * :allow_comments will turn on/off the check for comments inside the JSON stream, defaults to true.
+ *
+ * :check_utf8 will validate UTF8 characters found in the JSON stream, defaults to true.
+ */
+static VALUE rb_yajl_parser_init(int argc, VALUE * argv, VALUE self) {
+    return self;
+}
+
+/*
+ * Document-method: parse
+ *
+ * call-seq:
+ *  parse(input, buffer_size=8092)
+ *  parse(input, buffer_size=8092) { |obj| ... }
+ *
+ * +input+ can either be a string or an IO to parse JSON from
+ *
+ * +buffer_size+ is the size of chunk that will be parsed off the input (if it's an IO) for each loop of the parsing process.
+ * 8092 is a good balance between the different types of streams (off disk, off a socket, etc...), but this option
+ * is here so the caller can better tune their parsing depending on the type of stream being passed.
+ * A larger read buffer will perform better for files off disk, where as a smaller size may be more efficient for
+ * reading off of a socket directly.
+ *
+ * If a block was passed, it's called when an object has been parsed off the stream. This is especially
+ * usefull when parsing a stream of multiple JSON objects.
+ *
+ * NOTE: you can optionally assign the +on_parse_complete+ callback, and it will be called the same way the optional
+ * block is for this method.
+*/
+static VALUE rb_yajl_parser_parse(int argc, VALUE * argv, VALUE self) {
+    yajl_status stat;
+    struct yajl_parser_wrapper * wrapper;
+    VALUE parsed, rbufsize, input, blk;
+    
+    GetParser(self, wrapper);
+    parsed = rb_str_new2("");
+    
+    // setup our parameters
+    rb_scan_args(argc, argv, "11&", &input, &rbufsize, &blk);
+    if (NIL_P(rbufsize)) {
+        rbufsize = INT2FIX(READ_BUFSIZE);
+    } else {
+        Check_Type(rbufsize, T_FIXNUM);
+    }
+    if (!NIL_P(blk)) {
+        rb_yajl_set_complete_cb(self, blk);
+    }
+    
+    if (TYPE(input) == T_STRING) {
+        yajl_parse_chunk((const unsigned char *)RSTRING_PTR(input), RSTRING_LEN(input), wrapper->parser);
+    } else if (rb_respond_to(input, intern_eof)) {
+        while (rb_funcall(input, intern_eof, 0) != Qtrue) {
+            rb_funcall(input, intern_io_read, 2, rbufsize, parsed);
+            yajl_parse_chunk((const unsigned char *)RSTRING_PTR(parsed), RSTRING_LEN(parsed), wrapper->parser);
+        }
+    } else {
+        rb_raise(cParseError, "input must be a string or IO");
+    }
+    
+    // parse any remaining buffered data
+    stat = yajl_parse_complete(wrapper->parser);
+    
+    if (wrapper->parse_complete_callback != Qnil) {
+        yajl_check_and_fire_callback((void *)self);
+        return Qnil;
+    }
+
+    return rb_ary_pop(wrapper->builderStack);
+}
+
+/*
+ * Document-method: parse_chunk
+ *
+ * call-seq: parse_chunk(string_chunk)
+ *
+ * +string_chunk+ can be a partial or full JSON string to push on the parser.
+ *
+ * This method will throw an exception if the +on_parse_complete+ callback hasn't been assigned yet.
+ * The +on_parse_complete+ callback assignment is required so the user can handle objects that have been
+ * parsed off the stream as they're found.
+ */
+static VALUE rb_yajl_parser_parse_chunk(VALUE self, VALUE chunk) {
+    struct yajl_parser_wrapper * wrapper;
+    
+    GetParser(self, wrapper);
+    if (NIL_P(chunk)) {
+        rb_raise(cParseError, "Can't parse a nil string.");
+        return Qnil;
+    }
+    
+    if (wrapper->parse_complete_callback != Qnil) {
+        yajl_parse_chunk((const unsigned char *)RSTRING_PTR(chunk), RSTRING_LEN(chunk), wrapper->parser);
+    } else {
+        rb_raise(cParseError, "The on_parse_complete callback isn't setup, parsing useless.");
+    }
+
+    return Qnil;
+}
+
+/*
+ * Document-method: on_parse_complete=
+ *
+ * call-seq: on_parse_complete = Proc.new { |obj| ... }
+ *
+ * This callback setter allows you to pass a Proc/lambda or any other object that response to #call.
+ *
+ * It will pass a single parameter, the ruby object built from the last parsed JSON object
+ */
+static VALUE rb_yajl_set_complete_cb(VALUE self, VALUE callback) {
+    struct yajl_parser_wrapper * wrapper;
+    GetParser(self, wrapper);
+    wrapper->parse_complete_callback = callback;
+    return Qnil;
+}
+
+/*
+ * Document-class: Yajl::Encoder
+ *
+ * This class contains methods for encoding a Ruby object into JSON, streaming it's output into an IO object.
+ * The IO object need only respond to #write(str)
+ * The JSON stream created is written to the IO in chunks, as it's being created.
+ */
+
+/*
+ * Document-method: new
+ *
+ * call-seq: new([:pretty => false[, :indent => '  ']])
+ *
+ * :pretty will enable/disable beautifying or "pretty priting" the output string.
+ *
+ * :indent is the character(s) used to indent the output string.
+ */
+static VALUE rb_yajl_encoder_new(int argc, VALUE * argv, VALUE klass) {
+    yajl_gen_config cfg;
+    yajl_gen encoder;
+    VALUE opts, obj, indent;
+    const char * indentString = "  ";
+    int beautify = 0;
+    
+    // Scan off config vars
+    if (rb_scan_args(argc, argv, "01", &opts) == 1) {
+        Check_Type(opts, T_HASH);
+        
+        if (rb_hash_aref(opts, ID2SYM(sym_pretty)) == Qtrue) {
+            beautify = 1;
+            indent = rb_hash_aref(opts, ID2SYM(sym_indent));
+            if (indent != Qnil) {
+                Check_Type(indent, T_STRING);
+                indentString = RSTRING_PTR(indent);
+            }
+        }
+    }
+    cfg = (yajl_gen_config){beautify, indentString};
+    
+    encoder = yajl_gen_alloc(&cfg, NULL);
+    obj = Data_Wrap_Struct(klass, 0, yajl_gen_free, encoder);
+    rb_obj_call_init(obj, 0, 0);
+    return obj;
+}
+
+/*
+ * Document-method: initialize
+ *
+ * call-seq: initialize([:pretty => false[, :indent => '  ']])
+ *
+ * :pretty will enable/disable beautifying or "pretty priting" the output string.
+ *
+ * :indent is the character(s) used to indent the output string.
+ */
+static VALUE rb_yajl_encoder_init(int argc, VALUE * argv, VALUE self) {
+    return self;
+}
+
+/*
+ * Document-method: encode
+ *
+ * call-seq: encode(obj[, io[, &block]])
+ *
+ * +obj+ is the Ruby object to encode to JSON
+ *
+ * +io+ is an optional IO used to stream the encoded JSON string to.
+ * If +io+ isn't specified, this method will return the resulting JSON string. If +io+ is specified, this method returns nil
+ *
+ * If an optional block is passed, it's called when encoding is complete and passed the resulting JSON string
+ *
+ * It should be noted that you can reuse an instance of this class to continue encoding multiple JSON
+ * to the same stream. Just continue calling this method, passing it the same IO object with new/different
+ * ruby objects to encode. This is how streaming is accomplished.
+ */
+static VALUE rb_yajl_encoder_encode(int argc, VALUE * argv, VALUE self) {
+    yajl_gen encoder;
+    const unsigned char * buffer;
+    unsigned int len;
+    VALUE obj, io, blk, outBuff;
+    
+    GetEncoder(self, encoder);
+    
+    rb_scan_args(argc, argv, "11&", &obj, &io, &blk);
+    
+    // begin encode process
+    yajl_encode_part(encoder, obj, io);
+
+    // just make sure we output the remaining buffer
+    yajl_gen_get_buf(encoder, &buffer, &len);
+    outBuff = rb_str_new((const char *)buffer, len);
+    yajl_gen_clear(encoder);
+    if (io != Qnil) {
+        rb_io_write(io, outBuff);
+        return Qnil;
+    } else if (blk != Qnil) {
+        rb_funcall(blk, intern_call, 1, outBuff);
+        return Qnil;
+    } else {
+        return outBuff;
+    }
+    return Qnil;
+}
+
+
+// JSON Gem compatibility
+
+/*
+ * Document-class: Object
+ */
+/*
+ * Document-method: to_json
+ *
+ * call-seq: to_json(encoder=Yajl::Encoder.new)
+ *
+ * +encoder+ is an existing Yajl::Encoder used to encode JSON
+ *
+ * Encodes an instance of Object to JSON
+ */
+static VALUE rb_yajl_json_ext_object_to_json(int argc, VALUE * argv, VALUE self) {
+    VALUE rb_encoder;
+    rb_scan_args(argc, argv, "01", &rb_encoder);
+    if (rb_encoder == Qnil) {
+        rb_encoder = rb_yajl_encoder_new(0, NULL, cEncoder);
+    }
+    return rb_yajl_encoder_encode(1, &self, rb_encoder);
+}
+
+/*
+ * Document-class: Hash
+ */
+/*
+ * Document-method: to_json
+ *
+ * call-seq: to_json(encoder=Yajl::Encoder.new)
+ *
+ * +encoder+ is an existing Yajl::Encoder used to encode JSON
+ *
+ * Encodes an instance of Hash to JSON
+ */
+static VALUE rb_yajl_json_ext_hash_to_json(int argc, VALUE * argv, VALUE self) {
+    VALUE rb_encoder;
+    rb_scan_args(argc, argv, "01", &rb_encoder);
+    if (rb_encoder == Qnil) {
+        rb_encoder = rb_yajl_encoder_new(0, NULL, cEncoder);
+    }
+    return rb_yajl_encoder_encode(1, &self, rb_encoder);
+}
+
+/*
+ * Document-class: Array
+ */
+/*
+ * Document-method: to_json
+ *
+ * call-seq: to_json(encoder=Yajl::Encoder.new)
+ *
+ * +encoder+ is an existing Yajl::Encoder used to encode JSON
+ *
+ * Encodes an instance of Array to JSON
+ */
+static VALUE rb_yajl_json_ext_array_to_json(int argc, VALUE * argv, VALUE self) {
+    VALUE rb_encoder;
+    rb_scan_args(argc, argv, "01", &rb_encoder);
+    if (rb_encoder == Qnil) {
+        rb_encoder = rb_yajl_encoder_new(0, NULL, cEncoder);
+    }
+    return rb_yajl_encoder_encode(1, &self, rb_encoder);
+}
+
+/*
+ * Document-class: Fixnum
+ */
+/*
+ * Document-method: to_json
+ *
+ * call-seq: to_json(encoder=Yajl::Encoder.new)
+ *
+ * +encoder+ is an existing Yajl::Encoder used to encode JSON
+ *
+ * Encodes an instance of Fixnum to JSON
+ */
+static VALUE rb_yajl_json_ext_fixnum_to_json(int argc, VALUE * argv, VALUE self) {
+    VALUE rb_encoder;
+    rb_scan_args(argc, argv, "01", &rb_encoder);
+    if (rb_encoder == Qnil) {
+        rb_encoder = rb_yajl_encoder_new(0, NULL, cEncoder);
+    }
+    return rb_yajl_encoder_encode(1, &self, rb_encoder);
+}
+
+/*
+ * Document-class: Float
+ */
+/*
+ * Document-method: to_json
+ *
+ * call-seq: to_json(encoder=Yajl::Encoder.new)
+ *
+ * +encoder+ is an existing Yajl::Encoder used to encode JSON
+ *
+ * Encodes an instance of Float to JSON
+ */
+static VALUE rb_yajl_json_ext_float_to_json(int argc, VALUE * argv, VALUE self) {
+    VALUE rb_encoder;
+    rb_scan_args(argc, argv, "01", &rb_encoder);
+    if (rb_encoder == Qnil) {
+        rb_encoder = rb_yajl_encoder_new(0, NULL, cEncoder);
+    }
+    return rb_yajl_encoder_encode(1, &self, rb_encoder);
+}
+
+/*
+ * Document-class: String
+ */
+/*
+ * Document-method: to_json
+ *
+ * call-seq: to_json(encoder=Yajl::Encoder.new)
+ *
+ * +encoder+ is an existing Yajl::Encoder used to encode JSON
+ *
+ * Encodes an instance of TrueClass to JSON
+ */
+static VALUE rb_yajl_json_ext_string_to_json(int argc, VALUE * argv, VALUE self) {
+    VALUE rb_encoder;
+    rb_scan_args(argc, argv, "01", &rb_encoder);
+    if (rb_encoder == Qnil) {
+        rb_encoder = rb_yajl_encoder_new(0, NULL, cEncoder);
+    }
+    return rb_yajl_encoder_encode(1, &self, rb_encoder);
+}
+
+/*
+ * Document-class: TrueClass
+ */
+/*
+ * Document-method: to_json
+ *
+ * call-seq: to_json(encoder=Yajl::Encoder.new)
+ *
+ * +encoder+ is an existing Yajl::Encoder used to encode JSON
+ *
+ * Encodes an instance of TrueClass to JSON
+ */
+static VALUE rb_yajl_json_ext_true_to_json(int argc, VALUE * argv, VALUE self) {
+    VALUE rb_encoder;
+    rb_scan_args(argc, argv, "01", &rb_encoder);
+    if (rb_encoder == Qnil) {
+        rb_encoder = rb_yajl_encoder_new(0, NULL, cEncoder);
+    }
+    return rb_yajl_encoder_encode(1, &self, rb_encoder);
+}
+
+/*
+ * Document-class: FalseClass
+ */
+/*
+ * Document-method: to_json
+ *
+ * call-seq: to_json(encoder=Yajl::Encoder.new)
+ *
+ * +encoder+ is an existing Yajl::Encoder used to encode JSON
+ *
+ * Encodes an instance of FalseClass to JSON
+ */
+static VALUE rb_yajl_json_ext_false_to_json(int argc, VALUE * argv, VALUE self) {
+    VALUE rb_encoder;
+    rb_scan_args(argc, argv, "01", &rb_encoder);
+    if (rb_encoder == Qnil) {
+        rb_encoder = rb_yajl_encoder_new(0, NULL, cEncoder);
+    }
+    return rb_yajl_encoder_encode(1, &self, rb_encoder);
+}
+
+/*
+ * Document-class: NilClass
+ */
+/*
+ * Document-method: to_json
+ *
+ * call-seq: to_json(encoder=Yajl::Encoder.new)
+ *
+ * +encoder+ is an existing Yajl::Encoder used to encode JSON
+ *
+ * Encodes an instance of NilClass to JSON
+ */
+static VALUE rb_yajl_json_ext_nil_to_json(int argc, VALUE * argv, VALUE self) {
+    VALUE rb_encoder;
+    rb_scan_args(argc, argv, "01", &rb_encoder);
+    if (rb_encoder == Qnil) {
+        rb_encoder = rb_yajl_encoder_new(0, NULL, cEncoder);
+    }
+    return rb_yajl_encoder_encode(1, &self, rb_encoder);
+}
+
+/*
+ * Document-class: Yajl::Encoder
+ */
+/*
+ * Document-method: enable_json_gem_compatability
+ *
+ * call-seq: enable_json_gem_compatability
+ *
+ * Enables the JSON gem compatibility API
+ */
+static VALUE rb_yajl_encoder_enable_json_gem_ext(VALUE klass) {
+    rb_define_method(rb_cObject, "to_json", rb_yajl_json_ext_object_to_json, -1);
+    rb_define_method(rb_cHash, "to_json", rb_yajl_json_ext_hash_to_json, -1);
+    rb_define_method(rb_cArray, "to_json", rb_yajl_json_ext_array_to_json, -1);
+    rb_define_method(rb_cFixnum, "to_json", rb_yajl_json_ext_fixnum_to_json, -1);
+    rb_define_method(rb_cFloat, "to_json", rb_yajl_json_ext_float_to_json, -1);
+    rb_define_method(rb_cString, "to_json", rb_yajl_json_ext_string_to_json, -1);
+    rb_define_method(rb_cTrueClass, "to_json", rb_yajl_json_ext_true_to_json, -1);
+    rb_define_method(rb_cFalseClass, "to_json", rb_yajl_json_ext_false_to_json, -1);
+    rb_define_method(rb_cNilClass, "to_json", rb_yajl_json_ext_nil_to_json, -1);
+    return Qnil;
+}
+
+
+// Ruby Extension initializer
+void Init_yajl_ext() {
+    mYajl = rb_define_module("Yajl");
+    
+    cParseError = rb_define_class_under(mYajl, "ParseError", rb_eStandardError);
+    cEncodeError = rb_define_class_under(mYajl, "EncodeError", rb_eStandardError);
+    
+    cParser = rb_define_class_under(mYajl, "Parser", rb_cObject);
+    rb_define_singleton_method(cParser, "new", rb_yajl_parser_new, -1);
+    rb_define_method(cParser, "initialize", rb_yajl_parser_init, -1);
+    rb_define_method(cParser, "parse", rb_yajl_parser_parse, -1);
+    rb_define_method(cParser, "parse_chunk", rb_yajl_parser_parse_chunk, -1);
+    rb_define_method(cParser, "<<", rb_yajl_parser_parse_chunk, 1);
+    rb_define_method(cParser, "on_parse_complete=", rb_yajl_set_complete_cb, 1);
+    
+    cEncoder = rb_define_class_under(mYajl, "Encoder", rb_cObject);
+    rb_define_singleton_method(cEncoder, "new", rb_yajl_encoder_new, -1);
+    rb_define_method(cEncoder, "initialize", rb_yajl_encoder_init, -1);
+    rb_define_method(cEncoder, "encode", rb_yajl_encoder_encode, -1);
+    
+    rb_define_singleton_method(cEncoder, "enable_json_gem_compatability", rb_yajl_encoder_enable_json_gem_ext, 0);
+    
+    intern_io_read = rb_intern("read");
+    intern_eof = rb_intern("eof?");
+    intern_call = rb_intern("call");
+    intern_keys = rb_intern("keys");
+    intern_to_s = rb_intern("to_s");
+    intern_to_json = rb_intern("to_json");
+    
+    sym_allow_comments = rb_intern("allow_comments");
+    sym_check_utf8 = rb_intern("check_utf8");
+    sym_pretty = rb_intern("pretty");
+    sym_indent = rb_intern("indent");
+    sym_symbolize_keys = rb_intern("symbolize_keys");
+}