a
    hbòfÏ	  ã                   @   s–   d Z dgZddlmZmZmZmZ dddœeee eee ee edœdd	„Z	eee eeeef d
œdd„Z
dddœeee ee edœdd„ZdS )aÊ  Functions for reporting filesizes. Borrowed from https://github.com/PyFilesystem/pyfilesystem2

The functions declared in this module should cover the different
usecases 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>`_

Údecimalé    )ÚIterableÚListÚTupleÚOptionalé   ú ©Ú	precisionÚ	separator)ÚsizeÚsuffixesÚbaser
   r   Úreturnc                C   s`   | dkrdS | |k rd  | ¡S t|dƒD ]\}}|| }| |k r( qFq(dj ||  | |||d�S )Nr   z1 bytez
{:,} bytesé   z{:,.{precision}f}{separator}{}r	   )ÚformatÚ	enumerate)r   r   r   r
   r   ÚiÚsuffixÚunit© r   úV/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/pip/_vendor/rich/filesize.pyÚ_to_str   s    

ür   )r   r   r   r   c                 C   s2   t |ƒD ] \}}|| }| || k r q*q||fS )z*Pick a suffix and base for the given size.)r   )r   r   r   r   r   r   r   r   r   Úpick_unit_and_suffix,   s
    r   )r   r
   r   r   c                C   s   t | dd||d�S )a3  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'

    )ÚkBÚMBÚGBÚTBÚPBÚEBÚZBÚYBiè  r	   )r   )r   r
   r   r   r   r   r   5   s    ûN)Ú__doc__Ú__all__Útypingr   r   r   r   ÚintÚstrr   r   r   r   r   r   r   Ú<module>   s*   úù üû