canon 0.3.23 → 0.3.24

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e3fda4e37d9ca6cf584389c0ffec06c70811ec488910377151ed8ee29f20a35
-  data.tar.gz: cb73f6f95b16ce10b9ada9f13d1e91eaad0a4bce416d84ddfb49439227f270d5
+  metadata.gz: e1d317692d756e058f2a4fb6865fffa4240744ac1b7cf8c83cb026552acb3f16
+  data.tar.gz: b993bde4273af1fdfe30d05b43bc0e642b9c3b80d857dc437196d2e7ea20567f
 SHA512:
-  metadata.gz: 48a6dacc76c75c234a34583264f0cd3816c643bda7152ccbeee62cb4057fd370c70b168414bca515addc400de5ea12dacb82b9a356d35e4421596bff0109806b
-  data.tar.gz: a33a5b36fbd98f43d4832dbb275737726f5e9dc1786b91fc34313684a8e431724e3f169a426c18af3d90a15be1fb9a4970e561ef25d2f576ff52229cfebc1829
+  metadata.gz: 6ee303aab423e1bfb48b754b441c8e70b307af2a03956bd1cb7c5998dcb575cfc57c9c6ba1d02a22af74717cfbd8aaa1f05b88a52cc698da6e8547e3a0a25ce8
+  data.tar.gz: a2de4ba755d59ecd72bfe50e53f6fea6c1136cbc98fda6886c22f5240098a84235d304040dcefb8e1d882a9bab27228f86030bf784b297cbb29df1c745a622af

data/CLAUDE.md

@@ -145,7 +145,7 @@ Engine A/B testing: `CANON_XML_BACKEND=nokogiri bundle exec rspec` (or `=moxml`
 
 ### YAML Engines
 
-`Canon::YamlBackend` selects the YAML engine: `:psych` (default) or `:yeptris` (FFI over libyeptris, the YAML counterpart of the leptris XML stack — `CANON_YAML_BACKEND=yeptris` opts in; the optional `yeptris` Gemfile group must be enabled). `Canon::YamlParsing` is the single gateway for string loads; `YAML.dump` stays on Psych everywhere — canonical output bytes are canon's product and the writers differ. The default stays `:psych` until the yeptris Psych-parity gaps close (yeptris-ruby#29 empty documents, #30 sexagesimal scalars, #31 >64-bit integers); `spec/canon/yaml_engine_parity_spec.rb` is the executable gate, with upstream-tracked cases pending. Never `require "yeptris/psych"` — it rebinds the global `::Psych` constant for the whole process; only the namespaced `Yeptris::YAML` API is used.
+`Canon::YamlBackend` selects the YAML engine: `:psych` (default) or `:yeptris` (FFI over libyeptris, the YAML counterpart of the leptris XML stack — `CANON_YAML_BACKEND=yeptris` opts in; the optional `yeptris` Gemfile group must be enabled). `Canon::YamlParsing` is the single gateway for string loads; `Canon::JsonParsing` mirrors it for JSON (the same yeptris engine serves both — `Yeptris::YAML.load` auto-detects JSON and routes to the native C-API materializer; JSON falls back to stdlib unless `YamlBackend.yeptris_native?`, since the FFI ladder is ~29x slower than the stdlib C extension). `YAML.dump` stays on Psych everywhere — canonical output bytes are canon's product and the writers differ. The default stays `:psych` until the yeptris Psych-parity gaps close (yeptris-ruby#30 sexagesimal scalars, #31 >64-bit integers — #29 empty documents was fixed in 0.1.12); `spec/canon/yaml_engine_parity_spec.rb` is the executable gate, with upstream-tracked cases pending. Never `require "yeptris/psych"` — it rebinds the global `::Psych` constant for the whole process; only the namespaced `Yeptris::YAML` API is used.
 
 ### Format Detection
 

data/lib/canon/comparison/json_comparator.rb

@@ -64,7 +64,7 @@ module Canon
           return obj unless obj.is_a?(String)
 
           begin
-            JSON.parse(obj)
+            Canon::JsonParsing.parse(obj)
           rescue JSON::ParserError
             obj
           end

data/lib/canon/formatters/json_formatter.rb

@@ -17,7 +17,7 @@ module Canon
         # Return as-is if already parsed
         return json if json.is_a?(Hash) || json.is_a?(Array)
 
-        JSON.parse(json)
+        Canon::JsonParsing.parse(json)
       end
 
       def self.sort_json_keys(obj)

data/lib/canon/json_parsing.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Canon
+  # The only place canon talks to a JSON engine. The yeptris fast path
+  # (fused C-API materializer, on par with the stdlib C extension)
+  # engages through Yeptris::YAML.load's JSON auto-detection; without
+  # the native materializer the stdlib parser serves, unchanged.
+  # Errors normalize to JSON::ParserError so canon's rescues hold on
+  # both engines.
+  module JsonParsing
+    module_function
+
+    def parse(json)
+      if Canon::YamlBackend.yeptris_native?
+        begin
+          ::Yeptris::YAML.load(json)
+        rescue ::Yeptris::ParseError, ::FFI::NullPointerError => e
+          raise JSON::ParserError, e.message
+        end
+      else
+        JSON.parse(json)
+      end
+    end
+  end
+end

data/lib/canon/validators/json_validator.rb

@@ -20,7 +20,7 @@ module Canon
         return if input.is_a?(Hash) || input.is_a?(Array) # Already parsed
         return if input.strip.empty?
 
-        JSON.parse(input)
+        Canon::JsonParsing.parse(input)
       rescue JSON::ParserError => e
         # Extract position from error message
         position = extract_position(e.message)

data/lib/canon/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Canon
-  VERSION = "0.3.23"
+  VERSION = "0.3.24"
 end

data/lib/canon/yaml_backend.rb

@@ -51,6 +51,14 @@ module Canon
         false
       end
 
+      # The JSON fast path needs the fused C-API materializer
+      # (Yeptris::Native — load_json) specifically: the FFI ladder is
+      # ~29x slower than the stdlib JSON C extension, so JSON loads
+      # fall back to stdlib when only FFI is present.
+      def yeptris_native?
+        yeptris? && yeptris_available? && !defined?(::Yeptris::Native).nil?
+      end
+
       private
 
       def forced

data/lib/canon.rb

@@ -7,6 +7,7 @@ require "canon/xml_backend"
 require "canon/xml_parsing"
 require "canon/yaml_backend"
 require "canon/yaml_parsing"
+require "canon/json_parsing"
 require "canon/config"
 require "canon/data_model"
 require "canon/xml"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: canon
 version: !ruby/object:Gem::Version
-  version: 0.3.23
+  version: 0.3.24
 platform: ruby
 authors:
 - Ribose Inc.
@@ -332,6 +332,7 @@ files:
 - lib/canon/html.rb
 - lib/canon/html/data_model.rb
 - lib/canon/html/nokogiri_support.rb
+- lib/canon/json_parsing.rb
 - lib/canon/options.rb
 - lib/canon/options/cli_generator.rb
 - lib/canon/options/registry.rb