leptris 1.9.19-aarch64-linux → 1.9.21-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c17a17ac9f4c53847365c8e9eedfaa025713970e9d7831d3a5ada65941bbcffe
-  data.tar.gz: 889a3d367d1fed900d5ae12d0afaa12b4fe7f4125f8c32be11cba127460e2e8a
+  metadata.gz: 6a10b8e5a3f59b43792a986200af06e1d8f5ed09006b94272adf423546b9b5d3
+  data.tar.gz: 0f23a65d72a713b0221e6d67b68ef11b0f1244472ab17470924d41afe1018c0e
 SHA512:
-  metadata.gz: 59f1415e49d63285c56dac59891d83c08364146b40d221c05255cb141fe57dd23314288fb9ab997620fe3b3e0e7ae75d3db78b078ab0f6cbfe8aeab706c7f6da
-  data.tar.gz: 44d6c18f3866c5bdc769b095ebe1ef62c1aa7a47956c892e3562b5756b9d50191b4b516c88a33ebb75a642356ab984e8a8cc6588c36c6f68b2eec15b9baba80b
+  metadata.gz: b926e9e47f7b86dec2a7ca0768052a31b430849a020ceb10b4cd970b51299b750da3928bae592e254994170c0891a003c1be3e6a73179ea0b38f9fa8b079d26a
+  data.tar.gz: 8201fa8740f34c221fc72f26e1572ad4199af57042aecdb6ad7b0f3b120172a1b0fa2c6e6963b400b966547433a50e47417c9043e5444acbc059d669be74c617

data/CHANGELOG.md

@@ -5,6 +5,40 @@ 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.21] - 2026-08-27
+
+### Changed
+
+- **`#at` / `#%` take the single-node seam**: the generic entry now
+  dispatches on syntax (like `#search`) and calls `at_xpath` /
+  `at_css` directly instead of routing through
+  `search().first` and its NodeSet container — the round-XIV fast
+  path's last un-routed caller. Measured: `at("item > name")` 0.026 s
+  -> 0.020 s per 2000 iterations (**-23%**, now at parity with
+  `at_css`); scalar semantics for XPath-shaped expressions keep the
+  full-wrapper behavior.
+
+## [1.9.20] - 2026-08-27
+
+### Changed
+
+- **Pull event loop allocation trim**: `Parser#next_event` reads the
+  event's type/name/text through layout-derived offsets
+  (`PullEventStruct.offset_of` — the struct stays the ABI's single
+  source of truth) instead of allocating a struct wrapper per event;
+  `capture_attrs` builds its hash without the enumerator machinery
+  and answers nil for zero attributes. Streaming a 300-element
+  document: 2.9 ms -> 2.3 ms per parse (**-20%**). The remaining
+  per-event cost is FFI dispatch — the batch ask is filed upstream
+  (leptris/leptris#589).
+
+### Meta
+
+- Streaming-path benchmarks added to the round's report: pull with
+  events measured 145x slower than DOM-parsing the same bytes
+  (dispatch-dominated); iterparse's 60% system-time signature
+  documented on leptris/leptris#563 (C-side release churn).
+
 ## [1.9.19] - 2026-08-27
 
 Lockstep with libleptris 1.9.3 — unblocks the 1.9.18 release

data/lib/leptris/version.rb

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

data/lib/leptris/xml/pull.rb

@@ -60,6 +60,14 @@ module Leptris::XML::Pull
       self
     end
 
+    # Hot-loop offsets: derived from PullEventStruct's layout (the
+    # struct stays the single source of truth for the ABI), read via
+    # get_int/get_pointer so the per-event struct-wrapper allocation
+    # disappears from streaming loops.
+    NAME_OFFSET = Leptris::XML::FFI::PullEventStruct.offset_of(:name)
+    TEXT_OFFSET = Leptris::XML::FFI::PullEventStruct.offset_of(:text)
+    private_constant :NAME_OFFSET, :TEXT_OFFSET
+
     # Advances the cursor and returns the next Event, or nil after the
     # end of the document. Attribute values are captured during
     # start_element because the C accessors are valid only for the
@@ -67,26 +75,31 @@ module Leptris::XML::Pull
     def next_event
       raw = Leptris::XML::FFI.leptris_pull_next(@handle)
       return nil if raw.null?
-      event = Leptris::XML::FFI::PullEventStruct.new(raw)
-      type = TYPES[event[:type]]
-      name = read_owned(event[:name])
-      text = read_owned(event[:text])
+      type = TYPES[raw.get_int(0)]
+      name_ptr = raw.get_pointer(NAME_OFFSET)
+      text_ptr = raw.get_pointer(TEXT_OFFSET)
       attrs = type == :start_element ? capture_attrs : nil
-      Event.new(type: type, name: name, text: text, attrs: attrs)
+      Event.new(
+        type: type,
+        name: name_ptr.null? ? nil : name_ptr.read_string.force_encoding(Encoding::UTF_8),
+        text: text_ptr.null? ? nil : text_ptr.read_string.force_encoding(Encoding::UTF_8),
+        attrs: attrs
+      )
     end
 
     private
 
-    def read_owned(ptr)
-      ptr.null? ? nil : ptr.read_string.force_encoding(Encoding::UTF_8)
-    end
-
     def capture_attrs
       count = Leptris::XML::FFI.leptris_pull_attr_count(@handle)
-      count.times.each_with_object({}) do |i, hash|
+      return nil if count.zero?
+      hash = {}
+      i = 0
+      while i < count
         hash[Leptris::XML::FFI.leptris_pull_attr_name(@handle, i)] =
           Leptris::XML::FFI.leptris_pull_attr_value(@handle, i)
+        i += 1
       end
+      hash
     end
   end
 

data/lib/leptris/xml/searchable.rb

@@ -50,9 +50,16 @@ module Leptris::XML::Searchable
   end
   alias_method :/, :search
 
+  # Single-node seam (round XIV): dispatch on syntax like #search,
+  # then call the at_* fast paths directly — no NodeSet container,
+  # no result handle, one fewer dispatch than search().first.
   def at(*args)
-    result = search(*args)
-    result.is_a?(Leptris::XML::NodeSet) ? result.first : result
+    paths = args.first.is_a?(Array) ? args.first : [args.first]
+    if paths.map(&:to_s).all? { |p| looks_like_xpath?(p) }
+      at_xpath(*paths)
+    else
+      at_css(*args)
+    end
   end
   alias_method :%, :at
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.19
+  version: 1.9.21
 platform: aarch64-linux
 authors:
 - Ribose Inc.