ffi-yajl 0.0.1-universal-java → 3.0.1

data/lib/ffi_yajl/ffi/parser.rb

@@ -1,94 +1,96 @@
-
-require 'ffi_yajl/ffi'
+# Copyright (c) 2015 Lamont Granquist
+# Copyright (c) 2013-2025 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 module FFI_Yajl
   module FFI
     module Parser
-        attr_accessor :stack, :key_stack, :key, :finished
-
-        #
-        # stack used to build up our complex object
-        #
-        def stack
-          @stack ||= Array.new
-        end
-
-        def set_value(val)
-          case stack.last
-          when Hash
-            raise FFI_Yajl::ParseError.new("internal error: missing key in parse") if key.nil?
-            stack.last[key] = val
-          when Array
-            stack.last.push(val)
-          else
-            raise FFI_Yajl::ParseError.new("internal error: object not a hash or array")
-          end
-        end
-
-        def stack_pop
-          if stack.length > 1
-            set_value( stack.pop )
-          else
-            @finished = stack.pop
+      def set_value(val) # rubocop:disable Naming/AccessorMethodName
+        case stack.last
+        when Hash
+          raise FFI_Yajl::ParseError, "internal error: missing key in parse" if key.nil?
+          if @opts[:unique_key_checking] && stack.last.key?(key)
+            raise FFI_Yajl::ParseError, "repeated key: #{key}"
           end
-        end
 
-        #
-        # stack to keep track of keys as we create nested hashes
-        #
-        def key_stack
-          @key_stack ||= Array.new
+          stack.last[key] = val
+        when Array
+          stack.last.push(val)
+        else
+          stack.push(val)
         end
+      end
 
-        def key_push
-          key_stack.push(key)
-        end
+      def stack_pop
+        set_value( stack.pop ) if stack.length > 1
+      end
 
-        def key_pop
-          @key = key_stack.pop()
-        end
+      def key_push
+        key_stack.push(key)
+      end
 
+      def key_pop
+        @key = key_stack.pop
+      end
 
       def setup_callbacks
         @null_callback = ::FFI::Function.new(:int, [:pointer]) do |ctx|
           set_value(nil)
           1
         end
-        @boolean_callback = ::FFI::Function.new(:int, [:pointer, :int]) do |ctx, boolval|
+        @boolean_callback = ::FFI::Function.new(:int, %i{pointer int}) do |ctx, boolval|
           set_value(boolval == 1 ? true : false)
           1
         end
-        @integer_callback = ::FFI::Function.new(:int, [:pointer, :long_long]) do |ctx, intval|
+        @integer_callback = ::FFI::Function.new(:int, %i{pointer long_long}) do |ctx, intval|
           set_value(intval)
           1
         end
-        @number_callback = ::FFI::Function.new(:int, [:pointer, :string, :size_t ]) do |ctx, stringval, stringlen|
-          s = stringval.slice(0,stringlen)
-          s.force_encoding('UTF-8') if defined? Encoding
+        @number_callback = ::FFI::Function.new(:int, %i{pointer string size_t}) do |ctx, stringval, stringlen|
+          s = stringval.slice(0, stringlen)
+          s.force_encoding("UTF-8") if defined? Encoding
           # XXX: I can't think of a better way to do this right now.  need to call to_f if and only if its a float.
-          v = ( s =~ /\./ ) ? s.to_f : s.to_i
+          v = ( s =~ /[\.eE]/ ) ? s.to_f : s.to_i
           set_value(v)
           1
         end
-        @double_callback = ::FFI::Function.new(:int, [:pointer, :double]) do |ctx, doubleval|
+        @double_callback = ::FFI::Function.new(:int, %i{pointer double}) do |ctx, doubleval|
           set_value(doubleval)
           1
         end
-        @string_callback = ::FFI::Function.new(:int, [:pointer, :string, :size_t]) do |ctx, stringval, stringlen|
-          s = stringval.slice(0,stringlen)
-          s.force_encoding('UTF-8') if defined? Encoding
+        @string_callback = ::FFI::Function.new(:int, %i{pointer string size_t}) do |ctx, stringval, stringlen|
+          s = stringval.slice(0, stringlen)
+          s.force_encoding("UTF-8") if defined? Encoding
           set_value(s)
           1
         end
         @start_map_callback = ::FFI::Function.new(:int, [:pointer]) do |ctx|
           key_push  # for key => { } case, save the key
-          stack.push(Hash.new)
+          stack.push({})
           1
         end
-        @map_key_callback = ::FFI::Function.new(:int, [:pointer, :string, :size_t]) do |ctx, key, keylen|
-          s = key.slice(0,keylen)
-          s.force_encoding('UTF-8') if defined? Encoding
-          self.key = s
+        @map_key_callback = ::FFI::Function.new(:int, %i{pointer string size_t}) do |ctx, key, keylen|
+          s = key.slice(0, keylen)
+          s.force_encoding("UTF-8") if defined? Encoding
+          self.key = @opts[:symbolize_keys] ? s.to_sym : s
           1
         end
         @end_map_callback = ::FFI::Function.new(:int, [:pointer]) do |ctx|
@@ -98,7 +100,7 @@ module FFI_Yajl
         end
         @start_array_callback = ::FFI::Function.new(:int, [:pointer]) do |ctx|
           key_push  # for key => [ ] case, save the key
-          stack.push(Array.new)
+          stack.push([])
           1
         end
         @end_array_callback = ::FFI::Function.new(:int, [:pointer]) do |ctx|
@@ -108,8 +110,7 @@ module FFI_Yajl
         end
       end
 
-
-      def do_yajl_parse(str, opts = {})
+      def do_yajl_parse(str, yajl_opts = {})
         setup_callbacks
         callback_ptr = ::FFI::MemoryPointer.new(::FFI_Yajl::YajlCallbacks)
         callbacks = ::FFI_Yajl::YajlCallbacks.new(callback_ptr)
@@ -125,21 +126,38 @@ module FFI_Yajl
         callbacks[:yajl_start_array] = @start_array_callback
         callbacks[:yajl_end_array] = @end_array_callback
         yajl_handle = ::FFI_Yajl.yajl_alloc(callback_ptr, nil, nil)
-        if ( stat = ::FFI_Yajl.yajl_parse(yajl_handle, str, str.bytesize) != :yajl_status_ok )
+
+        # configure the yajl parser
+        if yajl_opts[:yajl_allow_comments]
+          ::FFI_Yajl.yajl_config(yajl_handle, :yajl_allow_comments, :int, 1)
+        end
+        if yajl_opts[:yajl_dont_validate_strings]
+          ::FFI_Yajl.yajl_config(yajl_handle, :yajl_dont_validate_strings, :int, 1)
+        end
+        if yajl_opts[:yajl_allow_trailing_garbage]
+          ::FFI_Yajl.yajl_config(yajl_handle, :yajl_allow_trailing_garbage, :int, 1)
+        end
+        if yajl_opts[:yajl_allow_multiple_values]
+          ::FFI_Yajl.yajl_config(yajl_handle, :yajl_allow_multiple_values, :int, 1)
+        end
+        if yajl_opts[:yajl_allow_partial_values]
+          ::FFI_Yajl.yajl_config(yajl_handle, :yajl_allow_partial_values, :int, 1)
+        end
+
+        if ::FFI_Yajl.yajl_parse(yajl_handle, str, str.bytesize) != :yajl_status_ok
           # FIXME: dup the error and call yajl_free_error?
           error = ::FFI_Yajl.yajl_get_error(yajl_handle, 1, str, str.bytesize)
-          raise ::FFI_Yajl::ParseError.new(error)
+          raise ::FFI_Yajl::ParseError, error
         end
-        if ( stat = FFI_Yajl.yajl_complete_parse(yajl_handle) != :yajl_status_ok )
+        if ::FFI_Yajl.yajl_complete_parse(yajl_handle) != :yajl_status_ok
           # FIXME: dup the error and call yajl_free_error?
           error = ::FFI_Yajl.yajl_get_error(yajl_handle, 1, str, str.bytesize)
-          raise ::FFI_Yajl::ParseError.new(error)
+          raise ::FFI_Yajl::ParseError, error
         end
-        finished
+        stack.pop
       ensure
         ::FFI_Yajl.yajl_free(yajl_handle) if yajl_handle
       end
     end
   end
 end
-

data/lib/ffi_yajl/ffi.rb

@@ -1,19 +1,44 @@
-require 'rubygems'
+# Copyright (c) 2015 Lamont Granquist
+# Copyright (c) 2013-2025 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require "rubygems" unless defined?(Gem)
+
+require "libyajl2"
+begin
+  require "ffi" unless defined?(FFI)
+rescue LoadError
+  $stderr.puts "FATAL: to use the ffi extension instead of the compiled C extension, the ffi gem must be installed"
+  $stderr.puts "       (it is optional, so you must include it in your bundle manually)"
+  exit 1
+end
 
-require 'ffi'
+require_relative "map_library_name"
 
 module FFI_Yajl
   extend ::FFI::Library
 
-  libname = ::FFI.map_library_name("yajl")
-  libpath = File.expand_path(File.join(File.dirname(__FILE__), "..", libname))
+  extend FFI_Yajl::MapLibraryName
 
-  if File.file?(libpath)
-    # use our vendored version of libyajl2 if we find it installed
-    ffi_lib libpath
-  else
-    ffi_lib 'yajl'
-  end
+  ffi_open_yajl_library
 
   class YajlCallbacks < ::FFI::Struct
     layout :yajl_null, :pointer,
@@ -29,37 +54,37 @@ module FFI_Yajl
       :yajl_end_array, :pointer
   end
 
-  enum :yajl_status, [
-    :yajl_status_ok,
-    :yajl_status_client_canceled,
-    :yajl_status_insufficient_data,
-    :yajl_status_error,
-  ]
-
-# FFI::Enums are slow, should remove the rest
-#  enum :yajl_gen_status, [
-#    :yajl_gen_status_ok,
-#    :yajl_gen_keys_must_be_strings,
-#    :yajl_max_depth_exceeded,
-#    :yajl_gen_in_error_state,
-#    :yajl_gen_generation_complete,
-#    :yajl_gen_invalid_number,
-#    :yajl_gen_no_buf,
-#  ]
+  enum :yajl_status, %i{
+    yajl_status_ok
+    yajl_status_client_canceled
+    yajl_status_insufficient_data
+    yajl_status_error
+  }
+
+  # FFI::Enums are slow, should remove the rest
+  #  enum :yajl_gen_status, [
+  #    :yajl_gen_status_ok,
+  #    :yajl_gen_keys_must_be_strings,
+  #    :yajl_max_depth_exceeded,
+  #    :yajl_gen_in_error_state,
+  #    :yajl_gen_generation_complete,
+  #    :yajl_gen_invalid_number,
+  #    :yajl_gen_no_buf,
+  #  ]
 
   enum :yajl_option, [
     :yajl_allow_comments, 0x01,
     :yajl_dont_validate_strings, 0x02,
     :yajl_allow_trailing_garbage, 0x04,
     :yajl_allow_multiple_values, 0x08,
-    :yajl_allow_partial_values, 0x10,
+    :yajl_allow_partial_values, 0x10
   ]
 
   enum :yajl_gen_option, [
     :yajl_gen_beautify, 0x01,
     :yajl_gen_indent_string, 0x02,
     :yajl_gen_print_callback, 0x04,
-    :yajl_gen_validate_utf8, 0x08,
+    :yajl_gen_validate_utf8, 0x08
   ]
 
   typedef :pointer, :yajl_handle
@@ -72,22 +97,22 @@ module FFI_Yajl
   # const char *yajl_status_to_string (yajl_status code)
   attach_function :yajl_status_to_string, [ :yajl_status ], :string
   # yajl_handle yajl_alloc(const yajl_callbacks * callbacks, yajl_alloc_funcs * afs, void * ctx)
-  attach_function :yajl_alloc, [:pointer, :pointer, :pointer], :yajl_handle
+  attach_function :yajl_alloc, %i{pointer pointer pointer}, :yajl_handle
   # void yajl_free (yajl_handle handle)
   attach_function :yajl_free, [:yajl_handle], :void
   # yajl_status yajl_parse (yajl_handle hand, const unsigned char *jsonText, unsigned int jsonTextLength)
-  attach_function :yajl_parse, [:yajl_handle, :ustring, :uint], :yajl_status
+  attach_function :yajl_parse, %i{yajl_handle ustring uint}, :yajl_status
   # yajl_status yajl_parse_complete (yajl_handle hand)
   attach_function :yajl_complete_parse, [:yajl_handle], :yajl_status
   # unsigned char *yajl_get_error (yajl_handle hand, int verbose, const unsigned char *jsonText, unsigned int jsonTextLength)
-  attach_function :yajl_get_error, [:yajl_handle, :int, :ustring, :int], :ustring
+  attach_function :yajl_get_error, %i{yajl_handle int ustring int}, :ustring
   # void yajl_free_error (yajl_handle hand, unsigned char *str)
-  attach_function :yajl_free_error, [:yajl_handle, :ustring], :void
+  attach_function :yajl_free_error, %i{yajl_handle ustring}, :void
 
   #
-  attach_function :yajl_config, [:yajl_handle, :yajl_option, :int], :int
+  attach_function :yajl_config, %i{yajl_handle yajl_option varargs}, :int
 
-  attach_function :yajl_gen_config, [:yajl_gen, :yajl_gen_option, :varargs], :int
+  attach_function :yajl_gen_config, %i{yajl_gen yajl_gen_option varargs}, :int
 
   # yajl_gen yajl_gen_alloc (const yajl_alloc_funcs *allocFuncs)
   attach_function :yajl_gen_alloc, [:pointer], :yajl_gen
@@ -96,34 +121,33 @@ module FFI_Yajl
   # void  yajl_gen_free (yajl_gen handle)
   attach_function :yajl_gen_free, [:yajl_gen], :void
 
-  attach_function :yajl_gen_integer, [:yajl_gen, :long_long], :int
-  attach_function :yajl_gen_double, [:yajl_gen, :double], :int
-  attach_function :yajl_gen_number, [:yajl_gen, :ustring, :int], :int
-  attach_function :yajl_gen_string, [:yajl_gen, :ustring, :int], :int
+  attach_function :yajl_gen_integer, %i{yajl_gen long_long}, :int
+  attach_function :yajl_gen_double, %i{yajl_gen double}, :int
+  attach_function :yajl_gen_number, %i{yajl_gen ustring int}, :int
+  attach_function :yajl_gen_string, %i{yajl_gen ustring int}, :int
   attach_function :yajl_gen_null, [:yajl_gen], :int
-  attach_function :yajl_gen_bool, [:yajl_gen, :int], :int
+  attach_function :yajl_gen_bool, %i{yajl_gen int}, :int
   attach_function :yajl_gen_map_open, [:yajl_gen], :int
   attach_function :yajl_gen_map_close, [:yajl_gen], :int
   attach_function :yajl_gen_array_open, [:yajl_gen], :int
   attach_function :yajl_gen_array_close, [:yajl_gen], :int
   # yajl_gen_status yajl_gen_get_buf (yajl_gen hand, const unsigned char **buf, unsigned int *len)
-  attach_function :yajl_gen_get_buf, [:yajl_gen, :pointer ,:pointer], :int
+  attach_function :yajl_gen_get_buf, %i{yajl_gen pointer pointer}, :int
   # void yajl_gen_clear (yajl_gen hand)
   attach_function :yajl_gen_clear, [:yajl_gen], :void
-
 end
 
-require 'ffi_yajl/encoder'
-require 'ffi_yajl/parser'
+require_relative "encoder"
+require_relative "parser"
 
 module FFI_Yajl
   class Parser
-    require 'ffi_yajl/ffi/parser'
+    require_relative "ffi/parser"
     include FFI_Yajl::FFI::Parser
   end
 
   class Encoder
-    require 'ffi_yajl/ffi/encoder'
+    require_relative "ffi/encoder"
     include FFI_Yajl::FFI::Encoder
   end
 end

data/lib/ffi_yajl/map_library_name.rb

@@ -0,0 +1,109 @@
+# Copyright (c) 2015 Lamont Granquist
+# Copyright (c) 2013-2025 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require "libyajl2"
+
+# Mixin for use in finding the right yajl library on the system.  The 'caller'
+# needs to also mixin either the FFI module or the DLopen module.  Those are
+# deliberately not mixed in to avoid loading the dlopen module in the ffi
+# codepath (which fails on jruby which does not have that C extension).
+
+module FFI_Yajl
+  module MapLibraryName
+    private
+
+    # Stub for tests to override the host_os
+    #
+    # @api private
+    # @return [Array<String>] lower case ruby host_os string
+    def host_os
+      RbConfig::CONFIG["host_os"].downcase
+    end
+
+    # Array of yajl library names on the platform.  Some platforms like Windows
+    # and Mac may have different names/extensions.
+    #
+    # @api private
+    # @return [Array<String>] Array of yajl library names for platform
+    def library_names
+      case host_os
+      when /mingw|mswin/
+        [ "libyajl.so", "yajl.dll" ]
+      when /cygwin/
+        [ "libyajl.so", "cygyajl.dll" ]
+      when /darwin/
+        [ "libyajl.bundle", "libyajl.dylib" ]
+      else
+        [ "libyajl.so" ]
+      end
+    end
+
+    # Array of yajl library names prepended with the libyajl2 path to use to
+    # load those directly and bypass the system libyajl by default.  Since
+    # these are full paths, this API checks to ensure that the file exists on
+    # the filesystem.  May return an empty array.
+    #
+    # @api private
+    # @return [Array<String>] Array of full paths to libyajl2 gem libraries
+    def expanded_library_names
+      library_names.map do |libname|
+        pathname = File.expand_path(File.join(Libyajl2.opt_path, libname))
+        pathname if File.file?(pathname)
+      end.compact
+    end
+
+    # Iterate across the expanded library names in the libyajl2-gem and then
+    # attempt to load the system libraries.  Uses the native dlopen extension
+    # that ships in this gem.
+    #
+    # @api private
+    def dlopen_yajl_library
+      found = false
+      ( expanded_library_names + library_names ).each do |libname|
+
+        dlopen(libname)
+        found = true
+        break
+      rescue ArgumentError
+
+      end
+      raise "cannot find yajl library for platform" unless found
+    end
+
+    # Iterate across the expanded library names in the libyajl2-gem and attempt
+    # to load them.  If they are missing just use `ffi_lib 'yajl'` to accept
+    # the FFI default algorithm to find the library.
+    #
+    # @api private
+    def ffi_open_yajl_library
+      found = false
+      expanded_library_names.each do |libname|
+
+        ffi_lib libname
+        found = true
+      rescue LoadError
+
+      end
+      ffi_lib "yajl" unless found
+    end
+  end
+end

data/lib/ffi_yajl/parser.rb

@@ -1,21 +1,89 @@
+# Copyright (c) 2015 Lamont Granquist
+# Copyright (c) 2013-2025 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 module FFI_Yajl
   class ParseError < StandardError; end
+
   class Parser
+    attr_writer :stack, :key_stack
+    attr_accessor :key, :finished
+
     attr_accessor :opts
 
+    #
+    # stack used to build up our complex object
+    #
+    def stack
+      @stack ||= []
+    end
+
+    #
+    # stack to keep track of keys as we create nested hashes
+    #
+    def key_stack
+      @key_stack ||= []
+    end
+
     def self.parse(obj, *args)
       new(*args).parse(obj)
     end
 
     def initialize(opts = {})
-      @opts = opts
+      @opts = opts ? opts.dup : {}
+      # JSON gem uses 'symbolize_names' and ruby-yajl supports this as well
+      @opts[:symbolize_keys] = true if @opts[:symbolize_names]
     end
 
     def parse(str)
+      raise FFI_Yajl::ParseError, "input must be a string or IO" unless str.is_a?(String) || str.respond_to?(:read)
+
       # initialization that we can do in pure ruby
       yajl_opts = {}
 
+      if @opts[:check_utf8] == false && @opts[:dont_validate_strings] == false
+        raise ArgumentError, "options check_utf8 and dont_validate_strings are both false which conflict"
+      end
+      if @opts[:check_utf8] == true && @opts[:dont_validate_strings] == true
+        raise ArgumentError, "options check_utf8 and dont_validate_strings are both true which conflict"
+      end
+
+      yajl_opts[:yajl_allow_comments] = true
+
+      if @opts.key?(:allow_comments)
+        yajl_opts[:yajl_allow_comments] = @opts[:allow_comments]
+      end
+
+      yajl_opts[:yajl_dont_validate_strings]  = (@opts[:check_utf8] == false || @opts[:dont_validate_strings])
+      yajl_opts[:yajl_allow_trailing_garbage] = @opts[:allow_trailing_garbage]
+      yajl_opts[:yajl_allow_multiple_values]  = @opts[:allow_multiple_values]
+      yajl_opts[:yajl_allow_partial_values]   = @opts[:allow_partial_values]
+
+      yajl_opts[:unique_key_checking]         = @opts[:unique_key_checking]
+
+      # XXX: bug-compat with ruby-yajl
+      return nil if str == ""
+
+      str = str.read if str.respond_to?(:read)
+
       # call either the ext or ffi hook
       do_yajl_parse(str, yajl_opts)
     end

data/lib/ffi_yajl/platform.rb

@@ -0,0 +1,29 @@
+# Copyright (c) 2015 Lamont Granquist
+# Copyright (c) 2013-2025 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+module FFI_Yajl
+  module Platform
+    def windows?
+      !!(RUBY_PLATFORM =~ /mswin|mingw|cygwin|windows/)
+    end
+  end
+end

data/lib/ffi_yajl/version.rb

@@ -1,3 +1,25 @@
+# Copyright (c) 2015 Lamont Granquist
+# Copyright:: Copyright (c) 2013-2025 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
 module FFI_Yajl
-  VERSION = "0.0.1"
+  VERSION = "3.0.1".freeze
 end