leptris 1.9.7 → 1.9.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '001396e9d1eca04e38bc3223964f4d8b8aa22f7672d32d6dc936f4730db35c60'
-  data.tar.gz: a4a24591d60276ea69fc9be41cd1b30aa6ac66df1cb77aa9f258489f2a8e7f28
+  metadata.gz: 8f306f9bc45d304b82c3db1ac2936dcc0d708b21d2caf595e4a9484da5c6b48a
+  data.tar.gz: ce9b04f6f1e91e6dffd1ff68ce70967b8b2bcff8351132db2f3312e4b534e803
 SHA512:
-  metadata.gz: 94b3e177f5419851483df347346993d6e42b9eb7a2ed7cca238804547cd65ab81ef7cdd3de04fe9898493f35e13178b359b99aecf653aea379a5714be088fc87
-  data.tar.gz: d30f779432c68c767754e55d2695e53c920e94d3f37b31603a76841c4c462b4afd62f192ba02de647ba762b4c4be59748615803fbdaedd570dd69c3ab5a488bd
+  metadata.gz: 40618f16214157768b018c774816f738a8cbce00e757286822a69f22f71413605c165448a22644b1ff5cc66a387ce63d6e2c496167b8049f2e80ab7cdf124582
+  data.tar.gz: f3c5d00e54f051510d76db44582806252ccf84091c9c9eb11915fc43675282721f4224fada0331f45616250be411362f981d545fb5de47bfcaadfaf09a4954bb

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: ruby
 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