No interfaces found.
"
return f"{index} | {esc(network['ssid'])}{connected_label} | {signal} | "
f"{esc(network.get('channel'))} | {esc(network.get('frequency_mhz'))} MHz | {esc(network['security'])} | {esc(network['bssid'])} | "
)
network_rows = "".join(network_rows)
if network_rows:
wifi_body = "| # | SSID | Signal | Channel | Frequency | Security | BSSID |
|---|
" + network_rows + "
{esc(report['scan_note'] or 'No Wi-Fi networks found.')}
"
return (
""
"Network Diagnostic Report"
""
f""
+ interface_section("Physical Ethernet interfaces", report["physical_ethernet"])
+ interface_section("Physical Wi-Fi interfaces", report["physical_wifi"])
+ f"Top 10 Wi-Fi networks in range
Sorted by strongest signal · {esc(report['scan_source'] or 'no scan source')}
{wifi_body}"
+ interface_section("Virtual interfaces", report["virtual_interfaces"])
+ "\n"
)
def ask(prompt, default):
try:
answer = input(f"{prompt} [{default}]: ").strip()
except EOFError:
return default
return answer or default
def ask_yes_no(prompt, default):
marker = "Y/n" if default else "y/N"
try:
answer = input(f"{prompt} [{marker}]: ").strip().lower()
except EOFError:
return default
if not answer:
return default
return answer in ("y", "yes")
def infer_format(path, requested):
if requested:
return requested
suffix = pathlib.Path(path).suffix.lower().lstrip(".")
return suffix if suffix in ("txt", "json", "html") else "txt"
def render_report(report, format_name):
if format_name == "json":
return json.dumps(report, ensure_ascii=False, indent=2) + "\n"
if format_name == "html":
return render_html(report)
return render_text(report)
def save_report(path_text, format_name, force, interactive, report):
path = pathlib.Path(path_text).expanduser()
if not path.parent.exists() or not path.parent.is_dir():
raise OSError(f"output directory does not exist: {path.parent}")
if path.exists() and not force:
if not interactive or not ask_yes_no(f"{path} already exists. Overwrite it?", False):
return False
rendered = render_report(report, format_name)
temporary = None
try:
with tempfile.NamedTemporaryFile("w", encoding="utf-8", dir=path.parent, delete=False) as output:
temporary = pathlib.Path(output.name)
output.write(rendered)
os.replace(temporary, path)
finally:
if temporary is not None and temporary.exists():
temporary.unlink()
print(f"Report saved: {path}", file=sys.stderr)
return True
def main():
output_path, requested_format, force_value = sys.argv[1:4]
force = force_value == "1"
interactive = sys.stdin.isatty() and sys.stdout.isatty()
report = collect_report()
text_report = render_text(report)
if output_path:
format_name = infer_format(output_path, requested_format)
if not save_report(output_path, format_name, force, interactive, report):
print("Report not written; existing file was not overwritten.", file=sys.stderr)
return 1 if not interactive else 0
return 0
if not interactive:
print(render_report(report, requested_format or "txt"), end="")
return 0
print(render_text(report, color=sys.stdout.isatty() and "NO_COLOR" not in os.environ), end="")
if not ask_yes_no("Save this report to a file?", True):
return 0
format_name = requested_format or ask("Report format (txt/json/html)", "txt").lower()
if format_name not in ("txt", "json", "html"):
print("Unsupported format; using txt.", file=sys.stderr)
format_name = "txt"
default_path = str(pathlib.Path.home() / f"report.{format_name}")
path = ask("Output path", default_path)
if not save_report(path, format_name, force, interactive, report):
print("Report not written; existing file was not overwritten.", file=sys.stderr)
return 0
try:
raise SystemExit(main())
except (OSError, RuntimeError, json.JSONDecodeError) as error:
print(f"Error: {error}", file=sys.stderr)
raise SystemExit(1)
PYCODE
)" "$OUTPUT_PATH" "$OUTPUT_FORMAT" "$FORCE"