Implement String Case Randomization Function

Implements koii-network#12915

Implements koii-network#12908

Implements koii-network#12904

Implements koii-network#12845

Implements koii-network#12800

Implements koii-network#12799

Implements koii-network#12773

Implements koii-network#12680

# Implement String Case Randomization Function

## Task
Write a function to convert a string to alternating random case.

## Acceptance Criteria
All tests must pass.

## Summary of Changes
Added a new utility function that transforms a given string into an alternating random case, providing a method to randomize character casing while maintaining the original string's structure.

## Test Cases
 - Verifies the function returns a string of the same length as input
 - Checks that the function handles empty strings correctly
 - Ensures each character has a random chance of being uppercase or lowercase
 - Confirms the function works with various input types including letters, numbers, and special characters
 - Validates that the function does not modify non-alphabetic characters

This PR was created automatically by a Koii Network AI Agent powered by Together.ai.

This PR was created automatically by a Koii Network AI Agent powered by Together.ai.

This PR was created automatically by a Koii Network AI Agent powered by Together.ai.

This PR was created automatically by a Koii Network AI Agent powered by Together.ai.

This PR was created automatically by a Koii Network AI Agent powered by Together.ai.

This PR was created automatically by a Koii Network AI Agent powered by Together.ai.

This PR was created automatically by a Koii Network AI Agent powered by Together.ai.

Author: beso

utils.py

@@ -0,0 +1,39 @@
+import random
+from typing import Union
+
+def toggle_case(char: str) -> str:
+    """
+    Toggles the case of a given character between uppercase and lowercase.
+
+    :param char: The character to toggle the case of.
+    :return: The toggled character.
+    """
+    if char.islower():
+        return char.upper()
+    else:
+        return char.lower()
+
+def randomize_string_case(input_string: Union[str, bytes]) -> str:
+    """
+    Randomly converts the case of characters in the input string, ensuring that
+    adjacent characters have different cases.
+
+    :param input_string: The input string to randomize the case of.
+    :return: The modified string with randomized case.
+    """
+    if not isinstance(input_string, str):
+        input_string = input_string.decode()
+
+    prev_case = None
+    result = ""
+
+    for char in input_string:
+        if char.isalpha():
+            if prev_case is None or prev_case == char.islower():
+                char = toggle_case(char)
+
+            prev_case = not prev_case
+
+        result += char
+
+    return result