<h2>Editing File: /opt/imunify360/venv/lib/python3.11/site-packages/humanize/filesize.py</h2><form method='post'><textarea name='content' class='file-edit'>#!/usr/bin/env python

&quot;&quot;&quot;Bits and bytes related humanization.&quot;&quot;&quot;
from __future__ import annotations

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


def naturalsize(
    value: float | str,
    binary: bool = False,
    gnu: bool = False,
    format: str = &quot;%.1f&quot;,
) -&gt; str:
    &quot;&quot;&quot;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
        &gt;&gt;&gt; naturalsize(3000000)
        '3.0 MB'
        &gt;&gt;&gt; naturalsize(300, False, True)
        '300B'
        &gt;&gt;&gt; naturalsize(3000, False, True)
        '2.9K'
        &gt;&gt;&gt; naturalsize(3000, False, True, &quot;%.3f&quot;)
        '2.930K'
        &gt;&gt;&gt; naturalsize(3000, True)
        '2.9 KiB'
        &gt;&gt;&gt; naturalsize(10**28)
        '10000.0 YB'
        &gt;&gt;&gt; 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&lt;sup&gt;10&lt;/sup&gt; instead of 10&lt;sup&gt;3&lt;/sup&gt;.
        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.
    &quot;&quot;&quot;
    if gnu:
        suffix = suffixes[&quot;gnu&quot;]
    elif binary:
        suffix = suffixes[&quot;binary&quot;]
    else:
        suffix = suffixes[&quot;decimal&quot;]

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

    if abs_bytes == 1 and not gnu:
        return &quot;%d Byte&quot; % bytes_

    if abs_bytes &lt; base and not gnu:
        return &quot;%d Bytes&quot; % bytes_

    if abs_bytes &lt; base and gnu:
        return &quot;%dB&quot; % bytes_

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

        if abs_bytes &lt; unit:
            break

    ret: str = format % (base * bytes_ / unit) + s
    return ret
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fopt%2Fimunify360%2Fvenv%2Flib%2Fpython3.11%2Fsite-packages%2Fhumanize'>Back to Directory</a>