CN.3704670284688232:c2f11925e5aec315471918508dd4a6ef_6931ad3442348ce42adc8955.6931aeb142348ce42adc8989.6931aeb18e6d7e45310d94f6:Trae CN.T(2025/12/4 23:54:25)

src/humanize/__init__.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from humanize.bitrate import natural_bitrate
 from humanize.filesize import naturalsize
 from humanize.i18n import activate, deactivate, decimal_separator, thousands_separator
 from humanize.lists import natural_list
@@ -36,6 +37,7 @@
     "intcomma",
     "intword",
     "metric",
+    "natural_bitrate",
     "natural_list",
     "naturaldate",
     "naturalday",

src/humanize/bitrate.py

@@ -0,0 +1,51 @@
+"""Bitrate related humanization."""
+
+from __future__ import annotations
+
+from math import log
+
+
+def natural_bitrate(value: float | str, format: str = "%.1f") -> str:
+    """Format a number of bits per second like a human-readable bitrate (e.g. 1 kbps).
+
+    Uses SI standard (1000-based) prefixes.
+
+    Examples:
+        ```pycon
+        >>> natural_bitrate(1000)
+        '1.0 kbps'
+        >>> natural_bitrate(5200)
+        '5.2 kbps'
+        >>> natural_bitrate(1000000)
+        '1.0 Mbps'
+        >>> natural_bitrate(1500000000)
+        '1.5 Gbps'
+        >>> natural_bitrate(1000000000000)
+        '1.0 Tbps'
+        >>> natural_bitrate(500)
+        '500 bps'
+        >>> natural_bitrate(0)
+        '0 bps'
+        >>> natural_bitrate(-1000)
+        '-1.0 kbps'
+
+        ```
+
+    Args:
+        value (int, float, str): Integer to convert.
+        format (str): Custom formatter.
+
+    Returns:
+        str: Human readable representation of a bitrate.
+    """
+    suffixes = (" kbps", " Mbps", " Gbps", " Tbps")
+    base = 1000
+    bps = float(value)
+    abs_bps = abs(bps)
+
+    if abs_bps < base:
+        return f"{int(bps)} bps"
+
+    exp = int(min(log(abs_bps, base), len(suffixes)))
+    ret: str = format % (bps / (base**exp)) + suffixes[exp - 1]
+    return ret