moxml 0.5.118 → 0.5.119

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60a08183c240700f3cde7675fb3428b47340f0dba11e723309c5afb09aa988bb
-  data.tar.gz: 42e790020feb09861560717610f16f6e8996fb7435689eae1f989a05cb90ab0a
+  metadata.gz: 7a30730e871854c7b88fc3b6a3498b4f4d5504ac47caa2aabcc530f2bf0eec96
+  data.tar.gz: 8d4f301d7d100cab15cc55b4f0e3db36bc5e50916775adfd34f64b816546d466
 SHA512:
-  metadata.gz: 4accde9025cb43cbe09661c68be8d31047f39339f035f2a80d895e3e8b03a786b7b0d492880a39d0f2f4b57b0209002e62cc79c7c71b3c4373091ceaac4481ee
-  data.tar.gz: 203fb7db9d8e46a7a028218dda254367cc0cb1c8ac096b516102937874ba0f14b2bbe1f06cfcb413334567722d31f94f4e00fe2850e2c3a20f1334a3bfce5f70
+  metadata.gz: 4b61a839f7399e0b9e9236b1d921cfc161714b114d73da1b737a80c98795d8c88b96f8e85e71c3a71f58a090578b2ba6ffa4ec57cb9a6309cb53296bb000b277
+  data.tar.gz: b42fa624031b28da813039d441024be7766f8322fc54f247075b0c205cb79ec57052ababc789ab90f1c3b91b04a0ced4de85760af3178c1675aedd390fdd8046

data/Gemfile

@@ -9,7 +9,7 @@ gemspec
 gem "benchmark"
 gem "benchmark-ips"
 gem "get_process_mem"
-gem "leptris", "~> 1.9.320"
+gem "leptris", "~> 1.9.321"
 gem "libxml-ruby", ">= 5.0"
 gem "nokogiri", "~> 1.18"
 gem "openssl", "~> 3.0"

data/README.adoc

@@ -119,7 +119,7 @@ carries the plan-ABI surface, the 1.9.290 XSLT-params and
 bulk-append faces, and the 1.9.292 engine deep-copy root install).
 |===
 
-NOTE: moxml's dev Gemfile pins `leptris ~> 1.9.320` (the tested pair; the gemspec itself has zero runtime dependencies). Consumers of the leptris adapter should run leptris 1.9.320+ — earlier engines carry silent wrong-answer plan-path defects (moxml#344); moxml gates degrade to the always-correct slower paths below it.
+NOTE: moxml's dev Gemfile pins `leptris ~> 1.9.321` (the tested pair; the gemspec itself has zero runtime dependencies). Consumers of the leptris adapter should run leptris 1.9.320+ — earlier engines carry silent wrong-answer plan-path defects (moxml#344); moxml gates degrade to the always-correct slower paths below it.
 `ox ~> 2.14`, `libxml-ruby >= 5.0`, and the vendored oga fork — the CI
 matrix tests exactly those floors.
 

data/lib/moxml/adapter/base.rb

@@ -258,6 +258,20 @@ module Moxml
           raise Moxml::NotImplementedError, XSLT_UNSUPPORTED_MESSAGE
         end
 
+        # XSD validation (moxml XSD contract): engines without a
+        # validator raise; leptris gates on >= 1.9.321.0.
+        XSD_SUPPORTED = false
+
+        def xsd_compile(_schema_source)
+          raise Moxml::NotImplementedError,
+                "XSD validation requires an adapter with an XSD engine"
+        end
+
+        def xsd_validate(_xsd_handle, _native_document)
+          raise Moxml::NotImplementedError,
+                "XSD validation requires an adapter with an XSD engine"
+        end
+
         # Apply a compiled stylesheet; returns the engine's result
         # document, or nil when the output method cannot produce one
         # (text). @params is the flat quoted name/value list.

data/lib/moxml/adapter/leptris.rb

@@ -165,6 +165,18 @@ module Moxml
       # binding 1.9.313): the DSL accumulates markup in a plain
       # String and ONE native crossing (parse + attach) flushes the
       # whole subtree. See Adapter::Base#builder_face.
+      # XSD validation (leptris-ruby tier-1, #1075): the binding's
+      # Leptris::XML::XSD faces — >= 1.9.321.0 carries instance
+      # validation with accumulated errors (slices 3-4). Face probe
+      # pairs the gate (misrelease races — NATIVE_PLAN_STRUCTS
+      # lesson).
+      NATIVE_XSD =
+        Gem::Version.new(::Leptris::VERSION) >= Gem::Version.new("1.9.321.0") &&
+        defined?(::Leptris::XML::XSD) &&
+        ::Leptris::XML::FFI.respond_to?(:leptris_xsd_validate)
+
+      XSD_SUPPORTED = NATIVE_XSD
+
       NATIVE_BUILDER =
         defined?(::Leptris::XML::Builder) &&
         defined?(::Leptris::XML::Document) &&
@@ -218,6 +230,27 @@ module Moxml
         # (and on installs without the native layer — the constant
         # check short-circuits), a Node.wrap over the shared C
         # pointer for NativeNodes.
+        def xsd_compile(schema_source)
+          unless XSD_SUPPORTED
+            raise Moxml::NotImplementedError,
+                  "XSD validation requires the leptris 1.9.321+ engine"
+          end
+
+          ::Leptris::XML::XSD.compile(schema_source)
+        end
+
+        def xsd_validate(xsd_handle, native_document)
+          # +xsd_handle+ is the binding's Leptris::XML::XSD::Schema;
+          # validate_errors takes the binding document and returns
+          # the engine's accumulated messages ([] = valid).
+          doc = if native_document.is_a?(::Leptris::XML::Document)
+                  native_document
+                else
+                  to_binding(native_document)
+                end
+          xsd_handle.validate_errors(doc)
+        end
+
         def builder_face(native_document)
           return nil unless NATIVE_BUILDER && NATIVE_READ_LAYER
 

data/lib/moxml/context.rb

@@ -144,6 +144,18 @@ module Moxml
     # @return [Moxml::XSLT::Stylesheet]
     # @raise [Moxml::NotImplementedError] on adapters without an engine
     # @raise [Moxml::XsltError] on a malformed stylesheet
+    # Compile an XSD schema for validation (moxml XSD contract).
+    # Returns a Moxml::XSD::Schema; #validate/#valid? take a node or
+    # raw XML string. Adapters without an engine raise
+    # Moxml::NotImplementedError; Moxml::XSD.supported?(self)
+    # answers without raising.
+    #
+    # @raise [Moxml::NotImplementedError] on adapters without a validator
+    def xsd(schema_source)
+      handle = config.adapter.xsd_compile(schema_source.to_s)
+      Moxml::XSD::Schema.new(handle, self)
+    end
+
     def xslt(stylesheet)
       source = case stylesheet
                when Moxml::Document then stylesheet.to_xml

data/lib/moxml/version.rb

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

data/lib/moxml/xsd.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Moxml
+  # XSD validation. Implementation-agnostic over engines that ship
+  # an XSD validator (currently leptris, tier-1: named+typed
+  # top-level elements, one-level content-model descent, lexical
+  # builtin/simpleType checks — see docs/c14n for the sibling
+  # pattern).
+  #
+  #     ctx    = Moxml.new(:leptris)
+  #     schema = ctx.xsd(<<~XSD)
+  #       <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
+  #         <xs:element name="note" type="t_note"/>
+  #         <xs:complexType name="t_note">
+  #           <xs:sequence>
+  #             <xs:element name="to" type="xs:string"/>
+  #           </xs:sequence>
+  #         </xs:complexType>
+  #       </xs:schema>
+  #     XSD
+  #     schema.valid?(doc)     # => true/false
+  #     schema.validate(doc)   # => [] or ["1:0: ...", ...]
+  #
+  # Adapters without an engine raise Moxml::NotImplementedError at
+  # compile; Moxml::XSD.supported?(context) answers without
+  # raising. The tier-1 scope is the engine's: documents outside it
+  # validate laxly (see the binding's xsd_validate_spec).
+  module XSD
+    SUPPORTED_ADAPTERS = %i[leptris].freeze
+
+    class << self
+      # Whether the context's adapter ships an XSD validator.
+      # Answers without raising; compile raises
+      # Moxml::NotImplementedError regardless (the capability probe
+      # is advisory).
+      def supported?(context)
+        adapter = context.config.adapter
+        adapter.const_defined?(:XSD_SUPPORTED) &&
+          adapter.const_get(:XSD_SUPPORTED)
+      end
+    end
+
+    # A compiled schema (adapter-owned handle). Validation results
+    # are the engine's accumulated messages; [] means valid.
+    class Schema
+      def initialize(handle, context)
+        @handle = handle
+        @context = context
+      end
+
+      # Validate a node or raw XML string. Returns [] when valid.
+      def validate(node_or_xml)
+        doc = case node_or_xml
+              when Moxml::Document then node_or_xml
+              when Moxml::Node then node_or_xml.document
+              else @context.parse(node_or_xml.to_s)
+              end
+        @context.config.adapter.xsd_validate(@handle, doc.native)
+      end
+
+      def valid?(node_or_xml)
+        validate(node_or_xml).empty?
+      end
+    end
+  end
+end

data/lib/moxml.rb

@@ -101,6 +101,7 @@ module Moxml
   autoload :Signature, "moxml/signature"
   autoload :C14n, "moxml/c14n"
   autoload :XSLT, "moxml/xslt"
+  autoload :XSD, "moxml/xsd"
 
   # Error hierarchy — each subclass autoloads from the same file
   autoload :Error, "moxml/error"

data/spec/moxml/xsd_spec.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+# Moxml::XSD contract (leptris tier-1 faces): compile + validate
+# with accumulated errors; unsupported adapters raise
+# NotImplementedError at compile.
+RSpec.describe Moxml::XSD do
+  let(:ctx) { Moxml.new(:leptris) }
+  let(:schema_text) do
+    <<~XSD
+      <?xml version="1.0"?>
+      <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
+        <xs:element name="note" type="t_note"/>
+        <xs:complexType name="t_note">
+          <xs:sequence>
+            <xs:element name="to" type="xs:string"/>
+          </xs:sequence>
+        </xs:complexType>
+      </xs:schema>
+    XSD
+  end
+
+  it "reports supported? on the leptris adapter" do
+    skip "leptris adapter unavailable" unless
+      Moxml::Adapter::Leptris::XSD_SUPPORTED
+
+    expect(described_class.supported?(ctx)).to be(true)
+  end
+
+  context "when the adapter ships a validator" do
+    before do
+      skip "leptris 1.9.321+ engine required" unless
+        Moxml::Adapter::Leptris::XSD_SUPPORTED
+    end
+
+    it "compiles and validates a good document" do
+      schema = ctx.xsd(schema_text)
+      doc = ctx.parse("<note><to>You</to></note>")
+      expect(schema.valid?(doc)).to be(true)
+      expect(schema.validate(doc)).to eq([])
+    end
+
+    it "returns accumulated messages for an invalid document" do
+      schema = ctx.xsd(schema_text)
+      errors = schema.validate("<note><wrong/></note>")
+      expect(errors).not_to be_empty
+    end
+
+    it "validates raw XML strings and nodes" do
+      schema = ctx.xsd(schema_text)
+      doc = ctx.parse("<note><to>x</to></note>")
+      expect(schema.valid?(doc.root)).to be(true)
+      expect(schema.valid?("<note><to>x</to></note>")).to be(true)
+      expect(schema.valid?("<note><wrong/></note>")).to be(false)
+    end
+
+    it "derives XSD_SUPPORTED from the engine face gate" do
+      # The capability flag must not outrun the engine faces: a
+      # misreleased lockstep (NATIVE_PLAN_STRUCTS lesson) would arm
+      # compile against missing functions.
+      expect(Moxml::Adapter::Leptris::XSD_SUPPORTED)
+        .to eq(Moxml::Adapter::Leptris::NATIVE_XSD)
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: moxml
 version: !ruby/object:Gem::Version
-  version: 0.5.118
+  version: 0.5.119
 platform: ruby
 authors:
 - Ribose Inc.
@@ -297,6 +297,7 @@ files:
 - lib/moxml/xpath/parser.rb
 - lib/moxml/xpath/ruby/generator.rb
 - lib/moxml/xpath/ruby/node.rb
+- lib/moxml/xsd.rb
 - lib/moxml/xslt.rb
 - lib/moxml/xslt/stylesheet.rb
 - moxml.gemspec
@@ -569,6 +570,7 @@ files:
 - spec/moxml/xpath/union_spec.rb
 - spec/moxml/xpath_capabilities_spec.rb
 - spec/moxml/xpath_spec.rb
+- spec/moxml/xsd_spec.rb
 - spec/moxml/xslt/stylesheet_spec.rb
 - spec/performance/README.md
 - spec/performance/benchmark_spec.rb