Add shared test helpers

Extract shared assertions for Test::Unit and shared examples
for RSpec to reduce duplicated expectations. Wire both suites
to the shared helpers.

Author: evolve75

spec/spec_helper.rb

@@ -11,6 +11,7 @@
 
 require 'tree'
 require_relative 'support/fixtures'
+require_relative 'support/shared_examples'
 
 if ENV['COVERAGE']
   begin

spec/support/shared_examples.rb

@@ -0,0 +1,58 @@
+# shared_examples.rb - This file is part of the RubyTree package.
+#
+# Copyright (c) 2026 Anupam Sengupta. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification,
+# are permitted provided that the following conditions are met:
+#
+# - Redistributions of source code must retain the above copyright notice, this
+#   list of conditions and the following disclaimer.
+#
+# - Redistributions in binary form must reproduce the above copyright notice, this
+#   list of conditions and the following disclaimer in the documentation and/or
+#   other materials provided with the distribution.
+#
+# - Neither the name of the organization nor the names of its contributors may
+#   be used to endorse or promote products derived from this software without
+#   specific prior written permission.
+#
+#   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+# ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# frozen_string_literal: true
+
+RSpec.shared_examples 'detached node' do
+  it 'does not equal "Object.new"' do
+    expect(tree).not_to eq(Object.new)
+  end
+
+  it 'does not equal 1 or any other fixnum' do
+    expect(tree).not_to eq(1)
+  end
+
+  it 'identifies itself as a root node' do
+    expect(tree.root?).to be(true)
+  end
+
+  it 'does not have a parent node' do
+    expect(tree.parent).to be_nil
+  end
+end
+
+RSpec.shared_examples 'cloned node' do
+  it 'is equal to the original' do
+    expect(clone).to eq tree
+  end
+
+  it 'is not identical to the original' do
+    expect(clone).not_to be tree
+  end
+end

spec/tree_spec.rb

@@ -14,23 +14,6 @@
 class SpecializedTreeNode < Tree::TreeNode; end
 
 describe Tree do
-  shared_examples_for 'any detached node' do
-    it 'does not equal "Object.new"' do
-      expect(tree).not_to eq(Object.new)
-    end
-
-    it 'does not equal 1 or any other fixnum' do
-      expect(tree).not_to eq(1)
-    end
-
-    it 'identifies itself as a root node' do
-      expect(tree.root?).to be(true)
-    end
-
-    it 'does not have a parent node' do
-      expect(tree.parent).to be_nil
-    end
-  end
 
   describe '#initialize with empty name and nil content' do
     let(:tree) { Tree::TreeNode.new('') }
@@ -43,7 +26,7 @@ class SpecializedTreeNode < Tree::TreeNode; end
       expect(tree.content).to be_nil
     end
 
-    it_behaves_like 'any detached node'
+    it_behaves_like 'detached node'
   end
 
   describe "#initialize with name 'A' and nil content" do
@@ -57,7 +40,7 @@ class SpecializedTreeNode < Tree::TreeNode; end
       expect(tree.content).to be_nil
     end
 
-    it_behaves_like 'any detached node'
+    it_behaves_like 'detached node'
   end
 
   describe "#initialize with node name 'A' and some content" do
@@ -72,7 +55,7 @@ class SpecializedTreeNode < Tree::TreeNode; end
       expect(tree.content).to eq(sample)
     end
 
-    it_behaves_like 'any detached node'
+    it_behaves_like 'detached node'
   end
 
   describe 'comparison' do
@@ -117,21 +100,11 @@ class SpecializedTreeNode < Tree::TreeNode; end
     end
   end
 
-  shared_examples_for 'any cloned node' do
-    it 'is equal to the original' do
-      expect(clone).to eq tree
-    end
-
-    it 'is not identical to the original' do
-      expect(clone).not_to be tree
-    end
-  end
-
   describe '#detached_copy', 'Without content' do
     let(:tree) { Tree::TreeNode.new('A', nil) }
     let(:clone) { tree.detached_copy }
 
-    it_behaves_like 'any cloned node'
+    it_behaves_like 'cloned node'
   end
 
   describe '#detached_copy with clonable content' do
@@ -146,7 +119,7 @@ class SpecializedTreeNode < Tree::TreeNode; end
       expect(clone.content).not_to be tree.content
     end
 
-    it_behaves_like 'any cloned node'
+    it_behaves_like 'cloned node'
   end
 
   describe '#detached_copy with unclonable content' do
@@ -157,7 +130,7 @@ class SpecializedTreeNode < Tree::TreeNode; end
       expect(clone.content).to be tree.content
     end
 
-    it_behaves_like 'any cloned node'
+    it_behaves_like 'cloned node'
   end
 
   describe '#detached_copy with false as content' do
@@ -168,6 +141,6 @@ class SpecializedTreeNode < Tree::TreeNode; end
       expect(clone.content).to be tree.content
     end
 
-    it_behaves_like 'any cloned node'
+    it_behaves_like 'cloned node'
   end
 end

test/support/assertions.rb

@@ -0,0 +1,45 @@
+# assertions.rb - This file is part of the RubyTree package.
+#
+# Copyright (c) 2026 Anupam Sengupta. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification,
+# are permitted provided that the following conditions are met:
+#
+# - Redistributions of source code must retain the above copyright notice, this
+#   list of conditions and the following disclaimer.
+#
+# - Redistributions in binary form must reproduce the above copyright notice, this
+#   list of conditions and the following disclaimer in the documentation and/or
+#   other materials provided with the distribution.
+#
+# - Neither the name of the organization nor the names of its contributors may
+#   be used to endorse or promote products derived from this software without
+#   specific prior written permission.
+#
+#   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+# ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+# ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# frozen_string_literal: true
+
+module TreeTestAssertions
+  def assert_detached_node(node, name: nil, content_provided: false, content: nil)
+    assert_not_nil(node, 'Node should not be nil')
+    assert(node.root?, 'Node should identify as root')
+    assert_nil(node.parent, 'Node should not have a parent')
+    assert_equal(name, node.name, 'Node name does not match') if name
+    assert_equal(content, node.content, 'Node content does not match') if content_provided
+  end
+
+  def assert_clone_of(original, clone)
+    assert_equal(original, clone, 'Clone should be equal to original')
+    assert_not_same(original, clone, 'Clone should not be identical to original')
+  end
+end

test/test_tree.rb

@@ -35,12 +35,14 @@
 require 'json'
 require_relative '../lib/tree/tree_deps'
 require_relative 'support/fixtures_shared'
+require_relative 'support/assertions'
 
 module TestTree
   # Test class for the Tree node.
   # noinspection RubyTooManyInstanceVariablesInspection
   class TestTreeNode < Test::Unit::TestCase
     include TreeTestFixtures
+    include TreeTestAssertions
     Person = Struct.new(:First, :last) # A simple structure to use as the content for the nodes.
 
     # Create this structure for the tests
@@ -96,13 +98,8 @@ def test_has_version_number
 
     # This test is for the root alone - without any children being linked
     def test_root_setup
-      assert_not_nil(@root, 'Root cannot be nil')
-      assert_nil(@root.parent, 'Parent of root node should be nil')
-      assert_not_nil(@root.name, 'Name should not be nil')
-      assert_equal('ROOT', @root.name, "Name should be 'ROOT'")
-      assert_equal('Root Node', @root.content, "Content should be 'Root Node'")
+      assert_detached_node(@root, name: 'ROOT', content_provided: true, content: 'Root Node')
       assert(@root.to_s.include?('Content: Root Node'), 'to_s should include content value')
-      assert(@root.root?, 'Should identify as root')
       assert(!@root.children?, 'Cannot have any children')
       assert(@root.content?, 'This root should have content')
       assert_equal(1, @root.size, 'Number of nodes should be one')
@@ -1205,14 +1202,15 @@ def test_detached_copy
       assert(@root.children?, 'The root should have children')
       copy_of_root = @root.detached_copy
       assert(!copy_of_root.children?, 'The copy should not have children')
-      assert_equal(@root.name, copy_of_root.name, 'The names should be equal')
+      assert_clone_of(@root, copy_of_root)
 
       # Try the same test with a child node
       assert(!@child3.root?, 'Child 3 is not a root')
       assert(@child3.children?, 'Child 3 has children')
       copy_of_child3 = @child3.detached_copy
       assert(copy_of_child3.root?, "Child 3's copy is a root")
       assert(!copy_of_child3.children?, "Child 3's copy does not have children")
+      assert_clone_of(@child3, copy_of_child3)
     end
 
     # Test the detached_subtree_copy method.