leptris 1.9.9-aarch64-linux → 1.9.10-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3e769db2680672311b6a197addbddf7aea0ebc854633d8c6e70dcc2c9b140d5
-  data.tar.gz: 41babd5326bfb3d919da576ce62d8c66978705af5c459c4e2ffd5a37e90e7814
+  metadata.gz: efe9c8c8dcce3172320cb136460cbb5be0cc2ccbecdfc4fc121c0d497dbf1c3e
+  data.tar.gz: 76d3ddb87586fd9bbffe7b6b19d4cce8054d7573f27cec48db41f4c4e16740f5
 SHA512:
-  metadata.gz: da87c53f676e34885526b7b8c4caae847e8743e9ea1066423f35504e68c46ee27432ff4d65da5d132190a14ff88c6c8810cbd500e418d4828fb8efc979292217
-  data.tar.gz: c3125b29f8d0d59a665fa2905831bcd54f797b7d04ee5ea5b9874fefc9b995a79d2d763134670c19a99f9f86305f85c77db5f50951bf5bca4007c052b4ee9d11
+  metadata.gz: 9693e537dbb31e512481cc007cc9552ae72f0c32e5c529c8c96027fc83bbe89014c84ff60805a90203991c0dbb33e35ac214f9b4460445bb5d493d5538cd7b03
+  data.tar.gz: c810827e0feb0e1f0f5b85f1cf776ec208356149840a0ac7df90dce95113b67c7d7fe36948d4643117dd612c239273d64cd022dc029df727f01a37c857984145

data/CHANGELOG.md

@@ -5,6 +5,22 @@ 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.10] - 2026-08-26
+
+### Changed
+
+- **README: Migrating from Nokogiri, caught up to the 1.9.x
+  surface** — the notable-differences list now covers the lifetime
+  contract (UseAfterFreeError on freed-document reads/mutations),
+  readonly mode, recover parsing + last_error_position, searchable
+  fragments, receiver-relative css, and expanded-name attribute
+  access, each with the migrating reader's context.
+- **Spec organization**: the eight-round perf_surface_spec grab-bag
+  splits into one file per concern (seam_and_reads,
+  sax_and_query_paths, lifetime_contract, fragment_and_position,
+  receiver_relative_css). Suite count unchanged at 274; each file
+  is one scannable context.
+
 ## [1.9.9] - 2026-08-26
 
 ### Changed

data/README.adoc

@@ -410,7 +410,26 @@ Notable differences:
 * `Node#children` includes whitespace text nodes (same as Nokogiri); use
   `#element_children` or `#first_element_child` to skip them.
 * CSS support is intentionally minimal — for advanced selectors, drop to
-  `xpath`.
+  `xpath`. `css` is receiver-relative (Nokogiri semantics): scoped to
+  an element or fragment, document-wide from a Document.
+* `DocumentFragment` is searchable (`fragment.xpath/at_xpath/css/at_css/search`)
+  — Nokogiri fragment parity.
+* Expanded-name attribute access: `Element#attribute_ns(uri, local)` /
+  `#has_attribute_ns?(uri, local)` — XML Namespaces 1.0 semantics
+  (cross-prefix match, nil URI matches no-namespace, xmlns invisible).
+* `Leptris::XML.parse(xml, recover: true)` returns an empty document
+  with the failure recorded on the thread-global last error instead of
+  raising ParseError — libxml2 `XML_PARSE_RECOVER` semantics. The
+  companion `Document#last_error_position` returns `[line, column]`.
+* `Leptris::XML.parse(xml, readonly: true)` (or `Document#readonly!`)
+  freezes the document for reading: mutations raise ReadOnlyError, read
+  methods memoize aggressively. Faster steady state; no Nokogiri
+  equivalent.
+* **Lifetime contract**: a borrowed handle used after the owning
+  document has been freed (or GC'd) raises `Leptris::XML::UseAfterFreeError`.
+  Nokogiri is silent on this — migrating code that holds Node references
+  past Document disposal will see the error; silence-replace-UAF patterns
+  from Nokogiri do not apply.
 * No `Nokogiri::HTML` or `Nokogiri::CSS` parser. Leptris is XML-only.
 * No XSLT, no RelaxNG / DTD validation, no schema caching.
 * No built-in JRuby / TruffleRuby support — only CRuby via `ffi`.

data/Rakefile

@@ -55,11 +55,25 @@ task default: :spec
 namespace :audit do
   desc "Fail when ffi.rb attachments and library exports drift"
   task :symbols do
-    lib = Dir.glob("lib/libleptris.{dylib,so,dll}").first
-    unless system("which nm > /dev/null 2>&1")
+    # nm cannot read MSVC PE export tables (every symbol reports as
+    # unexported -> guaranteed false drift), so Windows skips: the
+    # darwin/linux CI legs enforce the mirror — any one platform's
+    # build of the same C surface suffices.
+    if Gem.win_platform?
+      puts "audit:symbols: skipped on Windows (PE export tables); " \
+           "darwin/linux legs enforce the mirror"
+      next
+    end
+    # Probe nm without a shell: the multi-arg system() execs
+    # directly, so there is no which/redirect syntax to be
+    # platform-hostile. File::NULL is NUL where it must be; a
+    # missing binary is falsy either way (ENOENT rescue belts the
+    # older spawn behavior).
+    unless nm_available?
       puts "audit:symbols: skipped (nm unavailable on this platform)"
       next
     end
+    lib = Dir.glob("lib/libleptris.{dylib,so,dll}").first
     unless lib
       abort "audit:symbols: vendored library not found — run rake compile"
     end
@@ -86,6 +100,13 @@ namespace :audit do
       abort "audit:symbols: drift detected"
     end
   end
+
+  # @api private
+  def nm_available?
+    system("nm", "--version", out: File::NULL, err: File::NULL)
+  rescue Errno::ENOENT
+    false
+  end
 end
 
 require "rubygems/package_task"

data/lib/leptris/version.rb

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

metadata

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