R`i
d Z dgZddlmZmZmZmZ ddddedee d ed
ee d ee d ef d
Z dedee d ed eeef fdZ
dddded
ee d ee d efdZ y)a 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 `_
decimal )IterableListOptionalTuple precision separatorsizesuffixesbaser r returnc | dk( ry| |k rdj | S t |d D ] \ }}||z }| |k s n dj || z z || S )Nr z1 bytez
{:,} bytes z {:,.{precision}f}{separator}{}r
)format enumerate)r
r r r r isuffixunits /builddir/build/BUILDROOT/alt-python312-pip-23.3.1-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/pip/_vendor/rich/filesize.py_to_strr s} qy
""4(( x+ 6Qw $; , , 2 2
t 3 c T t | D ] \ }}||z }| ||z k s ||fS fS )z*Pick a suffix and base for the given size.)r )r
r r r r r s r pick_unit_and_suffixr , sC x( 6Qw $+ < ) <r c " t | dd|| 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'
)kBMBGBTBPBEBZBYBi r
)r )r
r r s r r r 5 s < 8 r N) __doc____all__typingr r r r intstrr r r r r r, s
+ 2 2 ! "
sm
} }
2s d3i s uSRUX ! " $
$ }$ } $
$r