synology_apm_repo.sdk.presentation.format module

Size, duration, rate, timestamp and count formatting shared by every frontend.

synology_apm_repo.sdk.presentation.format.pluralize(count, singular, plural=None)

singular for count == 1, else plural (default: singular with an “s” appended).

synology_apm_repo.sdk.presentation.format.format_bytes(n)

n bytes in binary units: "512 B", "1.5 MiB", up to TiB.

synology_apm_repo.sdk.presentation.format.format_duration(seconds)

seconds as MM:SS, or HH:MM:SS from one hour up.

synology_apm_repo.sdk.presentation.format.format_timestamp(dt)

A timezone-aware datetime as "YYYY-MM-DD HH:MM:SS" in the machine’s local timezone; Version.display_name uses the same format.

synology_apm_repo.sdk.presentation.format.format_rate(rate, unit)

A ProgressMeter.rate value for display: "12.3 MiB/s" for the "bytes" unit, "4.0 <unit>/s" for any other. Meaningful only for rate > 0.