compare-xml 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '044582cb43241dc59a65422b8c36a2cc96d1a3120f9648c0950b7ef9fe125be5'
-  data.tar.gz: 3a33391e6f5a67f305546173a43725a64bd6ed4df12135434453da9bc3982e98
+  metadata.gz: f7e6709bb5f5150832a22634027282fb7a2e80571f0a5c8210f7f8982f59bb67
+  data.tar.gz: ba0a234e1c095d4d0a97b72c22a8e6831d53b2203acf860965602dc81bdfbb85
 SHA512:
-  metadata.gz: 0f3a32d528e4298a96ce59238f7ed556fa110ea7a4d715b651e1e578887f6bde9c6852928d0971c114e6ca9fb77dca8c4e6ca53c9580143cc5d89785ca14d942
-  data.tar.gz: fc8371bdce1193d15d42092c24b9b44d2d9c51a685331102ba69fd9290cafdd6faf588feab68871b1c7659c42ed1f1656718b97b72fbf0702bde153e3a2caf30
+  metadata.gz: c2e9309f2980da1b6faa1e1ecea38293654492e04f216b1aa45e53c93817f2b394811511b4b233a8e74e3d498f6f71df0020b4d55635b5c95b6314aea7701f5b
+  data.tar.gz: ac6934cf5624163ea039cdd3985f07b28bd7f60e7f77e9329b70343d87b48e237b790e380316294293073a8d40de8f111d6f44addfb39a477d6b3f5389332f61

data/README.md

@@ -1,12 +1,15 @@
 # CompareXML
 
-[![Gem Version](https://img.shields.io/gem/v/compare-xml.svg)](https://rubygems.org/gems/compare-xml)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Lint Status](https://github.com/vkononov/compare-xml/actions/workflows/lint.yml/badge.svg)](https://github.com/vkononov/compare-xml/actions/workflows/lint.yml)
-[![Test Status](https://github.com/vkononov/compare-xml/actions/workflows/test.yml/badge.svg)](https://github.com/vkononov/compare-xml/actions/workflows/test.yml)
+[![Gem Version](https://img.shields.io/gem/v/compare-xml.svg?label=Gem&logo=rubygems&logoColor=white)](https://rubygems.org/gems/compare-xml)
+[![Ruby](https://img.shields.io/badge/Ruby-2.4%20to%204.0-CC342D?logo=ruby&logoColor=white)](https://github.com/vkononov/compare-xml/blob/main/.github/workflows/test.yml)
+[![Test Matrix](https://img.shields.io/github/actions/workflow/status/vkononov/compare-xml/test.yml?branch=main&label=Test%20Matrix&logo=github)](https://github.com/vkononov/compare-xml/actions/workflows/test.yml)
+[![Lint](https://img.shields.io/github/actions/workflow/status/vkononov/compare-xml/lint.yml?branch=main&label=Lint&logo=github)](https://github.com/vkononov/compare-xml/actions/workflows/lint.yml)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/license/MIT)
 
 CompareXML is a fast, lightweight and feature-rich tool that will solve your XML/HTML comparison or diffing needs. Its purpose is to compare two instances of `Nokogiri::XML::Node` or `Nokogiri::XML::NodeSet` for equality or equivalency.
 
+Supports **Ruby 2.4 → latest**, with the full Ruby matrix tested daily in CI.
+
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)](https://www.buymeacoffee.com/vkononov)
 
 **Features**
@@ -49,8 +52,8 @@ where `doc1` and `doc2` are instances of `Nokogiri::XML::Node` or `Nokogiri::XML
 Suppose you have two files `1.html` and `2.html` that you would like to compare. You could do it as follows:
 
 ```ruby
-doc1 = Nokogiri::HTML(open('1.html'))
-doc2 = Nokogiri::HTML(open('2.html'))
+doc1 = Nokogiri::HTML(File.read('1.html'))
+doc2 = Nokogiri::HTML(File.read('2.html'))
 puts CompareXML.equivalent?(doc1, doc2)
 ```
 
@@ -81,7 +84,7 @@ CompareXML.equivalent?(doc1, doc2, {collapse_whitespace: false, verbose: true})
     - when provided, ignores all attributes that contain substrings `string`, `string2`, etc.
 
 - `ignore_attrs: [css_selector1, css_selector1, ...]` default: **`[]`**     [show examples ⇨](#ignore_attrs)
-    - when provided, ignores specific *attributes* using [CSS selectors](http://www.w3schools.com/cssref/css_selectors.asp)
+    - when provided, ignores specific *attributes* using [CSS selectors](https://www.w3schools.com/cssref/css_selectors.php)
 
 - `ignore_attrs_by_name: [matcher1, matcher2, ...]` default: **`[]`**     [show examples ⇨](#ignore_attrs_by_name)
     - when provided, ignores *attributes* whose name matches a `String` (exact) or `Regexp` (pattern)
@@ -90,7 +93,7 @@ CompareXML.equivalent?(doc1, doc2, {collapse_whitespace: false, verbose: true})
     - when `true`, ignores comments, such as `<!-- comment -->`
 
 - `ignore_nodes: [css_selector1, css_selector1, ...]` default: **`[]`** &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[show examples ⇨](#ignore_nodes)
-    - when provided, ignores specific *nodes* using [CSS selectors](http://www.w3schools.com/cssref/css_selectors.asp)
+    - when provided, ignores specific *nodes* using [CSS selectors](https://www.w3schools.com/cssref/css_selectors.php)
 
 - `ignore_text_nodes: {true|false}` default: **`false`**&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[show examples ⇨](#ignore_text_nodes)
     - when `true`, ignores all text content within a document
@@ -188,7 +191,7 @@ CompareXML.equivalent?(doc1, doc2, {collapse_whitespace: false, verbose: true})
 
 - <a id="ignore_attrs"></a>`ignore_attrs: [css_selector1, css_selector1, ...]` default: **`[]`**
 
-    When provided, ignores all **attributes** that satisfy a particular rule using [CSS selectors](http://www.w3schools.com/cssref/css_selectors.asp).
+    When provided, ignores all **attributes** that satisfy a particular rule using [CSS selectors](https://www.w3schools.com/cssref/css_selectors.php).
 
     **Usage Example:** `CompareXML.equivalent?(doc1, doc2, {ignore_attrs: ['a[rel="nofollow"]', 'input[type="hidden"']})`
 
@@ -250,7 +253,7 @@ CompareXML.equivalent?(doc1, doc2, {collapse_whitespace: false, verbose: true})
 
 - <a id="ignore_nodes"></a>`ignore_nodes: [css_selector1, css_selector1, ...]` default: **`[]`**
 
-    When provided, ignores all **nodes** that satisfy a particular rule using [CSS selectors](http://www.w3schools.com/cssref/css_selectors.asp).
+    When provided, ignores all **nodes** that satisfy a particular rule using [CSS selectors](https://www.w3schools.com/cssref/css_selectors.php).
 
     **Usage Example:** `CompareXML.equivalent?(doc1, doc2, {ignore_nodes: ['script', 'object']})`
 
@@ -382,6 +385,31 @@ CompareXML.equivalent?(doc1, doc2, {collapse_whitespace: false, verbose: true})
 
 ----------
 
+## Separate Options for Child Nodes
+
+`CompareXML.equivalent?` accepts two further optional arguments that let child nodes be compared under a different set of options than the root:
+
+```ruby
+CompareXML.equivalent?(doc1, doc2, opts = {}, child_opts = {}, diff_children = false)
+```
+
+- `child_opts` - a second options hash, merged over the defaults the same way as `opts`, applied to child nodes
+- `diff_children` - when `true`, child nodes are compared using `child_opts` instead of `opts`
+
+`child_opts` is ignored unless `diff_children` is `true`.
+
+**Example:** compare the root strictly, but ignore text content within child nodes:
+
+```ruby
+doc1 = Nokogiri::HTML('<html><body><p>Hello</p></body></html>')
+doc2 = Nokogiri::HTML('<html><body><p>Goodbye</p></body></html>')
+
+CompareXML.equivalent?(doc1, doc2) # => false
+CompareXML.equivalent?(doc1, doc2, {}, { ignore_text_nodes: true }, true) # => true
+```
+
+----------
+
 ## Contributing
 
 1. Fork it
@@ -400,4 +428,4 @@ This gem was inspired by [Michael B. Klein](https://github.com/mbklein)'s gem [`
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/license/MIT).

data/lib/compare-xml/version.rb

@@ -1,3 +1,3 @@
 module CompareXML
-  VERSION = '1.0.0'.freeze
+  VERSION = '1.0.1'.freeze
 end

data/lib/compare-xml.rb

@@ -115,6 +115,8 @@ module CompareXML
           status = diff_children ? compare_element_nodes(n1, n2, opts, differences, child_opts, diff_children: diff_children) : compare_element_nodes(n1, n2, opts, differences)
         when Nokogiri::XML::Text
           status = compare_text_nodes(n1, n2, opts, differences)
+        when Nokogiri::XML::NodeSet
+          status = diff_children ? compare_children(n1, n2, child_opts, differences, diff_children: diff_children) : compare_children(n1, n2, opts, differences)
         else
           raise 'Comparison only allowed between objects of type Nokogiri::XML::Node and Nokogiri::XML::NodeSet.' unless n1.is_a?(Nokogiri::XML::Node) || n1.is_a?(Nokogiri::XML::NodeSet)
           status = compare_children(n1.children, n2.children, opts, differences)
@@ -293,7 +295,7 @@ module CompareXML
         attr_str = attrs.map { |a| "#{a.name}=#{a.value}" }.join(' ')
         children = node.children.reject { |c| node_excluded?(c, opts) }
         child_str = children.map { |c| node_fingerprint(c, opts, cache) }.join
-        "E:#{node.name}[#{attr_str}](#{child_str})"
+        "E:#{element_name(node)}[#{attr_str}](#{child_str})"
       else
         "O:#{node.class}:#{node}"
       end
@@ -345,7 +347,7 @@ module CompareXML
     #   @return type of equivalence (from equivalence constants)
     #
     def compare_element_nodes(n1, n2, opts, differences, child_opts = {}, diff_children: false, status: EQUIVALENT)
-      if n1.name == n2.name
+      if element_name(n1) == element_name(n2)
         result = compare_attribute_sets(n1, n2, n1.attribute_nodes, n2.attribute_nodes, opts, differences)
         return result unless result == EQUIVALENT || opts[:force_children] == true
         status = result unless result == EQUIVALENT
@@ -353,11 +355,24 @@ module CompareXML
         status = result unless result == EQUIVALENT
       else
         status = UNEQUAL_ELEMENTS
-        add_difference(n1, n2, n1.name, n2.name, opts, differences)
+        add_difference(n1, n2, element_name(n1), element_name(n2), opts, differences)
       end
       status
     end
 
+    ##
+    # Returns the element name qualified by its namespace URI, so that elements with
+    # the same local name in different namespaces are not treated as equal.
+    #
+    #   @param [Nokogiri::XML::Element] node the element
+    #
+    #   @return [String] the local name, prefixed with "{uri}" when namespaced
+    #
+    def element_name(node)
+      href = node.namespace&.href
+      href ? "{#{href}}#{node.name}" : node.name
+    end
+
     ##
     # Compares two nodes of type Nokogiri::XML::Text.
     #

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: compare-xml
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Vadim Kononov
@@ -23,9 +23,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.6'
-description: CompareXML is a fast, lightweight and feature-rich tool that will solve
-  your XML/HTML comparison or diffing needs. its purpose is to compare two instances
-  of Nokogiri::XML::Node or Nokogiri::XML::NodeSet for equality or equivalency.
+description: Compares Nokogiri XML and HTML documents, nodes and node sets for equality
+  or equivalency. Returns a list of differences and can exclude chosen nodes or attributes.
 email:
 - vadim@konoson.com
 executables: []
@@ -60,6 +59,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.10
 specification_version: 4
-summary: A customizable tool that compares two instances of Nokogiri::XML::Node for
-  equality or equivalency.
+summary: Compare XML and HTML documents or Nokogiri nodes for equality with a diff
 test_files: []