Function normalize_submodule_declarations

src/harness/submodules/loader.py:9–37

Normalize submodule declarations from YAML data to a standard format.

(
    yaml_data: Dict[str, Any],
    yaml_file_path: str,
)

def normalize_submodule_declarations(
    yaml_data: Dict[str, Any],
    yaml_file_path: str,
) -> List[Dict[str, Any]]:
    """Normalize submodule declarations from YAML data to a standard format."""
    submodules = yaml_data.get("submodules", [])
    if not submodules:
        return []
    if isinstance(submodules, dict):
        submodules = [{"name": name, "path": path} for name, path in submodules.items()]
    if not isinstance(submodules, list):
        raise ValueError("submodules must be a list or mapping")

    base_dir = Path(yaml_file_path).resolve().parent
    normalized = []
    for entry in submodules:
        if isinstance(entry, str):
            entry = {"path": entry}
        if not isinstance(entry, dict):
            raise ValueError("Each submodule entry must be a mapping or string path")
        name = entry.get("name")
        path = entry.get("path") or entry.get("file") or entry.get("filepath")
        if not path:
            raise ValueError("Submodule entry must include a file path")
        module_path = (
            str((base_dir / path).resolve()) if not os.path.isabs(path) else path
        )
        normalized.append({"name": name, "path": module_path})
    return normalized


def parse_submodule_function_declaration(