$ show dustin/go-humanize
go-humanize is a Go library that provides functions to convert numbers, byte sizes, times, ordinals, and SI-prefixed values into human-readable strings and back. It is a pure utility library with no external dependencies beyond the Go standard library. The codebase is organized into a single package with a subpackage for English-specific utilities (pluralization, word series). Key entry points include Bytes, IBytes, Comma, Commaf, Time, Ordinal, SI, and ParseBytes/ParseSI. The library demonstrates solid Go craftsmanship with efficient algorithms (e.g., byte-level comma insertion, logarithmic SI prefix computation) and comprehensive test coverage including fuzz testing. It is widely used (4.8k stars) and actively maintained, though the Go version in CI (1.19) and module requirement (1.16) lag behind current Go releases, indicating moderate technical drift.
The LLM identified 4 files worth highlighting for reuse:
Implements Comma (int64), Commaf (float64), and BigComma (big.Int) to insert thousands separators. The Comma function uses a byte-level loop to build the output string without intermediate string conversions, handling edge cases like MinInt64. Commaf uses strconv.FormatFloat and a buffer with comma insertion. BigComma uses big.Int division. These are self-contained, reusable formatting utilities that demonstrate non-obvious optimization for performance.
Provides ComputeSI to find the appropriate SI prefix for a float, SI to format with unit, SIWithDigits for precision control, and ParseSI to parse back. Uses a precomputed prefix table and a regex for parsing. The ComputeSI function handles edge cases like zero and exact 1000.0. This module is self-contained and reusable for any application needing SI metric prefix formatting.
Implements relative time formatting (e.g., '3 weeks ago') with a customizable magnitude table via CustomRelTime. The default magnitudes cover from seconds to years. Uses sort.Search to find the appropriate magnitude. The pattern allows users to define custom time ranges and formats. This is a clean, reusable implementation of a common UX pattern.
Provides PluralWord for English pluralization with special cases (indices, vertices) and sibilant endings, Plural to format quantity + word, WordSeries for comma-separated lists, and OxfordWordSeries with serial comma. The pluralization logic is self-contained and implements common English rules without external dependencies. Reusable for any Go project needing English text generation.