moxml 0.1.26 → 0.2.0

data/spec/moxml/xml_emitter_spec.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe Moxml::XmlEmitter do
+  describe ".escape_text" do
+    it "escapes only & < > in a single pass" do
+      expect(described_class.escape_text("a & < > ' \""))
+        .to eq("a &amp; &lt; &gt; ' \"")
+    end
+
+    it "returns clean strings unallocated" do
+      input = "clean"
+      expect(described_class.escape_text(input)).to equal(input)
+    end
+
+    it "coerces non-strings" do
+      expect(described_class.escape_text(1)).to eq("1")
+    end
+  end
+
+  describe ".escape_attribute" do
+    it "escapes & < > and double quotes, keeping apostrophes literal" do
+      expect(described_class.escape_attribute(%q{& < > ' "}))
+        .to eq("&amp; &lt; &gt; ' &quot;")
+    end
+  end
+
+  describe ".cdata" do
+    it "wraps content in a CDATA section" do
+      expect(described_class.cdata("data")).to eq("<![CDATA[data]]>")
+    end
+
+    it "splits an embedded end sequence into adjacent sections" do
+      expect(described_class.cdata("a]]>b"))
+        .to eq("<![CDATA[a]]]]><![CDATA[>b]]>")
+    end
+  end
+
+  describe ".declaration_xml" do
+    it "renders only the set attributes" do
+      expect(described_class.declaration_xml("1.0", nil, nil))
+        .to eq('<?xml version="1.0"?>')
+      expect(described_class.declaration_xml("1.0", "UTF-8", "yes"))
+        .to eq('<?xml version="1.0" encoding="UTF-8" standalone="yes"?>')
+    end
+
+    it "omits empty encodings" do
+      expect(described_class.declaration_xml("1.0", "", nil))
+        .to eq('<?xml version="1.0"?>')
+    end
+  end
+
+  describe ".doctype_xml" do
+    it "renders PUBLIC and SYSTEM forms and bare names" do
+      expect(described_class.doctype_xml("r", "pub", "sys"))
+        .to eq('<!DOCTYPE r PUBLIC "pub" "sys">')
+      expect(described_class.doctype_xml("r", nil, "sys"))
+        .to eq('<!DOCTYPE r SYSTEM "sys">')
+      expect(described_class.doctype_xml("r", nil, nil))
+        .to eq("<!DOCTYPE r>")
+    end
+  end
+end

data/spec/moxml/xpath/axes_spec.rb

@@ -163,6 +163,78 @@ RSpec.describe "XPath Axes" do
       end
     end
 
+    describe "attribute axis with namespaces" do
+      let(:ns_doc) do
+        xml = <<~XML
+          <root xmlns:p="http://x.org" xmlns:q="http://x.org">
+            <item q:type="namespaced" type="bare" other="o"/>
+          </root>
+        XML
+        context.parse(xml)
+      end
+
+      def select(expression, namespaces = nil)
+        ast = Moxml::XPath::Parser.parse(expression)
+        proc = Moxml::XPath::Compiler.compile_with_cache(ast,
+                                                         namespaces: namespaces)
+        proc.call(ns_doc).map(&:value)
+      end
+
+      it "matches bare names against no-namespace attributes only" do
+        expect(select("/root/item/@type")).to eq(["bare"])
+      end
+
+      it "matches prefixed names by namespace URI, not by prefix spelling" do
+        expect(select("/root/item/@p:type")).to eq(["namespaced"])
+        expect(select("/root/item/@q:type")).to eq(["namespaced"])
+      end
+
+      it "matches any local name within a prefix's namespace" do
+        expect(select("/root/item/@q:*")).to eq(["namespaced"])
+      end
+
+      it "matches nothing for an undeclared prefix" do
+        expect(select("/root/item/@z:type")).to be_empty
+      end
+
+      it "prefers context prefix mappings over document declarations" do
+        expect(select("/root/item/@p:type", "p" => "http://other.org"))
+          .to be_empty
+        expect(select("/root/item/@zzz:type", "zzz" => "http://x.org"))
+          .to eq(["namespaced"])
+      end
+    end
+
+    describe "descendant-or-self shorthand from an element" do
+      it "selects descendants with .//step" do
+        ast = Moxml::XPath::Parser.parse(".//grandchild")
+        proc = Moxml::XPath::Compiler.compile_with_cache(ast)
+        result = proc.call(doc.root.children.find(&:element?))
+
+        expect(result.map { |n| n.attribute("id").value })
+          .to contain_exactly("g1", "g2")
+      end
+    end
+
+    describe "node type tests as steps" do
+      it "selects text nodes with text()" do
+        ast = Moxml::XPath::Parser.parse("//grandchild/text()")
+        proc = Moxml::XPath::Compiler.compile_with_cache(ast)
+        result = proc.call(doc)
+
+        expect(result.map(&:content)).to contain_exactly("text1", "text2")
+      end
+
+      it "selects comments with comment()" do
+        commented = context.parse("<root><!-- c1 --><a/><!-- c2 --></root>")
+        ast = Moxml::XPath::Parser.parse("//comment()")
+        proc = Moxml::XPath::Compiler.compile_with_cache(ast)
+        result = proc.call(commented)
+
+        expect(result.map(&:content)).to contain_exactly(" c1 ", " c2 ")
+      end
+    end
+
     describe "descendant axis" do
       it "finds descendants without self" do
         ast = Moxml::XPath::Parser.parse("/root/descendant::child")

data/spec/moxml/xpath/parser_spec.rb

@@ -60,6 +60,12 @@ RSpec.describe Moxml::XPath::Parser do
         expect(ast.type).to eq(:relative_path)
       end
 
+      it "parses prefixed attribute names" do
+        ast = described_class.parse("@xmi:type")
+        expect(ast.type).to eq(:relative_path)
+        expect { described_class.parse("@xmi:*") }.not_to raise_error
+      end
+
       it "parses path with parent reference" do
         ast = described_class.parse("../book")
         expect(ast.type).to eq(:relative_path)

data/spec/moxml/xpath_capabilities_spec.rb

@@ -131,11 +131,13 @@ RSpec.describe "XPath Capabilities" do
       end
 
       describe "XPath functions" do
-        it "supports count() function" do
+        it "supports count() function, returning the scalar unwrapped" do
           doc = Moxml.new.parse(simple_xml)
-          # NOTE: count() returns a number, not nodes
           result = doc.xpath("count(//book)")
-          expect(result).to be_a(Numeric) if result.is_a?(Numeric)
+          # REXML's XPath has no function support and yields an empty set
+          skip "count() function not supported on #{adapter_name}" if result.is_a?(Moxml::NodeSet)
+
+          expect(result).to eq(2)
         rescue Moxml::XPathError, NoMethodError
           skip "count() function not supported on #{adapter_name}"
         end

data/spec/performance/benchmark_spec.rb

@@ -23,14 +23,21 @@ RSpec.shared_examples "Performance Examples" do
     context "measures performance" do
       let(:doc) { context.parse(large_xml) }
 
+      # Absolute ips varies more than 2x across machines and even between
+      # runs on the same machine (observed: rexml serializer 1.5-2.9 ips on
+      # one machine). These thresholds sit at roughly half of typical
+      # modern-runner throughput so they only trip on asymptotic
+      # regressions (accidental O(n^2), broken caching), not on hardware
+      # variance or a few percent of legitimate overhead.
       let(:thresholds) do
         {
-          nokogiri: { parser: 15, serializer: 1000 },
-          oga: { parser: 10, serializer: 100 },
-          rexml: { parser: 0, serializer: 5 },
-          ox: { parser: 2, serializer: 1000 },
-          headed_ox: { parser: 2, serializer: 1000 },
-          libxml: { parser: 500, serializer: 60 },
+          nokogiri: { parser: 8, serializer: 500 },
+          oga: { parser: 5, serializer: 50 },
+          rexml: { parser: 0, serializer: 1 },
+          ox: { parser: 1, serializer: 400 },
+          headed_ox: { parser: 1, serializer: 400 },
+          libxml: { parser: 200, serializer: 30 },
+          leptris: { parser: 1300, serializer: 600 },
         }
       end
 

data/spec/performance/thread_safety_spec.rb

@@ -20,10 +20,6 @@ RSpec.shared_examples "Thread Safety Examples" do
     end
 
     it "handles concurrent processing" do
-      if Moxml.new.config.adapter_name == :ox
-        skip "Ox doesn't have a native XPath"
-      end
-
       processor = processor_class.new
       threads = []
       results = Queue.new

data/spec/spec_helper.rb

@@ -101,7 +101,11 @@ RSpec.configure do |config|
 end
 
 Moxml.configure do |config|
-  config.adapter = RUBY_ENGINE == "opal" ? Moxml::Config::OPAL_DEFAULT_ADAPTER : Moxml::Config::DEFAULT_ADAPTER
+  # Pin the suite baseline to the fallback adapter so results are
+  # reproducible regardless of whether the local environment has a
+  # leptris new enough to win the runtime-default probe. Leptris gets
+  # full coverage through its explicit adapter/integration matrices.
+  config.adapter = RUBY_ENGINE == "opal" ? Moxml::Config::OPAL_DEFAULT_ADAPTER : Moxml::Config::FALLBACK_ADAPTER
   config.strict_parsing = true
   config.default_encoding = "UTF-8"
   config.entity_load_mode = :optional if RUBY_ENGINE == "opal"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: moxml
 version: !ruby/object:Gem::Version
-  version: 0.1.26
+  version: 0.2.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-22 00:00:00.000000000 Z
+date: 2026-08-25 00:00:00.000000000 Z
 dependencies: []
 description: |
   Moxml is a unified XML manipulation library that provides a common API
@@ -27,6 +27,7 @@ files:
 - ".github/workflows/rake.yml"
 - ".github/workflows/release.yml"
 - ".github/workflows/round-trip.yml"
+- ".github/workflows/windows.yml"
 - ".gitignore"
 - ".gitmodules"
 - ".rspec"
@@ -119,6 +120,11 @@ files:
 - lib/moxml.rb
 - lib/moxml/adapter.rb
 - lib/moxml/adapter/base.rb
+- lib/moxml/adapter/customized_leptris.rb
+- lib/moxml/adapter/customized_leptris/declaration.rb
+- lib/moxml/adapter/customized_leptris/doctype.rb
+- lib/moxml/adapter/customized_leptris/entity_reference.rb
+- lib/moxml/adapter/customized_leptris/text_segment.rb
 - lib/moxml/adapter/customized_libxml.rb
 - lib/moxml/adapter/customized_libxml/cdata.rb
 - lib/moxml/adapter/customized_libxml/comment.rb
@@ -129,6 +135,8 @@ files:
 - lib/moxml/adapter/customized_libxml/processing_instruction.rb
 - lib/moxml/adapter/customized_libxml/text.rb
 - lib/moxml/adapter/customized_oga.rb
+- lib/moxml/adapter/customized_oga/entity_decoder.rb
+- lib/moxml/adapter/customized_oga/raw_value_override.rb
 - lib/moxml/adapter/customized_oga/xml_declaration.rb
 - lib/moxml/adapter/customized_oga/xml_generator.rb
 - lib/moxml/adapter/customized_ox.rb
@@ -140,6 +148,7 @@ files:
 - lib/moxml/adapter/customized_rexml/entity_reference.rb
 - lib/moxml/adapter/customized_rexml/formatter.rb
 - lib/moxml/adapter/headed_ox.rb
+- lib/moxml/adapter/leptris.rb
 - lib/moxml/adapter/libxml.rb
 - lib/moxml/adapter/libxml/entity_ref_registry.rb
 - lib/moxml/adapter/libxml/entity_restorer.rb
@@ -148,6 +157,7 @@ files:
 - lib/moxml/adapter/ox.rb
 - lib/moxml/adapter/rexml.rb
 - lib/moxml/attribute.rb
+- lib/moxml/attribute_resolver.rb
 - lib/moxml/builder.rb
 - lib/moxml/c14n.rb
 - lib/moxml/c14n/attribute_handler.rb
@@ -179,6 +189,8 @@ files:
 - lib/moxml/document.rb
 - lib/moxml/document_builder.rb
 - lib/moxml/element.rb
+- lib/moxml/entity.rb
+- lib/moxml/entity/reference.rb
 - lib/moxml/entity_reference.rb
 - lib/moxml/entity_registry.rb
 - lib/moxml/entity_registry_opal_data.rb
@@ -246,6 +258,7 @@ files:
 - lib/moxml/signature/verifier.rb
 - lib/moxml/text.rb
 - lib/moxml/version.rb
+- lib/moxml/xml_emitter.rb
 - lib/moxml/xml_utils.rb
 - lib/moxml/xml_utils/encoder.rb
 - lib/moxml/xpath.rb
@@ -371,6 +384,7 @@ files:
 - spec/integration/README.md
 - spec/integration/all_adapters_spec.rb
 - spec/integration/headed_ox_integration_spec.rb
+- spec/integration/sax_parity_spec.rb
 - spec/integration/shared_examples/edge_cases.rb
 - spec/integration/shared_examples/entity_reference_whitespace.rb
 - spec/integration/shared_examples/high_level/.gitkeep
@@ -401,6 +415,7 @@ files:
 - spec/moxml/adapter/base_spec.rb
 - spec/moxml/adapter/entity_restoration_spec.rb
 - spec/moxml/adapter/headed_ox_spec.rb
+- spec/moxml/adapter/leptris_spec.rb
 - spec/moxml/adapter/libxml_internals_spec.rb
 - spec/moxml/adapter/libxml_spec.rb
 - spec/moxml/adapter/nokogiri_spec.rb
@@ -413,6 +428,7 @@ files:
 - spec/moxml/adapter_spec.rb
 - spec/moxml/allocation_benchmark_spec.rb
 - spec/moxml/allocation_guard_spec.rb
+- spec/moxml/attribute_resolver_spec.rb
 - spec/moxml/attribute_spec.rb
 - spec/moxml/builder_spec.rb
 - spec/moxml/c14n/api_spec.rb
@@ -434,6 +450,7 @@ files:
 - spec/moxml/entity_preservation_spec.rb
 - spec/moxml/entity_reference_spec.rb
 - spec/moxml/entity_registry_spec.rb
+- spec/moxml/entity_spec.rb
 - spec/moxml/error_spec.rb
 - spec/moxml/lazy_parse_spec.rb
 - spec/moxml/moxml_spec.rb
@@ -455,6 +472,7 @@ files:
 - spec/moxml/opal_smoke_spec.rb
 - spec/moxml/processing_instruction_spec.rb
 - spec/moxml/sax/namespace_splitter_spec.rb
+- spec/moxml/sax_entity_parity_spec.rb
 - spec/moxml/sax_spec.rb
 - spec/moxml/signature/algorithms/base64_transform_spec.rb
 - spec/moxml/signature/algorithms/digest_base_spec.rb
@@ -472,6 +490,7 @@ files:
 - spec/moxml/signature/round_trip_spec.rb
 - spec/moxml/text_spec.rb
 - spec/moxml/version_spec.rb
+- spec/moxml/xml_emitter_spec.rb
 - spec/moxml/xml_utils/.gitkeep
 - spec/moxml/xml_utils/encoder_spec.rb
 - spec/moxml/xml_utils_spec.rb