leptris 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28a6d0b01b14207e6a928eead2f38f84bf2dda03b9c7ae4a3c6bcc3163f2760d
-  data.tar.gz: e23962a817090c8707dc691fe58276f25da7075e1b0b64bb1fa39774cd113d4e
+  metadata.gz: e181133c2d381d3ed81fbab6ad41b99c0a72ed89cc651a7882c069eee06535fa
+  data.tar.gz: 768c1463a6746f331251d10f5499293b4c00c0914037fee33a08725b7855ac7c
 SHA512:
-  metadata.gz: 83e9f30fd09ded2f909d651423db46be8a6baca9f39f310e9b8c3632f5fd7cd5627d193cd57c80d6191a2c00145858b87d9454a72df12e96a28fbd928864a663
-  data.tar.gz: 5991c97a7ea5b8a3462c62492fd70808f4094d2758525ce2ec6ac47a9ffe61bb318c71d1999c95081e5e48ce10cc98d9e671ea8c52400c3a90b01e4f9a5b3ce1
+  metadata.gz: f0c45bea9042ffec94231c4c799aa43145592d1dff5268ee75e75212b015be689ad875dac84b76ee8a7cf0624bb1b983c39b3dba8ef3966bc8591275648c7738
+  data.tar.gz: eb2803ee6a55c4dcd543678bcb9899c5651269d9737d92bffa9f8f156ddb87b22838f6c12b610644ee585ed6854041f4815f5b4a6f1de4cceb8dd8ae5aceca50

data/CHANGELOG.md

@@ -5,6 +5,51 @@ All notable changes to Leptris will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0] - 2026-08-23
+
+Lockstep with libleptris 1.3.0 — takes full advantage of the
+concurrency-release surface.
+
+### Added
+
+- **EXSLT extension pack**: `Document#exslt` enables the first-party
+  str:/set:/math: function pack (replace, tokenize, split, concat,
+  padding; distinct, intersection, difference, leading, trailing;
+  max, min, abs, sqrt, power) as native C handlers on that document.
+- `Document#last_error` — per-document error retrieval (thread-safe
+  successor to the library-global string).
+- `leptris_thread_cleanup` bound — optional release of per-thread
+  registry entries when worker threads exit.
+
+### Changed
+
+- Namespace-bound XPath builds its binding set in **one FFI call**
+  via `leptris_xpath_ns_set_new_from_pairs` (flat alternating
+  prefix/URI array through the CStringArray adapter) instead of
+  N+1 calls.
+- `NodeSet#each` fetches mixed-kind results through
+  `leptris_xpath_result_get_nodes_ex`, which copies ALL node kinds —
+  the per-index fallback for the under-copying legacy accessor
+  (leptris#477 residual) is gone.
+- `leptris_version_components` is now officially declared upstream
+  (it was exported-but-undeclared; the export gate caught it).
+
+## [1.2.1] - 2026-08-23
+
+Completes the libleptris 1.2.0 public surface in the binding.
+
+### Added
+
+- **Namespace-bound XPath**: `doc.xpath("//p:title", "p" => "urn:p")`
+  (Nokogiri parity) — expression prefixes now resolve to caller-supplied
+  URIs regardless of the prefixes the document declared, via
+  `leptris_xpath_ns_set_new/_add/_free` + `leptris_xpath_eval_ns`. The
+  binding set is built per call and freed under `ensure`. Previously
+  the trailing namespace hash was silently ignored.
+- `leptris_error_message` / `leptris_last_error` bound; the status seam
+  and parse errors now append the library's last-error detail when
+  present (best-effort: it is a library-global string).
+
 ## [1.2.0] - 2026-08-23
 
 Lockstep with libleptris 1.2.0.

data/Rakefile

@@ -8,7 +8,7 @@ RSpec::Core::RakeTask.new(:spec)
 # Pin for `rake compile` and the platform-gem builds. Keep in lockstep
 # with .github/workflows/build.yml (which calls `rake compile`) and the
 # CHANGELOG when libleptris releases.
-LIBLEPTRIS_VERSION = "1.2.0"
+LIBLEPTRIS_VERSION = "1.3.0"
 
 CMAKE_FLAGS = %w[
   -DCMAKE_BUILD_TYPE=Release
@@ -34,8 +34,10 @@ task :compile do
   sh "cmake --build #{build}/build --config Release -j 4"
   # Windows names the shared library leptris.dll (no "lib" prefix);
   # vendoring under the uniform libleptris.* name keeps the FFI
-  # search order simple.
-  lib = Dir.glob("#{build}/build/**/libleptris.{dylib,so}").first ||
+  # search order simple. libleptris >= 1.3.0 renames the DLL to
+  # libleptris.dll on Windows too (leptris/leptris#507, issue
+  # TODO.concurrency/05) — accept both names.
+  lib = Dir.glob("#{build}/build/**/libleptris.{dylib,so,dll}").first ||
         Dir.glob("#{build}/build/**/leptris.dll").first
   raise "libleptris shared library not found after build" unless lib
   ext = File.extname(lib)

data/lib/leptris/version.rb

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

data/lib/leptris/xml/document.rb

@@ -50,7 +50,8 @@ class Leptris::XML::Document
     if raw.null?
       status = status_ptr.read_int
       raise Leptris::XML::ParseError,
-        "leptris_parse_string failed (status=#{status})"
+        "leptris_parse_string failed (status=#{status}): " +
+        Leptris::XML::FFI.status_message(status)
     end
     wrap(raw)
   end
@@ -222,6 +223,23 @@ class Leptris::XML::Document
     @wrapper_cache.clear
   end
 
+  # Enable the first-party EXSLT-style extension pack on this
+  # document: str:/set:/math: prefixed functions (replace, tokenize,
+  # split, concat, padding; distinct, intersection, difference,
+  # leading, trailing; max, min, abs, sqrt, power) as native C
+  # handlers. Returns self for chaining.
+  def exslt
+    Leptris::XML::FFI.check_status(
+      Leptris::XML::FFI.leptris_exslt_enable(@c_ptr))
+    self
+  end
+
+  # The most recent error recorded against this document, or nil.
+  def last_error
+    msg = Leptris::XML::FFI.leptris_document_last_error(@c_ptr)
+    msg.nil? || msg.empty? ? nil : msg
+  end
+
   def name; "document"; end
   def document; self; end
   def encoding

data/lib/leptris/xml/ffi.rb

@@ -23,6 +23,7 @@ module Leptris
       typedef :pointer, :leptris_attribute
       typedef :pointer, :leptris_doctype
       typedef :pointer, :leptris_xpath_result
+      typedef :pointer, :leptris_xpath_ns_set
       typedef :pointer, :leptris_xpath_var_set
       typedef :pointer, :leptris_sax_parser
       typedef :int, :leptris_status
@@ -343,6 +344,10 @@ module Leptris
         [:leptris_document, :string, :pointer, :pointer], :leptris_status
       attach_function :leptris_xpath_result_get_nodes,
         [:leptris_xpath_result, :pointer, :size_t], :size_t
+      # v1.3.0: copies ALL node kinds (the legacy accessor drops
+      # non-element entries) and can also report per-entry kinds.
+      attach_function :leptris_xpath_result_get_nodes_ex,
+        [:leptris_xpath_result, :pointer, :pointer, :size_t], :size_t
       attach_function :leptris_xpath_result_boolean,
         [:leptris_xpath_result], :int
       attach_function :leptris_xpath_result_number,
@@ -365,6 +370,22 @@ module Leptris
       attach_function :leptris_xpath_variable_set_string,
         [:leptris_xpath_var_set, :string, :string], :leptris_status
 
+      # Namespace-bound XPath (v1.2.0): expression prefixes resolve to
+      # caller-supplied URIs regardless of the document's declarations.
+      attach_function :leptris_xpath_ns_set_new,
+        [], :leptris_xpath_ns_set
+      attach_function :leptris_xpath_ns_set_free,
+        [:leptris_xpath_ns_set], :void
+      attach_function :leptris_xpath_ns_set_add,
+        [:leptris_xpath_ns_set, :string, :string], :leptris_status
+      # One-call constructor: flat array of 2*pair_count alternating
+      # prefix/URI strings (v1.3.0).
+      attach_function :leptris_xpath_ns_set_new_from_pairs,
+        [:pointer, :size_t], :leptris_xpath_ns_set
+      attach_function :leptris_xpath_eval_ns,
+        [:leptris_document, :leptris_element, :string, :leptris_xpath_ns_set],
+        :leptris_xpath_result
+
       attach_function :leptris_sax_parse,
         [:string, :size_t, :pointer, :pointer], :int
       attach_function :leptris_sax_parser_create,
@@ -419,6 +440,19 @@ module Leptris
       attach_function :leptris_document_set_allocators,
         [:leptris_document, :pointer, :pointer], :leptris_status
       attach_function :leptris_status_string, [:leptris_status], :string
+      attach_function :leptris_error_message, [:leptris_status], :string
+      # Thread-local since v1.3.0; reliable under the
+      # one-document-per-thread contract.
+      attach_function :leptris_last_error, [], :string
+      attach_function :leptris_document_last_error,
+        [:leptris_document], :string
+      # Optional: release per-thread registry entries when a worker
+      # thread exits (long-lived threads never need it).
+      attach_function :leptris_thread_cleanup, [], :void
+      # First-party EXSLT-style extension pack (str:/set:/math:),
+      # registered natively on one document.
+      attach_function :leptris_exslt_enable,
+        [:leptris_document], :leptris_status
 
       LEPTRIS_OK = 0
       LEPTRIS_ERROR_MEMORY = -1
@@ -467,13 +501,22 @@ module Leptris
         ptr.read_string.tap { leptris_free_string(ptr) }
       end
 
-      # Single status seam: turns a C status code into a Ruby error.
+      # Single status seam: turns a C status code into a Ruby error,
+      # appending the library's last-error detail when present. The
+      # detail is a library-global string, so it can only be treated
+      # as best-effort context.
       def self.check_status(status)
         unless status == LEPTRIS_OK
-          raise Leptris::XML::Error, leptris_status_string(status)
+          raise Leptris::XML::Error, status_message(status)
         end
         status
       end
+
+      def self.status_message(status)
+        base = leptris_status_string(status).to_s
+        detail = leptris_last_error.to_s
+        detail.empty? ? base : "#{base} (#{detail})"
+      end
     end
   end
 end

data/lib/leptris/xml/searchable.rb

@@ -2,14 +2,19 @@
 
 module Leptris::XML::Searchable
   def xpath(*paths)
-    handler, _ns, _vars = parse_search_args(paths)
+    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 = Leptris::XML::FFI.leptris_xpath_eval(doc_ptr, context_ptr, expr)
+    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_status_string(Leptris::XML::FFI::LEPTRIS_ERROR_XPATH)
@@ -50,6 +55,23 @@ module Leptris::XML::Searchable
 
   protected
 
+  # Builds a caller-owned namespace binding set in one FFI call
+  # (ns_set_new_from_pairs takes a flat alternating prefix/URI array,
+  # the same wire format CStringArray owns), evaluates via
+  # leptris_xpath_eval_ns, and frees the set regardless of outcome.
+  def xpath_eval_with_namespaces(doc_ptr, context_ptr, expr, ns)
+    flat = ns.flat_map { |prefix, uri| [prefix.to_s, uri.to_s] }
+    buffer, _anchors = Leptris::XML::CStringArray.to_c(flat)
+    set = Leptris::XML::FFI.leptris_xpath_ns_set_new_from_pairs(
+      buffer, flat.length / 2)
+    raise Leptris::XML::Error, "leptris_xpath_ns_set_new_from_pairs failed" if set.null?
+    begin
+      Leptris::XML::FFI.leptris_xpath_eval_ns(doc_ptr, context_ptr, expr, set)
+    ensure
+      Leptris::XML::FFI.leptris_xpath_ns_set_free(set)
+    end
+  end
+
   def parse_search_args(args)
     handler = args.find { |a| !a.is_a?(String) && !a.is_a?(Hash) && !a.is_a?(Symbol) }
     args = args - [handler] if handler

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Ribose Inc.