leptris 1.9.5 → 1.9.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 996051e28883434c5ac9cf2041278a37a0ebc3ad628685838e6b743cc87e0b9d
-  data.tar.gz: 3909cce576ad3ce14fa65c4058997476ddd814ea9f819e00e0b4bbb969bd09cf
+  metadata.gz: 68bba6b5b68f0266571ec17a5809ea42ce7b1f37f0ba3577f9a06afd57db578f
+  data.tar.gz: d15442dd463ba2b4d09c6415e51c478c385c851eb6630ffc8c4d00e6a9ad7a57
 SHA512:
-  metadata.gz: 61f73189528f9c0ffaff803328304baa44af1e545d6618d252ff8e46b5279a229fb204df807815a22a360bffbf107a0c32e1a33f5110cb699ae8135e06d2777e
-  data.tar.gz: 4b5b197e569e23820b74b1596b3a8f8bf2feefba09af9858bb830cbcd6339d59c196e71177760ab35eb7daeac30bd5c3edb2b384d1ff43fc56726b838bfe0f0a
+  metadata.gz: 52a5f4a5307b9b219911a9ebb7050672be1ad27096266e1c0732eb98ab40779055dcf25e4dd31c0ef0813966539e43894c6d4cdce20bd79e778a7df043c5631a
+  data.tar.gz: cd2e0732f88060f6ff02e3496bedca3d986fde26c9400c91efe458c05e96379caeddd50a5950eb65b965be23487aac243ada697855ade71d0ed6017bcfe49433

data/CHANGELOG.md

@@ -5,6 +5,21 @@ 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.6] - 2026-08-26
+
+### Changed
+
+- The lifetime guard (`ensure_alive!`) uses the cheapest sufficient
+  check (`Document#c_ptr.nil?` — `#free` nils it, and the GC
+  finalizer cannot fire while any handle exists) instead of the
+  deeper `Document#freed?` chain. Claw back on the cheapest single-
+  dispatch read (`Element#[]` hot loops): ~20% of the guard's cost.
+  Remaining guard cost is the method dispatch itself — the price of
+  the lifetime contract on the one call shape cheap enough to
+  notice it; all other harness loops measure at parity, and
+  readonly hot loops have the memoized `attributes`/`keys`
+  alternatives.
+
 ## [1.9.5] - 2026-08-26
 
 ### Fixed

data/lib/leptris/version.rb

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

data/lib/leptris/xml/node.rb

@@ -87,9 +87,14 @@ class Leptris::XML::Node
 
   # Borrowed-handle lifetime: every c_ptr dereference is valid only
   # while the owning document lives. Parentless nodes (iterparse
-  # yields) cannot validate and are skipped.
+  # yields) cannot validate and are skipped. The guard runs before
+  # every uncached FFI dispatch, so it uses the cheapest sufficient
+  # check: #free nils the document's c_ptr, and the GC-finalizer
+  # path cannot fire while any handle (which strongly references
+  # the document) exists. Document#freed? remains the accurate
+  # public predicate.
   def ensure_alive!
-    if @document&.freed?
+    if @document && @document.c_ptr.nil?
       raise Leptris::XML::UseAfterFreeError,
         "owning document has been freed — handle used on #{inspect}"
     end

metadata

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