leptris 1.9.12 → 1.9.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c286a2c462a249a214a59fa8ca2e9c85f0945e997dcf04b587412d4b10a85b6
-  data.tar.gz: 9c2b7efb4e42f2cd2433cc11f925eacf81ee67ff0f5f6faed8b9bb74dfbc4feb
+  metadata.gz: 590285b33ed6aac05def5ff85268822fc6d5abf87cfd5b262d51b72868f70ac3
+  data.tar.gz: 8dc09c12f495c12177a5dd15ff8892340dc090d678eb342738571bfb0e142228
 SHA512:
-  metadata.gz: 3265cfca1c7858c657c9bb58524b289f2224348614febf54c63c7f91f210a0500d889834a0ea55c950c788c5ae24dadba45a7677794c32afb431c929fd791ae6
-  data.tar.gz: 44a202c1c0edb009089f652c527401b5d9b52c5194e5546c9013c1100e4a37fc015ee7868a7aa3638e4e1798b7e838f73939e645f973e51e288061fdf49da870
+  metadata.gz: 2781b4465ff07a85ea7ecc91824070da8412aa933bc96273a4b9159860c95a0e227e06630967685e66db9fd696a6e5648ec9474217ecae769b8163096adf18ed
+  data.tar.gz: 9d7173b435723be6f068700e27e05f796246143dcf22dd1319079c5770a71f3f933fdd7d517a71ee47cba58f1305ed2d2e270ffaee43c422c43d693dbb77f4f7

data/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.13] - 2026-08-27
+
+### Changed
+
+- **Cached-true readonly guard**: readonly is one-way, so a node
+  caches TRUE once observed (FALSE stays uncached — the document
+  may still flip). Per-read guards drop from a three-call document
+  round-trip to one ivar check. Harness attr loop 0.061 -> 0.048 s.
+- **Lazy wrapper-cache allocation**: Documents no longer allocate
+  the wrapper-identity Hash up front; parse-heavy loops that free
+  before re-reading stop paying it (~9% on the tiny-doc
+  parse-query-serialize loop). Identity semantics unchanged.
+
+### Measured dead
+
+- Further readonly-[] trimming: the isolated read is at the Ruby
+  call-chain floor (~227 ns across ~7 calls); inlining the
+  attributes build would duplicate memo logic for ~10%.
+
 ## [1.9.12] - 2026-08-27
 
 ### Changed

data/lib/leptris/version.rb

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

data/lib/leptris/xml/document.rb

@@ -3,7 +3,7 @@
 require "ffi"
 
 class Leptris::XML::Document
-  attr_reader :c_ptr, :wrapper_cache
+  attr_reader :c_ptr
 
   # @api private
   # Internal flag container shared between the Document instance and its
@@ -31,7 +31,13 @@ class Leptris::XML::Document
     # the weak map — any GC sweep evicted it and the second call built
     # a fresh object. A strong cache costs at most one wrapper per node
     # actually visited, held until the document dies.
-    @wrapper_cache = {}
+    #
+    # Allocated lazily: parse-heavy loops stop paying one Hash per
+    # document for trees that are freed before any wrap.
+  end
+
+  def wrapper_cache
+    @wrapper_cache ||= {}
   end
 
   def self.parse(xml_or_io, options: nil, readonly: false, recover: false)
@@ -230,7 +236,7 @@ class Leptris::XML::Document
     @freed.state = :freed
     Leptris::XML::FFI.leptris_document_free(@c_ptr) unless @c_ptr.nil?
     @c_ptr = nil
-    @wrapper_cache.clear
+    @wrapper_cache&.clear
   end
 
   # Enable the first-party EXSLT-style extension pack on this

data/lib/leptris/xml/element.rb

@@ -36,7 +36,7 @@ class Leptris::XML::Element < Leptris::XML::Node
     # materializes on demand — repeated reads become hash lookups,
     # with no dispatch and no lifetime guard (a hash read cannot
     # use-after-free).
-    if @document&.readonly?
+    if readonly_document?
       cached = attributes[key.to_s]
       return cached.nil? ? nil : cached.value
     end

data/lib/leptris/xml/node.rb

@@ -104,12 +104,22 @@ class Leptris::XML::Node
   # UseAfterFreeError when it was freed.
   def ensure_writable!
     ensure_alive!
-    if @document&.readonly?
+    if readonly_document?
       raise Leptris::XML::ReadOnlyError,
         "document is readonly — mutation attempted on #{inspect}"
     end
   end
 
+  # Readonly is one-way, so caching TRUE is sound: once observed,
+  # the document is readonly forever. FALSE stays uncached (the
+  # document may still flip). Saves the document round-trip on
+  # per-read guards.
+  def readonly_document?
+    return true if instance_variable_defined?(:@readonly_document)
+    return false unless @document&.readonly?
+    @readonly_document = true
+  end
+
   def line
     ensure_alive!
     Leptris::XML::FFI.leptris_node_line(@c_ptr)

metadata

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