rxerces 0.1.0 → 0.3.0

data/spec/nokogiri_compatibility_spec.rb

@@ -0,0 +1,167 @@
+require 'spec_helper'
+require 'rxerces/nokogiri'
+
+RSpec.describe "Nokogiri compatibility" do
+  let(:simple_xml) { '<root><child>Hello</child></root>' }
+
+  describe "Nokogiri module" do
+    it "exists" do
+      expect(defined?(Nokogiri)).to eq('constant')
+    end
+
+    describe ".XML" do
+      it "parses XML" do
+        doc = Nokogiri.XML(simple_xml)
+        expect(doc).to be_a(RXerces::XML::Document)
+      end
+    end
+
+    describe ".parse" do
+      it "is an alias for .XML" do
+        doc = Nokogiri.parse(simple_xml)
+        expect(doc).to be_a(RXerces::XML::Document)
+      end
+    end
+  end
+
+  describe "Nokogiri::XML" do
+    it "exists" do
+      expect(defined?(Nokogiri::XML)).to eq('constant')
+    end
+
+    describe ".parse" do
+      it "parses XML" do
+        doc = Nokogiri::XML.parse(simple_xml)
+        expect(doc).to be_a(RXerces::XML::Document)
+      end
+    end
+  end
+
+  describe "Nokogiri::XML::Document" do
+    it "is an alias for RXerces::XML::Document" do
+      expect(Nokogiri::XML::Document).to eq(RXerces::XML::Document)
+    end
+  end
+
+  describe "Nokogiri::XML::Node" do
+    it "is an alias for RXerces::XML::Node" do
+      expect(Nokogiri::XML::Node).to eq(RXerces::XML::Node)
+    end
+  end
+
+  describe "Nokogiri::XML::Element" do
+    it "is an alias for RXerces::XML::Element" do
+      expect(Nokogiri::XML::Element).to eq(RXerces::XML::Element)
+    end
+  end
+
+  describe "Nokogiri::XML::NodeSet" do
+    it "is an alias for RXerces::XML::NodeSet" do
+      expect(Nokogiri::XML::NodeSet).to eq(RXerces::XML::NodeSet)
+    end
+  end
+
+  describe "Nokogiri::XML::Schema" do
+    it "is an alias for RXerces::XML::Schema" do
+      expect(Nokogiri::XML::Schema).to eq(RXerces::XML::Schema)
+    end
+  end
+
+  describe "API compatibility" do
+    let(:doc) { Nokogiri.XML(simple_xml) }
+
+    it "provides root method" do
+      expect(doc.root).to be_a(Nokogiri::XML::Element)
+      expect(doc.root.name).to eq('root')
+    end
+
+    it "provides to_s method" do
+      xml_string = doc.to_s
+      expect(xml_string).to be_a(String)
+      expect(xml_string).to include('<root>')
+    end
+
+    it "provides to_xml method" do
+      xml_string = doc.to_xml
+      expect(xml_string).to be_a(String)
+      expect(xml_string).to include('<root>')
+    end
+
+    it "provides node name method" do
+      expect(doc.root.name).to eq('root')
+    end
+
+    it "provides node text method" do
+      child = doc.root.children.find { |n| n.is_a?(Nokogiri::XML::Element) }
+      expect(child.text).to be_a(String)
+    end
+
+    it "provides node children method" do
+      children = doc.root.children
+      expect(children).to be_an(Array)
+    end
+  end
+
+  describe "Schema validation compatibility" do
+    let(:xsd) do
+      <<~XSD
+        <?xml version="1.0"?>
+        <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
+          <xs:element name="person">
+            <xs:complexType>
+              <xs:sequence>
+                <xs:element name="name" type="xs:string"/>
+                <xs:element name="age" type="xs:integer"/>
+              </xs:sequence>
+            </xs:complexType>
+          </xs:element>
+        </xs:schema>
+      XSD
+    end
+
+    let(:valid_xml) do
+      <<~XML
+        <?xml version="1.0"?>
+        <person>
+          <name>John</name>
+          <age>30</age>
+        </person>
+      XML
+    end
+
+    let(:invalid_xml) do
+      <<~XML
+        <?xml version="1.0"?>
+        <person>
+          <name>Jane</name>
+          <age>invalid</age>
+        </person>
+      XML
+    end
+
+    it "provides Schema.from_string method" do
+      schema = Nokogiri::XML::Schema.from_string(xsd)
+      expect(schema).to be_a(Nokogiri::XML::Schema)
+    end
+
+    it "provides Schema.from_document method" do
+      doc = Nokogiri::XML.parse(xsd)
+      schema = Nokogiri::XML::Schema.from_document(doc)
+      expect(schema).to be_a(Nokogiri::XML::Schema)
+    end
+
+    it "validates a valid document" do
+      schema = Nokogiri::XML::Schema.from_string(xsd)
+      doc = Nokogiri::XML.parse(valid_xml)
+      errors = doc.validate(schema)
+      expect(errors).to be_empty
+    end
+
+    it "returns errors for an invalid document" do
+      schema = Nokogiri::XML::Schema.from_string(xsd)
+      doc = Nokogiri::XML.parse(invalid_xml)
+      errors = doc.validate(schema)
+      expect(errors).not_to be_empty
+    end
+  end
+end

data/spec/rxerces_shared.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'rxerces'
+
+RSpec.shared_examples RXerces do
+  example 'version number is set to the expected value' do
+    expect(RXerces::VERSION).to eq('0.3.0')
+    expect(RXerces::VERSION).to be_frozen
+  end
+end

data/spec/rxerces_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+RSpec.describe RXerces do
+  it "has a version number" do
+    expect(RXerces::VERSION).not_to be nil
+  end
+
+  describe ".XML" do
+    it "parses XML string" do
+      xml = '<root><child>text</child></root>'
+      doc = RXerces.XML(xml)
+      expect(doc).to be_a(RXerces::XML::Document)
+    end
+  end
+
+  describe ".parse" do
+    it "is an alias for .XML" do
+      xml = '<root><child>text</child></root>'
+      doc = RXerces.parse(xml)
+      expect(doc).to be_a(RXerces::XML::Document)
+    end
+  end
+end

data/spec/schema_spec.rb

@@ -0,0 +1,76 @@
+require 'spec_helper'
+
+RSpec.describe RXerces::XML::Schema do
+  let(:simple_xsd) do
+    <<~XSD
+      <?xml version="1.0" encoding="UTF-8"?>
+      <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
+        <xs:element name="root">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element name="name" type="xs:string"/>
+              <xs:element name="age" type="xs:integer"/>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+      </xs:schema>
+    XSD
+  end
+
+  let(:valid_xml) do
+    <<~XML
+      <?xml version="1.0"?>
+      <root>
+        <name>John</name>
+        <age>30</age>
+      </root>
+    XML
+  end
+
+  let(:invalid_xml) do
+    <<~XML
+      <?xml version="1.0"?>
+      <root>
+        <name>John</name>
+        <age>not-a-number</age>
+      </root>
+    XML
+  end
+
+  describe '.from_string' do
+    it 'creates a schema from an XSD string' do
+      schema = described_class.from_string(simple_xsd)
+      expect(schema).to be_a(described_class)
+    end
+
+    # Note: Xerces-C parser is very tolerant of invalid XML
+    # So we just skip testing for invalid XML for now
+  end
+
+  describe '.from_document' do
+    it 'creates a schema from a Document' do
+      schema_doc = RXerces::XML::Document.parse(simple_xsd)
+      schema = described_class.from_document(schema_doc)
+      expect(schema).to be_a(described_class)
+    end
+  end
+
+  describe 'validation' do
+    let(:schema) { described_class.from_string(simple_xsd) }
+
+    it 'validates a valid document' do
+      doc = RXerces::XML::Document.parse(valid_xml)
+      errors = doc.validate(schema)
+      expect(errors).to be_a(Array)
+      expect(errors).to be_empty
+    end
+
+    it 'returns validation errors for an invalid document' do
+      doc = RXerces::XML::Document.parse(invalid_xml)
+      errors = doc.validate(schema)
+      expect(errors).to be_a(Array)
+      expect(errors).not_to be_empty
+      expect(errors.first).to include('not-a-number')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+require 'rspec'
+require 'rxerces'
+require 'rxerces_shared'
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = ".rspec_status"
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+
+  config.include_context(RXerces)
+end

data/spec/xpath_spec.rb

@@ -0,0 +1,164 @@
+require 'spec_helper'
+require 'rxerces/nokogiri'
+
+RSpec.describe "XPath support" do
+  let(:xml) do
+    <<-XML
+      <library>
+        <book id="1" category="fiction">
+          <title>1984</title>
+          <author>George Orwell</author>
+          <year>1949</year>
+          <price>15.99</price>
+        </book>
+        <book id="2" category="fiction">
+          <title>Brave New World</title>
+          <author>Aldous Huxley</author>
+          <year>1932</year>
+          <price>14.99</price>
+        </book>
+        <book id="3" category="non-fiction">
+          <title>Sapiens</title>
+          <author>Yuval Noah Harari</author>
+          <year>2011</year>
+          <price>18.99</price>
+        </book>
+      </library>
+    XML
+  end
+
+  let(:doc) { RXerces::XML::Document.parse(xml) }
+
+  describe "Document XPath queries" do
+    it "finds all book elements" do
+      books = doc.xpath('//book')
+      expect(books).to be_a(RXerces::XML::NodeSet)
+      expect(books.length).to eq(3)
+    end
+
+    it "finds all title elements" do
+      titles = doc.xpath('//title')
+      expect(titles.length).to eq(3)
+      expect(titles[0].text.strip).to eq('1984')
+      expect(titles[1].text.strip).to eq('Brave New World')
+      expect(titles[2].text.strip).to eq('Sapiens')
+    end
+
+    it "finds elements by path" do
+      authors = doc.xpath('/library/book/author')
+      expect(authors.length).to eq(3)
+    end
+
+    it "finds descendant elements" do
+      years = doc.xpath('//year')
+      expect(years.length).to eq(3)
+    end
+
+    it "finds price elements" do
+      prices = doc.xpath('//price')
+      expect(prices.length).to eq(3)
+    end
+
+    it "returns empty nodeset for non-matching xpath" do
+      result = doc.xpath('//nonexistent')
+      expect(result).to be_a(RXerces::XML::NodeSet)
+      expect(result.length).to eq(0)
+    end
+
+    it "can find nested elements" do
+      library_books = doc.xpath('/library/book')
+      expect(library_books.length).to eq(3)
+    end
+  end
+
+  describe "Node XPath queries" do
+    let(:root) { doc.root }
+
+    it "finds children from root element" do
+      books = root.xpath('.//book')
+      expect(books.length).to eq(3)
+    end
+
+    it "finds specific child elements" do
+      first_book = root.children.find { |n| n.is_a?(RXerces::XML::Element) }
+      titles = first_book.xpath('.//title')
+      expect(titles.length).to eq(1)
+      expect(titles[0].text.strip).to eq('1984')
+    end
+
+    it "finds descendant elements from node" do
+      first_book = root.children.find { |n| n.is_a?(RXerces::XML::Element) }
+      author = first_book.xpath('.//author')
+      expect(author.length).to eq(1)
+      expect(author[0].text.strip).to eq('George Orwell')
+    end
+
+    it "can use relative paths" do
+      books = root.xpath('book')
+      expect(books.length).to eq(3)
+    end
+
+    it "finds all descendants" do
+      all_titles = root.xpath('.//title')
+      expect(all_titles.length).to eq(3)
+    end
+  end
+
+  describe "Error handling" do
+    it "raises error for invalid XPath" do
+      expect {
+        doc.xpath('//[invalid')
+      }.to raise_error(RuntimeError, /XPath error/)
+    end
+  end
+
+  describe "Nokogiri compatibility" do
+    it "works with Nokogiri syntax" do
+      nokogiri_doc = Nokogiri::XML(xml)
+      books = nokogiri_doc.xpath('//book')
+      expect(books).to be_a(Nokogiri::XML::NodeSet)
+      expect(books.length).to eq(3)
+    end
+
+    it "can chain xpath on results" do
+      books = doc.xpath('//book')
+      expect(books.length).to eq(3)
+
+      # Access first book's title
+      first_book = books[0]
+      titles = first_book.xpath('.//title')
+      expect(titles.length).to eq(1)
+      expect(titles[0].text.strip).to eq('1984')
+    end
+
+    it "can iterate over xpath results" do
+      authors = doc.xpath('//author')
+      author_names = []
+      authors.each do |author|
+        author_names << author.text.strip
+      end
+      expect(author_names).to include('George Orwell', 'Aldous Huxley', 'Yuval Noah Harari')
+    end
+  end
+
+  describe "XPath limitations" do
+    it "notes that Xerces-C uses XML Schema XPath subset" do
+      # Xerces-C implements the XML Schema XPath subset, not full XPath 1.0
+      # This means the following are NOT supported:
+      # - Attribute predicates like [@id="1"]
+      # - Functions like last(), position(), text()
+      # - Comparison operators in predicates
+      #
+      # However, basic path expressions work well:
+      # - // (descendant-or-self)
+      # - / (child)
+      # - . (self)
+      # - .. (parent)
+
+      # Basic paths work
+      expect(doc.xpath('//book').length).to eq(3)
+      expect(doc.xpath('/library/book').length).to eq(3)
+      expect(doc.xpath('//title').length).to eq(3)
+    end
+  end
+end

metadata

@@ -1,12 +1,39 @@
 --- !ruby/object:Gem::Specification
 name: rxerces
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
-- RXerces Contributors
+- Daniel J. Berger
 bindir: bin
-cert_chain: []
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEcDCCAtigAwIBAgIBATANBgkqhkiG9w0BAQsFADA/MREwDwYDVQQDDAhkamJl
+  cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+  MB4XDTE4MDMxODE1MjIwN1oXDTI4MDMxNTE1MjIwN1owPzERMA8GA1UEAwwIZGpi
+  ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+  bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBALgfaroVM6CI06cxr0/h
+  A+j+pc8fgpRgBVmHFaFunq28GPC3IvW7Nvc3Y8SnAW7pP1EQIbhlwRIaQzJ93/yj
+  u95KpkP7tA9erypnV7dpzBkzNlX14ACaFD/6pHoXoe2ltBxk3CCyyzx70mTqJpph
+  75IB03ni9a8yqn8pmse+s83bFJOAqddSj009sGPcQO+QOWiNxqYv1n5EHcvj2ebO
+  6hN7YTmhx7aSia4qL/quc4DlIaGMWoAhvML7u1fmo53CYxkKskfN8MOecq2vfEmL
+  iLu+SsVVEAufMDDFMXMJlvDsviolUSGMSNRTujkyCcJoXKYYxZSNtIiyd9etI0X3
+  ctu0uhrFyrMZXCedutvXNjUolD5r9KGBFSWH1R9u2I3n3SAyFF2yzv/7idQHLJJq
+  74BMnx0FIq6fCpu5slAipvxZ3ZkZpEXZFr3cIBtO1gFvQWW7E/Y3ijliWJS1GQFq
+  058qERadHGu1yu1dojmFRo6W2KZvY9al2yIlbkpDrD5MYQIDAQABo3cwdTAJBgNV
+  HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUFZsMapgzJimzsbaBG2Tm8j5e
+  AzgwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
+  YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAW2tnYixXQtKxgGXq
+  /3iSWG2bLwvxS4go3srO+aRXZHrFUMlJ5W0mCxl03aazxxKTsVVpZD8QZxvK91OQ
+  h9zr9JBYqCLcCVbr8SkmYCi/laxIZxsNE5YI8cC8vvlLI7AMgSfPSnn/Epq1GjGY
+  6L1iRcEDtanGCIvjqlCXO9+BmsnCfEVehqZkQHeYczA03tpOWb6pon2wzvMKSsKH
+  ks0ApVdstSLz1kzzAqem/uHdG9FyXdbTAwH1G4ZPv69sQAFAOCgAqYmdnzedsQtE
+  1LQfaQrx0twO+CZJPcRLEESjq8ScQxWRRkfuh2VeR7cEU7L7KqT10mtUwrvw7APf
+  DYoeCY9KyjIBjQXfbj2ke5u1hZj94Fsq9FfbEQg8ygCgwThnmkTrrKEiMSs3alYR
+  ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
+  WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
+  -----END CERTIFICATE-----
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
@@ -53,25 +80,52 @@ dependencies:
         version: '3.12'
 description: A Ruby XML library with Nokogiri-compatible API, powered by Xerces-C
   instead of libxml2
-email:
-- contributors@example.com
+email: djberg96@gmail.com
 executables: []
 extensions:
 - ext/rxerces/extconf.rb
 extra_rdoc_files: []
 files:
+- CHANGES.md
+- Gemfile
 - LICENSE
 - README.md
+- Rakefile
+- certs/djberg96_pub.pem
+- examples/basic_usage.rb
+- examples/schema_example.rb
+- examples/simple_example.rb
+- examples/xpath_example.rb
 - ext/rxerces/extconf.rb
 - ext/rxerces/rxerces.cpp
 - ext/rxerces/rxerces.h
 - lib/rxerces.rb
-- lib/rxerces/rxerces.bundle
+- lib/rxerces/nokogiri.rb
 - lib/rxerces/version.rb
-homepage: https://github.com/example/rxerces
+- rxerces.gemspec
+- spec/document_spec.rb
+- spec/element_spec.rb
+- spec/node_spec.rb
+- spec/nodeset_spec.rb
+- spec/nokogiri_compatibility_spec.rb
+- spec/rxerces_shared.rb
+- spec/rxerces_spec.rb
+- spec/schema_spec.rb
+- spec/spec_helper.rb
+- spec/xpath_spec.rb
+homepage: http://github.com/djberg96/rxerces
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/djberg96/rxerces
+  bug_tracker_uri: https://github.com/djberg96/rxerces/issues
+  changelog_uri: https://github.com/djberg96/rxerces/blob/main/CHANGES.md
+  documentation_uri: https://github.com/djberg96/rxerces/wiki
+  source_code_uri: https://github.com/djberg96/rxerces
+  wiki_uri: https://github.com/djberg96/rxerces/wiki
+  rubygems_mfa_required: 'true'
+  github_repo: https://github.com/djberg96/rxerces
+  funding_uri: https://github.com/sponsors/djberg96
 rdoc_options: []
 require_paths:
 - lib
@@ -89,4 +143,12 @@ requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
 summary: Nokogiri-compatible XML library using Xerces-C
-test_files: []
+test_files:
+- spec/document_spec.rb
+- spec/element_spec.rb
+- spec/node_spec.rb
+- spec/nodeset_spec.rb
+- spec/nokogiri_compatibility_spec.rb
+- spec/rxerces_spec.rb
+- spec/schema_spec.rb
+- spec/xpath_spec.rb

metadata.gz.sig

@@ -0,0 +1,2 @@
+Q� �q
��o�{�;?��-6��%�:��-ܪB�h�y,�P�U}�#loyp�w��c����M@X+>��]U�.��<z5��a'�m�z]G���1laA�x���w�V�`���b6��U�����s��z��=u��$�6��Vj6��~��x:�����
+O��Е>d~�s��cYs����	������tHgd�%�Y��@TtcԁI��S