Update documentation for clarity and consistency

Author: SoundsSerious

CLAUDE.md

@@ -15,10 +15,25 @@ pip install .
 # Install in development mode 
 pip install -e .
 
+# Install development dependencies
+pip install -e ".[dev]"
+
 # Test the command line tool
 diffgetr file1.json file2.json path.to.key
 ```
 
+## Testing Commands
+
+```bash
+# Run unit tests
+python -m unittest discover tests -v
+
+# Build and test package
+python -m build
+pip install dist/*.whl
+python -c "import diffgetr; print('Package imported successfully')"
+```
+
 ## Core Architecture
 
 ### Main Class: `diff_get`

README.md

@@ -203,6 +203,22 @@ diff.diff_sidebyside()
 # - .version                       | "1.2.3"                      | "1.3.0"
 ```
 
+## Testing
+
+Run the comprehensive test suite to verify functionality:
+
+```bash
+python -m unittest discover tests -v
+```
+
+The test suite covers:
+• Core diff functionality and navigation through nested structures
+• Multiple output formats (summary, detailed, side-by-side)
+• Pattern recognition for UUIDs and CSV-like data
+• Error handling and edge cases
+• IPython integration and tab completion
+• Command-line interface functionality
+
 ## Contributing
 
 This tool is part of the SMART_X project ecosystem. When contributing:

tests/test_diff_get.py

@@ -1,10 +1,10 @@
-import pytest
+import unittest
 import json
 import io
 from diffgetr.diff_get import diff_get
 
 
-class TestDiffGet:
+class TestDiffGet(unittest.TestCase):
 
     def test_basic_diff(self):
         """Test basic diff functionality"""
@@ -82,10 +82,10 @@ def test_keyerror_handling(self):
 
         diff = diff_get(s0, s1)
 
-        with pytest.raises(KeyError) as exc_info:
+        with self.assertRaises(KeyError) as context:
             diff['a']['nonexistent']
 
-        assert "key missing: nonexistent" in str(exc_info.value)
+        self.assertIn("key missing: nonexistent", str(context.exception))
 
     def test_string_representation(self):
         """Test string representation of diff object"""
@@ -139,7 +139,7 @@ def test_diff_all_output(self):
 
     def test_type_assertion(self):
         """Test that different types raise assertion error"""
-        with pytest.raises(AssertionError):
+        with self.assertRaises(AssertionError):
             diff_get({"a": 1}, ["a", 1])
 
     def test_ipython_key_completions(self):
@@ -154,15 +154,15 @@ def test_ipython_key_completions(self):
         assert isinstance(completions, list)
 
 
-class TestCLI:
+class TestCLI(unittest.TestCase):
 
     def test_main_function_exists(self):
         """Test that main function exists and is callable"""
         from diffgetr.diff_get import main
-        assert callable(main)
+        self.assertTrue(callable(main))
 
 
-class TestPatternRecognition:
+class TestPatternRecognition(unittest.TestCase):
 
     def test_uuid_pattern_replacement(self):
         """Test UUID pattern recognition in diff summary"""
@@ -175,4 +175,37 @@ def test_uuid_pattern_replacement(self):
         summary = output.getvalue()
 
         # UUIDs should be abstracted in the summary
-        assert "UUID" in summary or summary  # At minimum should not crash
+        assert "UUID" in summary or summary  # At minimum should not crash
+
+
+if __name__ == "__main__":
+    import sys
+    import traceback
+    
+    # Simple test runner
+    test_classes = [TestDiffGet, TestCLI, TestPatternRecognition]
+    total_tests = 0
+    passed_tests = 0
+    
+    for test_class in test_classes:
+        instance = test_class()
+        methods = [m for m in dir(instance) if m.startswith('test_')]
+        
+        for method_name in methods:
+            total_tests += 1
+            try:
+                method = getattr(instance, method_name)
+                method()
+                print(f"✅ {test_class.__name__}.{method_name}")
+                passed_tests += 1
+            except Exception as e:
+                print(f"❌ {test_class.__name__}.{method_name}: {e}")
+                traceback.print_exc()
+    
+    print(f"\n🏆 SUMMARY: {passed_tests}/{total_tests} tests passed")
+    if passed_tests == total_tests:
+        print("✅ ALL TESTS PASSED")
+        sys.exit(0)
+    else:
+        print("❌ SOME TESTS FAILED")
+        sys.exit(1)