translate to english

Author: joyguoguo

fuzz/build_oss_fuzz.py

@@ -4,11 +4,11 @@
 """
 build_oss_fuzz.py
 
-并行构建 OSS-Fuzz 项目（Docker 镜像和 Fuzzer 编译）。
-使用 multiprocessing.Pool 将项目分发到多个 CPU 核心同时处理。
+Parallel build of OSS-Fuzz projects (Docker images and Fuzzer compilation).
+Uses multiprocessing.Pool to distribute projects across multiple CPU cores for concurrent processing.
 
-用法: python3 build_oss_fuzz.py [项目列表文件] [--sanitizer 类型] [--workers N]
-示例: python3 fuzz/build_oss_fuzz.py data/valid_projects.txt \
+Usage: python3 build_oss_fuzz.py [project_list_file] [--sanitizer type] [--workers N]
+Example: python3 fuzz/build_oss_fuzz.py data/valid_projects.txt \
     --sanitizer address \
     --workers 8
 """
@@ -22,19 +22,19 @@
 from typing import List, Optional, Tuple
 from multiprocessing import Pool, cpu_count
 
-# --- 全局配置 ---
+# --- Global configuration ---
 HOME_DIR = Path.home()
 OSS_FUZZ_DIR = HOME_DIR / "FuzzAug" / "fuzz" / "oss-fuzz"
 LOG_DIR = OSS_FUZZ_DIR / "build_logs"
 
 def setup_logging(project_name: str) -> Path:
-    """为单个项目创建带时间戳的日志文件"""
+    """Create a timestamped log file for a single project"""
     LOG_DIR.mkdir(parents=True, exist_ok=True)
     timestamp = datetime.now().strftime("%Y%m%d%H%M%S")
     return LOG_DIR / f"build_{project_name}_{timestamp}.log"
 
 def log_and_print(message: str, log_file: Path, to_stdout: bool = True):
-    """将消息写入日志并打印到控制台"""
+    """Write message to log and print to console"""
     if to_stdout:
         print(f"[PID:{os.getpid()}] {message}")
     with open(log_file, "a", encoding="utf-8") as f:
@@ -46,14 +46,14 @@ def run_command(
     log_file: Path,
     allowed_exit_codes: Optional[List[int]] = None
 ) -> bool:
-    """执行 shell 命令并实时记录输出"""
+    """Execute a shell command and stream output to log in real-time"""
     allowed_exit_codes = allowed_exit_codes or []
     log_and_print(f"▶️ {log_msg}...", log_file, to_stdout=False)
     log_and_print(f"   $ {cmd}", log_file, to_stdout=False)
 
     try:
         process = subprocess.Popen(
-            f"yes | {cmd}",  # 自动确认所有提示
+            f"yes | {cmd}",  # Auto-confirm all prompts
             shell=True,
             stdout=subprocess.PIPE,
             stderr=subprocess.STDOUT,
@@ -67,67 +67,67 @@ def run_command(
         process.wait()
         exit_code = process.returncode
         if exit_code in [0, *allowed_exit_codes]:
-            log_and_print(f"✅ 命令成功完成", log_file, to_stdout=False)
+            log_and_print(f"✅ Command completed successfully", log_file, to_stdout=False)
             return True
-        log_and_print(f"❌ 命令失败 (退出码: {exit_code})", log_file)
+        log_and_print(f"❌ Command failed (exit code: {exit_code})", log_file)
         return False
     except Exception as e:
-        log_and_print(f"💥 执行异常: {e}", log_file)
+        log_and_print(f"💥 Execution exception: {e}", log_file)
         return False
 
 def build_project(project_name: str, sanitizer: str) -> Tuple[bool, str]:
-    """单个项目的构建工作流"""
+    """Build workflow for a single project"""
     log_file = setup_logging(project_name)
     os.chdir(OSS_FUZZ_DIR)
 
     log_and_print("="*60, log_file)
-    log_and_print(f"🔨 开始构建项目: {project_name}", log_file)
-    log_and_print(f"📝 日志路径: {log_file}", log_file)
+    log_and_print(f"🔨 Starting build for project: {project_name}", log_file)
+    log_and_print(f"📝 Log path: {log_file}", log_file)
     log_and_print("="*60, log_file)
 
-    # 1. 构建 Docker 镜像
+    # 1. Build Docker image
     if not run_command(
         f"python3 infra/helper.py build_image {project_name}",
-        "步骤1/2: 构建 Docker 镜像",
+        "Step 1/2: Building Docker image",
         log_file
     ):
         return (False, project_name)
 
-    # 2. 编译 Fuzzer
+    # 2. Compile Fuzzers
     if not run_command(
         f"python3 infra/helper.py build_fuzzers --sanitizer {sanitizer} {project_name}",
-        f"步骤2/2: 编译 Fuzzer (sanitizer={sanitizer})",
+        f"Step 2/2: Compiling Fuzzers (sanitizer={sanitizer})",
         log_file
     ):
         return (False, project_name)
 
-    log_and_print(f"✅ 项目 {project_name} 构建完成", log_file)
+    log_and_print(f"✅ Project {project_name} build completed", log_file)
     return (True, project_name)
 
 def main():
-    parser = argparse.ArgumentParser(description="OSS-Fuzz 并行构建工具")
-    parser.add_argument("project_list", help="项目列表文件路径")
+    parser = argparse.ArgumentParser(description="OSS-Fuzz Parallel Build Tool")
+    parser.add_argument("project_list", help="Project list file path")
     parser.add_argument("--sanitizer", default="address", choices=["address", "memory", "undefined"])
     parser.add_argument("--workers", type=int, default=cpu_count())
     args = parser.parse_args()
 
-    # 读取项目列表
+    # Read project list
     try:
         with open(args.project_list, "r") as f:
             projects = [line.strip() for line in f if line.strip()]
     except Exception as e:
-        print(f"❌ 读取项目列表失败: {e}")
+        print(f"❌ Failed to read project list: {e}")
         sys.exit(1)
 
-    # 并行构建
+    # Parallel build
     with Pool(args.workers) as pool:
         results = pool.starmap(build_project, [(p, args.sanitizer) for p in projects])
 
-    # 输出结果
+    # Output results
     failed = [p for success, p in results if not success]
-    print(f"\n📊 构建完成: 成功 {len(projects)-len(failed)}/{len(projects)}")
+    print(f"\n📊 Build completed: Success {len(projects)-len(failed)}/{len(projects)}")
     if failed:
-        print("❌ 失败项目: " + ", ".join(failed))
+        print("❌ Failed projects: " + ", ".join(failed))
 
 if __name__ == "__main__":
     main()