leptris 1.9.7-aarch64-linux → 1.9.8-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e675b83fc86c61c5711b97dfb7f7a487c68a950fae14e530bd5310d5cb4a188
-  data.tar.gz: d2dc2339a090408af8989534296bd76367b058a757ed53ec7f8625ea52b027ef
+  metadata.gz: 5fbe855476d5983224c48fee05aac7c39b5b68ad97ac4471960121435ba12ee0
+  data.tar.gz: 4839996a52ccefdc5786bb11da99fea5a43823b669385fe76bcedc0fad0238bf
 SHA512:
-  metadata.gz: ac187f6f91c2b7884fd8c405212f675b8eb53d5c052edcf0656cffc4a9df3726da3ae9d64cb6907a00f1e7eb5e22a1e5ce61f54f12da460fe5af2668282cf615
-  data.tar.gz: 3e24d0394e4ef11675c2ee257a1386a7c24f2310c44e2ae59bb53bf49e7ea1b52f6698006e2ce5aae8e1fd5e5e689c4cb1a05e0d4dffce628a96c7c852382260
+  metadata.gz: 4c7bace3fda21144a9d3b24fffb7b19704110f57e55ce540cbec9e6b751957c6bc5a0737f25d83a546e284d7f7ae3a59f4c086301ec74edea51844464e2e1bc6
+  data.tar.gz: 761e779a227d720e062d95661dfb0043c6992b73caf2aebc5c11fa393ccb433027615ee940b3f5622324d507c30d8e45d8646aaee611bc3eb96aba88b727bd15

data/CHANGELOG.md

@@ -5,6 +5,24 @@ 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.8] - 2026-08-26
+
+### Added
+
+- **`rake audit:symbols`**: the lockstep drift detector as an
+  executable step — `nm -gU` on the vendored library vs the ffi.rb
+  attach list, failing with both directions of drift (ADR 0001's
+  enforcement arm; previously prose plus ad-hoc pipelines).
+
+### Changed
+
+- ffi.rb attaches the five header-declared exports past cleanups
+  had dropped (element_children, serialize_document,
+  xpath_ns_set_add, xpath_result_get, xpath_result_get_nodes) —
+  mirror-only, supersession noted inline. The audit now runs green:
+  **224/224 symbols in lockstep**. Pull-attribute batch fetch asked
+  upstream (leptris/leptris#562).
+
 ## [1.9.7] - 2026-08-26
 
 ### Added

data/CLAUDE.md

@@ -91,6 +91,7 @@ lib/leptris/xml/css_to_xpath.rb   — minimal CSS translation
   check both before proposing refactors; they exist so reviews
   stop re-deriving settled questions.
 - libleptris public headers (`src/include/leptris/*.h`) are the
-  contract; when symbols change, bump lockstep and audit
-  attached-vs-exported (`nm -gU` on a fresh build).
+  contract; when symbols change, bump lockstep and run
+  `rake audit:symbols` (attached == exported on the vendored
+  library; fails listing both directions of drift).
 - Upstream issues worth tracking live at leptris/leptris.

data/README.adoc

@@ -169,12 +169,13 @@ against a readonly document is legal; mutating the frozen one is not.
 
 == Searching: XPath and CSS
 
-`Document` and `Element` (via `Leptris::XML::Searchable`) support:
+`Document`, `Element`, and `DocumentFragment` (via
+`Leptris::XML::Searchable`) support:
 
 [horizontal]
 `#xpath(*exprs)` :: evaluate XPath; returns `NodeSet`, `true`/`false`, `Float`, or `String` depending on the expression.
 `#at_xpath(*exprs)` :: first match (or scalar), like `xpath(*exprs).first`.
-`#css(*selectors)` :: minimal CSS-to-XPath translation, then `xpath`.
+`#css(*selectors)` :: minimal CSS-to-XPath translation, then `xpath`. Receiver-relative (Nokogiri semantics): scoped to the element or fragment, document-wide from a Document.
 `#at_css(*selectors)` :: first match of `css`.
 `#search(*exprs)` :: dispatches on syntax — `/`-prefixed or `,`-separated → `xpath`, otherwise `css`.
 `#at(*exprs)` :: first match of `search`.
@@ -190,6 +191,11 @@ doc.at_xpath("string(//book[1]/@id)")     # => "b1"
 doc.css("book[lang='en'] title")          # => NodeSet[<title>Refactoring</title>]
 doc.at_css("book#b1 title")               # => <title>Refactoring</title>  (id selector)
 doc.css("book:first-child")               # first <book>
+
+# css is receiver-relative: scoped to the receiver, not the document
+doc.root.at_css("book").css("title")      # titles under THAT book only
+frag = doc.fragment("<a x='1'><n/></a>")
+frag.css("a > n")                         # searches the fragment
 ----
 
 XPath result type follows XPath 1.0 semantics:

data/Rakefile

@@ -49,6 +49,41 @@ task spec: :compile unless ENV.key?("LEPTRIS_LIB_PATH")
 
 task default: :spec
 
+# Lockstep drift detector (ADR 0001): ffi.rb mirrors the public
+# header, so attached == exported must hold on the vendored library.
+# Run after `rake compile` and before any lockstep release.
+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 lib && system("which nm > /dev/null 2>&1")
+      abort "audit:symbols: vendored library or nm not found — run rake compile"
+    end
+    exported = `nm -gU #{lib}`
+      .lines.map { |l| l.split[2] }.compact
+      .map { |n| n.sub(/\A_/, "") }
+      .select { |n| n.start_with?("leptris_") }
+      .map { |n| n.sub(/\Aleptris_/, "") }.sort
+    attached = File.read("lib/leptris/xml/ffi.rb")
+      .scan(/attach_function :leptris_([a-z_0-9]+)/).flatten.sort
+    unattached = exported - attached
+    unexported = attached - exported
+    unless unattached.empty?
+      puts "exported but NOT attached (upstream surface drift):"
+      unattached.each { |s| puts "  leptris_#{s}" }
+    end
+    unless unexported.empty?
+      puts "attached but NOT exported (stale attachment):"
+      unexported.each { |s| puts "  leptris_#{s}" }
+    end
+    if unattached.empty? && unexported.empty?
+      puts "audit:symbols: #{attached.length}/#{exported.length} symbols in lockstep"
+    else
+      abort "audit:symbols: drift detected"
+    end
+  end
+end
+
 require "rubygems/package_task"
 
 desc "Build the pure-Ruby gem"

data/lib/leptris/version.rb

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

data/lib/leptris/xml/ffi.rb

@@ -173,6 +173,10 @@ module Leptris
       # count-only query returning the TOTAL across every child kind.
       attach_function :leptris_node_children,
         [:leptris_node_ref, :pointer, :size_t], :size_t
+      # Element-only batch; mirror-only — fetch_children rides the
+      # all-kind node_children above.
+      attach_function :leptris_element_children,
+        [:leptris_element, :pointer, :size_t], :size_t
       attach_function :leptris_node_as_element,
         [:leptris_node_ref], :leptris_element
       attach_function :leptris_element_as_node,
@@ -402,6 +406,12 @@ module Leptris
       # which (element / synthetic attribute / text / other).
       attach_function :leptris_xpath_result_node_kind,
         [:leptris_xpath_result, :size_t], :int
+      # Pre-_ex variants, superseded by xpath_result_get_nodes_ex /
+      # xpath_result_get_node; mirror-only (ADR 0001).
+      attach_function :leptris_xpath_result_get,
+        [:leptris_xpath_result, :size_t], :leptris_element
+      attach_function :leptris_xpath_result_get_nodes,
+        [:leptris_xpath_result, :pointer, :size_t], :size_t
       attach_function :leptris_xpath_result_get_node,
         [:leptris_xpath_result, :size_t], :leptris_node_ref
       attach_function :leptris_xpath_result_node_name,
@@ -447,6 +457,10 @@ module Leptris
         [:leptris_xpath_ns_set], :void
       # One-call constructor: flat array of 2*pair_count alternating
       # prefix/URI strings.
+      # Per-pair add; superseded by ns_set_new_from_pairs (one call);
+      # mirror-only (ADR 0001).
+      attach_function :leptris_xpath_ns_set_add,
+        [:leptris_xpath_ns_set, :string, :string], :leptris_status
       attach_function :leptris_xpath_ns_set_new_from_pairs,
         [:pointer, :size_t], :leptris_xpath_ns_set
       attach_function :leptris_xpath_eval_ns,
@@ -507,6 +521,10 @@ module Leptris
 
       attach_function :leptris_document_serialize,
         [:leptris_document, :pointer], :pointer
+      # Deprecated automatic-options alias (header: prefer
+      # leptris_document_serialize); mirror-only.
+      attach_function :leptris_serialize_document,
+        [:leptris_document], :pointer
       # libleptris >= 1.9.0: caller-buffer serialization with options
       # (leptris#541). buf=NULL is a size query; the size-query +
       # fill pair reuses one serialization through a per-document

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.7
+  version: 1.9.8
 platform: aarch64-linux
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-25 00:00:00.000000000 Z
+date: 2026-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi