Function main

ci/bloat.py:248–321

()

def main() -> int:
    parser = argparse.ArgumentParser(
        description="Per-symbol flash/RAM bloat analysis for FastLED builds."
    )
    parser.add_argument(
        "board",
        help="Board name (esp32s3, esp32, esp32c3, ...). "
        "See BOARD_CHIP_MAP in ci/bloat.py to add a new target.",
    )
    parser.add_argument(
        "--example",
        default="Blink",
        help="Example whose build to analyze (default: Blink).",
    )
    parser.add_argument(
        "--top",
        type=int,
        default=10,
        help="Top-N symbols to print in the summary (default: 10).",
    )
    parser.add_argument(
        "--no-summary",
        action="store_true",
        help="Skip the stdout summary; just write the JSON + MD artifacts.",
    )
    parser.add_argument(
        "--build",
        action="store_true",
        help="Run `bash compile <board> --examples <example> --platformio` "
        "first to produce a fresh ELF.",
    )
    parser.add_argument(
        "--build-root",
        default=".build",
        help="Build output root (default: .build).",
    )
    args = parser.parse_args()

    project_root = Path(__file__).resolve().parent.parent
    os.chdir(project_root)

    assert_fbuild_has_symbols()

    if args.build:
        compile_script = "compile.bat" if os.name == "nt" else "./compile"
        if os.name != "nt" and not shutil.which("bash"):
            raise SystemExit("bash not on PATH; cannot --build")
        cmd = [
            compile_script,
            args.board,
            "--examples",
            args.example,
            "--platformio",
        ]
        print(f"$ {' '.join(cmd)}")
        subprocess.run(cmd, check=True)

    nm = resolve_nm(args.board)