Graham McIntire
49d0594d28
StatusLive had a hand-rolled thousands-separator format_number/1 and a
binary-prefix format_bytes/1 — duplication that was already part of the
review punch-list. Move both to Microwaveprop.Format (which previously
held only distance_km) and delete the local defps. Fourteen call sites
switched to Format.number / Format.bytes.
Also extend the IEM error classifier to snooze on Req.TransportError
{:closed, :timeout, :econnrefused, :nxdomain}. Same rationale as the
429 snooze in batch 1: upstream TCP resets mid-fetch aren't a job
failure, they're transient — returning {:error, _} blows them up into
Oban.PerformError logspam with full stacktraces.
60 lines
2 KiB
Elixir
60 lines
2 KiB
Elixir
defmodule Microwaveprop.Format do
|
|
@moduledoc """
|
|
Shared human-facing formatters. Miles are the primary distance unit
|
|
across the site; km appears parenthetically for readers working in
|
|
metric.
|
|
"""
|
|
|
|
@doc """
|
|
Format a distance in km as "X mi (Y km)". Under 10 miles the output
|
|
carries one decimal so near-LOS paths don't round to zero; longer
|
|
distances round to whole numbers.
|
|
"""
|
|
@spec distance_km(number() | Decimal.t() | nil) :: String.t()
|
|
def distance_km(nil), do: "—"
|
|
|
|
def distance_km(%Decimal{} = d), do: d |> Decimal.to_float() |> distance_km()
|
|
|
|
def distance_km(km) when is_number(km) do
|
|
mi = km / 1.609344
|
|
|
|
{mi_str, km_str} =
|
|
if mi < 10.0,
|
|
do: {one_decimal(mi), one_decimal(km)},
|
|
else: {Integer.to_string(round(mi)), Integer.to_string(round(km))}
|
|
|
|
"#{mi_str} mi (#{km_str} km)"
|
|
end
|
|
|
|
defp one_decimal(n), do: :erlang.float_to_binary(n * 1.0, decimals: 1)
|
|
|
|
@doc """
|
|
Thousand-grouped integer for UI counters (row counts, job totals, etc).
|
|
Floats round to nearest integer first; non-numerics are passed through
|
|
to `to_string/1` so a `nil` or `:unknown` renders without crashing.
|
|
"""
|
|
@spec number(integer() | float() | any()) :: String.t()
|
|
def number(n) when is_integer(n) do
|
|
n
|
|
|> Integer.to_string()
|
|
|> String.graphemes()
|
|
|> Enum.reverse()
|
|
|> Enum.chunk_every(3)
|
|
|> Enum.map_join(",", &Enum.join/1)
|
|
|> String.reverse()
|
|
|> String.replace(~r/^,/, "")
|
|
end
|
|
|
|
def number(n) when is_float(n), do: number(round(n))
|
|
def number(n), do: to_string(n)
|
|
|
|
@doc """
|
|
Binary-prefix byte count (1024-based) with one decimal. Intended for
|
|
admin / status surfaces where "1.4 MB" is more useful than "1468006".
|
|
"""
|
|
@spec bytes(non_neg_integer()) :: String.t()
|
|
def bytes(b) when b >= 1_073_741_824, do: "#{Float.round(b / 1_073_741_824, 1)} GB"
|
|
def bytes(b) when b >= 1_048_576, do: "#{Float.round(b / 1_048_576, 1)} MB"
|
|
def bytes(b) when b >= 1024, do: "#{Float.round(b / 1024, 1)} KB"
|
|
def bytes(b), do: "#{b} B"
|
|
end
|