rxerces 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71254540124db9069ed4366fe61e6efa20d0d74fe4c92f5f8b51793bca16099d
-  data.tar.gz: ba91d5747e0394f5cd5149921af75d838e97815f0dc8b2b09528ac775530461d
+  metadata.gz: e19a59f7418eca81e344bf69e5a60b91a510615979d4716c23eb18cd79fd954f
+  data.tar.gz: b8d5c62806c094fc61ca00ad47b4347990440d3f208d6e2678c1b26e9453b0e0
 SHA512:
-  metadata.gz: 6e26d2111e1ef02ed72fdac2e532d38201dfba9de4b1521bbf22046c2a23a1a821f0ad42368d47520f61139caa0aca365169399abf6ce79b2fa6fd337e0e0026
-  data.tar.gz: 6897cb5b3f9755c4cab71735c4ca5eeaf5a3e85917c67d6a4e5903adb3312067de51961262ec7470ca7b91c1984007d58090f7078081a8400692358be870acc7
+  metadata.gz: e2fd038f7d64bab9017b48b2a20b1abd1df859f6bc21082ae4e73e955f41a2d664eb5991d07bbc5aa1393eb8d72040e1f65358436c424987d1757261f71e086d
+  data.tar.gz: 1493d18f198efc2bd6bf9f06282d071a96b7edf91f0de4cb5960ceefad6baf394fe3257348b1f835f193a982661be2af12d0dc12b80a9dcc933794d5a521e61f

data/CHANGES.md

@@ -0,0 +1,9 @@
+## 0.2.0 - 13-Dec-2025
+* The nokogiri compatibility layer is now optional.
+* Fixed up the gemspec with real values instead of the AI generated junk.
+* Updated the Rakefile a bit, reworked some of the tasks.
+* Minor spec updates.
+* Added my cert.
+
+## 0.1.0 - 12-Dec-2025
+* Initial release.

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'rake', '~> 13.0'
+gem 'rake-compiler', '~> 1.2'
+gem 'rspec', '~> 3.12'

data/README.md

@@ -1,3 +1,5 @@
+[![Ruby](https://github.com/djberg96/rxerces/actions/workflows/ci.yml/badge.svg)](https://github.com/djberg96/rxerces/actions/workflows/ci.yml)
+
 # RXerces
 
 A Ruby XML library with a Nokogiri-compatible API, powered by Apache Xerces-C instead of libxml2.
@@ -73,10 +75,10 @@ puts root.name  # => "root"
 
 ### Nokogiri Compatibility
 
-RXerces provides a `Nokogiri` module for drop-in compatibility:
+RXerces provides optional Nokogiri compatibility. Require `rxerces/nokogiri` to enable drop-in replacement:
 
 ```ruby
-require 'rxerces'
+require 'rxerces/nokogiri'
 
 # Use Nokogiri syntax
 doc = Nokogiri.XML('<root><child>text</child></root>')
@@ -86,6 +88,8 @@ puts doc.root.name  # => "root"
 Nokogiri::XML::Document == RXerces::XML::Document  # => true
 ```
 
+**Note:** If you don't need Nokogiri compatibility, just `require 'rxerces'` and use the `RXerces` module directly.
+
 ### Working with Nodes
 
 ```ruby

data/Rakefile

@@ -0,0 +1,43 @@
+require "rake/extensiontask"
+require "rspec/core/rake_task"
+require "rake/clean"
+require "rbconfig"
+include RbConfig
+
+CLEAN.include(
+  '**/*.gem',               # Gem files
+  '**/*.rbc',               # Rubinius
+  '**/*.o',                 # C object file
+  '**/*.log',               # Ruby extension build log
+  '**/*.lock',              # Gemfile.lock
+  '**/Makefile',            # C Makefile
+  '**/conftest.dSYM',       # OS X build directory
+  "**/*.#{CONFIG['DLEXT']}" # C shared object
+)
+
+namespace :gem do
+  desc "Create the sys-uname gem"
+  task :create => [:clean] do
+    require 'rubygems/package'
+    spec = Gem::Specification.load('rxerces.gemspec')
+    spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
+    Gem::Package.build(spec)
+  end
+
+  desc "Install the sys-uname gem"
+  task :install => [:create] do
+    file = Dir["*.gem"].first
+    sh "gem install #{file}"
+  end
+end
+
+Rake::ExtensionTask.new("rxerces") do |ext|
+  ext.lib_dir = "lib/rxerces"
+end
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.verbose = false
+  t.rspec_opts = '-f documentation -w'
+end
+
+task default: [:compile, :spec]

data/certs/djberg96_pub.pem

@@ -0,0 +1,26 @@
+-----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-----

data/examples/basic_usage.rb

@@ -0,0 +1,75 @@
+require 'rxerces'
+require 'rxerces/nokogiri'
+
+puts "=== RXerces Basic Usage Example ===\n\n"
+
+# Parse XML
+xml = <<-XML
+  <library name="City Library">
+    <book id="1" isbn="978-0451524935">
+      <title>1984</title>
+      <author>George Orwell</author>
+      <year>1949</year>
+    </book>
+    <book id="2" isbn="978-0060850524">
+      <title>Brave New World</title>
+      <author>Aldous Huxley</author>
+      <year>1932</year>
+    </book>
+  </library>
+XML
+
+puts "1. Parsing XML document..."
+doc = RXerces.XML(xml)
+puts "   ✓ Document parsed successfully\n\n"
+
+# Access root element
+puts "2. Accessing root element..."
+root = doc.root
+puts "   Root element name: #{root.name}"
+puts "   Library name: #{root['name']}\n\n"
+
+# Navigate children
+puts "3. Navigating child elements..."
+books = root.children.select { |n| n.is_a?(RXerces::XML::Element) }
+puts "   Found #{books.length} books:\n\n"
+
+books.each do |book|
+  title = book.children.find { |n| n.name == 'title' }
+  author = book.children.find { |n| n.name == 'author' }
+  year = book.children.find { |n| n.name == 'year' }
+
+  puts "   Book ##{book['id']}:"
+  puts "     Title:  #{title.text.strip}"
+  puts "     Author: #{author.text.strip}"
+  puts "     Year:   #{year.text.strip}"
+  puts "     ISBN:   #{book['isbn']}"
+  puts
+end
+
+# Modify document
+puts "4. Modifying the document..."
+first_book = books.first
+first_book['rating'] = '5 stars'
+title = first_book.children.find { |n| n.name == 'title' }
+puts "   Added rating to first book: #{first_book['rating']}"
+puts "   First book title: #{title.text.strip}\n\n"
+
+# Serialize back to XML
+puts "5. Serializing to XML..."
+xml_output = doc.to_xml
+puts "   ✓ Document serialized successfully"
+puts "\n   Output preview:"
+puts "   " + xml_output.lines.first(3).join("   ")
+puts "   ...\n\n"
+
+# Nokogiri compatibility
+puts "6. Testing Nokogiri compatibility..."
+nokogiri_doc = Nokogiri.XML('<test><item>Hello World</item></test>')
+puts "   Parsed with Nokogiri.XML: #{nokogiri_doc.root.name}"
+item = nokogiri_doc.root.children.find { |n| n.is_a?(Nokogiri::XML::Element) }
+puts "   Item text: #{item.text}"
+puts "   Document class: #{nokogiri_doc.class}"
+puts "   ✓ Nokogiri compatibility confirmed\n\n"
+
+puts "=== Example Complete ==="

data/examples/simple_example.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+require 'bundler/setup'
+require 'rxerces'
+
+puts "=== RXerces Simple Example (No Nokogiri) ===\n\n"
+
+xml = <<-XML
+  <bookstore>
+    <book>
+      <title>1984</title>
+      <author>George Orwell</author>
+    </book>
+  </bookstore>
+XML
+
+# Parse using RXerces directly
+doc = RXerces.XML(xml)
+
+puts "Document parsed successfully!"
+puts "Root element: #{doc.root.name}"
+puts
+
+# Find the book
+book = doc.root.children.find { |n| n.is_a?(RXerces::XML::Element) }
+title = book.children.find { |n| n.name == 'title' }
+author = book.children.find { |n| n.name == 'author' }
+
+puts "Book found:"
+puts "  Title: #{title.text.strip}"
+puts "  Author: #{author.text.strip}"
+puts
+
+puts "=== Example Complete ===\n"
+puts "Note: This example uses RXerces directly without Nokogiri compatibility."

data/examples/xpath_example.rb

@@ -0,0 +1,108 @@
+require 'rxerces'
+require 'rxerces/nokogiri'
+
+puts "=== RXerces XPath Example ===\n\n"
+
+xml = <<-XML
+  <bookstore>
+    <book category="fiction">
+      <title>1984</title>
+      <author>George Orwell</author>
+      <year>1949</year>
+      <price>15.99</price>
+    </book>
+    <book category="fiction">
+      <title>Brave New World</title>
+      <author>Aldous Huxley</author>
+      <year>1932</year>
+      <price>14.99</price>
+    </book>
+    <book category="non-fiction">
+      <title>Sapiens</title>
+      <author>Yuval Noah Harari</author>
+      <year>2011</year>
+      <price>18.99</price>
+    </book>
+  </bookstore>
+XML
+
+doc = RXerces.XML(xml)
+
+puts "1. Finding all books:"
+books = doc.xpath('//book')
+puts "   Found #{books.length} books"
+puts
+
+puts "2. Finding all titles:"
+titles = doc.xpath('//title')
+titles.each do |title|
+  puts "   - #{title.text.strip}"
+end
+puts
+
+puts "3. Finding all authors:"
+authors = doc.xpath('//author')
+authors.each do |author|
+  puts "   - #{author.text.strip}"
+end
+puts
+
+puts "4. Using absolute paths:"
+bookstore_books = doc.xpath('/bookstore/book')
+puts "   Found #{bookstore_books.length} books via absolute path"
+puts
+
+puts "5. Querying from a specific node:"
+first_book = books[0]
+title = first_book.xpath('.//title').first
+author = first_book.xpath('.//author').first
+puts "   First book: #{title.text.strip} by #{author.text.strip}"
+puts
+
+puts "6. Combining XPath with Ruby methods:"
+puts "   All books with their details:"
+books.each_with_index do |book, i|
+  title_node = book.xpath('.//title').first
+  author_node = book.xpath('.//author').first
+  year_node = book.xpath('.//year').first
+  price_node = book.xpath('.//price').first
+
+  puts "   Book #{i + 1}:"
+  puts "     Title:  #{title_node.text.strip}"
+  puts "     Author: #{author_node.text.strip}"
+  puts "     Year:   #{year_node.text.strip}"
+  puts "     Price:  $#{price_node.text.strip}"
+  puts "     Category: #{book['category']}"
+  puts
+end
+
+puts "7. Filtering with Ruby:"
+puts "   Fiction books only:"
+fiction_books = books.select { |book| book['category'] == 'fiction' }
+fiction_books.each do |book|
+  title = book.xpath('.//title').first
+  puts "   - #{title.text.strip}"
+end
+puts
+
+puts "8. Finding nested elements:"
+all_prices = doc.xpath('//book/price')
+puts "   Found #{all_prices.length} prices:"
+total = 0
+all_prices.each do |price|
+  amount = price.text.strip.to_f
+  total += amount
+  puts "   - $#{amount}"
+end
+puts "   Total: $#{'%.2f' % total}"
+puts
+
+puts "9. Nokogiri compatibility:"
+nokogiri_doc = Nokogiri.XML(xml)
+nokogiri_books = nokogiri_doc.xpath('//book')
+puts "   Parsed with Nokogiri: #{nokogiri_books.length} books found"
+puts
+
+puts "=== Example Complete ==="
+puts "\nNote: Xerces-C supports the XML Schema XPath subset."
+puts "For advanced filtering, combine basic XPath with Ruby methods."

data/lib/rxerces/nokogiri.rb

@@ -0,0 +1,33 @@
+require 'rxerces'
+
+# Nokogiri compatibility module
+# Provides drop-in replacement for Nokogiri XML parsing using RXerces
+module Nokogiri
+  # Nokogiri-compatible XML module
+  module XML
+    # Parse XML from a string - delegates to RXerces
+    # @param string [String] XML string to parse
+    # @return [RXerces::XML::Document] parsed document
+    def self.parse(string)
+      RXerces::XML::Document.parse(string)
+    end
+
+    # Alias Document class for compatibility
+    Document = RXerces::XML::Document
+    Node = RXerces::XML::Node
+    Element = RXerces::XML::Element
+    Text = RXerces::XML::Text
+    NodeSet = RXerces::XML::NodeSet
+  end
+
+  # Top-level parse method for compatibility
+  # @param string [String] XML string to parse
+  # @return [RXerces::XML::Document] parsed document
+  def self.XML(string)
+    RXerces::XML::Document.parse(string)
+  end
+
+  class << self
+    alias_method :parse, :XML
+  end
+end

data/lib/rxerces/version.rb

@@ -1,3 +1,3 @@
 module RXerces
-  VERSION = "0.1.0"
+  VERSION = "0.2.0".freeze
 end

data/lib/rxerces.rb

@@ -15,34 +15,3 @@ module RXerces
     alias_method :parse, :XML
   end
 end
-
-# Nokogiri compatibility module
-module Nokogiri
-  # Nokogiri-compatible XML module
-  module XML
-    # Parse XML from a string - delegates to RXerces
-    # @param string [String] XML string to parse
-    # @return [RXerces::XML::Document] parsed document
-    def self.parse(string)
-      RXerces::XML::Document.parse(string)
-    end
-
-    # Alias Document class for compatibility
-    Document = RXerces::XML::Document
-    Node = RXerces::XML::Node
-    Element = RXerces::XML::Element
-    Text = RXerces::XML::Text
-    NodeSet = RXerces::XML::NodeSet
-  end
-
-  # Top-level parse method for compatibility
-  # @param string [String] XML string to parse
-  # @return [RXerces::XML::Document] parsed document
-  def self.XML(string)
-    RXerces::XML::Document.parse(string)
-  end
-
-  class << self
-    alias_method :parse, :XML
-  end
-end

data/rxerces.gemspec

@@ -0,0 +1,33 @@
+Gem::Specification.new do |spec|
+  spec.name        = "rxerces"
+  spec.version     = "0.2.0"
+  spec.author      = "Daniel J. Berger"
+  spec.email       = "djberg96@gmail.com"
+  spec.cert_chain  = ["certs/djberg96_pub.pem"]
+  spec.homepage    = "http://github.com/djberg96/rxerces"
+  spec.summary     = "Nokogiri-compatible XML library using Xerces-C"
+  spec.license     = "MIT"
+  spec.files       = Dir['**/*'].reject{ |f| f.include?('git') }
+  spec.test_files  = Dir['spec/*_spec.rb']
+  spec.extensions  = ["ext/rxerces/extconf.rb"]
+
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rake-compiler", "~> 1.2"
+  spec.add_development_dependency "rspec", "~> 3.12"
+
+  spec.description = "A Ruby XML library with Nokogiri-compatible API, powered by Xerces-C instead of libxml2"
+
+  spec.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'
+  }
+end

data/spec/document_spec.rb

@@ -0,0 +1,66 @@
+require 'spec_helper'
+
+RSpec.describe RXerces::XML::Document do
+  let(:simple_xml) { '<root><child>Hello</child></root>' }
+  let(:complex_xml) do
+    <<-XML
+      <root>
+        <person id="1" name="Alice">
+          <age>30</age>
+          <city>New York</city>
+        </person>
+        <person id="2" name="Bob">
+          <age>25</age>
+          <city>London</city>
+        </person>
+      </root>
+    XML
+  end
+
+  describe ".parse" do
+    it "parses simple XML" do
+      doc = RXerces::XML::Document.parse(simple_xml)
+      expect(doc).to be_a(RXerces::XML::Document)
+    end
+
+    it "parses complex XML" do
+      doc = RXerces::XML::Document.parse(complex_xml)
+      expect(doc).to be_a(RXerces::XML::Document)
+    end
+  end
+
+  describe "#root" do
+    it "returns the root element" do
+      doc = RXerces::XML::Document.parse(simple_xml)
+      root = doc.root
+      expect(root).to be_a(RXerces::XML::Element)
+      expect(root.name).to eq('root')
+    end
+  end
+
+  describe "#to_s" do
+    it "serializes document to string" do
+      doc = RXerces::XML::Document.parse(simple_xml)
+      xml_string = doc.to_s
+      expect(xml_string).to be_a(String)
+      expect(xml_string).to include('<root>')
+      expect(xml_string).to include('<child>')
+      expect(xml_string).to include('Hello')
+    end
+  end
+
+  describe "#to_xml" do
+    it "is an alias for to_s" do
+      doc = RXerces::XML::Document.parse(simple_xml)
+      expect(doc.to_xml).to eq(doc.to_s)
+    end
+  end
+
+  describe "#xpath" do
+    it "returns a NodeSet" do
+      doc = RXerces::XML::Document.parse(simple_xml)
+      result = doc.xpath('//child')
+      expect(result).to be_a(RXerces::XML::NodeSet)
+    end
+  end
+end

data/spec/element_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+RSpec.describe RXerces::XML::Element do
+  let(:xml) { '<root><child id="1">Text</child></root>' }
+  let(:doc) { RXerces::XML::Document.parse(xml) }
+  let(:element) { doc.root }
+
+  it "is a subclass of Node" do
+    expect(element).to be_a(RXerces::XML::Node)
+    expect(element).to be_a(RXerces::XML::Element)
+  end
+
+  it "has a name" do
+    expect(element.name).to eq('root')
+  end
+
+  it "can have attributes" do
+    child = element.children.find { |n| n.is_a?(RXerces::XML::Element) }
+    expect(child['id']).to eq('1')
+  end
+
+  it "can have children" do
+    expect(element.children).not_to be_empty
+  end
+end

data/spec/node_spec.rb

@@ -0,0 +1,111 @@
+require 'spec_helper'
+
+RSpec.describe RXerces::XML::Node do
+  let(:xml) do
+    <<-XML
+      <root>
+        <person id="1" name="Alice">
+          <age>30</age>
+          <city>New York</city>
+        </person>
+        <person id="2" name="Bob">
+          <age>25</age>
+        </person>
+      </root>
+    XML
+  end
+
+  let(:doc) { RXerces::XML::Document.parse(xml) }
+  let(:root) { doc.root }
+
+  describe "#name" do
+    it "returns the node name" do
+      expect(root.name).to eq('root')
+    end
+
+    it "returns child element names" do
+      person = root.children.find { |n| n.is_a?(RXerces::XML::Element) }
+      expect(person.name).to eq('person')
+    end
+  end
+
+  describe "#text" do
+    it "returns text content" do
+      person = root.children.find { |n| n.is_a?(RXerces::XML::Element) }
+      age = person.children.find { |n| n.name == 'age' }
+      expect(age.text.strip).to eq('30')
+    end
+
+    it "returns empty string for nodes without text" do
+      expect(root.text).to be_a(String)
+    end
+  end
+
+  describe "#content" do
+    it "is an alias for text" do
+      person = root.children.find { |n| n.is_a?(RXerces::XML::Element) }
+      age = person.children.find { |n| n.name == 'age' }
+      expect(age.content).to eq(age.text)
+    end
+  end
+
+  describe "#text=" do
+    it "sets text content" do
+      person = root.children.find { |n| n.is_a?(RXerces::XML::Element) }
+      age = person.children.find { |n| n.name == 'age' }
+      age.text = '35'
+      expect(age.text.strip).to eq('35')
+    end
+  end
+
+  describe "#[]" do
+    it "gets attribute value" do
+      person = root.children.find { |n| n.is_a?(RXerces::XML::Element) }
+      expect(person['id']).to eq('1')
+      expect(person['name']).to eq('Alice')
+    end
+
+    it "returns nil for non-existent attribute" do
+      expect(root['nonexistent']).to be_nil
+    end
+  end
+
+  describe "#[]=" do
+    it "sets attribute value" do
+      person = root.children.find { |n| n.is_a?(RXerces::XML::Element) }
+      person['id'] = '100'
+      expect(person['id']).to eq('100')
+    end
+
+    it "creates new attribute" do
+      person = root.children.find { |n| n.is_a?(RXerces::XML::Element) }
+      person['email'] = 'alice@example.com'
+      expect(person['email']).to eq('alice@example.com')
+    end
+  end
+
+  describe "#children" do
+    it "returns an array of child nodes" do
+      children = root.children
+      expect(children).to be_an(Array)
+      expect(children.length).to be > 0
+    end
+
+    it "includes element nodes" do
+      person_nodes = root.children.select { |n| n.is_a?(RXerces::XML::Element) }
+      expect(person_nodes.length).to eq(2)
+    end
+
+    it "includes text nodes" do
+      text_nodes = root.children.select { |n| n.is_a?(RXerces::XML::Text) }
+      expect(text_nodes.length).to be > 0
+    end
+  end
+
+  describe "#xpath" do
+    it "returns a NodeSet" do
+      result = root.xpath('.//age')
+      expect(result).to be_a(RXerces::XML::NodeSet)
+    end
+  end
+end

data/spec/nodeset_spec.rb

@@ -0,0 +1,92 @@
+require 'spec_helper'
+
+RSpec.describe RXerces::XML::NodeSet do
+  let(:xml) do
+    <<-XML
+      <root>
+        <item>First</item>
+        <item>Second</item>
+        <item>Third</item>
+      </root>
+    XML
+  end
+
+  let(:doc) { RXerces::XML::Document.parse(xml) }
+  let(:nodeset) { doc.xpath('//item') }
+  let(:empty_nodeset) { doc.xpath('//nonexistent') }
+
+  describe "#length" do
+    it "returns the number of nodes" do
+      expect(nodeset.length).to be_a(Integer)
+      expect(nodeset.length).to eq(3)
+    end
+
+    it "returns 0 for empty nodeset" do
+      expect(empty_nodeset.length).to eq(0)
+    end
+  end
+
+  describe "#size" do
+    it "is an alias for length" do
+      expect(nodeset.size).to eq(nodeset.length)
+    end
+  end
+
+  describe "#[]" do
+    it "returns node at index" do
+      item = nodeset[0]
+      expect(item).to be_a(RXerces::XML::Element)
+      expect(item.text.strip).to eq('First')
+    end
+
+    it "returns nil for out of bounds index" do
+      expect(nodeset[999]).to be_nil
+    end
+
+    it "returns nil for empty nodeset" do
+      expect(empty_nodeset[0]).to be_nil
+    end
+  end
+
+  describe "#each" do
+    it "is enumerable" do
+      expect(nodeset).to respond_to(:each)
+    end
+
+    it "returns enumerator when no block given" do
+      expect(nodeset.each).to be_a(Enumerator)
+    end
+
+    it "yields all items in nodeset" do
+      count = 0
+      nodeset.each { count += 1 }
+      expect(count).to eq(3)
+    end
+
+    it "yields nothing for empty nodeset" do
+      count = 0
+      empty_nodeset.each { count += 1 }
+      expect(count).to eq(0)
+    end
+
+    it "can iterate and access node properties" do
+      texts = []
+      nodeset.each do |item|
+        texts << item.text.strip
+      end
+      expect(texts).to eq(['First', 'Second', 'Third'])
+    end
+  end
+
+  describe "#to_a" do
+    it "converts to array" do
+      result = nodeset.to_a
+      expect(result).to be_an(Array)
+      expect(result.length).to eq(3)
+    end
+  end
+
+  it "includes Enumerable" do
+    expect(RXerces::XML::NodeSet.ancestors).to include(Enumerable)
+  end
+end

data/spec/nokogiri_compatibility_spec.rb

@@ -0,0 +1,98 @@
+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 "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
+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.2.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/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.2.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,50 @@ 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/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/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 +141,11 @@ 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/xpath_spec.rb

metadata.gz.sig

@@ -0,0 +1,2 @@
+*P�]���/���d�E���/'�*L��Ư��?]�ZmZ�u,�_�W����q���jí�Ͷ2�O�1���{��iI��7���"�	�����+��b�>�B���
+s��P}(]�����J�4����kӺP^��&9m����[N3i�pֲ�MK���Ǒ��D� �Qz��%eR���.|U�u�6O!ku�ma���Á}��W~���/�z�;�n��HU�