Function print_instances

misc/python/materialize/scratch.py:155–226

(
    ists: list[Instance],
    format: str = "table",
    numbered: bool = False,
    show_launched_by: bool = False,
)

def print_instances(
    ists: list[Instance],
    format: str = "table",
    numbered: bool = False,
    show_launched_by: bool = False,
) -> None:
    if format == "csv":
        # CSV is machine-readable: emit the full set of columns, unabridged.
        field_names = [
            "Name",
            "Instance ID",
            "Public IP Address",
            "Private IP Address",
            "Launched By",
            "Delete After",
            "State",
        ]
        if numbered:
            field_names = ["#"] + field_names
        w = csv.writer(sys.stdout)
        w.writerow(field_names)
        for idx, i in enumerate(ists, 1):
            t = tags(i)
            row = [
                name(t),
                i.instance_id,
                i.public_ip_address,
                i.private_ip_address,
                launched_by(t),
                delete_after(t),
                i.state["Name"],
            ]
            if numbered:
                row = [idx] + row
            w.writerow(row)
        return

    if format != "table":
        raise RuntimeError("Unknown format passed to print_instances")

    # Table is for humans: a compact subset that fits a default terminal.
    # Private IP is omitted (mssh connects by instance id, not IP) and the
    # owner only shown when listing instances beyond your own.
    headers = ["INSTANCE ID", "NAME", "STATE", "EXPIRES", "PUBLIC IP"]
    if show_launched_by:
        headers.append("LAUNCHED BY")
    if numbered:
        headers = ["#"] + headers
    rows = []
    for idx, i in enumerate(ists, 1):
        t = tags(i)
        state = i.state["Name"]
        # A dead instance has no meaningful expiry; don't show a future time.
        expires = (
            "-"
            if state in ("terminated", "shutting-down")
            else _format_expires(delete_after(t))
        )