How to Parse Taskfile YAML in Python

import yaml
from pathlib import Path

def load_taskfile(taskfile_path: str) -> dict:
    """Load and parse a Taskfile.yaml file into a dict."""
    data = Path(taskfile_path).read_text()
    return yaml.safe_load(data)

def run_task(taskfile: dict, task_name: str) -> dict:
    """Simulate running a task by returning its metadata."""
    tasks = taskfile.get("tasks", {})
    task = tasks.get(task_name)
    if task is None:
        raise KeyError(f"Task '{task_name}' not found")
    return task

def execute_tasks(taskfile: dict, task_list: list[str]) -> list[str]:
    """Run a list of tasks and return their commands."""
    results = []
    for name in task_list:
        task = run_task(taskfile, name)
        cmd = task.get("cmds", task.get("command", "echo no-op"))
        results.append(f"{name}: {cmd}")
    return results

if __name__ == "__main__":
    taskfile = {
        "version": "3",
        "tasks": {
            "build": {"cmds": ["go build"], "desc": "Build app"},
            "test": {"cmds": ["go test ./..."], "depends_on": ["build"]},
            "lint": {"command": "golangci-lint run"},
        },
    }
    output = execute_tasks(taskfile, ["test", "lint"])
    print("\n".join(output))