leptris 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28a6d0b01b14207e6a928eead2f38f84bf2dda03b9c7ae4a3c6bcc3163f2760d
-  data.tar.gz: e23962a817090c8707dc691fe58276f25da7075e1b0b64bb1fa39774cd113d4e
+  metadata.gz: e9d9e951ee8e7b15451e02933c6e5e80d6cb78fa970ff4411153ec1358c50ab1
+  data.tar.gz: 5aab53987963478c27bb0d9bfe96e804672dcc6b7da1842cc3422f9e0b91c235
 SHA512:
-  metadata.gz: 83e9f30fd09ded2f909d651423db46be8a6baca9f39f310e9b8c3632f5fd7cd5627d193cd57c80d6191a2c00145858b87d9454a72df12e96a28fbd928864a663
-  data.tar.gz: 5991c97a7ea5b8a3462c62492fd70808f4094d2758525ce2ec6ac47a9ffe61bb318c71d1999c95081e5e48ce10cc98d9e671ea8c52400c3a90b01e4f9a5b3ce1
+  metadata.gz: 7de27428d6e469b405889481a78bdbe1680d28e4b8c4bd2041ccfb49dd3b9a620359f5d66a4bc4f4573e16c332916348cf4313bedbb1c5d1876cf08cb64b243e
+  data.tar.gz: c71f63da347773adfd341782dd10326ff5993c673080e63554013eed453137014f76f2b4a0474b9fa452c5009f573d4d65f01213822016e296735a0a1eea30e3

data/CHANGELOG.md

@@ -5,6 +5,22 @@ 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.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/lib/leptris/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Leptris
-  VERSION = "1.2.0"
+  VERSION = "1.2.1"
 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

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
@@ -365,6 +366,18 @@ 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
+      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 +432,8 @@ 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
+      attach_function :leptris_last_error, [], :string
 
       LEPTRIS_OK = 0
       LEPTRIS_ERROR_MEMORY = -1
@@ -467,13 +482,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,22 @@ module Leptris::XML::Searchable
 
   protected
 
+  # Builds a caller-owned namespace binding set, 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
+    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)
+    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.2.1
 platform: ruby
 authors:
 - Ribose Inc.