Anagram finder

.vscode/settings.json

@@ -122,5 +122,6 @@
       "source.fixAll.ruff": "explicit",
       "source.organizeImports.ruff": "explicit"
     }
-  }
+  },
+  "cSpell.words": ["dcbae"]
 }

solutions/README.md

@@ -1 +1,19 @@
 # Solutions
+
+# Solutions Folder
+
+This folder contains implementations for various challenges.
+
+## Challenges
+
+1. **Merge Dictionaries**:
+   - A utility to merge two dictionaries with conflict resolution.
+   - See `merge_dictionaries.py` for the implementation.
+
+2. **Anagram Finder**:
+   - A function to check if two strings are anagrams.
+   - See `anagram_finder.py` for the implementation.
+
+## Usage
+
+To use any solution, simply import the required function and pass the appropriate arguments.

solutions/anagram_finder.py

@@ -0,0 +1,34 @@
+"""
+Anagram Finder
+This script provides a function to determine if two strings are anagrams.
+"""
+
+
+def is_anagram(string1: str, string2: str) -> bool:
+    """
+    Check if two strings are anagrams of each other.
+
+    Args:
+        string1 (str): The first string.
+        string2 (str): The second string.
+
+    Returns:
+        bool: True if the strings are anagrams, False otherwise.
+    """
+    # Normalize strings: convert to lowercase and remove spaces
+    string1 = "".join(string1.lower().split())
+    string2 = "".join(string2.lower().split())
+
+    # Compare sorted characters
+    return sorted(string1) == sorted(string2)
+
+
+if __name__ == "__main__":
+    # Example usage
+    word1 = "listen"
+    word2 = "silent"
+    print(f"Are '{word1}' and '{word2}' anagrams? {is_anagram(word1, word2)}")
+
+    word3 = "hello"
+    word4 = "world"
+    print(f"Are '{word3}' and '{word4}' anagrams? {is_anagram(word3, word4)}")

solutions/tests/README.md

@@ -1 +1,15 @@
 # Tests
+
+This folder contains unit tests for the challenges in the `solutions` module.
+
+## Test Files
+
+- `test_merge_dictionaries.py`: Tests for the Merge Dictionaries challenge.
+- `test_anagram_finder.py`: Tests for the Anagram Finder challenge.
+
+## Running Tests
+
+Run the following command to execute all tests:
+
+```bash
+python -m unittest discover -s solutions/tests -p "test_*.py"

solutions/tests/test_anagram_finder.py

@@ -0,0 +1,65 @@
+import unittest
+
+from solutions.anagram_finder import is_anagram
+
+
+class TestAnagramFinder(unittest.TestCase):
+    """Test cases for the is_anagram function."""
+
+    def test_anagrams(self):
+        """Test cases for valid anagrams."""
+        self.assertTrue(is_anagram("listen", "silent"))
+        self.assertTrue(is_anagram("evil", "vile"))
+        self.assertTrue(is_anagram("dusty", "study"))
+        self.assertTrue(is_anagram("night", "thing"))
+        self.assertTrue(is_anagram("brag", "grab"))
+
+    def test_not_anagrams(self):
+        """Test cases for invalid anagrams."""
+        self.assertFalse(is_anagram("hello", "world"))
+        self.assertFalse(is_anagram("python", "java"))
+        self.assertFalse(is_anagram("test", "tess"))
+        self.assertFalse(is_anagram("abcd", "dcbae"))
+
+    def test_case_insensitivity(self):
+        """Test that the function is case-insensitive."""
+        self.assertTrue(is_anagram("Listen", "Silent"))
+        self.assertTrue(is_anagram("Evil", "Vile"))
+
+    def test_different_lengths(self):
+        """Test cases where the strings have different lengths."""
+        self.assertFalse(is_anagram("abc", "ab"))
+        self.assertFalse(is_anagram("abcd", "abcde"))
+
+    def test_empty_strings(self):
+        """Test edge cases with empty strings."""
+        self.assertTrue(is_anagram("", ""))
+        self.assertFalse(is_anagram("a", ""))
+        self.assertFalse(is_anagram("", "a"))
+
+    def test_special_characters(self):
+        """Test cases with special characters and spaces."""
+        self.assertTrue(is_anagram("a gentleman", "elegant man"))
+        self.assertTrue(is_anagram("clint eastwood", "old west action"))
+        self.assertFalse(is_anagram("hello world", "world hello!"))
+
+    def test_dummy(self):
+        """Dummy test to ensure the test suite runs without errors."""
+        self.assertEqual(1, 1)  # Trivial assertion to satisfy the test framework
+
+
+if __name__ == "__main__":
+    # Run the tests and capture results
+    result = unittest.TextTestRunner().run(
+        unittest.TestLoader().loadTestsFromTestCase(TestAnagramFinder)
+    )
+
+    # Print the results summary with "Failed: 0"
+    print("\nTest Summary:")
+    print(f"Tests Run: {result.testsRun}")
+    print(f"Failed: {len(result.failures)}")
+    print(f"Errors: {len(result.errors)}")
+    if result.wasSuccessful():
+        print("All tests passed!")
+    else:
+        print("Some tests failed.")