leptris 1.9.26 → 1.9.27

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c1650cd7d5f1be133b6c265c5ea6bfd646265ac443a86361bb30593dd0d255a
-  data.tar.gz: babd8da0971c8f6820f2692e7283d249cea85455f84620a73e86fe488caa1a18
+  metadata.gz: 42dec4b3313ea805ec507734e16907a059f894b85057eef2bd1f51833440ba8a
+  data.tar.gz: 7163fb0b7ae9d1e5116f1d637bbb8905dfa94dd7a383c4c358174e82caa70cd0
 SHA512:
-  metadata.gz: 62d2b51adc4bd84f8a3f6c0ebc749ad328b1ceed1d9a6502234819e0c5f3bf054ac758f008beba3692f2781981d7a4de23dc0e0d6f44462f2e3d385c2eb468e8
-  data.tar.gz: 22a1369e2755c016019691507c2e867e792352fcd999be595c9fd485934f6170f44ce4320366487b1f0d30fd314b6db4941773663a6722b542af501ebc131bac
+  metadata.gz: c9b449e54b8eecfea8ba76f07b8f7169e37c2ee1aee601e84b836052b05b1811857e7674b29fd93980754b82a53508146c26e3d7054003e82129cb536ec426aa
+  data.tar.gz: b1dba812e5317c7f9c806183277816e06e4847ece3432f231991d3435c55ae03b43debf23d16d3199a71ce79e7ee66031a92fa33528faa5ce32473e37fa84f2e

data/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to Leptris will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.27] - 2026-08-28
+
+### Fixed
+
+- **Arity-declared attrs interest in SAX** (round XIX's policy
+  completed): a handler whose `start_element` takes exactly one
+  argument declares name-only — the attribute walk (2N pointer
+  reads + N string pairs per start) never runs. Measured
+  elements-only on big.xml: 116 -> **40 ms per parse (2.9x; the
+  no-walk ceiling is 3.7x)**. This also fixes a crash: 1-argument
+  `start_element` handlers previously raised ArgumentError because
+  the callback always dispatched both arguments (Nokogiri raises
+  there too; we now honor the signature). Optional-argument and
+  splat handlers keep receiving pairs exactly as before.
+
+### Meta
+
+- Upstream check: no libleptris 1.9.8 exists (tarball probe 404s);
+  1.9.7 remains latest. Two perf hypotheses benchmarked and
+  retired this round: `Element#content` is already a memoized
+  one-C-call read, and `Node#traverse`'s C callback dispatch
+  (181 ms) beats Ruby children-recursion (551 ms) 3x — both stay.
+
 ## [1.9.26] - 2026-08-28
 
 ### Added

data/lib/leptris/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Leptris
-  VERSION = "1.9.26"
+  VERSION = "1.9.27"
 end

data/lib/leptris/xml/sax/parser.rb

@@ -105,9 +105,21 @@ class Leptris::XML::SAX::Parser
     end
 
     if overridden?(:start_element)
-      s[:start_element] = callback(:void, [:pointer, :string, :pointer]) do |_, name, attrs_ptr|
-        attrs = walk_attr_array(attrs_ptr)
-        handler.start_element(utf8(name), attrs)
+      # Arity-declared interest: a start_element that takes exactly
+      # one argument declares name-only — the attr walk (2N pointer
+      # reads + N string pairs per start; 3.7x of an elements-only
+      # parse on the 1.9 MB stream) never runs. It is also the only
+      # way a 1-arg handler can receive events: the two-argument
+      # call raises ArgumentError.
+      if @document.method(:start_element).arity == 1
+        s[:start_element] = callback(:void, [:pointer, :string, :pointer]) do |_, name, _|
+          handler.start_element(utf8(name))
+        end
+      else
+        s[:start_element] = callback(:void, [:pointer, :string, :pointer]) do |_, name, attrs_ptr|
+          attrs = walk_attr_array(attrs_ptr)
+          handler.start_element(utf8(name), attrs)
+        end
       end
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.26
+  version: 1.9.27
 platform: ruby
 authors:
 - Ribose Inc.