Function output

knockpy/output.py:580–655

Render the compact summary table shown after a scan.

(results: Union[dict, List[dict], None], elapsed: Optional[timedelta] = None)

def output(results: Union[dict, List[dict], None], elapsed: Optional[timedelta] = None) -> None:
    """Render the compact summary table shown after a scan."""
    if not results:
        err_console.print("[yellow]No results to display.[/yellow]")
        return

    items = [results] if isinstance(results, dict) else results
    notes: List[str] = []

    table = _new_table(box_style=box.SIMPLE_HEAVY, show_header=True, header_style="bold cyan")
    table.add_column("Domain", style="cyan", width=SUMMARY_DOMAIN_WIDTH, min_width=SUMMARY_DOMAIN_WIDTH, max_width=SUMMARY_DOMAIN_WIDTH, no_wrap=True, overflow="ellipsis")
    table.add_column(
        "IP",
        style="white",
        width=SUMMARY_IP_WIDTH,
        min_width=SUMMARY_IP_WIDTH,
        max_width=SUMMARY_IP_WIDTH,
        no_wrap=False,
        overflow="fold",
    )
    table.add_column("HTTP", justify="center", width=SUMMARY_CODE_WIDTH, min_width=SUMMARY_CODE_WIDTH, max_width=SUMMARY_CODE_WIDTH, no_wrap=True)
    table.add_column("HTTPS", justify="center", width=SUMMARY_CODE_WIDTH, min_width=SUMMARY_CODE_WIDTH, max_width=SUMMARY_CODE_WIDTH, no_wrap=True)
    table.add_column("Cert", justify="center", width=SUMMARY_CERT_WIDTH, min_width=SUMMARY_CERT_WIDTH, max_width=SUMMARY_CERT_WIDTH, no_wrap=True)
    table.add_column("Expiry", justify="center", width=SUMMARY_EXPIRY_WIDTH, min_width=SUMMARY_EXPIRY_WIDTH, max_width=SUMMARY_EXPIRY_WIDTH, no_wrap=True)
    table.add_column("TLS", overflow="fold", no_wrap=False)
    table.add_column("Status", justify="center", width=SUMMARY_STATUS_WIDTH, min_width=SUMMARY_STATUS_WIDTH, max_width=SUMMARY_STATUS_WIDTH, no_wrap=True)

    for item in items:
        for note in (item.get("scan_notes") or []):
            if isinstance(note, str) and note and note not in notes:
                notes.append(note)

        ips = _format_ips_for_cell(item.get("ip") or [])

        http = item.get("http") or [None, None, None, None]
        https = item.get("https") or [None, None, None, None]
        cert = item.get("cert") or [None, None, None, None]

        http_code = "-" if len(http) < 1 or http[0] is None else str(http[0])
        https_code = "-" if len(https) < 1 or https[0] is None else str(https[0])

        cert_ok = cert[0]
        cert_text = "-"
        if cert_ok is True:
            cert_text = "[green]valid[/green]"
        elif cert_ok is False:
            cert_text = "[red]invalid[/red]"

        status = _status_text(http, https, cert)
        takeover = item.get("takeover") or {}
        takeover_status = str(takeover.get("status") or "").strip().lower()
        if takeover_status in {"possible", "likely"} and status == "ok":
            status = "warning"

        if status == "ok":
            status_text = "[green]ok[/green]"
        elif status == "warning":
            status_text = "[yellow]warning[/yellow]"