feat: rename with single * wildcard.

src/plex_footage_sorter/_rename.py

@@ -2,10 +2,97 @@
 
 """Platform independent wildcard rename command."""
 
-from pathlib import Path
+import os
+import re
+from typing import List
 
 
-def main(directory: Path, match_pattern: str, target_pattern: str, regex: bool):
+def _discover_files(directory: str, pattern: str) -> List[re.Match]:
+    """Find files in the specified directory that match the regex pattern.
+
+    Args:
+        directory (str): The path to the directory to be searched.
+        pattern (str): A regex pattern against which to match.
+
+    Returns:
+        List[re.Match]: A list of match objects, each corresponding to a
+            matching file.
+    """
+
+    print(f"Discovering files in {directory}", end="")
+
+    files = [
+        file
+        for file in [re.match(pattern, f) for f in os.listdir(directory)]
+        if file is not None
+    ]
+
+    print(f" ... Found {len(files)} matching file(s).")
+
+    return files
+
+
+def _convert_glob_to_capturing_regex(pattern: str) -> str:
+    """Convert a glob string to a regex with capturing groups.
+
+    This aims to duplicate the functionality of `fnmatch.translate`, but with
+    separate capturing groups wherever glob special characters appear.
+    For example,
+
+    ```txt
+    my_file_*
+    ```
+
+    will be converted to:
+
+    ```regex
+    my_file_(.*)
+    ```
+
+    The full conversion table is:
+
+    | glob str | regex | notes                                                       |
+    |----------|-------|-------------------------------------------------------------|
+    | *        | (.*)  | match any number of characters (including 0)                |
+    | ?        |       | match any single character.                              NI |
+    | [abc]    |       | match one character given in the bracket.                NI |
+    | [a-z]    |       | match one character from the range given in the bracket. NI |
+    | [!abc]   |       | match one character that is not given in the bracket.    NI |
+    | [!a-z]   |       | match one character that is not from the range.          NI |
+
+    Currently only `*` is implemented.
+
+    Args:
+        pattern (str): _description_
+
+    Returns:
+        str: _description_
+    """
+    if any(x in pattern for x in ["?", "["]):
+        raise NotImplementedError(
+            f"Pattern '{pattern}' contains glob wildcards that are not yet supported."
+        )
+
+    return "(.*)".join(pattern.split("*"))
+
+
+def _convert_glob_to_format_string(pattern: str) -> str:
+    """Convert a glob pattern to a
+
+    Args:
+        pattern (str): _description_
+
+    Returns:
+        str: _description_
+    """
+    chars = list(pattern)
+    for i, char in enumerate(chars):
+        if char == "*":
+            chars[i] = "%s"
+    return "".join(chars)
+
+
+def main(directory: str, match_pattern: str, target_pattern: str, regex: bool):
     """Find and rename matching files.
 
     Args:
@@ -15,4 +102,19 @@ def main(directory: Path, match_pattern: str, target_pattern: str, regex: bool):
         regex (bool): If True, interpret the match and target patterns using regex. If
             False, glob will be used. Defaults to False.
     """
-    pass
+    if (
+        len(
+            files := _discover_files(
+                directory, _convert_glob_to_capturing_regex(match_pattern)
+            )
+        )
+        == 0
+    ):
+        return
+
+    _target_pattern = _convert_glob_to_format_string(target_pattern)
+
+    for file in files:
+        new_name = _target_pattern % (file.group(1))
+        os.rename(file.group(0), new_name)
+        print(f"{file} -> {new_name}")