o †Q`¶ ã@sjdZddlmZddlmZddlZejrddlmZmZmZgd¢Z dd„Z d d „Z d d „Z d d„Z dS)aŽFunctions for reporting filesizes. 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 `_ é)Údivision)Úunicode_literalsN)ÚIterableÚ SupportsIntÚText)Ú traditionalÚdecimalÚbinarycCs„zt|ƒ}Wntytd |¡ƒ‚w|dkrdS||kr$d |¡St|dƒD]\}}||}||kr7nq)d ||||¡S)Nz+filesize requires a numeric value, not {!r}éz1 bytez {:,} byteséz {:,.1f} {})ÚintÚ ValueErrorÚ TypeErrorÚformatÚ enumerate)ÚsizeÚsuffixesÚbaseÚiÚsuffixZunit©rú-/usr/lib/python3/dist-packages/fs/filesize.pyÚ_to_strs  ÿ ÿrcCó t|ddƒS)u}Convert a filesize in to a string (powers of 1024, JDEC prefixes). In this convention, ``1024 B = 1 KB``. This is the format that was used to display the size of DVDs (*700 MB* meaning actually about *734 003 200 bytes*) before standardisation of IEC units among manufacturers, and still used by **Windows** to report the storage capacity of hard drives (*279.4 GB* meaning *279.4 × 1024³ bytes*). Arguments: size (int): A file size. Returns: `str`: A string containing an abbreviated file size and units. Example: >>> filesize.traditional(30000) '29.3 KB' )ZKBÚMBÚGBÚTBÚPBÚEBÚZBÚYBé©r©rrrrr-ó rcCr)aeConvert a filesize in to a string (powers of 1024, IEC prefixes). In this convention, ``1024 B = 1 KiB``. This is the format that has gained adoption among manufacturers to avoid ambiguity regarding size units, since it explicitly states using a binary base (*KiB = kibi bytes = kilo binary bytes*). This format is notably being used by the **Linux** kernel (see ``man 7 units``). Arguments: int (size): A file size. Returns: `str`: A string containing a abbreviated file size and units. Example: >>> filesize.binary(30000) '29.3 KiB' )ZKiBZMiBZGiBZTiBZPiBZEiBZZiBZYiBr!r"r#rrrr Gr$r cCr)a8Convert 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. Returns: `str`: A string containing a abbreviated file size and units. Example: >>> filesize.decimal(30000) '30.0 kB' )ZkBrrrrrrr ièr"r#rrrras r)Ú__doc__Z __future__rrÚtypingZ TYPE_CHECKINGrrrÚ__all__rrr rrrrrÚs