#!/usr/bin/env python3 """Summarize saved iperf3 client JSON; no dependencies, no lab connections.""" import argparse import csv import json import sys from pathlib import Path def main(): parser = argparse.ArgumentParser(description=__doc__) parser.add_argument('files', nargs='+', type=Path) args = parser.parse_args() writer = csv.writer(sys.stdout) writer.writerow(['file', 'protocol', 'receiver_Mbps', 'retransmits', 'jitter_ms', 'lost_percent']) for path in args.files: data = json.loads(path.read_text()) if 'error' in data: raise SystemExit(f'{path}: {data["error"]}') protocol = data['start']['test_start']['protocol'] end = data['end'] if protocol == 'TCP': receiver = end['sum_received'] sender = end['sum_sent'] writer.writerow([path.name, protocol, receiver['bits_per_second']/1e6, sender.get('retransmits', ''), '', '']) else: # iperf3 3.12 client sum/stream UDP figures can describe the sender. # Prefer explicit receiver summaries, then receiver stream records. receiver = end.get('sum_received') if receiver is None: candidates = [s['udp'] for s in end.get('streams', []) if 'udp' in s and s['udp'].get('sender') is False] receiver = candidates[0] if len(candidates) == 1 else None if receiver is None: receiver = end.get('sum') if not receiver or receiver.get('sender') is True: raise SystemExit(f'{path}: receiver UDP summary unavailable; use server JSON') writer.writerow([path.name, protocol, receiver['bits_per_second']/1e6, '', receiver.get('jitter_ms', ''), receiver.get('lost_percent', '')]) if __name__ == '__main__': main()