U
‰dy ã @ s8 d Z ddlmZ ddddœZdd d
d
d d d œd
d„ZdS )z$Bits and bytes related humanization.é )Ú annotations)z kBz MBz GBz TBz PBz EBz ZBz YB)z KiBz MiBz GiBz TiBz PiBz EiBz ZiBz YiBZKMGTPEZY)ÚdecimalÚbinaryÚgnuFú%.1fz float | strÚboolÚstr)Úvaluer r ÚformatÚreturnc C s |rt d }n|r t d }nt d }|s,|r0dnd}t| ƒ}t|ƒ}|dkrX|sXd| S ||k rl|sld| S ||k r€|r€d | S t|ƒD ] \}} ||d
}
||
k rˆ qªqˆ||| |
| } | S ) aO 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
>>> naturalsize(3000000)
'3.0 MB'
>>> naturalsize(300, False, True)
'300B'
>>> naturalsize(3000, False, True)
'2.9K'
>>> naturalsize(3000, False, True, "%.3f")
'2.930K'
>>> naturalsize(3000, True)
'2.9 KiB'
>>> naturalsize(10**28)
'10000.0 YB'
>>> 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
210 instead of 103.
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.
r r r i iè é z%d Bytez%d Bytesz%dBé )ÚsuffixesÚfloatÚabsÚ enumerate) r r r r
ÚsuffixÚbaseZbytes_Z abs_bytesÚiÚsÚunitÚret© r ú5/tmp/pip-unpacked-wheel-kd4adnh7/humanize/filesize.pyÚ naturalsize
s( )
r N)FFr )Ú__doc__Ú
__future__r r r r r r r Ú s ý ü