rxerces 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71254540124db9069ed4366fe61e6efa20d0d74fe4c92f5f8b51793bca16099d
-  data.tar.gz: ba91d5747e0394f5cd5149921af75d838e97815f0dc8b2b09528ac775530461d
+  metadata.gz: 8a6f91adbbf73a000b638acc525461a8e0a06ce847bff4f8fd48ad5faf117483
+  data.tar.gz: ce10fe12e10294c5012624263cdbc05e4d751c7f62cad3647b2d73f88b19b8ab
 SHA512:
-  metadata.gz: 6e26d2111e1ef02ed72fdac2e532d38201dfba9de4b1521bbf22046c2a23a1a821f0ad42368d47520f61139caa0aca365169399abf6ce79b2fa6fd337e0e0026
-  data.tar.gz: 6897cb5b3f9755c4cab71735c4ca5eeaf5a3e85917c67d6a4e5903adb3312067de51961262ec7470ca7b91c1984007d58090f7078081a8400692358be870acc7
+  metadata.gz: c70510870068a501df10218e42c2eee838df962588929e0731d7e37eb250a80f3e875f77646a254681b976f487435fa531aca4144c1efc39ba22c6ec79c722fc
+  data.tar.gz: 47cacc7b927ff6ea7a5c206cd24d2d44fb52bc74ebdb314d05fa67d3bacd8f228113d7053f759626f70acde116ddcfffa194969c85a46a6a8e7e5850f906f36e

checksums.yaml.gz.sig

@@ -0,0 +1,4 @@
+���\�|�1�"�F:\�A���Ի�pI�r4s�h�ҿ��>H݄����{,�R��ҩ���rV87]�B�*̃_��}��jf�ku�0�Ҩ�ܸ=PIR8���Z��ܯ�
+kl��k@�'��(;�T�0��F-a��p�B"�(�Tu����pz8R�}'H#7}F@O/�L�l��H�h�%[%�
+^���ju�W���^��R/}-nUU�ZU�Q��j��ϳkS�q͆��GyQ:��:��`�q����	��<ǯo��xt
+��3\QK�gI���\9Lԟݺ��Zi�A��

data/CHANGES.md

@@ -0,0 +1,21 @@
+## 0.3.0 - 14-Dec-2025
+* Added Node#parent.
+* Added Element#attributes.
+* Added Node#next_node and Node#next_sibling.
+* Added Node#previous_node and Node#previous_sibling.
+* Added Element#add_child.
+* Added Node#remove and Node#unlink.
+* Added Document#create_element.
+* Added Element#inner_xml and Element#inner_html.
+* Added Node#path.
+* Added Node#blank?
+
+## 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/schema_example.rb

@@ -0,0 +1,107 @@
+#!/usr/bin/env ruby
+require_relative '../lib/rxerces'
+
+# Define an XSD schema
+schema_xsd = <<~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:element name="email" type="xs:string"/>
+        </xs:sequence>
+      </xs:complexType>
+    </xs:element>
+  </xs:schema>
+XSD
+
+puts "=" * 60
+puts "RXerces Schema Validation Example"
+puts "=" * 60
+
+# Create a schema from the XSD
+puts "\nCreating schema from XSD..."
+schema = RXerces::XML::Schema.from_string(schema_xsd)
+puts "✓ Schema created successfully"
+
+# Test 1: Valid document
+puts "\n" + "-" * 60
+puts "Test 1: Validating a VALID document"
+puts "-" * 60
+
+valid_xml = <<~XML
+  <?xml version="1.0"?>
+  <person>
+    <name>John Doe</name>
+    <age>30</age>
+    <email>john@example.com</email>
+  </person>
+XML
+
+doc = RXerces::XML::Document.parse(valid_xml)
+errors = doc.validate(schema)
+if errors.empty?
+  puts "✓ Document is VALID (no validation errors)"
+else
+  puts "✗ Document has validation errors:"
+  errors.each { |error| puts "  - #{error}" }
+end
+
+# Test 2: Invalid document (missing required element)
+puts "\n" + "-" * 60
+puts "Test 2: Validating an INVALID document (missing 'email')"
+puts "-" * 60
+
+invalid_xml = <<~XML
+  <?xml version="1.0"?>
+  <person>
+    <name>Jane Doe</name>
+    <age>25</age>
+  </person>
+XML
+
+doc2 = RXerces::XML::Document.parse(invalid_xml)
+errors2 = doc2.validate(schema)
+if errors2.empty?
+  puts "✓ Document is VALID (no validation errors)"
+else
+  puts "✗ Document has validation errors (as expected):"
+  errors2.each { |error| puts "  - #{error}" }
+end
+
+# Test 3: Invalid document (wrong type)
+puts "\n" + "-" * 60
+puts "Test 3: Validating an INVALID document (wrong type for 'age')"
+puts "-" * 60
+
+invalid_xml2 = <<~XML
+  <?xml version="1.0"?>
+  <person>
+    <name>Bob Smith</name>
+    <age>not-a-number</age>
+    <email>bob@example.com</email>
+  </person>
+XML
+
+doc3 = RXerces::XML::Document.parse(invalid_xml2)
+errors3 = doc3.validate(schema)
+if errors3.empty?
+  puts "✓ Document is VALID (no validation errors)"
+else
+  puts "✗ Document has validation errors (as expected):"
+  errors3.each { |error| puts "  - #{error}" }
+end
+
+# You can also create a schema from a document
+puts "\n" + "-" * 60
+puts "Creating schema from a Document object..."
+puts "-" * 60
+schema_doc = RXerces::XML::Document.parse(schema_xsd)
+schema2 = RXerces::XML::Schema.from_document(schema_doc)
+puts "✓ Schema created from Document"
+
+puts "\n" + "=" * 60
+puts "Full XSD validation is now implemented using Xerces-C!"
+puts "=" * 60

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."