Function process_markdown_file

ci/extract_cpp_doc_code.py:191–217

(md_path: Path, output_dir: Path)

def process_markdown_file(md_path: Path, output_dir: Path) -> List[Path]:
    # logging.info(f"Processing {md_path}")

    with open(md_path, "r", encoding="utf-8") as f:
        content = f.read()

    code_blocks = extract_cpp_code_blocks(content)
    logging.info(f"  Found {len(code_blocks)} C++ code blocks")

    generated_files = []

    for i, (code, line_num) in enumerate(code_blocks):
        if not is_complete_example(code):
            logging.debug(f"  Skipping incomplete example at line {line_num}")
            continue

        test_content = wrap_code_as_test(code, md_path.name, i)
        test_file_name = generate_test_file_name(md_path.name, i)
        test_path = output_dir / test_file_name

        with open(test_path, "w", encoding="utf-8") as f:
            f.write(test_content)

        generated_files.append(test_path)
        logging.info(f"  Generated {test_file_name}")

    return generated_files


def generate_bazel_build(test_files: List[Path], output_dir: Path) -> None: