leptris 1.9.19 → 1.9.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97ca1201d65e8bb43ac419b09c9e208fd49a1cb88275beb14cb2f2ec0e7965e2
-  data.tar.gz: df1b06279ae9426f463c724a6c895a135daedb19880f62ba1c8cda377228af3f
+  metadata.gz: 5b71e0f6fdc7eafc4b804bfc7006f7e15e11f8e1ebf2a403c440763bc1fe9cba
+  data.tar.gz: 3d7d98ef8818d1789afa83fbb9e5eff6bab040ef4838900bccd8213cb8404570
 SHA512:
-  metadata.gz: 390e31d59b5fe74f08776d719e5cd608a6cee954184a65edd688d25e92ed019be47b39c65369a5553fe1b1425341570778b3f6a7abf5896ca425935cf1e3e2aa
-  data.tar.gz: f72f7460afa8f16d0aa77e313d8d047c8ff1cf98180332c34f59c4034352fa737256cf943b1cecf941caee2ae7beddd1e0f844c1e2bb305332594f496b026d77
+  metadata.gz: a11ceae79c465f05002dd31e9af7a29d1b86194c45398f940523c4718f4e1695382b573557199dac34e8cc4aae1c39aa9faf430d6def6b6333f86f3973938393
+  data.tar.gz: d77c0a145409d9735b593e396b4e3a2d093cbc8011f5880510c2100fac2e2787cdff6977ba795e5b85ac2f1b6f837c17ff8b647a1e20dcdb3037cc3f08621c00

data/CHANGELOG.md

@@ -5,6 +5,27 @@ 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.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.20"
 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
 

metadata

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