# SPDX-License-Identifier: GPL-2.0-only OR MIT
# Copyright (C) 2025 TNG Technology Consulting GmbH

from dataclasses import dataclass
import re

from sbom.path_utils import PathStr

INCBIN_PATTERN = re.compile(r'\s*\.incbin\s+"(?P<path>[^"]+)"')
"""Regex pattern for matching `.incbin "<path>"` statements."""


@dataclass
class IncbinStatement:
    """A parsed `.incbin "<path>"` directive."""

    path: PathStr
    """path to the file referenced by the `.incbin` directive."""

    full_statement: str
    """Full `.incbin "<path>"` statement as it originally appeared in the file."""


def parse_incbin_statements(absolute_path: PathStr) -> list[IncbinStatement]:
    """
    Parses `.incbin` directives from an `.S` assembly file.

    Args:
        absolute_path: Absolute path to the `.S` assembly file.

    Returns:
        list[IncbinStatement]: Parsed `.incbin` statements.
    """
    with open(absolute_path, "rt", encoding="utf-8") as f:
        content = f.read()
    return [
        IncbinStatement(
            path=match.group("path"),
            full_statement=match.group(0).strip(),
        )
        for match in INCBIN_PATTERN.finditer(content)
    ]