Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-05-13 15:07
__init__.py	5.92 KB	-rw-r--r--	2023-02-14 03:31
__main__.py	8.14 KB	-rw-r--r--	2023-02-14 03:31
_cell_widths.py	9.86 KB	-rw-r--r--	2023-02-14 03:31
_emoji_codes.py	136.95 KB	-rw-r--r--	2023-02-14 03:31
_emoji_replace.py	1.04 KB	-rw-r--r--	2023-02-14 03:31
_export_format.py	2.06 KB	-rw-r--r--	2023-02-14 03:31
_extension.py	241 B	-rw-r--r--	2023-02-14 03:31
_fileno.py	799 B	-rw-r--r--	2023-02-14 03:31
_inspect.py	9.47 KB	-rw-r--r--	2023-02-14 03:31
_log_render.py	3.14 KB	-rw-r--r--	2023-02-14 03:31
_loop.py	1.21 KB	-rw-r--r--	2023-02-14 03:31
_null_file.py	1.35 KB	-rw-r--r--	2023-02-14 03:31
_palettes.py	6.9 KB	-rw-r--r--	2023-02-14 03:31
_pick.py	423 B	-rw-r--r--	2023-02-14 03:31
_ratio.py	5.33 KB	-rw-r--r--	2023-02-14 03:31
_spinners.py	19.45 KB	-rw-r--r--	2023-02-14 03:31
_stack.py	351 B	-rw-r--r--	2023-02-14 03:31
_timer.py	417 B	-rw-r--r--	2023-02-14 03:31
_win32_console.py	22.25 KB	-rw-r--r--	2023-02-14 03:31
_windows.py	1.86 KB	-rw-r--r--	2023-02-14 03:31
_windows_renderer.py	2.69 KB	-rw-r--r--	2023-02-14 03:31
_wrap.py	1.8 KB	-rw-r--r--	2023-02-14 03:31
abc.py	878 B	-rw-r--r--	2023-02-14 03:31
align.py	10.08 KB	-rw-r--r--	2023-02-14 03:31
ansi.py	6.66 KB	-rw-r--r--	2023-02-14 03:31
bar.py	3.19 KB	-rw-r--r--	2023-02-14 03:31
box.py	9.56 KB	-rw-r--r--	2023-02-14 03:31
cells.py	4.4 KB	-rw-r--r--	2023-02-14 03:31
color.py	17.8 KB	-rw-r--r--	2023-02-14 03:31
color_triplet.py	1.03 KB	-rw-r--r--	2023-02-14 03:31
columns.py	6.96 KB	-rw-r--r--	2023-02-14 03:31
console.py	96.7 KB	-rw-r--r--	2023-02-14 03:31
constrain.py	1.26 KB	-rw-r--r--	2023-02-14 03:31
containers.py	5.37 KB	-rw-r--r--	2023-02-14 03:31
control.py	6.45 KB	-rw-r--r--	2023-02-14 03:31
default_styles.py	7.86 KB	-rw-r--r--	2023-02-14 03:31
diagnose.py	924 B	-rw-r--r--	2023-02-14 03:31
emoji.py	2.41 KB	-rw-r--r--	2023-02-14 03:31
errors.py	642 B	-rw-r--r--	2023-02-14 03:31
file_proxy.py	1.64 KB	-rw-r--r--	2023-02-14 03:31
filesize.py	2.45 KB	-rw-r--r--	2023-02-14 03:31
highlighter.py	9.36 KB	-rw-r--r--	2023-02-14 03:31
json.py	4.9 KB	-rw-r--r--	2023-02-14 03:31
jupyter.py	3.15 KB	-rw-r--r--	2023-02-14 03:31
layout.py	13.62 KB	-rw-r--r--	2023-02-14 03:31
live.py	13.84 KB	-rw-r--r--	2023-02-14 03:31
live_render.py	3.57 KB	-rw-r--r--	2023-02-14 03:31
logging.py	11.61 KB	-rw-r--r--	2023-02-14 03:31
markdown.py	21.84 KB	-rw-r--r--	2023-02-14 03:31
markup.py	7.98 KB	-rw-r--r--	2023-02-14 03:31
measure.py	5.18 KB	-rw-r--r--	2023-02-14 03:31
padding.py	4.84 KB	-rw-r--r--	2023-02-14 03:31
pager.py	828 B	-rw-r--r--	2023-02-14 03:31
palette.py	3.21 KB	-rw-r--r--	2023-02-14 03:31
panel.py	10.33 KB	-rw-r--r--	2023-02-14 03:31
pretty.py	36.47 KB	-rw-r--r--	2023-02-14 03:31
progress.py	58.27 KB	-rw-r--r--	2023-02-14 03:31
progress_bar.py	7.97 KB	-rw-r--r--	2023-02-14 03:31
prompt.py	11.03 KB	-rw-r--r--	2023-02-14 03:31
protocol.py	1.33 KB	-rw-r--r--	2023-02-14 03:31
py.typed	0 B	-rw-r--r--	2023-02-14 03:31
region.py	166 B	-rw-r--r--	2023-02-14 03:31
repr.py	4.32 KB	-rw-r--r--	2023-02-14 03:31
rule.py	4.48 KB	-rw-r--r--	2023-02-14 03:31
scope.py	2.76 KB	-rw-r--r--	2023-02-14 03:31
screen.py	1.54 KB	-rw-r--r--	2023-02-14 03:31
segment.py	23.63 KB	-rw-r--r--	2023-02-14 03:31
spinner.py	4.24 KB	-rw-r--r--	2023-02-14 03:31
status.py	4.32 KB	-rw-r--r--	2023-02-14 03:31
style.py	25.71 KB	-rw-r--r--	2023-02-14 03:31
styled.py	1.21 KB	-rw-r--r--	2023-02-14 03:31
syntax.py	34.05 KB	-rw-r--r--	2023-02-14 03:31
table.py	38.72 KB	-rw-r--r--	2023-02-14 03:31
terminal_theme.py	3.29 KB	-rw-r--r--	2023-02-14 03:31
text.py	44.6 KB	-rw-r--r--	2023-02-14 03:31
theme.py	3.69 KB	-rw-r--r--	2023-02-14 03:31
themes.py	102 B	-rw-r--r--	2023-02-14 03:31
traceback.py	28.42 KB	-rw-r--r--	2023-02-14 03:31
tree.py	8.9 KB	-rw-r--r--	2023-02-14 03:31

Rename

# coding: utf-8
"""Functions for reporting filesizes. Borrowed from https://github.com/PyFilesystem/pyfilesystem2

The functions declared in this module should cover the different
use cases needed to generate a string representation of a file size
using several different units. Since there are many standards regarding
file size units, three different functions have been implemented.

See Also:
    * `Wikipedia: Binary prefix <https://en.wikipedia.org/wiki/Binary_prefix>`_

"""

__all__ = ["decimal"]

from typing import Iterable, List, Optional, Tuple

def _to_str(
    size: int,
    suffixes: Iterable[str],
    base: int,
    *,
    precision: Optional[int] = 1,
    separator: Optional[str] = " ",
) -> str:
    if size == 1:
        return "1 byte"
    elif size < base:
        return "{:,} bytes".format(size)

for i, suffix in enumerate(suffixes, 2):  # noqa: B007
        unit = base**i
        if size < unit:
            break
    return "{:,.{precision}f}{separator}{}".format(
        (base * size / unit),
        suffix,
        precision=precision,
        separator=separator,
    )

def pick_unit_and_suffix(size: int, suffixes: List[str], base: int) -> Tuple[int, str]:
    """Pick a suffix and base for the given size."""
    for i, suffix in enumerate(suffixes):
        unit = base**i
        if size < unit * base:
            break
    return unit, suffix

def decimal(
    size: int,
    *,
    precision: Optional[int] = 1,
    separator: Optional[str] = " ",
) -> str:
    """Convert a filesize in to a string (powers of 1000, SI prefixes).

In this convention, ``1000 B = 1 kB``.

This is typically the format used to advertise the storage
    capacity of USB flash drives and the like (*256 MB* meaning
    actually a storage capacity of more than *256 000 000 B*),
    or used by **Mac OS X** since v10.6 to report file sizes.

Arguments:
        int (size): A file size.
        int (precision): The number of decimal places to include (default = 1).
        str (separator): The string to separate the value from the units (default = " ").

Returns:
        `str`: A string containing a abbreviated file size and units.

Example:
        >>> filesize.decimal(30000)
        '30.0 kB'
        >>> filesize.decimal(30000, precision=2, separator="")
        '30.00kB'

"""
    return _to_str(
        size,
        ("kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"),
        1000,
        precision=precision,
        separator=separator,
    )