yajl-ffi 0.1.2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 6de3c945368d22be36236e10320d4f352eb30d92
-  data.tar.gz: fb7fb82310439d20429da612ac5e134bfeb1e733
+SHA256:
+  metadata.gz: fffd8c833d69c6f4f8d4789c0ce9280424382e54f9cf88c01692b4e391f89da1
+  data.tar.gz: 2f7b4c56052718cc19ed6ec12ade7919f316bb03fd7bbf9b4a46ce951b5602d9
 SHA512:
-  metadata.gz: 42d060dadaf9bc2e0eea2e5ce7e218180b7bd6c483ae449ec4e8329d1da61bac9c85fd7c96a9ea374f49eca828fc967663f7caa0f43300bf458c4fe4a9567a4d
-  data.tar.gz: e0b43c9e8427a05d72f76e69e468baf69483e69fd0290571173b023a283c8f5ae7791b99fb36c6457ecd35a1be4346e5281063790a99bbe2cd6a17a539c7b8d6
+  metadata.gz: 25b94db497125d03576caf1cd50096672a6d5de266c608887b056ce68ec685a5f0557c13cecb9a64e398a3e0a1f832ce16173bdb3f8871243701ef1d6d7d5c96
+  data.tar.gz: 756be42ebd98bbaa2548853869b93d1b6ba00e6c12277df6ef57284eb1a8089bc3ede827c6a1f8b13a78d440371ba470ac01756329d6e76a7d6036e3725cd7d5

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+gemspec
+
+group :benchmark do
+  gem 'json'
+  gem 'json-stream'
+  gem 'yajl-ruby'
+end

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2014 David Graham
+Copyright (c) 2014-2024 David Graham
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -56,8 +56,8 @@ def post_init
   @parser.end_object     { puts "end object" }
   @parser.start_array    { puts "start array" }
   @parser.end_array      { puts "end array" }
-  @parser.key            {|k| puts "key: #{k}" }
-  @parser.value          {|v| puts "value: #{v}" }
+  @parser.key            { |k| puts "key: #{k}" }
+  @parser.value          { |v| puts "value: #{v}" }
 end
 
 def receive_data(data)
@@ -83,8 +83,6 @@ processed in constant memory space this way.
 ## Dependencies
 
 * [libyajl2](https://github.com/lloyd/yajl)
-* ruby >= 1.9.3
-* jruby >= 1.7
 
 ## Library loading
 
@@ -146,25 +144,21 @@ $ ./configure
 $ make && make install
 ```
 
-## Alternatives
-
-* [json](https://github.com/flori/json)
-* [yajl-ruby](https://github.com/brianmario/yajl-ruby)
-* [json-stream](https://github.com/dgraham/json-stream)
+## Performance
 
 This gem provides a benchmark script to test the relative performance of
 several parsers. Here's a sample run.
 
 ```
-$ rake benchmark
+$ bin/rake benchmark
                   user     system      total        real
-json          0.120000   0.010000   0.130000 (  0.130072)
-yajl-ruby     0.130000   0.000000   0.130000 (  0.129388)
-yajl-ffi      0.790000   0.010000   0.800000 (  0.805279)
-json-stream   7.500000   0.030000   7.530000 (  7.524760)
+json          0.037963   0.002951   0.040914 (  0.041196)
+yajl-ruby     0.043128   0.001845   0.044973 (  0.045292)
+yajl-ffi      0.181198   0.004324   0.185522 (  0.186301)
+json-stream   2.169778   0.010984   2.180762 (  2.196817)
 ```
 
-Yajl::FFI is about 6x slower than the pure native parsers. JSON::Stream is a
+Yajl::FFI is about 4x slower than the pure native parsers. JSON::Stream is a
 pure Ruby parser, and it performs accordingly. But it's useful in cases where
 you're unable to use native bindings or when the limiting factor is the
 network, rather than processor speed.
@@ -174,6 +168,20 @@ are the best options. If you need to stream, and incrementally parse, pieces of
 large document in constant memory space, yajl-ffi and json-stream are good
 choices.
 
+## Alternatives
+
+* [json](https://github.com/flori/json)
+* [yajl-ruby](https://github.com/brianmario/yajl-ruby)
+* [json-stream](https://github.com/dgraham/json-stream)
+* [application/json-seq](http://www.rfc-editor.org/rfc/rfc7464.txt)
+
+## Development
+
+```
+$ bin/setup
+$ bin/rake test
+```
+
 ## License
 
 Yajl::FFI is released under the MIT license. Check the LICENSE file for details.

data/lib/yajl/ffi/parser.rb

@@ -8,8 +8,8 @@ module Yajl
     # Examples
     #
     #   parser = Yajl::FFI::Parser.new
-    #   parser.key {|key| puts key }
-    #   parser.value {|value| puts value }
+    #   parser.key { |key| puts key }
+    #   parser.value { |value| puts value }
     #   parser << '{"answer":'
     #   parser << ' 42}'
     class Parser
@@ -56,8 +56,8 @@ module Yajl
       #     end_object     { puts "end object" }
       #     start_array    { puts "start array" }
       #     end_array      { puts "end array" }
-      #     key            {|k| puts "key: #{k}" }
-      #     value          {|v| puts "value: #{v}" }
+      #     key            { |k| puts "key: #{k}" }
+      #     value          { |v| puts "value: #{v}" }
       #   end
       def initialize(&block)
         @listeners = {
@@ -176,9 +176,9 @@ module Yajl
       #
       # Examples
       #
-      #    # broadcast events for {"answer": 42}
+      #    # Broadcast events for {"answer": 42}
       #    notify(:start_object)
-      #    notify(:key, "answer")
+      #    notify(:key, 'answer')
       #    notify(:value, 42)
       #    notify(:end_object)
       #

data/lib/yajl/ffi/tasks/benchmark.rake

@@ -1,6 +1,5 @@
 desc 'Compare parser performance'
 task :benchmark do
-  $: << './lib'
   require 'benchmark'
   require 'json'
   require 'json/stream'

data/lib/yajl/ffi/version.rb

@@ -1,5 +1,5 @@
 module Yajl
   module FFI
-    VERSION = '0.1.2'
+    VERSION = '1.0.0'
   end
 end

data/yajl-ffi.gemspec

@@ -11,12 +11,13 @@ Gem::Specification.new do |s|
   s.homepage     = 'https://github.com/dgraham/yajl-ffi'
   s.license      = 'MIT'
 
-  s.files        = Dir['[A-Z]*', 'yajl-ffi.gemspec', '{lib}/**/*']
-  s.test_files   = Dir['spec/**/*']
+  s.files        = Dir['[A-Z]*', 'yajl-ffi.gemspec', '{lib}/**/*'] - ['Gemfile.lock']
   s.require_path = 'lib'
 
-  s.add_dependency 'ffi', '~> 1.9'
-  s.add_development_dependency 'rake', '~> 10.3'
+  s.add_dependency 'ffi', '~> 1.16'
+  s.add_development_dependency 'bundler', '~> 2.2'
+  s.add_development_dependency 'minitest', '~> 5.22'
+  s.add_development_dependency 'rake', '~> 13.2'
 
-  s.required_ruby_version = '>= 1.9.3'
+  s.required_ruby_version = '>= 2.6.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yajl-ffi
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 1.0.0
 platform: ruby
 authors:
 - David Graham
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-07-08 00:00:00.000000000 Z
+date: 2024-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -16,28 +16,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '1.16'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.22'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.3'
+        version: '13.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.3'
+        version: '13.2'
 description: Ruby FFI bindings to the native YAJL streaming JSON parser.
 email:
 - david.malcom.graham@gmail.com
@@ -45,6 +73,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- Gemfile
 - LICENSE
 - README.md
 - Rakefile
@@ -53,15 +82,12 @@ files:
 - lib/yajl/ffi/parser.rb
 - lib/yajl/ffi/tasks/benchmark.rake
 - lib/yajl/ffi/version.rb
-- spec/builder_spec.rb
-- spec/fixtures/repository.json
-- spec/parser_spec.rb
 - yajl-ffi.gemspec
 homepage: https://github.com/dgraham/yajl-ffi
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -69,19 +95,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.2.2
-signing_key: 
+rubygems_version: 3.5.4
+signing_key:
 specification_version: 4
 summary: A streaming JSON parser that generates SAX-like events.
-test_files:
-- spec/builder_spec.rb
-- spec/fixtures/repository.json
-- spec/parser_spec.rb
+test_files: []

data/spec/builder_spec.rb

@@ -1,155 +0,0 @@
-require 'yajl/ffi'
-require 'minitest/autorun'
-
-describe Yajl::FFI::Builder do
-  let(:parser) { Yajl::FFI::Parser.new }
-  subject { Yajl::FFI::Builder.new(parser) }
-
-  it 'builds a false value' do
-    assert_nil subject.result
-    subject.start_document
-    subject.value(false)
-    assert_nil subject.result
-    subject.end_document
-    assert_equal false, subject.result
-  end
-
-  it 'builds a string value' do
-    assert_nil subject.result
-    subject.start_document
-    subject.value("test")
-    assert_nil subject.result
-    subject.end_document
-    assert_equal "test", subject.result
-  end
-
-  it 'builds an empty array' do
-    assert_nil subject.result
-    subject.start_document
-    subject.start_array
-    subject.end_array
-    assert_nil subject.result
-    subject.end_document
-    assert_equal [], subject.result
-  end
-
-  it 'builds an array of numbers' do
-    subject.start_document
-    subject.start_array
-    subject.value(1)
-    subject.value(2)
-    subject.value(3)
-    subject.end_array
-    subject.end_document
-    assert_equal [1, 2, 3], subject.result
-  end
-
-  it 'builds nested empty arrays' do
-    subject.start_document
-    subject.start_array
-    subject.start_array
-    subject.end_array
-    subject.end_array
-    subject.end_document
-    assert_equal [[]], subject.result
-  end
-
-  it 'builds nested arrays of numbers' do
-    subject.start_document
-    subject.start_array
-    subject.value(1)
-    subject.start_array
-    subject.value(2)
-    subject.end_array
-    subject.value(3)
-    subject.end_array
-    subject.end_document
-    assert_equal [1, [2], 3], subject.result
-  end
-
-  it 'builds an empty object' do
-    subject.start_document
-    subject.start_object
-    subject.end_object
-    subject.end_document
-    assert_equal({}, subject.result)
-  end
-
-  it 'builds a complex object' do
-    subject.start_document
-    subject.start_object
-    subject.key("k1")
-    subject.value(1)
-    subject.key("k2")
-    subject.value(nil)
-    subject.key("k3")
-    subject.value(true)
-    subject.key("k4")
-    subject.value(false)
-    subject.key("k5")
-    subject.value("string value")
-    subject.end_object
-    subject.end_document
-    expected = {
-      "k1" => 1,
-      "k2" => nil,
-      "k3" => true,
-      "k4" => false,
-      "k5" => "string value"
-    }
-    assert_equal expected, subject.result
-  end
-
-  it 'builds a nested object' do
-    subject.start_document
-    subject.start_object
-    subject.key("k1")
-    subject.value(1)
-
-    subject.key("k2")
-    subject.start_object
-    subject.end_object
-
-    subject.key("k3")
-    subject.start_object
-      subject.key("sub1")
-      subject.start_array
-        subject.value(12)
-      subject.end_array
-    subject.end_object
-
-    subject.key("k4")
-    subject.start_array
-      subject.value(1)
-      subject.start_object
-        subject.key("sub2")
-        subject.start_array
-        subject.value(nil)
-        subject.end_array
-      subject.end_object
-    subject.end_array
-
-    subject.key("k5")
-    subject.value("string value")
-    subject.end_object
-    subject.end_document
-    expected = {
-      "k1" => 1,
-      "k2" => {},
-      "k3" => {"sub1" => [12]},
-      "k4" => [1, {"sub2" => [nil]}],
-      "k5" => "string value"
-    }
-    assert_equal expected, subject.result
-  end
-
-  it 'builds a real document' do
-    refute_nil subject
-    parser << File.read('spec/fixtures/repository.json')
-    refute_nil subject.result
-    assert_equal 'rails', subject.result['name']
-    assert_equal 4223, subject.result['owner']['id']
-    assert_equal false, subject.result['fork']
-    assert_equal nil, subject.result['mirror_url']
-  end
-end

data/spec/fixtures/repository.json

@@ -1,107 +0,0 @@
-{
-  "id": 8514,
-  "name": "rails",
-  "full_name": "rails/rails",
-  "owner": {
-    "login": "rails",
-    "id": 4223,
-    "avatar_url": "https://avatars.githubusercontent.com/u/4223?",
-    "gravatar_id": "30f39a09e233e8369dddf6feb4be0308",
-    "url": "https://api.github.com/users/rails",
-    "html_url": "https://github.com/rails",
-    "followers_url": "https://api.github.com/users/rails/followers",
-    "following_url": "https://api.github.com/users/rails/following{/other_user}",
-    "gists_url": "https://api.github.com/users/rails/gists{/gist_id}",
-    "starred_url": "https://api.github.com/users/rails/starred{/owner}{/repo}",
-    "subscriptions_url": "https://api.github.com/users/rails/subscriptions",
-    "organizations_url": "https://api.github.com/users/rails/orgs",
-    "repos_url": "https://api.github.com/users/rails/repos",
-    "events_url": "https://api.github.com/users/rails/events{/privacy}",
-    "received_events_url": "https://api.github.com/users/rails/received_events",
-    "type": "Organization",
-    "site_admin": false
-  },
-  "private": false,
-  "html_url": "https://github.com/rails/rails",
-  "description": "Ruby on Rails",
-  "fork": false,
-  "url": "https://api.github.com/repos/rails/rails",
-  "forks_url": "https://api.github.com/repos/rails/rails/forks",
-  "keys_url": "https://api.github.com/repos/rails/rails/keys{/key_id}",
-  "collaborators_url": "https://api.github.com/repos/rails/rails/collaborators{/collaborator}",
-  "teams_url": "https://api.github.com/repos/rails/rails/teams",
-  "hooks_url": "https://api.github.com/repos/rails/rails/hooks",
-  "issue_events_url": "https://api.github.com/repos/rails/rails/issues/events{/number}",
-  "events_url": "https://api.github.com/repos/rails/rails/events",
-  "assignees_url": "https://api.github.com/repos/rails/rails/assignees{/user}",
-  "branches_url": "https://api.github.com/repos/rails/rails/branches{/branch}",
-  "tags_url": "https://api.github.com/repos/rails/rails/tags",
-  "blobs_url": "https://api.github.com/repos/rails/rails/git/blobs{/sha}",
-  "git_tags_url": "https://api.github.com/repos/rails/rails/git/tags{/sha}",
-  "git_refs_url": "https://api.github.com/repos/rails/rails/git/refs{/sha}",
-  "trees_url": "https://api.github.com/repos/rails/rails/git/trees{/sha}",
-  "statuses_url": "https://api.github.com/repos/rails/rails/statuses/{sha}",
-  "languages_url": "https://api.github.com/repos/rails/rails/languages",
-  "stargazers_url": "https://api.github.com/repos/rails/rails/stargazers",
-  "contributors_url": "https://api.github.com/repos/rails/rails/contributors",
-  "subscribers_url": "https://api.github.com/repos/rails/rails/subscribers",
-  "subscription_url": "https://api.github.com/repos/rails/rails/subscription",
-  "commits_url": "https://api.github.com/repos/rails/rails/commits{/sha}",
-  "git_commits_url": "https://api.github.com/repos/rails/rails/git/commits{/sha}",
-  "comments_url": "https://api.github.com/repos/rails/rails/comments{/number}",
-  "issue_comment_url": "https://api.github.com/repos/rails/rails/issues/comments/{number}",
-  "contents_url": "https://api.github.com/repos/rails/rails/contents/{+path}",
-  "compare_url": "https://api.github.com/repos/rails/rails/compare/{base}...{head}",
-  "merges_url": "https://api.github.com/repos/rails/rails/merges",
-  "archive_url": "https://api.github.com/repos/rails/rails/{archive_format}{/ref}",
-  "downloads_url": "https://api.github.com/repos/rails/rails/downloads",
-  "issues_url": "https://api.github.com/repos/rails/rails/issues{/number}",
-  "pulls_url": "https://api.github.com/repos/rails/rails/pulls{/number}",
-  "milestones_url": "https://api.github.com/repos/rails/rails/milestones{/number}",
-  "notifications_url": "https://api.github.com/repos/rails/rails/notifications{?since,all,participating}",
-  "labels_url": "https://api.github.com/repos/rails/rails/labels{/name}",
-  "releases_url": "https://api.github.com/repos/rails/rails/releases{/id}",
-  "created_at": "2008-04-11T02:19:47Z",
-  "updated_at": "2014-06-25T21:08:45Z",
-  "pushed_at": "2014-06-25T17:47:52Z",
-  "git_url": "git://github.com/rails/rails.git",
-  "ssh_url": "git@github.com:rails/rails.git",
-  "clone_url": "https://github.com/rails/rails.git",
-  "svn_url": "https://github.com/rails/rails",
-  "homepage": "http://rubyonrails.org",
-  "size": 331047,
-  "stargazers_count": 22248,
-  "watchers_count": 22248,
-  "language": "Ruby",
-  "has_issues": true,
-  "has_downloads": true,
-  "has_wiki": false,
-  "forks_count": 8278,
-  "mirror_url": null,
-  "open_issues_count": 625,
-  "forks": 8278,
-  "open_issues": 625,
-  "watchers": 22248,
-  "default_branch": "master",
-  "organization": {
-    "login": "rails",
-    "id": 4223,
-    "avatar_url": "https://avatars.githubusercontent.com/u/4223?",
-    "gravatar_id": "30f39a09e233e8369dddf6feb4be0308",
-    "url": "https://api.github.com/users/rails",
-    "html_url": "https://github.com/rails",
-    "followers_url": "https://api.github.com/users/rails/followers",
-    "following_url": "https://api.github.com/users/rails/following{/other_user}",
-    "gists_url": "https://api.github.com/users/rails/gists{/gist_id}",
-    "starred_url": "https://api.github.com/users/rails/starred{/owner}{/repo}",
-    "subscriptions_url": "https://api.github.com/users/rails/subscriptions",
-    "organizations_url": "https://api.github.com/users/rails/orgs",
-    "repos_url": "https://api.github.com/users/rails/repos",
-    "events_url": "https://api.github.com/users/rails/events{/privacy}",
-    "received_events_url": "https://api.github.com/users/rails/received_events",
-    "type": "Organization",
-    "site_admin": false
-  },
-  "network_count": 8278,
-  "subscribers_count": 1521
-}