Update file clean up logic to delete audio files older than 30 minuteds when writing new audio file to static/audio directory.

src/config.py

@@ -13,7 +13,6 @@ Key Features:
 import atexit
 import logging
 import os
-import shutil
 
 # Third-Party Library Imports
 from dotenv import load_dotenv
@@ -45,35 +44,3 @@ if DEBUG:
 AUDIO_DIR = os.path.join(os.getcwd(), "static", "audio")
 os.makedirs(AUDIO_DIR, exist_ok=True)
 logger.info(f"Audio directory set to {AUDIO_DIR}")
-
-
-def cleanup_audio_directory_contents() -> None:
-    """
-    Delete all audio files within AUDIO_DIR, leaving the directory intact.
-
-    This function is intended to be registered to run when the application exits.
-    It assumes that AUDIO_DIR contains only audio files (or symbolic links), and no subdirectories.
-    """
-    if not os.path.exists(AUDIO_DIR):
-        logger.info(
-            "Audio directory %s does not exist. Nothing to clean up.", AUDIO_DIR
-        )
-        return
-
-    # Use os.scandir for efficient directory iteration.
-    with os.scandir(AUDIO_DIR) as entries:
-        for entry in entries:
-            if entry.is_file() or entry.is_symlink():
-                try:
-                    os.unlink(entry.path)
-                    logger.info("Deleted file: %s", entry.path)
-                except Exception as exc:
-                    logger.error(
-                        "Failed to delete file %s. Reason: %s", entry.path, exc
-                    )
-            else:
-                logger.warning("Skipping non-file entry: %s", entry.path)
-
-
-# Register the cleanup function to be called on normal program termination.
-atexit.register(cleanup_audio_directory_contents)

src/integrations/elevenlabs_api.py

@@ -23,7 +23,7 @@ Functions:
 from dataclasses import dataclass
 import logging
 import random
-from typing import Optional, Union
+from typing import Optional, Tuple, Union
 
 # Third-Party Library Imports
 from elevenlabs import ElevenLabs, TextToVoiceCreatePreviewsRequestOutputFormat

src/utils.py

@@ -14,6 +14,7 @@ Functions:
 import base64
 import os
 import random
+import time
 from typing import Tuple
 
 # Local Application Imports
@@ -123,12 +124,46 @@ def validate_character_description_length(character_description: str) -> None:
     )
 
 
+def delete_files_older_than(directory: str, minutes: int = 30) -> None:
+    """
+    Delete all files in the specified directory that are older than a given number of minutes.
+
+    This function checks each file in the given directory and removes it if its last modification
+    time is older than the specified threshold. By default, the threshold is set to 30 minutes.
+
+    Args:
+        directory (str): The path to the directory where files will be checked and possibly deleted.
+        minutes (int, optional): The age threshold in minutes. Files older than this will be deleted.
+                                 Defaults to 30 minutes.
+
+    Returns: None
+    """
+    # Get the current time in seconds since the epoch.
+    now = time.time()
+    # Convert the minutes threshold to seconds.
+    cutoff = now - (minutes * 60)
+
+    # Iterate over all files in the directory.
+    for filename in os.listdir(directory):
+        file_path = os.path.join(directory, filename)
+        file_mod_time = os.path.getmtime(file_path)
+        # If the file's modification time is older than the cutoff, delete it.
+        if file_mod_time < cutoff:
+            try:
+                os.remove(file_path)
+                print(f"Deleted: {file_path}")
+            except Exception as e:
+                print(f"Error deleting {file_path}: {e}")
+
+
 def save_base64_audio_to_file(base64_audio: str, filename: str) -> str:
     """
     Decode a base64-encoded audio string and write the resulting binary data to a file
-    within the preconfigured AUDIO_DIR directory. This function verifies the file was created,
-    logs the absolute and relative file paths, and returns a path relative to the current
-    working directory (which is what Gradio requires to serve static files).
+    within the preconfigured AUDIO_DIR directory. Prior to writing the bytes to an audio
+    file all files within the directory which are more than 30 minutes old are deleted.
+    This function verifies the file was created, logs the absolute and relative file
+    paths, and returns a path relative to the current working directory (which is what
+    Gradio requires to serve static files).
 
     Args:
         base64_audio (str): The base64-encoded string representing the audio data.
@@ -148,6 +183,10 @@ def save_base64_audio_to_file(base64_audio: str, filename: str) -> str:
     # Construct the full absolute file path within the AUDIO_DIR directory.
     file_path = os.path.join(AUDIO_DIR, filename)
 
+    # Delete all audio files older than 30 minutes before writing new audio file.
+    num_minutes = 30
+    delete_files_older_than(AUDIO_DIR, num_minutes)
+
     # Write the binary audio data to the file.
     with open(file_path, "wb") as audio_file:
         audio_file.write(audio_bytes)