leptris 1.9.8 → 1.9.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f306f9bc45d304b82c3db1ac2936dcc0d708b21d2caf595e4a9484da5c6b48a
-  data.tar.gz: ce9b04f6f1e91e6dffd1ff68ce70967b8b2bcff8351132db2f3312e4b534e803
+  metadata.gz: b2e2451251a0c5aec3567f67ed11c48f1b48d1a9f3622bc8c3fe62f03192c185
+  data.tar.gz: 6be47e0deac36287f736e5b6b7b9755ce4b1e2e4e3986959caa750c5072bcada
 SHA512:
-  metadata.gz: 40618f16214157768b018c774816f738a8cbce00e757286822a69f22f71413605c165448a22644b1ff5cc66a387ce63d6e2c496167b8049f2e80ab7cdf124582
-  data.tar.gz: f3c5d00e54f051510d76db44582806252ccf84091c9c9eb11915fc43675282721f4224fada0331f45616250be411362f981d545fb5de47bfcaadfaf09a4954bb
+  metadata.gz: a352efddd7e68f48e17d7126bf1d003d8da0c2eb5cdf09be1c7c7d42b739a761208792e4b45033cd7dfd928123ff7db80c8d629a0f625554d778c7c6b822e4df
+  data.tar.gz: 71c3504e8592fab25b026c68d25300c2420c22e932546257dd6d5cc819c47b9cf3ff82cbd80136d55e8250efe1c6b835a82d336b341d3cdbbcde8177ff16933d

data/CHANGELOG.md

@@ -5,6 +5,31 @@ 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.9] - 2026-08-26
+
+### Changed
+
+- **CI gates the symbol audit**: the build workflow runs
+  `rake compile audit:symbols` before the suite — upstream surface
+  drift now fails CI on the PR that first sees it instead of
+  relying on someone remembering to run it. The task skips
+  gracefully where nm is unavailable (Windows).
+- **benchmark/leptris_vs_nokogiri.rb prints live provenance**
+  (library, gem, nokogiri, ruby versions) instead of a frozen
+  footer claiming "v0.12.0 / 176 specs".
+- README: the `#search` dispatch description now matches the
+  heuristic the code implements (path-prefix → xpath; everything
+  else translates as CSS, commas included).
+
+### Meta
+
+- **ADR 0006** records the ruby-variant packaging policy as
+  practiced since 1.9.0: the `ruby` platform gem ships as the
+  fallback/source variant without a vendored library, safe under
+  the eager-load failure mode (issue #49) — clarifying the 1.9.0
+  changelog's "platform variants only" phrasing without rewriting
+  history.
+
 ## [1.9.8] - 2026-08-26
 
 ### Added

data/README.adoc

@@ -177,7 +177,7 @@ against a readonly document is legal; mutating the frozen one is not.
 `#at_xpath(*exprs)` :: first match (or scalar), like `xpath(*exprs).first`.
 `#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`.
+`#search(*exprs)` :: dispatches on syntax — path-prefixed expressions (`/`, `.`, `..`) go to `xpath`; everything else translates as CSS (comma unions included).
 `#at(*exprs)` :: first match of `search`.
 
 [source,ruby]

data/Rakefile

@@ -56,8 +56,12 @@ 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"
+    unless system("which nm > /dev/null 2>&1")
+      puts "audit:symbols: skipped (nm unavailable on this platform)"
+      next
+    end
+    unless lib
+      abort "audit:symbols: vendored library not found — run rake compile"
     end
     exported = `nm -gU #{lib}`
       .lines.map { |l| l.split[2] }.compact

data/docs/adr/0006-ruby-variant-policy.md

@@ -0,0 +1,25 @@
+# ADR 0006: the ruby-platform variant ships as the fallback, unvendored
+
+## Context
+The 1.9.0-era CHANGELOG said "never publishes ruby-platform releases
+without the vendored library — platform variants only", and an early
+fix removed the `gem:native:any` task. The 1.9.0 lockstep restored
+the `ruby` matrix entry deliberately, and every release since has
+published the variant — practice contradicting the recorded policy.
+
+## Decision
+The `ruby`-platform gem ships as the fallback/source variant WITHOUT
+a vendored library, by design. It is safe because library resolution
+is eager (issue #49): on a machine without a usable libleptris the
+gem fails at `require` with the actionable remedy (install the
+platform-specific variant or set LEPTRIS_LIB_PATH) instead of deep
+inside Document.parse. Bundler prefers platform-specific gems
+wherever they exist (9 of 10 published variants are precompiled);
+the ruby variant serves source installs and exotic platforms that
+accept providing their own library.
+
+## Consequences
+Do not re-propose removing the `platform: any` release leg without
+new evidence that bundler misresolves it in practice. A future
+change to the eager-load behavior (ADR 0005 ordering aside) must
+keep the ruby variant failing loudly at require time.

data/lib/leptris/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.8
+  version: 1.9.9
 platform: ruby
 authors:
 - Ribose Inc.
@@ -74,6 +74,7 @@ files:
 - docs/adr/0003-readonly-memoization-pattern.md
 - docs/adr/0004-lifetime-guard.md
 - docs/adr/0005-autoload-manifest-ordering.md
+- docs/adr/0006-ruby-variant-policy.md
 - leptris.gemspec
 - lib/leptris.rb
 - lib/leptris/version.rb