Mirror/intercept
1
0
Fork 0
mirror of https://github.com/smittix/intercept.git synced 2026-07-14 20:48:11 -07:00
Code Issues Packages Projects Releases Wiki Activity

style: apply ruff-format to entire codebase

Browse Source 
First-time run of ruff-format via pre-commit hook normalises quote
style, trailing commas, and whitespace across 188 Python files.
No logic changes.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
James Smith
2026-07-05 14:48:11 +01:00
parent 82e64104fe
commit 96172ca593
189 changed files with 19883 additions and 19552 deletions
Download Patch File Download Diff File Expand all files Collapse all files
utils/acars_translator.py
+199 -182
View File
@@ -8,163 +8,183 @@ import re
# Sources: ARINC 618, ARINC 620, airline implementations
ACARS_LABELS: dict[str, str] = {
# Position & navigation
'H1': 'Position report (HF data link)',
'H2': 'Weather report',
'5Z': 'OOOI (gate times)',
'15': 'Departure report',
'16': 'Arrival report',
'20': 'Position report',
'22': 'Fuel report',
'2Z': 'Off-gate report',
'30': 'Progress report',
'44': 'Weather request',
'80': 'Free text (3-char header)',
'83': 'Free text',
'8E': 'ATIS request',
"H1": "Position report (HF data link)",
"H2": "Weather report",
"5Z": "OOOI (gate times)",
"15": "Departure report",
"16": "Arrival report",
"20": "Position report",
"22": "Fuel report",
"2Z": "Off-gate report",
"30": "Progress report",
"44": "Weather request",
"80": "Free text (3-char header)",
"83": "Free text",
"8E": "ATIS request",
# Engine & performance
'DF': 'Engine data / DFDR',
'D3': 'Engine exceedance',
'D6': 'Engine trend data',
"DF": "Engine data / DFDR",
"D3": "Engine exceedance",
"D6": "Engine trend data",
# ATS / air traffic services
'B1': 'ATC request',
'B2': 'ATC clearance',
'B3': 'ATC comm test',
'B6': 'ATC departure clearance',
'B9': 'ATC message',
'BA': 'ATC advisory',
'BB': 'ATC response',
"B1": "ATC request",
"B2": "ATC clearance",
"B3": "ATC comm test",
"B6": "ATC departure clearance",
"B9": "ATC message",
"BA": "ATC advisory",
"BB": "ATC response",
# CPDLC (Controller-Pilot Data Link Communications)
'AA': 'CPDLC message',
'AB': 'CPDLC response',
'A0': 'CPDLC uplink',
'A1': 'CPDLC downlink',
'A2': 'CPDLC connection request',
'A3': 'CPDLC logon/logoff',
'A6': 'CPDLC message',
'A7': 'CPDLC response',
'AT': 'CPDLC transfer',
"AA": "CPDLC message",
"AB": "CPDLC response",
"A0": "CPDLC uplink",
"A1": "CPDLC downlink",
"A2": "CPDLC connection request",
"A3": "CPDLC logon/logoff",
"A6": "CPDLC message",
"A7": "CPDLC response",
"AT": "CPDLC transfer",
# Handshake & link management
'_d': 'Demand mode (link test)',
'Q0': 'Link test',
'QA': 'Link test reply',
'QB': 'Acknowledgement',
'QC': 'Link request',
'QD': 'Link accept',
'QE': 'Link reject',
'QF': 'Squitter / heartbeat',
'QG': 'Abort',
'QH': 'Version request',
'QK': 'Mode change',
'QM': 'Link verification',
'QN': 'Media advisory',
'QP': 'Polling',
'QQ': 'Status',
'QR': 'General response',
'QS': 'System table request',
'QT': 'System table',
'QX': 'Frequency change',
"_d": "Demand mode (link test)",
"Q0": "Link test",
"QA": "Link test reply",
"QB": "Acknowledgement",
"QC": "Link request",
"QD": "Link accept",
"QE": "Link reject",
"QF": "Squitter / heartbeat",
"QG": "Abort",
"QH": "Version request",
"QK": "Mode change",
"QM": "Link verification",
"QN": "Media advisory",
"QP": "Polling",
"QQ": "Status",
"QR": "General response",
"QS": "System table request",
"QT": "System table",
"QX": "Frequency change",
# Squawk & surveillance
'SQ': 'Squawk assignment',
'SA': 'Surveillance data',
'S1': 'ADS-C report',
"SQ": "Squawk assignment",
"SA": "Surveillance data",
"S1": "ADS-C report",
# Airline operations
'C1': 'Crew scheduling',
'C2': 'Crew response',
'C3': 'Crew message',
'C4': 'Crew query',
'10': 'Delay message',
'12': 'Clearance request',
'17': 'Cargo/load data',
'4T': 'TWIP (terminal weather)',
'4X': 'Connectivity test',
'50': 'Weather observation',
'51': 'METAR/TAF request',
'52': 'METAR/TAF response',
'54': 'SIGMET / AIRMET',
'70': 'Maintenance report',
'7A': 'Fault message',
'7B': 'Fault clear',
'F3': 'Flight plan',
'F5': 'Flight plan amendment',
'F6': 'Route request',
'F7': 'Route clearance',
'RA': 'ATIS report',
'RB': 'ATIS request',
"C1": "Crew scheduling",
"C2": "Crew response",
"C3": "Crew message",
"C4": "Crew query",
"10": "Delay message",
"12": "Clearance request",
"17": "Cargo/load data",
"4T": "TWIP (terminal weather)",
"4X": "Connectivity test",
"50": "Weather observation",
"51": "METAR/TAF request",
"52": "METAR/TAF response",
"54": "SIGMET / AIRMET",
"70": "Maintenance report",
"7A": "Fault message",
"7B": "Fault clear",
"F3": "Flight plan",
"F5": "Flight plan amendment",
"F6": "Route request",
"F7": "Route clearance",
"RA": "ATIS report",
"RB": "ATIS request",
}
# Message type classification for UI colour coding
MESSAGE_TYPES = {
'position', 'engine_data', 'weather', 'ats', 'handshake',
'oooi', 'squawk', 'link_test', 'cpdlc', 'other',
"position",
"engine_data",
"weather",
"ats",
"handshake",
"oooi",
"squawk",
"link_test",
"cpdlc",
"other",
}
def translate_label(label: str | None) -> str:
"""Return human-readable description for an ACARS label code."""
if not label:
return 'Unknown label'
return "Unknown label"
label = label.strip()
if label in ACARS_LABELS:
return ACARS_LABELS[label]
# Check for Q-prefix group
if len(label) == 2 and label.startswith('Q'):
return f'Link management ({label})'
return f'Label {label}'
if len(label) == 2 and label.startswith("Q"):
return f"Link management ({label})"
return f"Label {label}"
def classify_message_type(label: str | None, text: str | None = None) -> str:
"""Classify an ACARS message into a canonical type for UI display."""
if not label:
return 'other'
return "other"
label = label.strip()
# Position reports
if label in ('H1', '20', '15', '16', '30', 'S1'):
return 'position'
if text and '#M1BPOS' in text:
return 'position'
if label in ("H1", "20", "15", "16", "30", "S1"):
return "position"
if text and "#M1BPOS" in text:
return "position"
# Engine / DFDR data
if label in ('DF', 'D3', 'D6'):
return 'engine_data'
if label in ("DF", "D3", "D6"):
return "engine_data"
# Weather
if label in ('H2', '44', '50', '51', '52', '54', '4T'):
return 'weather'
if label in ("H2", "44", "50", "51", "52", "54", "4T"):
return "weather"
# ATS / ATC
if label.startswith('B') and len(label) == 2:
return 'ats'
if label.startswith("B") and len(label) == 2:
return "ats"
# CPDLC
if label in ('AA', 'AB', 'A0', 'A1', 'A2', 'A3', 'A6', 'A7', 'AT'):
return 'cpdlc'
if label in ("AA", "AB", "A0", "A1", "A2", "A3", "A6", "A7", "AT"):
return "cpdlc"
# OOOI (Out/Off/On/In gate times)
if label in ('5Z', '2Z'):
return 'oooi'
if label in ("5Z", "2Z"):
return "oooi"
# Squawk
if label in ('SQ', 'SA'):
return 'squawk'
if label in ("SQ", "SA"):
return "squawk"
# Link test / handshake
if label in ('Q0', 'QA', 'QB', 'QC', 'QD', 'QE', 'QF', 'QG',
'QH', 'QK', 'QM', 'QN', 'QP', 'QQ', 'QR', 'QS', 'QT', 'QX',
'4X'):
return 'link_test'
if label in (
"Q0",
"QA",
"QB",
"QC",
"QD",
"QE",
"QF",
"QG",
"QH",
"QK",
"QM",
"QN",
"QP",
"QQ",
"QR",
"QS",
"QT",
"QX",
"4X",
):
return "link_test"
# Handshake (_d is demand mode)
if label == '_d':
return 'handshake'
if label == "_d":
return "handshake"
return 'other'
return "other"
def parse_position_report(text: str | None) -> dict | None:
@@ -185,13 +205,13 @@ def parse_position_report(text: str | None) -> dict | None:
# Look for BPOS block
bpos_match = re.search(
r'#M\d[A-Z]*POS'
r'([NS])(\d{2,5})([EW])(\d{3,6})'
r',([^,]*),(\d{4,6})'
r',(\d{2,3})'
r'(?:,([NS]\d{2,5}[EW]\d{3,6}))?'
r'(?:,([A-Z]{3,4}))?',
text
r"#M\d[A-Z]*POS"
r"([NS])(\d{2,5})([EW])(\d{3,6})"
r",([^,]*),(\d{4,6})"
r",(\d{2,3})"
r"(?:,([NS]\d{2,5}[EW]\d{3,6}))?"
r"(?:,([A-Z]{3,4}))?",
text,
)
if bpos_match:
lat_dir, lat_val, lon_dir, lon_val = bpos_match.group(1, 2, 3, 4)
@@ -202,7 +222,7 @@ def parse_position_report(text: str | None) -> dict | None:
lat = lat_deg + lat_min / 60
else:
lat = float(lat_val)
if lat_dir == 'S':
if lat_dir == "S":
lat = -lat
if len(lon_val) >= 5:
@@ -211,22 +231,22 @@ def parse_position_report(text: str | None) -> dict | None:
lon = lon_deg + lon_min / 60
else:
lon = float(lon_val)
if lon_dir == 'W':
if lon_dir == "W":
lon = -lon
result['lat'] = round(lat, 4)
result['lon'] = round(lon, 4)
result['waypoint'] = bpos_match.group(5).strip() if bpos_match.group(5) else None
result['time'] = bpos_match.group(6)
result['flight_level'] = f"FL{bpos_match.group(7)}"
result["lat"] = round(lat, 4)
result["lon"] = round(lon, 4)
result["waypoint"] = bpos_match.group(5).strip() if bpos_match.group(5) else None
result["time"] = bpos_match.group(6)
result["flight_level"] = f"FL{bpos_match.group(7)}"
if bpos_match.group(9):
result['destination'] = bpos_match.group(9)
result["destination"] = bpos_match.group(9)
# Look for temperature (e.g., /TS-045 or M045)
temp_match = re.search(r'/TS([MP]?)(\d{2,3})', text)
temp_match = re.search(r"/TS([MP]?)(\d{2,3})", text)
if temp_match:
sign = '-' if temp_match.group(1) == 'M' else ''
result['temperature'] = f"{sign}{temp_match.group(2)} C"
sign = "-" if temp_match.group(1) == "M" else ""
result["temperature"] = f"{sign}{temp_match.group(2)} C"
return result if result else None
@@ -243,30 +263,30 @@ def parse_engine_data(text: str | None) -> dict | None:
result: dict = {}
engine_keys = {
'SM': 'Source mode',
'AC0': 'Eng 1 N2 (%)',
'AC1': 'Eng 2 N2 (%)',
'FL': 'Flight level',
'FU': 'Fuel used (lbs)',
'ES': 'EGT spread',
'BA': 'Bleed air',
'CO': 'Config',
'AO': 'Auto',
'EGT': 'Exhaust gas temp',
'OIT': 'Oil temp',
'OIP': 'Oil pressure',
'N1': 'N1 (%)',
'N2': 'N2 (%)',
'FF': 'Fuel flow',
'VIB': 'Vibration',
"SM": "Source mode",
"AC0": "Eng 1 N2 (%)",
"AC1": "Eng 2 N2 (%)",
"FL": "Flight level",
"FU": "Fuel used (lbs)",
"ES": "EGT spread",
"BA": "Bleed air",
"CO": "Config",
"AO": "Auto",
"EGT": "Exhaust gas temp",
"OIT": "Oil temp",
"OIP": "Oil pressure",
"N1": "N1 (%)",
"N2": "N2 (%)",
"FF": "Fuel flow",
"VIB": "Vibration",
}
# Match KEY/VALUE or KEY VALUE patterns
for key, desc in engine_keys.items():
pattern = rf'\b{re.escape(key)}[/: ]?\s*([+-]?\d+\.?\d*)'
pattern = rf"\b{re.escape(key)}[/: ]?\s*([+-]?\d+\.?\d*)"
m = re.search(pattern, text)
if m:
result[key] = {'value': m.group(1), 'description': desc}
result[key] = {"value": m.group(1), "description": desc}
return result if result else None
@@ -279,26 +299,26 @@ def parse_weather_data(text: str | None) -> dict | None:
result: dict = {}
# Wind: direction/speed (e.g., 270/15 or WND270015)
wind_match = re.search(r'(?:WND|WIND)\s*(\d{3})[/ ]?(\d{2,3})', text)
wind_match = re.search(r"(?:WND|WIND)\s*(\d{3})[/ ]?(\d{2,3})", text)
if wind_match:
result['wind_dir'] = f"{wind_match.group(1)} deg"
result['wind_speed'] = f"{wind_match.group(2)} kts"
result["wind_dir"] = f"{wind_match.group(1)} deg"
result["wind_speed"] = f"{wind_match.group(2)} kts"
# Airport codes (3-4 letter ICAO)
airports = re.findall(r'\b([A-Z]{3,4})\b', text)
airports = re.findall(r"\b([A-Z]{3,4})\b", text)
if airports:
result['airports'] = list(dict.fromkeys(airports))[:4]
result["airports"] = list(dict.fromkeys(airports))[:4]
# Temperature (e.g., T24/D18, TMP24, TEMP -5)
temp_match = re.search(r'(?:TMP|TEMP|T)\s*([MP+-]?\d{1,3})', text)
temp_match = re.search(r"(?:TMP|TEMP|T)\s*([MP+-]?\d{1,3})", text)
if temp_match:
val = temp_match.group(1).replace('M', '-').replace('P', '')
result['temperature'] = f"{val} C"
val = temp_match.group(1).replace("M", "-").replace("P", "")
result["temperature"] = f"{val} C"
# Visibility
vis_match = re.search(r'VIS\s*(\d+(?:\.\d+)?)', text)
vis_match = re.search(r"VIS\s*(\d+(?:\.\d+)?)", text)
if vis_match:
result['visibility'] = f"{vis_match.group(1)} SM"
result["visibility"] = f"{vis_match.group(1)} SM"
return result if result else None
@@ -315,27 +335,24 @@ def parse_oooi(text: str | None) -> dict | None:
result: dict = {}
# Try to find airport pair + 4 time blocks
oooi_match = re.search(
r'([A-Z]{3,4})\s+([A-Z]{3,4})\s+(\d{4})\s+(\d{4})\s+(\d{4})\s+(\d{4})',
text
)
oooi_match = re.search(r"([A-Z]{3,4})\s+([A-Z]{3,4})\s+(\d{4})\s+(\d{4})\s+(\d{4})\s+(\d{4})", text)
if oooi_match:
result['origin'] = oooi_match.group(1)
result['destination'] = oooi_match.group(2)
result['out'] = oooi_match.group(3)
result['off'] = oooi_match.group(4)
result['on'] = oooi_match.group(5)
result['in'] = oooi_match.group(6)
result["origin"] = oooi_match.group(1)
result["destination"] = oooi_match.group(2)
result["out"] = oooi_match.group(3)
result["off"] = oooi_match.group(4)
result["on"] = oooi_match.group(5)
result["in"] = oooi_match.group(6)
return result
# Try partial (just origin/destination and some times)
partial = re.search(r'([A-Z]{3,4})\s+([A-Z]{3,4})', text)
partial = re.search(r"([A-Z]{3,4})\s+([A-Z]{3,4})", text)
if partial:
result['origin'] = partial.group(1)
result['destination'] = partial.group(2)
result["origin"] = partial.group(1)
result["destination"] = partial.group(2)
times = re.findall(r'\b(\d{4})\b', text)
labels = ['out', 'off', 'on', 'in']
times = re.findall(r"\b(\d{4})\b", text)
labels = ["out", "off", "on", "in"]
for i, t in enumerate(times[:4]):
result[labels[i]] = t
@@ -351,24 +368,24 @@ def translate_message(msg: dict) -> dict:
Returns:
Dict with 'label_description', 'message_type', 'parsed'.
"""
label = msg.get('label')
text = msg.get('text') or msg.get('msg') or ''
label = msg.get("label")
text = msg.get("text") or msg.get("msg") or ""
label_description = translate_label(label)
message_type = classify_message_type(label, text)
parsed: dict | None = None
if message_type == 'position' or (label == 'H1' and 'POS' in text.upper()):
if message_type == "position" or (label == "H1" and "POS" in text.upper()):
parsed = parse_position_report(text)
elif message_type == 'engine_data':
elif message_type == "engine_data":
parsed = parse_engine_data(text)
elif message_type == 'weather':
elif message_type == "weather":
parsed = parse_weather_data(text)
elif message_type == 'oooi':
elif message_type == "oooi":
parsed = parse_oooi(text)
return {
'label_description': label_description,
'message_type': message_type,
'parsed': parsed,
"label_description": label_description,
"message_type": message_type,
"parsed": parsed,
}