rapidjson 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17354e68c40c730955b333eacdc5232255f5c0e12605a2e35ea0a90dd84def19
-  data.tar.gz: c3d95c72fb9e4416f33007bf7076ed616e82bd138b2637e0a2e0a57a5b55faed
+  metadata.gz: 722ff2bcb2ebfc8ab861d5066e53e938933bd03d2e7f4bca7662233fa0a8a314
+  data.tar.gz: 59d25e68af12d81bc3b5517a88de320a76a72c6b5d7cc9d26758084bd604b9fe
 SHA512:
-  metadata.gz: 5d3dc6b671e1cc4110c457a8551fdf05b62ef03ff355a93531406b32853fd0b9174bc6a9ae3b743f891fd1ff4fe8eb95506b36bff9753ca1ed8f60970e694ed7
-  data.tar.gz: 26195d47a4c2a68b190f0d46da8e09d2df7125b89ad53478758c9db74bf59e65c5a0a6b9fb10f47372da45fe25e269a0c6e48c44b36af10f3f22222739e70497
+  metadata.gz: 4eea208e695986e0e312c3794ba44852057f86a8159c4d862518482d263f2d13ef94fff481c38e2d7a79f881a13cef08e65eff4d49ded5c85378891bc79dab85
+  data.tar.gz: cafbbb2e33c4adecdfac50d1fc0bb34e3c1b019828af29714b0005a8a24955c3914c79e7a9690161589597b3df12928d6adddad8887014fd48fb36b58525f25d

data/README.md

@@ -2,6 +2,8 @@
 
 (Maybe) Ruby's fastest JSON library! Built using the [RapidJSON C++ library](https://rapidjson.org/)
 
+No monkey patches, ActiveSupport integration, `json` gem emulation.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -42,6 +44,58 @@ RapidJSON.pretty_encode(json_string)
 # }
 ```
 
+By default the encoder is "strict" and will raise an exception
+
+## ActiveSupport
+
+RapidJSON provides a drop-in replacement ActiveSupport encoder, with very good compatibility.
+Add the following to an initializer to opt-in.
+
+```
+# config/initializers/rapidjson.rb
+
+ActiveSupport::JSON::Encoding.json_encoder = RapidJSON::ActiveSupportEncoder
+```
+
+This makes `model.to_json` ~15x faster, and `nested_hash.to_json` ~27x faster (compred using Rails 7.0)
+
+## JSON gem compatibility
+
+Contrary to some other JSON libraries, `RapidJSON` doesn't provice a monkey patch to entirely replace the stdlib JSON gem.
+
+However it does provide a module that behave like the stdlib JSON gem and that can be used to monkey patch existing code.
+
+```ruby
+module SomeLibrary
+  def do_stuff(payload)
+    JSON.parse(payload)
+  end
+end
+```
+
+```ruby
+SomeLibrary::JSON = RapidJSON::JSONGem
+```
+
+Note that this module only use `RapidJSON` when it's certain it is safe to do so. If the JSON gem is called with
+some options that `RapidJSON` doesn't support, it automatically fallbacks to calling the JSON gem.
+
+## Advanced usage
+
+By default RapidJSON will only encode "JSON-ready" types: `Hash`, `Array`, `Integer`, `Float`, `String`, `Symbol`, `true`, `false`, and `nil`.
+
+RapidJSON::Coder can be initialized with a block which allows the behaviour to be customized. This is how the ActiveSupport encoder and JSON compatibility above are implemented! Just using Ruby :heart:.
+
+```
+RapidJSON::Coder.new do |object, is_key|
+  object.to_s # Convert any unknown object to string
+end
+```
+
+The block is called only for unrecognized types. The return value is expected to be a "JSON ready" type which will then be encoded.
+
+One additional special type is `RapidJSON::Fragment`, which is interpreted as an existing JSON-encoded string. This can be used to efficiently embed an existing JSON document, or to provide compatibility.
+
 ## Performance
 
 Your current JSON parser/encoder is probably fine.
@@ -88,27 +142,6 @@ I spent a week working on YAJL/yajl-ruby, and though I really liked the library,
 
 However, if you're happy with your current Ruby JSON library (including `json`) you should keep using it. They're all very good.
 
-## JSON gem compatibility
-
-Contrary to some other JSON libraries, `RapidJSON` doesn't provice a monkey patch to entirely replace the stdlib JSON gem.
-
-However it does provide a module that behave like the stdlib JSON gem and that can be used to monkey patch existing code.
-
-```ruby
-module SomeLibrary
-  def do_stuff(payload)
-    JSON.parse(payload)
-  end
-end
-```
-
-```ruby
-SomeLibrary::JSON = RapidJSON::JSONGem
-```
-
-Note that this module only use `RapidJSON` when it's certain it is safe to do so. If the JSON gem is called with
-some options that `RapidJSON` doesn't support, it automatically fallbacks to calling the JSON gem.
-
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/ext/rapidjson/buffer.hh

@@ -12,9 +12,16 @@ class RubyStringBuffer {
             mem = RSTRING_PTR(ruby_string);
         }
 
-        void Reserve(size_t size) {
-            if (capacity - used < size) {
-                resize(capacity * 2);
+        void Reserve(size_t want) {
+            if (capacity - used < want) {
+                size_t new_capacity = capacity;
+                while (new_capacity - used < want) {
+                    if (new_capacity >= SIZE_MAX / 2) {
+                        ruby_malloc_size_overflow(capacity, 2);
+                    }
+                    new_capacity <<= 1;
+                }
+                resize(new_capacity);
             }
         }
 

data/lib/rapidjson/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RapidJSON
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rapidjson
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - John Hawthorn
@@ -93,7 +93,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: Fast JSON encoder/decoder based using RapidJSON