ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: opt / imunify360 / venv / lib / python3.11 / site-packages / pip / _vendor / rich

"""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 f"{size:,} bytes"

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,
    )

[-] jupyter.py [edit]
[-] errors.py [edit]
[-] progress_bar.py [edit]
[-] _log_render.py [edit]
[-] pretty.py [edit]
[-] spinner.py [edit]
[-] _inspect.py [edit]
[-] _windows_renderer.py [edit]
[-] segment.py [edit]
[-] repr.py [edit]
[-] live_render.py [edit]
[-] live.py [edit]
[-] _windows.py [edit]
[-] panel.py [edit]
[-] default_styles.py [edit]
[-] ansi.py [edit]
[-] _fileno.py [edit]
[-] highlighter.py [edit]
[+] ..
[-] constrain.py [edit]
[-] measure.py [edit]
[-] _win32_console.py [edit]
[-] themes.py [edit]
[-] layout.py [edit]
[-] color.py [edit]
[-] _timer.py [edit]
[-] _palettes.py [edit]
[-] _emoji_codes.py [edit]
[-] __main__.py [edit]
[-] _extension.py [edit]
[-] emoji.py [edit]
[-] theme.py [edit]
[-] _pick.py [edit]
[-] style.py [edit]
[-] screen.py [edit]
[-] syntax.py [edit]
[-] py.typed [edit]
[-] abc.py [edit]
[-] region.py [edit]
[-] palette.py [edit]
[-] _export_format.py [edit]
[-] protocol.py [edit]
[-] text.py [edit]
[-] prompt.py [edit]
[-] status.py [edit]
[+] __pycache__
[-] align.py [edit]
[-] color_triplet.py [edit]
[-] bar.py [edit]
[-] control.py [edit]
[-] styled.py [edit]
[-] progress.py [edit]
[-] console.py [edit]
[-] scope.py [edit]
[-] traceback.py [edit]
[-] _null_file.py [edit]
[-] rule.py [edit]
[-] logging.py [edit]
[-] box.py [edit]
[-] table.py [edit]
[-] terminal_theme.py [edit]
[-] _spinners.py [edit]
[-] filesize.py [edit]
[-] padding.py [edit]
[-] __init__.py [edit]
[-] _wrap.py [edit]
[-] columns.py [edit]
[-] _cell_widths.py [edit]
[-] markup.py [edit]
[-] containers.py [edit]
[-] json.py [edit]
[-] diagnose.py [edit]
[-] _loop.py [edit]
[-] _ratio.py [edit]
[-] _emoji_replace.py [edit]
[-] pager.py [edit]
[-] tree.py [edit]
[-] file_proxy.py [edit]
[-] _stack.py [edit]
[-] cells.py [edit]