Function is_complete_example

ci/extract_cpp_doc_code.py:51–109

(code: str)

def is_complete_example(code: str) -> bool:
    # Check if the code block is a complete, runnable example.A complete example should have a main function with all code inside it.
    # Code blocks with statements outside of functions are not complete examples.
    has_main = "int main()" in code or "int main (" in code

    # Check if there are statements outside of any function
    # look for lines that look like function calls
    # or object declarations at the top level
    lines = code.split("\n")
    brace_depth = 0
    in_main = False

    for line in lines:
        stripped = line.strip()
        if not stripped or stripped.startswith("//"):
            continue

        # Track braces
        for char in stripped:
            if char == "{":
                brace_depth += 1
            elif char == "}":
                brace_depth -= 1

        # Check if entering main
        if "int main" in stripped:
            in_main = True
            continue

        # If code is not inside any braces and not in a struct/class declaration,
        # and we see what looks like a function call or object usage,
        # this is a uncompleted example
        if brace_depth == 0 and not in_main:
            # Skip struct/class/enum declarations
            if any(
                keyword in stripped
                for keyword in [
                    "struct ",
                    "class ",
                    "enum ",
                    "using ",
                    "namespace ",
                    "#include",
                    "FORY_STRUCT",
                    "FORY_ENUM",
                ]
            ):
                continue
            # Skip forward declarations
            if stripped.endswith(";"):
                continue
            # If we see code that looks like it's executing (not declaring),
            # this is not a complete example
            if re.search(r"\w+\s*\([^)]*\)\s*;", stripped) and not re.search(
                r"^(struct|class|enum|using|namespace|#include|FORY_)", stripped
            ):
                return False