Function _parse_file

Scripts/parse_headers.py:313–413

Main parse loop. Walks source sequentially, building up ParsedClass/ParsedEnum objects. Strategy: find UCLASS/USTRUCT/UENUM blocks, then scan the body for UPROPERTY/UFUNCTION.

(source: str, result: ParsedFile)

def _parse_file(source: str, result: ParsedFile):
    """
    Main parse loop. Walks source sequentially, building up ParsedClass/ParsedEnum objects.
    Strategy: find UCLASS/USTRUCT/UENUM blocks, then scan the body for UPROPERTY/UFUNCTION.
    """
    # ── 1. Find all UENUM blocks ──────────────────────────────────────────────
    enum_macro_re = re.compile(r'(?:/\*\*((?:(?!\*/).)*?)\*/\s*)?UENUM\s*\((.*?)\)\s*enum\s+class\s+(\w+)[^{]*\{', re.DOTALL)
    for m in enum_macro_re.finditer(source):
        raw_doc = m.group(1) or ''
        spec_str = m.group(2) or ''
        enum_name = m.group(3)
        brief, desc = _clean_doc_comment(raw_doc)
        specs = _parse_specifiers(spec_str)

        # Extract body
        body_start = m.end()
        body = _extract_to_closing_brace(source, body_start - 1)

        enm = ParsedEnum(
            name=enum_name,
            specifiers=specs,
            brief=brief,
            description=desc,
            is_blueprint_type=specs.get('BlueprintType', False) is True,
        )

        # Extract enum values
        for vm in _ENUM_VALUE_RE.finditer(body):
            vname = vm.group(1)
            if vname in ('GENERATED_BODY', 'GENERATED_USTRUCT_BODY'):
                continue
            display = vm.group(2) or vname
            enm.values.append(asdict(ParsedEnumValue(name=vname, display_name=display)))

        result.enums.append(asdict(enm))

    # ── 2. Find all UCLASS / USTRUCT blocks ───────────────────────────────────
    # Match: optional doc, then UCLASS/USTRUCT macro, then class/struct Name
    class_block_re = re.compile(
        r'(?:/\*\*((?:(?!\*/).)*?)\*/\s*)?'           # optional doc comment
        r'(UCLASS|USTRUCT)\s*\((.*?)\)\s*'  # UCLASS/USTRUCT macro
        r'(?:class|struct)\s+(?:\w+_API\s+)?(\w+)'  # class/struct Name
        r'(?:\s*:\s*(?:public\s+)?(\w+))?'         # optional : public Parent
        r'\s*\{',                                    # opening brace
        re.DOTALL
    )
    for m in class_block_re.finditer(source):
        raw_doc = m.group(1) or ''
        macro = m.group(2)
        spec_str = m.group(3) or ''
        cls_name = m.group(4)
        parent = m.group(5) or ''
        brief, desc = _clean_doc_comment(raw_doc)
        specs = _parse_specifiers(spec_str)

        # Extract class body
        body_start = m.end()
        body = _extract_to_closing_brace(source, body_start - 1)