moxml 0.5.24 → 0.5.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1181803fec34397cfd858d8671e2dcd6a02a88418dc5848a5ea9c7a44d7bc64
-  data.tar.gz: b9809e6ed48ae4a5a946ed9487fe61d0a89d333b51921de70b50dd271956ba0a
+  metadata.gz: 7962623114db23fce306ee38745c51ccf85fe8333c60a274322eb3d5a6dd6270
+  data.tar.gz: 00b614eed4a674d4ad43a1cbf1f4dd0483de2e929b7e78728c4aab7106662b56
 SHA512:
-  metadata.gz: 26df2786fe6a81b696fe2273c2d5f36151bb6af9daf2ce10f057662f7df3ce8ca75970f883a832dbc0c4741e7262be87d79a6eac143298dc9c398ba198f6ba43
-  data.tar.gz: d7d155e11b4d1718e072ad5d2eabcb3aad8c2875753eea571bde7e710deee1c88a8acb3244cb01b4055b4c7e648384f91410c42ad576d600ab4c49ffcb39b895
+  metadata.gz: 9e49d1c70a4332def347256eccf22f7defa256eaec8290987a73079daa0bcfed0f141f4862a9b457fbbc6f606be5386c3d5717e35e767b1088d2e7f88e0fde5d
+  data.tar.gz: d3ad61616f0b7bf163fef6333c59595bbce7b40dc96fd01c7a64f8bf2e8db2419102f3633444d1a54453bff7f6ad170051f75c9756e1c406233e25716426f3c7

data/.github/workflows/rake.yml

@@ -54,7 +54,8 @@ jobs:
       - name: Run rubocop
         run: bundle exec rubocop
 
-      - name: Run performance gates
+      - name: Run performance gates (YJIT)
         env:
           RUN_PERFORMANCE: "1"
+          RUBY_YJIT_ENABLE: "1"
         run: bundle exec rake spec:performance

data/docs/_pages/performance.adoc

@@ -33,3 +33,34 @@ doc.xpath('//title')
 root.xpath('./*/title')
 ----
 
+
+=== Run with YJIT
+
+The wrapper layer is Ruby-dispatch-heavy — exactly what YJIT compiles
+well. Enable it for any throughput-sensitive workload (Ruby >= 3.3;
+production-ready since then):
+
+[source,bash]
+----
+RUBY_YJIT_ENABLE=1 ruby your_app.rb   # or: ruby --yjit
+----
+
+Measured against raw engine calls on a 52KB fixture (leptris,
+min-of-N, 100 warm reads): without YJIT the facade adds +23% on tree
+walks and +43% on warm attribute reads; **with YJIT those become
+-12% (faster than the binding's own walk) and +10%**, and `.name`
+reads reach parity. Parse, serialize and duplicate are C-bound
+either way. No semantic surface changes — it is a runtime flag.
+
+Consumers on CRuby 3.3+ (canon's pretty-print pipeline, batch
+conversion) should treat it as the default; moxml's own CI
+performance gates run with YJIT enabled.
+
+=== Prefer bulk paths for per-node conversion
+
+Per-node Ruby iteration pays the wrapper tax per element. When the
+goal is conversion rather than manipulation, the bulk paths move the
+loop into C: `materialize_fields` streams the flattened record
+fields from one C call and measures faster than an equivalent
+raw-Nokogiri DOM walk. See
+link:conversion-apis[Conversion and memory lifecycle APIs].

data/lib/moxml/entity.rb

@@ -49,6 +49,34 @@ module Moxml
     # marker gsub's full-buffer copy entirely.
     NON_STANDARD_ENTITY_RE = /&(?!amp;|lt;|gt;|quot;|apos;)(#{NAME_PATTERN});/
 
+    # True when a NON-standard named entity exists somewhere (the
+    # gsub would then be needed). The leptris binding's C probe
+    # (leptris-ruby#124) answers in one pass at memcmp speed; it is
+    # resolved lazily because adapters load on demand. Otherwise:
+    # the cheap `&` pre-filter, then the Ruby regex.
+    def nonstandard_entity?(str)
+      probe = c_entity_probe
+      if probe
+        probe.call(str, str.bytesize) == 1
+      else
+        str.include?("&") && str.match?(NON_STANDARD_ENTITY_RE)
+      end
+    end
+
+    def c_entity_probe
+      if @c_entity_probe.nil?
+        @c_entity_probe =
+          if defined?(::Leptris::XML::FFI) &&
+              ::Leptris::XML::FFI.respond_to?(:leptris_str_has_nonstandard_entity)
+            ::Leptris::XML::FFI.method(:leptris_str_has_nonstandard_entity)
+          else
+            false
+          end
+      end
+      @c_entity_probe || nil
+    end
+    module_function :nonstandard_entity?, :c_entity_probe
+
     NAMED_DECODE_MAP = {
       "amp" => "&", "lt" => "<", "gt" => ">",
       "quot" => '"', "apos" => "'"
@@ -87,11 +115,12 @@ module Moxml
       # Fast path: no `&` means no entity references to mark — skip
       # the regex scan and string allocation entirely. The vast
       # majority of XML payloads contain no entity references.
-      return [str, false] unless str.include?("&")
       # Second fast path: only predefined entities — the gsub would
       # pass every match through unchanged, so skip its full-buffer
-      # copy too.
-      return [str, false] unless str.match?(NON_STANDARD_ENTITY_RE)
+      # copy too. When the leptris binding is loaded, its C probe
+      # (leptris-ruby#124) answers in one memcmp-class pass; the
+      # binding loads lazily, so the probe is resolved on first use.
+      return [str, false] unless nonstandard_entity?(str)
 
       marked = false
       processed = str.gsub(NAME_RE) do |match|

data/lib/moxml/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Moxml
-  VERSION = "0.5.24"
+  VERSION = "0.5.25"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: moxml
 version: !ruby/object:Gem::Version
-  version: 0.5.24
+  version: 0.5.25
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-02 00:00:00.000000000 Z
+date: 2026-09-03 00:00:00.000000000 Z
 dependencies: []
 description: |
   Moxml is a unified XML manipulation library that provides a common API