moxml 0.5.52 → 0.5.54

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b9e4f8b355a983117cbc435343e414c731791232b8ecee131f5de68fe8e7ce8
-  data.tar.gz: 9409d7e0b355d76423acb9abbc812a09665110c53ba29e04cf838d486d257c4e
+  metadata.gz: ba51d35ca414232eb04fafd976a2f5d24b2f43fff1b0e4c4a69147162da324c7
+  data.tar.gz: 73df7c7f9da2ff33e4ab2d06f3b56b29b0a09e4784c78eb9907d3ec15f82c234
 SHA512:
-  metadata.gz: '028a06c0b8f3e041f4ac257df4104052137f4d64d590d1be2c58f093dbf6909685767924c08914e1624daeb7bb8d419e2ad034ae61003a5099e7c673c7ced58b'
-  data.tar.gz: 0f737e2a0055194c05492bfebee65253e5a45fffecdd610e0c1f46b53728e23483acc44cdd48165313c213b8fca597685e1bf8e0f28db6afa8a67c28ae1c4167
+  metadata.gz: c30f3bef444d6a6da7416e5ee5493c5656a6bbca1f28c9d504c9405b3be54b083eb5bf9a218ed1e0ac1cb94b3551678c028adadf667fcc7b15b50a2e403341ab
+  data.tar.gz: cef805979f7168ec08ce5dc80624e74a2bef27225233d1389862d84b6d4d9cea56806b50a6231e078a626ba488ce90668e0fd8b40ad6cf11a650a3b154c24041

data/README.adoc

@@ -51,8 +51,55 @@ Leptris:: https://github.com/leptris/leptris[Leptris], a pure-C99 XML 1.0
 parser with a W3C-conformant XPath 1.0 engine, consumed through the
 https://github.com/leptris/leptris-ruby[leptris-ruby] FFI binding
 (precompiled platform gems — no compilation at install). Fastest on
-every measured operation; requires leptris >= 1.2 for programmatic
-document construction.
+every measured operation; requires leptris >= 1.9.32 (see version table below).
+
+=== Underlying library versions
+
+Moxml declares no runtime gem dependencies: you bundle the adapter
+gem(s) you want. Each adapter carries the version floor it is built
+and tested against — older versions are untested and the leptris
+adapter refuses to load below its floor.
+
+[cols="2,3,5"]
+|===
+|Adapter |Acceptable versions |Notes
+
+|REXML
+|Ruby-bundled (Ruby >= 3.0)
+|Always available; no gem to manage.
+
+|Nokogiri
+|>= 1.18
+|Tested against the 1.18 line.
+
+|Ox
+|>= 2.14
+|Tested against the 2.14 line.
+
+|Oga
+|3.4 / 3.5
+|The moxml repository vendors an Opal-compatible fork of oga 3.4
+for development and CI. Oga 4.x is not yet validated against
+moxml's customized generator and decoder overrides.
+
+|LibXML (libxml-ruby)
+|>= 5.0
+|6.x works and is the installed default on Ruby >= 3.2 (libxml-ruby
+6.0 itself requires Ruby >= 3.2); Ruby 3.1 resolves 5.x.
+
+|Leptris (leptris-ruby)
+|>= 1.9.32
+|Hard floor — `MINIMUM_BINDING_VERSION`; older bindings do not load.
+Newer bindings unlock more native surface automatically:
+1.9.163.7+ single-result XPath seams, 1.9.174.4+ C-minted identity
+wrappers, 1.9.174.6+ one-dispatch subtree walks, 1.9.177+ first-class
+entity references (`entity_mode: :keep`). The release notes carry the
+current recommendation.
+|===
+
+NOTE: moxml's dev Gemfile pins `leptris ~> 1.9.174`, `nokogiri ~> 1.18`,
+`ox ~> 2.14`, `libxml-ruby >= 5.0`, and the vendored oga fork — the CI
+matrix tests exactly those floors.
 
 ==== Default adapter selection
 
@@ -61,7 +108,7 @@ the runtime environment:
 
 . If running on Opal (`RUBY_ENGINE == "opal"`), Oga is used (pure Ruby, no C extensions)
 . Otherwise, if the installed leptris gem supports programmatic document
-  construction (`Leptris::XML::Document.create`, leptris >= 1.2), Leptris is used
+  construction (`Leptris::XML::Document.create`, leptris >= 1.9.32), Leptris is used
 . Otherwise, Moxml detects already-loaded XML libraries in this order:
   .. Nokogiri
   .. Ox
@@ -72,7 +119,7 @@ the runtime environment:
 ----
 # Automatic detection — picks the best available adapter
 ctx = Moxml.new
-ctx.config.adapter_name  # => :leptris (leptris >= 1.2), :nokogiri otherwise, :oga on Opal
+ctx.config.adapter_name  # => :leptris (leptris >= 1.9.32), :nokogiri otherwise, :oga on Opal
 
 # Explicit override — always takes precedence
 ctx = Moxml.new(:ox)

data/lib/moxml/adapter/leptris.rb

@@ -973,7 +973,12 @@ module Moxml
         end
 
         def children(node, entity_bearing: false)
-          if NATIVE_ENTITY_REFS &&
+          # NATIVE_READ_LAYER gates the whole keep-path: it consults
+          # NN_DOCUMENT (defined only with the native layer), and
+          # native-less installs answer through the binding case
+          # branch below, whose children already carry first-class
+          # EntityReference nodes (issue #240).
+          if NATIVE_READ_LAYER && NATIVE_ENTITY_REFS &&
               native_keep_entity_refs?(node)
             return to_binding(node).children.to_a
           end
@@ -1041,7 +1046,8 @@ module Moxml
         end
 
         def native_keep_entity_refs?(node)
-          return false unless node.is_a?(::Leptris::XML::NativeNode)
+          return false unless NATIVE_READ_LAYER &&
+            node.is_a?(::Leptris::XML::NativeNode)
 
           doc = NN_DOCUMENT.bind_call(node)
           attachments.get(doc, :keep_entity_refs) == true

data/lib/moxml/adapter/oga.rb

@@ -561,9 +561,10 @@ module Moxml
           )
         end
 
-        # Whether this oga build honors the indent option (newer
-        # releases do; the capability probe keeps the indentation
-        # spec pending-or-live across both).
+        # Whether this adapter's oga serialization honors the
+        # indent option (the customized generator currently does
+        # not; the probe keeps the indentation spec pending-or-live
+        # per environment).
         def indents_output?
           return @indents_output unless @indents_output.nil?
 

data/lib/moxml/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Moxml
-  VERSION = "0.5.52"
+  VERSION = "0.5.54"
 end

data/spec/moxml/adapter/libxml_internals_spec.rb

@@ -1,9 +1,14 @@
 # frozen_string_literal: true
 
 begin
-  require "libxml-ruby" rescue (require "libxml")
+  require "libxml-ruby"
 rescue LoadError
-  return
+  begin
+    require "libxml"
+  rescue LoadError
+    # LibXML gem not available - skip all specs in this file
+    return
+  end
 end
 
 require "moxml/adapter/libxml"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: moxml
 version: !ruby/object:Gem::Version
-  version: 0.5.52
+  version: 0.5.54
 platform: ruby
 authors:
 - Ribose Inc.