rxerces 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e19a59f7418eca81e344bf69e5a60b91a510615979d4716c23eb18cd79fd954f
-  data.tar.gz: b8d5c62806c094fc61ca00ad47b4347990440d3f208d6e2678c1b26e9453b0e0
+  metadata.gz: 5c6ba3896b05b5303ed0842c6ccc0376ce27e0325301dafe54472c73f9298ed9
+  data.tar.gz: 45844824ec1ca0ba91acf214cd1369466b40e1e0d7d1a653ed5ad7807a488e58
 SHA512:
-  metadata.gz: e2fd038f7d64bab9017b48b2a20b1abd1df859f6bc21082ae4e73e955f41a2d664eb5991d07bbc5aa1393eb8d72040e1f65358436c424987d1757261f71e086d
-  data.tar.gz: 1493d18f198efc2bd6bf9f06282d071a96b7edf91f0de4cb5960ceefad6baf394fe3257348b1f835f193a982661be2af12d0dc12b80a9dcc933794d5a521e61f
+  metadata.gz: d9513b47e15bf8219c9cfc0a801763b656622e0f00c517d4e3cc3065b7775555d03ec1ad933eb309933e9bb9563ec234f66d19ce179693a265bac1a9a9d52f7e
+  data.tar.gz: 8df33c1af2dc29c325e2b82a148b2adaa75d61d1e80a7dba466b39cb0896ea9a26da3c53b564a84643330c70d88f239202ee87b3fedb7c2ca66e4b82e5eb4112

data/CHANGES.md

@@ -1,3 +1,23 @@
+## 0.4.0 - 15-Dec-2025
+* Now uses Xalan if installed for xpath 1.0 compliance.
+* Added Node#search.
+* Added Node#at and Node#at_xpath.
+* Added Document#encoding.
+* Added Node#namespace.
+* Added a placeholder css method for now, it's on the TODO list.
+
+## 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.

data/README.md

@@ -39,6 +39,28 @@ sudo apt-get install libxerces-c-dev
 sudo yum install xerces-c-devel
 ```
 
+### Xalan
+
+For XPath 1.0 compliance, you will need to install the Xalan library. Note
+that this is optional, and rxerces will default to using the Xpath support
+from Xerces, which is more limited.
+
+**Ubuntu/Debian:**
+```bash
+sudo apt-get install libxalan-c-dev
+```
+
+**Fedora/RHEL:**
+```bash
+sudo yum install xalan-c-devel
+```
+
+Note that MacOS, contrary to what the documentation currently says, does not
+have a brew package for Xalan. You will either need to use Mac ports or clone
+and build the code manually. I found that it required some tweaking to work:
+
+https://github.com/apache/xalan-c/pull/44
+
 ### Install the Gem
 
 Add this line to your application's Gemfile:
@@ -156,7 +178,7 @@ puts doc.to_s
 
 ### XPath Queries
 
-RXerces supports XPath queries using Xerces-C's XPath implementation:
+RXerces supports XPath queries using Xerces-C's XPath implementation by default:
 
 ```ruby
 xml = <<-XML
@@ -206,6 +228,8 @@ Not supported:
 
 For more complex queries, you can combine basic XPath with Ruby's `select` and `find` methods.
 
+For full XPath 1.0 support, install the Xalan library.
+
 ## API Reference
 
 ### RXerces Module
@@ -270,7 +294,7 @@ bundle exec rake
 
 - Uses Apache Xerces-C 3.x for XML parsing
 - C++ extension compiled with Ruby's native extension API
-- XPath support is basic (full XPath requires additional implementation)
+- XPath support is basic by default (full XPath requires Xalan)
 - Memory management handled by Ruby's GC and Xerces-C's DOM
 
 ## Differences from Nokogiri

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/ext/rxerces/extconf.rb

@@ -29,4 +29,46 @@ unless find_header('xercesc/util/PlatformUtils.hpp')
   puts "Proceeding with compilation..."
 end
 
+# Check for Xalan-C (optional for enhanced XPath support)
+# Use dir_config which handles --with-xalan-dir and --with-xalan-include/lib
+dir_config('xalan')
+
+# Also try to auto-detect in common locations
+if RUBY_PLATFORM =~ /darwin/
+  homebrew_xalan = `brew --prefix xalan-c 2>/dev/null`.chomp
+  if !homebrew_xalan.empty? && File.directory?(homebrew_xalan)
+    $INCFLAGS << " -I#{homebrew_xalan}/include" unless $INCFLAGS.include?("-I#{homebrew_xalan}/include")
+    $LDFLAGS << " -L#{homebrew_xalan}/lib" unless $LDFLAGS.include?("-L#{homebrew_xalan}/lib")
+  end
+end
+
+# Try standard locations
+xalan_found_prefix = nil
+['/usr/local', '/opt/local', '/usr'].each do |prefix|
+  if File.directory?("#{prefix}/include/xalanc")
+    $INCFLAGS << " -I#{prefix}/include" unless $INCFLAGS.include?("-I#{prefix}/include")
+    $LDFLAGS << " -L#{prefix}/lib" unless $LDFLAGS.include?("-L#{prefix}/lib")
+    xalan_found_prefix = prefix
+    break
+  end
+end
+
+# Check for Xalan libraries
+# Note: We skip the header check because Xalan C++ headers require C++ compilation
+# which mkmf's find_header doesn't handle well. The library check is sufficient.
+if have_library('xalanMsg') && have_library('xalan-c')
+  $CXXFLAGS << " -DHAVE_XALAN"
+  # Add rpath so the dynamic libraries can be found at runtime
+  if xalan_found_prefix
+    $LDFLAGS << " -Wl,-rpath,#{xalan_found_prefix}/lib"
+  end
+  puts "Xalan-C found: Full XPath 1.0 support enabled"
+else
+  puts "Xalan-C not found: Using Xerces XPath subset"
+  puts "For full XPath 1.0 support, install Xalan-C:"
+  puts "  macOS: Build from source (no homebrew formula available)"
+  puts "  Linux: May be available via package manager"
+  puts "  Or specify: --with-xalan-dir=/path/to/xalan"
+end
+
 create_makefile('rxerces/rxerces')