(new) merge folders python script (#12)

Author: bakerboy448

README.md

@@ -1,6 +1,9 @@
 # StarrScripts
 
-A curated collection of scripts to optimize and manage various functions related to Starr applications and associated tools. These scripts are designed to enhance functionality, improve management, and automate routine tasks.
+A curated collection of scripts to optimize and manage various functions related to Starr applications and associated tools.
+Occasionally holds random useful scripts as well.
+These scripts are designed to enhance functionality, improve management, and automate routine tasks.
+All scripts are **Created By: [Bakerboy448](https://github.com/bakerboy448/) unless otherwise noted.
 
 ## Scripts Overview
 
@@ -34,6 +37,22 @@ A curated collection of scripts to optimize and manage various functions related
   3. Review and adjust script parameters to fit your use case.
 - **Output:** Results are saved to a file as specified in the script.
 
+### Merge Folders Utility
+
+- **Script:** `merge_folders.py`
+- **Description:** A robust utility designed for merging multiple directories into a single target directory, ensuring that no existing files are overwritten in the process. This script uses a recursive function to efficiently merge content, while providing detailed logging of each step to monitor the creation, movement, and skipping of files and directories.
+- **Features:**
+  - **Recursive Merging:** Seamlessly combines contents of source directories into a target directory.
+  - **Non-destructive:** Preserves existing files by not overwriting them.
+  - **Error Handling:** Captures and logs errors during the merging process, ensuring reliable operations.
+  - **Detailed Logging:** Tracks and logs every file and directory operation, providing clear visibility into the process.
+- **Usage Case:** Ideal for consolidating data in scenarios like organizing media libraries, merging data backups, or simplifying file system structures.
+- **Setup:**
+  1. Update `source_dirs` and uncomment the variable
+  2. Update `target_dir` and uncomment the variable
+  3. Uncomment `atomic_moves` to engage the movement operation
+  4. Run the script with `python3 merge_folders.py`
+
 ### Notifiarr Branch Builder
 
 - **Script:** `notifiarr-branch-builder.sh`

merge_folders.py

@@ -0,0 +1,39 @@
+def merge_directories(src, dst):
+    """
+    Recursively merges directories from src to dst without overwriting existing files.
+    """
+    for item in os.listdir(src):
+        src_path = os.path.join(src, item)
+        dst_path = os.path.join(dst, item)
+        
+        if os.path.isdir(src_path):
+            # If it's a directory, recurse into it
+            if not os.path.exists(dst_path):
+                os.makedirs(dst_path)
+                logging.info(f"Directory created: {dst_path}")
+            merge_directories(src_path, dst_path)
+        else:
+            # It's a file, check if it exists in the destination
+            if not os.path.exists(dst_path):
+                # Move the file atomically if on the same filesystem
+                shutil.move(src_path, dst_path)
+                logging.info(f"File moved: {src_path} to {dst_path}")
+            else:
+                logging.info(f"File skipped (already exists): {dst_path}")
+
+def atomic_moves(source_directories, target_directory):
+    """
+    Handles atomic moving from multiple source directories to a single target directory.
+    """
+    for src in source_directories:
+        logging.info(f"Processing source directory: {src}")
+        try:
+            # Start the merging process for each source directory
+            merge_directories(src, target_directory)
+        except Exception as e:
+            logging.error(f"Error during moving process from {src}: {e}")
+
+# Example use case (commented out for safety):
+# source_dirs = ['/mnt/data/media/tv-slade', '/mnt/data/media/tv-tmp']
+# target_dir = '/mnt/data/media/tv'
+# atomic_moves(source_dirs, target_dir)