leptris 1.9.15-aarch64-linux → 1.9.16-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8bd4232b17186b481475262c089642cf53fe8772cce8f4ac5b14c3e2908fe2fc
-  data.tar.gz: a3d9cf9ea0eb60207fd1efddd36a20e2f7f03d5d8ceb9a334b243dc9d1965488
+  metadata.gz: f6960184588bed5ebd9fa8fbf64fe97bb8476b433ba43b5176568f20b9dd561b
+  data.tar.gz: 739e787fbd3c921bcb2ac4cdf776b3f85bc7ec2fe870b8f94f9366cd3aacc710
 SHA512:
-  metadata.gz: '08142860a72a4f30a91e9e13ebb53560e7e3724c22634463f517d1916e3a074a809e2b5fb30915ff819611f05f75fd75eff4332bc7b633eed671743c7c4d1cf2'
-  data.tar.gz: ba14890554f0df8ea9db1efb1ed3832977a63abfb3d624b447c38c37038f96708724b81184da0bbaa64eebd4644233ee3b2be04d5b7329ce2a45d426e578ff94
+  metadata.gz: 2588d661f45aec8859681b381fffd2fb05b4600f2888c826ad86a1c43f8ad86d7a8fc95b8ce4d5ae803772275066e4f43e67f09bf0592d5648d732383081168e
+  data.tar.gz: d01eb46bdd19bbdfdf26c6fb278111291f8713439d088f205f7985ba46f31696c344c864f8d95229d4e389c7bc857bdfaae25721cf49d8475c71936c2344b8e1

data/CHANGELOG.md

@@ -5,6 +5,20 @@ 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.16] - 2026-08-27
+
+### Changed
+
+- **at_xpath / at_css take the single-node path**: a new
+  `wrap_xpath_first_result` seam answers nodeset results via
+  get_node(0) + wrap + free — no NodeSet container, no AutoPointer,
+  one fewer FFI than xpath().first; scalar results keep full-wrapper
+  semantics. Measured on the canonical scraper loop: at_xpath 0.018 s
+  -> 0.005 s (3.6x — the per-iteration container churn was GC
+  pressure the old path paid twice), at_css ~24%. Equivalence with
+  xpath().first is spec-pinned across nodeset/empty/scalar shapes.
+  Also drops a vestigial `.send(:from_result)` on a public factory.
+
 ## [1.9.15] - 2026-08-27
 
 ### Changed

data/lib/leptris/version.rb

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

data/lib/leptris/xml/searchable.rb

@@ -24,8 +24,24 @@ module Leptris::XML::Searchable
   end
 
   def at_xpath(*paths)
-    result = xpath(*paths)
-    result.is_a?(Leptris::XML::NodeSet) ? result.first : result
+    handler, ns, _vars = parse_search_args(paths)
+    raise ArgumentError, "custom XPath handlers not supported" if handler
+    expr = paths.join(" | ")
+
+    doc_ptr = is_a?(Leptris::XML::Document) ? c_ptr : document.c_ptr
+    context_ptr = is_a?(Leptris::XML::Document) ? nil : c_ptr
+
+    result_ptr =
+      if ns && !ns.empty?
+        xpath_eval_with_namespaces(doc_ptr, context_ptr, expr, ns)
+      else
+        Leptris::XML::FFI.leptris_xpath_eval(doc_ptr, context_ptr, expr)
+      end
+    if result_ptr.null?
+      raise Leptris::XML::XPathError,
+        Leptris::XML::FFI.leptris_last_error.to_s
+    end
+    Leptris::XML::Searchable.wrap_xpath_first_result(document, result_ptr)
   end
 
   def search(*args)
@@ -53,8 +69,13 @@ module Leptris::XML::Searchable
   end
 
   def at_css(*args)
-    result = css(*args)
-    result.is_a?(Leptris::XML::NodeSet) ? result.first : result
+    handler, ns, _ = parse_search_args(args)
+    raise ArgumentError, "namespace bindings not supported in css" if ns && !ns.empty?
+    raise ArgumentError, "custom CSS handlers not supported" if handler
+    prefix = is_a?(Leptris::XML::Document) ? "//" : ".//"
+    expr = args.map { |r| Leptris::XML::CssToXPath.convert(r, prefix: prefix) }
+      .join(" | ")
+    at_xpath(expr)
   end
 
   protected
@@ -86,6 +107,22 @@ module Leptris::XML::Searchable
     %r{\A(\./|/|\.\.|\.)}.match?(str)
   end
 
+  # Single-node seam beside wrap_xpath_result: a nodeset answers
+  # via result_get_node(0) + wrap + free — no NodeSet container, no
+  # AutoPointer, one fewer FFI than xpath().first; scalars keep the
+  # full-wrapper semantics.
+  def self.wrap_xpath_first_result(document, result_ptr)
+    type = Leptris::XML::FFI.leptris_xpath_result_type(result_ptr)
+    if type == Leptris::XML::FFI::XPATH_NODESET
+      ptr = Leptris::XML::FFI.leptris_xpath_result_get_node(result_ptr, 0)
+      node = ptr.null? ? nil : Leptris::XML::Node.wrap(ptr, document)
+      Leptris::XML::FFI.leptris_xpath_result_free(result_ptr)
+      node
+    else
+      wrap_xpath_result(document, result_ptr)
+    end
+  end
+
   # Shared by Searchable#xpath and Leptris::XML::XPath (compiled
   # expressions): wraps a raw XPathResult pointer into the
   # Ruby-typed result and frees the C handle.
@@ -93,7 +130,7 @@ module Leptris::XML::Searchable
     type = Leptris::XML::FFI.leptris_xpath_result_type(result_ptr)
     case type
     when Leptris::XML::FFI::XPATH_NODESET
-      Leptris::XML::NodeSet.send(:from_result, document, result_ptr)
+      Leptris::XML::NodeSet.from_result(document, result_ptr)
     when Leptris::XML::FFI::XPATH_BOOLEAN
       v = Leptris::XML::FFI.leptris_xpath_result_boolean(result_ptr) != 0
       Leptris::XML::FFI.leptris_xpath_result_free(result_ptr)

metadata

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