31 lines
1015 B
Python
31 lines
1015 B
Python
"""Small shared size-formatting helpers for CLI/agent output.
|
|
|
|
Sibling of ``hermes_cli.timefmt`` (same extraction rationale: a tiny purpose-named module
|
|
lightweight consumers can import without dragging in the CLI surface). Replaces six near-identical
|
|
private byte formatters.
|
|
|
|
Two in-repo formatters intentionally do NOT delegate here:
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
def format_bytes(n) -> str:
|
|
"""1234567 -> '1.2 MB' (B/KB/MB/GB/TB; integer bytes, one decimal above).
|
|
|
|
Accepts anything ``float()`` accepts; returns ``"?"`` for None or unparseable input so display
|
|
call sites never raise (contract inherited from doctor's original copy — its stats dict
|
|
tolerates None fields).
|
|
"""
|
|
try:
|
|
size = float(n)
|
|
except (TypeError, ValueError):
|
|
return "?"
|
|
if size < 1024:
|
|
return f"{int(size)} B"
|
|
for unit in ("KB", "MB", "GB"):
|
|
size /= 1024.0
|
|
if size < 1024:
|
|
return f"{size:.1f} {unit}"
|
|
return f"{size / 1024.0:.1f} TB"
|