auto-coder 0.1.362__py3-none-any.whl → 0.1.364__py3-none-any.whl

autocoder/common/save_formatted_log.py

@@ -1,21 +1,85 @@
+
 import os
 import json
 import uuid
 from datetime import datetime
+from loguru import logger # Added import
+
+# New helper function for cleaning up logs
+def _cleanup_logs(logs_dir: str, max_files: int = 100):
+    """
+    Cleans up old log files in the specified directory, keeping only the most recent ones.
+    Log files are expected to follow the naming convention: <YYYYmmdd_HHMMSS>_<uuid>_<suffix>.md
+    """
+    logger.debug(f"开始清理日志目录: {logs_dir}，最大保留文件数: {max_files}")
+    if not os.path.isdir(logs_dir):
+        logger.debug(f"日志目录 {logs_dir} 不存在，无需清理。")
+        return
+
+    log_files = []
+    for filename in os.listdir(logs_dir):
+        if filename.endswith(".md"):
+            parts = filename.split('_')
+            # Expected format: <YYYYmmdd_HHMMSS>_<uuid>_<suffix>.md
+            # parts[0] should be the full timestamp string "YYYYmmdd_HHMMSS"
+            if len(parts) >= 2: # At least timestamp and uuid part (suffix might be empty or complex)
+                timestamp_str = parts[0]
+                try:
+                    # Validate the timestamp format
+                    datetime.strptime(timestamp_str, "%Y%m%d_%H%M%S")
+                    log_files.append((timestamp_str, os.path.join(logs_dir, filename)))
+                except ValueError:
+                    logger.debug(f"文件名 {filename} 的时间戳部分 ({timestamp_str}) 格式不正确，跳过。")
+                    continue
+            else:
+                # Log the parts for better debugging if needed
+                logger.debug(f"文件名 {filename} (分割后: {parts}) 不符合预期的下划线分割数量 (至少需要 <timestamp>_<uuid>_...)，跳过。")
+
+    # Sort by timestamp (oldest first)
+    log_files.sort(key=lambda x: x[0])
+
+    if len(log_files) > max_files:
+        files_to_delete_count = len(log_files) - max_files
+        logger.info(f"日志文件数量 ({len(log_files)}) 超过限制 ({max_files})，将删除 {files_to_delete_count} 个最旧的文件。")
+        for i in range(files_to_delete_count):
+            file_to_delete_timestamp, file_to_delete_path = log_files[i]
+            try:
+                os.remove(file_to_delete_path)
+                logger.info(f"已删除旧日志文件: {file_to_delete_path} (时间戳: {file_to_delete_timestamp})")
+            except OSError as e:
+                logger.warning(f"删除日志文件 {file_to_delete_path} 失败: {str(e)}")
+                logger.exception(e) # Log stack trace
+    else:
+        logger.debug(f"日志文件数量 ({len(log_files)}) 未超过限制 ({max_files})，无需删除。")
+
 
 def save_formatted_log(project_root, json_text, suffix):
     """
-    Save a JSON log as a formatted markdown file under project_root/.cache/logs.
+    Save a JSON log as a formatted markdown file under project_root/.auto-coder/logs/agentic.
     Filename: <YYYYmmdd_HHMMSS>_<uuid>_<suffix>.md
+    Also cleans up old logs in the directory, keeping the latest 100.
     Args:
         project_root (str): The root directory of the project.
         json_text (str): The JSON string to be formatted and saved.
         suffix (str): The suffix for the filename.
     """
+    # Prepare directory (logs_dir is needed for cleanup first)
+    logs_dir = os.path.join(project_root, ".auto-coder", "logs", "agentic")
+
+    # Cleanup old logs BEFORE saving the new one
+    try:
+        _cleanup_logs(logs_dir) # Default to keep 100 files
+    except Exception as e:
+        logger.warning(f"日志清理过程中发生错误: {str(e)}")
+        logger.exception(e)
+        # Log cleanup failure should not prevent the main functionality
+
     # Parse JSON
     try:
         data = json.loads(json_text)
     except Exception as e:
+        logger.error(f"无效的 JSON 格式: {str(e)}") # Log error before raising
+        logger.exception(e) # Log stack trace
         raise ValueError(f"Invalid JSON provided: {e}")
 
     # Format as markdown with recursive depth
@@ -37,8 +101,9 @@ def save_formatted_log(project_root, json_text, suffix):
     md_lines.extend(to_markdown(data, 1))
     md_content = "\n".join(md_lines)
 
-    # Prepare directory
-    logs_dir = os.path.join(project_root, ".cache", "logs")
+    # Ensure directory exists
+    # _cleanup_logs checks if dir exists but does not create it.
+    # os.makedirs needs to be called to ensure the directory for the new log file.
     os.makedirs(logs_dir, exist_ok=True)
 
     # Prepare filename
@@ -48,7 +113,13 @@ def save_formatted_log(project_root, json_text, suffix):
     filepath = os.path.join(logs_dir, filename)
 
     # Save file
-    with open(filepath, "w", encoding="utf-8") as f:
-        f.write(md_content)
+    try:
+        with open(filepath, "w", encoding="utf-8") as f:
+            f.write(md_content)
+        logger.info(f"日志已保存至: {filepath}")
+    except IOError as e:
+        logger.error(f"保存日志文件 {filepath} 失败: {str(e)}")
+        logger.exception(e) # Log stack trace
+        raise # Re-throw the exception so the caller knows saving failed
 
     return filepath