从高级工程师到独立游戏创业者：用工程化流水线撑起 5 年 10 款作品

{
  "id": "puzzle-001",
  "title": "The First Door",
  "grid": [
    "....",
    ".##.",
    "...."
  ],
  "solution": ["UP", "RIGHT", "DOWN"]
}

import json
import sys
from pathlib import Path

ALLOWED_CELLS = {".", "#"}
REQUIRED_FIELDS = {
    "id": str,
    "title": str,
    "grid": list,
    "solution": list,
}


def validate_file(path: Path) -> list[str]:
    errors = []

    try:
        data = json.loads(path.read_text(encoding="utf-8"))
    except (OSError, json.JSONDecodeError) as exc:
        return [f"cannot read valid JSON: {exc}"]

    for field, expected_type in REQUIRED_FIELDS.items():
        if field not in data:
            errors.append(f"missing field: {field}")
        elif not isinstance(data[field], expected_type):
            errors.append(f"{field} must be {expected_type.__name__}")

    grid = data.get("grid")
    if isinstance(grid, list):
        if not grid:
            errors.append("grid must not be empty")
        elif not all(isinstance(row, str) and row for row in grid):
            errors.append("every grid row must be a non-empty string")
        else:
            width = len(grid[0])
            if any(len(row) != width for row in grid):
                errors.append("all grid rows must have the same width")

            invalid = sorted({cell for row in grid for cell in row} - ALLOWED_CELLS)
            if invalid:
                errors.append(f"unsupported grid cells: {invalid}")

    solution = data.get("solution")
    if isinstance(solution, list) and not all(isinstance(step, str) for step in solution):
        errors.append("every solution step must be a string")

    return errors


def main() -> int:
    root = Path(sys.argv[1] if len(sys.argv) > 1 else "content")
    files = sorted(root.glob("*.json"))

    if not files:
        print(f"No JSON files found in {root}")
        return 1

    failed = False
    seen_ids = set()

    for path in files:
        errors = validate_file(path)
        if not errors:
            data = json.loads(path.read_text(encoding="utf-8"))
            puzzle_id = data["id"]
            if puzzle_id in seen_ids:
                errors.append(f"duplicate id: {puzzle_id}")
            seen_ids.add(puzzle_id)

        if errors:
            failed = True
            print(f"FAIL {path}")
            for error in errors:
                print(f"  - {error}")
        else:
            print(f"OK   {path}")

    return 1 if failed else 0


if __name__ == "__main__":
    raise SystemExit(main())

python validate_content.py content