Function validatePython

scripts/docs-validation/validate.ts:142–210

()

}

async function validatePython(): Promise<ValidationResult[]> {
  const results: ValidationResult[] = [];
  const pyDir = path.join(VALIDATION_DIR, "python");
  const manifest = loadManifest();

  if (!fs.existsSync(pyDir)) {
    console.log("  No Python files to validate");
    return results;
  }

  const files = await glob("*.py", { cwd: pyDir });

  for (const file of files) {
    const fullPath = path.join(pyDir, file);
    const block = manifest.blocks.find(
      (b) => b.outputFile === `python/${file}`,
    );
    const errors: string[] = [];

    // Syntax check with py_compile
    try {
      execFileSync("python3", ["-m", "py_compile", fullPath], {
        encoding: "utf-8",
      });
    } catch (err: any) {
      errors.push(err.stdout || err.stderr || err.message || "Syntax error");
    }

    // Type check with mypy (if available)
    if (errors.length === 0) {
      try {
        execFileSync(
          "python3",
          [
            "-m",
            "mypy",
            fullPath,
            "--ignore-missing-imports",
            "--no-error-summary",
          ],
          { encoding: "utf-8" },
        );
      } catch (err: any) {
        const output = err.stdout || err.stderr || err.message || "";
        // Filter out "Success" messages and notes
        const typeErrors = output
          .split("\n")
          .filter(
            (l: string) =>
              l.includes(": error:") &&
              !l.includes("Cannot find implementation"),
          );
        if (typeErrors.length > 0) {
          errors.push(...typeErrors);
        }
      }
    }