|
- """normalize.py
-
- Helper per normalizzare i MAC address in due formati:
-
- - compact: 12 hex uppercase senza separatori (es: AC233FC1DD3C)
- - colon: 6 byte separati da ":" (es: AC:23:3F:C1:DD:3C)
-
- Nota: nel progetto usiamo **compact** come chiave interna per fare matching tra:
- - gateway.csv (spesso con i ":")
- - topic MQTT (publish_out/<gw> in genere senza ":")
- - payload JSON (mac beacon/gateway spesso senza ":")
-
- Il formato colon rimane utile solo per *rendering* (es: header CSV).
- """
-
- from __future__ import annotations
-
- import re
-
- _HEX_ONLY = re.compile(r"[^0-9A-Fa-f]")
-
-
- def mac_to_compact(mac: object) -> str:
- """Ritorna 12 hex uppercase senza separatori."""
- if mac is None:
- return ""
- s = _HEX_ONLY.sub("", str(mac)).upper()
- if len(s) == 12:
- return s
- if len(s) > 12:
- # se arriva qualcosa di più lungo (es. UUID), prendiamo gli ultimi 12
- return s[-12:]
- return s
-
-
- def compact_to_colon(mac12: object) -> str:
- """Converte 'AC233FC1DD3C' -> 'AC:23:3F:C1:DD:3C'."""
- s = mac_to_compact(mac12)
- if len(s) != 12:
- return s
- return ":".join(s[i : i + 2] for i in range(0, 12, 2))
-
-
- def norm_mac(mac: object) -> str:
- """Alias storico: ritorna il formato con ':'."""
- return compact_to_colon(mac)
|
