leptris 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9d9e951ee8e7b15451e02933c6e5e80d6cb78fa970ff4411153ec1358c50ab1
-  data.tar.gz: 5aab53987963478c27bb0d9bfe96e804672dcc6b7da1842cc3422f9e0b91c235
+  metadata.gz: e181133c2d381d3ed81fbab6ad41b99c0a72ed89cc651a7882c069eee06535fa
+  data.tar.gz: 768c1463a6746f331251d10f5499293b4c00c0914037fee33a08725b7855ac7c
 SHA512:
-  metadata.gz: 7de27428d6e469b405889481a78bdbe1680d28e4b8c4bd2041ccfb49dd3b9a620359f5d66a4bc4f4573e16c332916348cf4313bedbb1c5d1876cf08cb64b243e
-  data.tar.gz: c71f63da347773adfd341782dd10326ff5993c673080e63554013eed453137014f76f2b4a0474b9fa452c5009f573d4d65f01213822016e296735a0a1eea30e3
+  metadata.gz: f0c45bea9042ffec94231c4c799aa43145592d1dff5268ee75e75212b015be689ad875dac84b76ee8a7cf0624bb1b983c39b3dba8ef3966bc8591275648c7738
+  data.tar.gz: eb2803ee6a55c4dcd543678bcb9899c5651269d9737d92bffa9f8f156ddb87b22838f6c12b610644ee585ed6854041f4815f5b4a6f1de4cceb8dd8ae5aceca50

data/CHANGELOG.md

@@ -5,6 +5,35 @@ 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.

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.1"
+  VERSION = "1.3.0"
 end

data/lib/leptris/xml/document.rb

@@ -223,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

@@ -344,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,
@@ -374,6 +378,10 @@ module Leptris
         [: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
@@ -433,7 +441,18 @@ module Leptris
         [: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

data/lib/leptris/xml/searchable.rb

@@ -55,16 +55,17 @@ module Leptris::XML::Searchable
 
   protected
 
-  # Builds a caller-owned namespace binding set, evaluates via
+  # 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)
-    set = Leptris::XML::FFI.leptris_xpath_ns_set_new
+    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
-      ns.each do |prefix, uri|
-        Leptris::XML::FFI.check_status(
-          Leptris::XML::FFI.leptris_xpath_ns_set_add(
-            set, prefix.to_s, uri.to_s))
-      end
       Leptris::XML::FFI.leptris_xpath_eval_ns(doc_ptr, context_ptr, expr, set)
     ensure
       Leptris::XML::FFI.leptris_xpath_ns_set_free(set)

metadata

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