Skip to content

v0.1.0

Choose a tag to compare

View all tags
@woodie woodie released this 08 Jul 21:12
v0.1.0
c756f9f

humane v0.1.0

Initial release

humane formats file sizes and relative dates the way macOS Finder does, modeled on Swift's ByteCountFormatter and RelativeDateTimeFormatter: small, configurable formatter classes with a single string method, rather than helper methods mixed into a view. Extracted from real usage in scandalous and its Go counterpart lambada, which were carrying hand-rolled, drifting copies of the same logic.

Humane::SizeFormatter

string(from_byte_count:) formats byte counts with 1000-based math and capitalized unit labels ("80 KB", "1.5 MB"), matching Finder's own file-size display — not SI's lowercase "kB", and not the 1024-based math Rails' number_to_human_size uses under the same "KB" label.

Humane::TimeFormatter

string(at:, relative_to:) formats one time relative to another as "X ago" / "X from now", with no "about" prefix on the hour bucket. collapse_minute: (defaults to true) buckets anything under a minute as "less than a minute ago" / "less than a minute from now".

This first release is scoped to just these two formatters. See the README for usage and docs/COMMENTS.md for design rationale, including why at:/relative_to: was chosen over Swift's for:/relativeTo: labels.

Assets 2
Loading