Admin

name	type	size	perms	modified	actions
[parent directory]
__pycache__/	dir	-	0755	2026-08-19 08:39:33
locale/	dir	-	0755	2026-08-19 08:39:32
__init__.py	file	896 B	0644	2026-07-20 00:00:00	edit
filesize.py	file	2,170 B	0644	2026-07-20 00:00:00	edit
i18n.py	file	4,754 B	0644	2026-07-20 00:00:00	edit
number.py	file	16,234 B	0644	2026-07-20 00:00:00	edit
py.typed	file	0 B	0644	2026-07-20 00:00:00	edit
time.py	file	18,739 B	0644	2026-07-20 00:00:00	edit

editing: filesize.py

#!/usr/bin/env python

"""Bits and bytes related humanization."""
from __future__ import annotations

suffixes = {
    "decimal": (" kB", " MB", " GB", " TB", " PB", " EB", " ZB", " YB"),
    "binary": (" KiB", " MiB", " GiB", " TiB", " PiB", " EiB", " ZiB", " YiB"),
    "gnu": "KMGTPEZY",
}

def naturalsize(
    value: float | str,
    binary: bool = False,
    gnu: bool = False,
    format: str = "%.1f",
) -> str:
    """Format a number of bytes like a human readable filesize (e.g. 10 kB).

By default, decimal suffixes (kB, MB) are used.

Non-GNU modes are compatible with jinja2's `filesizeformat` filter.

Examples:
        ```pycon
        >>> naturalsize(3000000)
        '3.0 MB'
        >>> naturalsize(300, False, True)
        '300B'
        >>> naturalsize(3000, False, True)
        '2.9K'
        >>> naturalsize(3000, False, True, "%.3f")
        '2.930K'
        >>> naturalsize(3000, True)
        '2.9 KiB'
        >>> naturalsize(10**28)
        '10000.0 YB'
        >>> naturalsize(-4096, True)
        '-4.0 KiB'

```

Args:
        value (int, float, str): Integer to convert.
        binary (bool): If `True`, uses binary suffixes (KiB, MiB) with base
            2<sup>10</sup> instead of 10<sup>3</sup>.
        gnu (bool): If `True`, the binary argument is ignored and GNU-style
            (`ls -sh` style) prefixes are used (K, M) with the 2**10 definition.
        format (str): Custom formatter.

Returns:
        str: Human readable representation of a filesize.
    """
    if gnu:
        suffix = suffixes["gnu"]
    elif binary:
        suffix = suffixes["binary"]
    else:
        suffix = suffixes["decimal"]

base = 1024 if (gnu or binary) else 1000
    bytes_ = float(value)
    abs_bytes = abs(bytes_)

if abs_bytes == 1 and not gnu:
        return "%d Byte" % bytes_

if abs_bytes < base and not gnu:
        return "%d Bytes" % bytes_

if abs_bytes < base and gnu:
        return "%dB" % bytes_

for i, s in enumerate(suffix):
        unit = base ** (i + 2)

if abs_bytes < unit:
            break

ret: str = format % (base * bytes_ / unit) + s
    return ret

cancel