Function format_todo_list

scripts/update_lib/cmd_todo.py:450–526

Format todo list for display. Args: todo_list: List from compute_todo_list() test_by_lib: Dict mapping lib_name -> list of test infos (optional) limit: Maximum number of items to show verbose: Show detailed dependency information Returns: List of for

(
    todo_list: list[dict],
    test_by_lib: dict[str, list[dict]] | None = None,
    limit: int | None = None,
    verbose: bool = False,
)

def format_todo_list(
    todo_list: list[dict],
    test_by_lib: dict[str, list[dict]] | None = None,
    limit: int | None = None,
    verbose: bool = False,
) -> list[str]:
    """Format todo list for display.

    Args:
        todo_list: List from compute_todo_list()
        test_by_lib: Dict mapping lib_name -> list of test infos (optional)
        limit: Maximum number of items to show
        verbose: Show detailed dependency information

    Returns:
        List of formatted lines
    """
    lines = []

    if limit:
        todo_list = todo_list[:limit]

    for item in todo_list:
        name = item["name"]
        score = item["score"]
        total_deps = item["total_deps"]
        rev_count = item["reverse_deps_count"]

        done_mark = "[x]" if item["up_to_date"] else "[ ]"

        if score == -1:
            score_str = "no deps"
        else:
            score_str = f"{score}/{total_deps} deps"

        rev_str = f"{rev_count} dependents" if rev_count else ""

        parts = ["-", done_mark, f"[{score_str}]", f"`{name}`"]
        if rev_str:
            parts.append(f"({rev_str})")

        line = " ".join(parts) + _format_meta_suffix(item)
        lines.append(line)

        # Show hard_deps:
        # - Normal mode: only show if lib is up-to-date but hard_deps are not
        # - Verbose mode: always show all hard_deps with their status
        hard_deps_status = item.get("hard_deps_status", {})
        if verbose and hard_deps_status:
            for hd in sorted(hard_deps_status.keys()):
                hd_mark = "[x]" if hard_deps_status[hd] else "[ ]"
                lines.append(f"  - {hd_mark} {hd} (hard_dep)")
        elif item["up_to_date"]:
            for hd, ok in sorted(hard_deps_status.items()):
                if not ok:
                    lines.append(f"  - [ ] {hd} (hard_dep)")

        # Show corresponding tests if exist