moxml 0.5.78 → 0.5.79

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd28ba8e6db906efd5a53cf65b12b2eee71739b60ca5b318c4c2013235f5ec1d
-  data.tar.gz: 2e36bde35317ddebb0a90c3b831f0566aa4e7b120ac51b9aead532309d586b28
+  metadata.gz: 9314d43b66d5890286b147d882d0200e33adee9e61209e8088674be8205e11ea
+  data.tar.gz: 3ec14b4892a6ae2f0dd2a8d2bded06b86a0c86ce742b20f6763478df4a851963
 SHA512:
-  metadata.gz: a2042daf1ec389e25b0a2e8896389944e19414c36881deb40d82327dc9025a1962ae6475d73b4e9e412cd787257a7a19403826b5f76ffacbe6a95fb694702250
-  data.tar.gz: 8259b9003c8085ce46567f4f75dc34502c41ebf15bff9d66b55499e127be8b69ccdcdabf3a3b1d262802684e26f8f2740b032a2dffed32929f3f121bc749090c
+  metadata.gz: bb2f60f496656598a90121c56039f620e4a46518753c9062262d4aa21a7c56db6b3d8b1fa5d3d87f4f45773a1de03d63e731e10ee95fc9fbe1c6d8bab5c3122d
+  data.tar.gz: 59d27148762e9b3837feb218bd42820a3a17291b8ac266b8868b730b19dc0d4d84abaa238f60e32a279c31673593dfc70f809d4cefd8b60c6deae173e8f63745

data/README.adoc

@@ -103,9 +103,10 @@ entity references (`entity_mode: :keep`), 1.9.193.4+ native plan rows
 executor (`Moxml::StructPlan`; the floor is the varargs-mint fix),
 1.9.204+ native document-level parts (created DOCTYPEs as native
 nodes, document-PI removal, declaration clear). Current
-recommendation: 1.9.216+ (the plan-ABI train: bound plan rows,
-typed scalars, the #1242 iterparse fix; the engine's 1.9.217+
-borrowed-text-run wins ride in automatically).
+recommendation: 1.9.228+ (the #318 text-set fix train; carries
+the plan-ABI surface — bound plan rows, typed scalars, fused
+Descriptor#materialize — plus the 1.9.217+ borrowed-text-run and
+1.9.221+ memory wins).
 |===
 
 NOTE: moxml's dev Gemfile pins `leptris ~> 1.9.174`, `nokogiri ~> 1.18`,
@@ -644,6 +645,42 @@ root.add_child(title)
 puts doc.to_xml(indent: 2)
 ----
 
+=== Fast paths and diagnostics
+
+Read-only attribute listing without Attribute node objects — the
+walk-hot shape when only names and values are needed (leptris
+answers in one C crossing; document order, duplicates included):
+
+[source,ruby]
+----
+element.attribute_pairs.each do |name, value|
+  # names are shared frozen strings; dup before mutating
+end
+----
+
+Typed struct members on `Moxml::StructPlan` — the executor casts
+in C with no intermediate String (unparseable input degrades to
+the raw String):
+
+[source,ruby]
+----
+plan = Moxml::StructPlan.new do
+  element "item", Item,
+          attrs: { "price" => [:price, :float], "qty" => [:qty, :integer] },
+          text: [:label, :integer]
+end
+----
+
+Recover-class parse diagnostics (duplicate-attribute events and
+siblings) on adapters with the surface; `[]` elsewhere. Read
+while the document is alive:
+
+[source,ruby]
+----
+doc.parse_diagnostics
+# => [{ kind: :recover, message: "Attribute a redefined" }]
+----
+
 == Real-world examples
 
 Practical, runnable examples demonstrating Moxml usage in common scenarios are

data/lib/moxml/adapter/leptris.rb

@@ -353,10 +353,8 @@ module Moxml
           }.freeze
 
           def wrap_binding_node(node, context)
-            if node.instance_variable_defined?(:@moxml_wrapper)
-              cached = node.instance_variable_get(:@moxml_wrapper)
-              return cached if cached
-            end
+            cached = node.instance_variable_get(:@moxml_wrapper)
+            return cached if cached
 
             entry = BINDING_FAST_WRAP[node.class]
             return nil unless entry

data/lib/moxml/adapter/nokogiri.rb

@@ -294,6 +294,18 @@ module Moxml
           element[name.to_s] = value.to_s
         end
 
+        # Cross-adapter parity for Document#parse_diagnostics
+        # (#271): Nokogiri's doc.errors already carries recover-
+        # mode entries; mapped into the same { kind:, message: }
+        # shape. Kind is :error — Nokogiri does not classify.
+        def parse_diagnostics(native_doc)
+          return [] unless native_doc.respond_to?(:errors)
+
+          native_doc.errors.map do |e|
+            { kind: :error, message: e.message.to_s }
+          end
+        end
+
         def attributes(element)
           # attribute_nodes, not attributes.values: the attributes Hash
           # is keyed by local name, so xmi:type and type collide and

data/lib/moxml/version.rb

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

data/spec/moxml/document_parse_diagnostics_spec.rb

@@ -40,4 +40,16 @@ RSpec.describe Moxml::Document do
   rescue StandardError, LoadError
     skip "rexml adapter unavailable"
   end
+
+  it "maps nokogiri doc.errors into the same shape" do
+    ctx = Moxml.new(:nokogiri)
+    doc = ctx.parse(%(<r a="1" a="2"/>), recover: true) ||
+      ctx.parse(%(<r a="1" a="2"/>))
+    diags = doc.parse_diagnostics
+    expect(diags).not_to be_empty
+    expect(diags.first[:kind]).to eq(:error)
+    expect(diags.first[:message]).to be_a(String)
+  rescue StandardError, LoadError
+    skip "nokogiri adapter unavailable"
+  end
 end

metadata

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