ob ldZddlmZmZddlZej r ddlmZmZmZgdZ dZ dZ dZ d Z y) aFunctions 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 `_ )divisionunicode_literalsN)Iterable SupportsIntText) traditionaldecimalbinaryc t|}|dk(ry||krdj|St |dD]\}}||z}||ksndj||zz S#t$rtdj|wxYw)Nz+filesize requires a numeric value, not {!r}z1 bytez {:,} bytesz {:,.1f} {})int ValueError TypeErrorformat enumerate)sizesuffixesbaseisuffixunits -/usr/lib/python3/dist-packages/fs/filesize.py_to_strrsT4y qy ""4((x+ 6Qw $;    t d 2V << TELLTRSSTs A!!$Bct|ddS)uConvert 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: >>> fs.filesize.traditional(30000) '29.3 KB' )KBMBGBTBPBEBZBYBrrs rrr,s. 4I4 PPct|ddS)ahConvert 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: >>> fs.filesize.binary(30000) '29.3 KiB' )KiBMiBGiBTiBPiBEiBZiBYiBr$r%r&s rr r Fs. 4QSW XXr'ct|ddS)a;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. Returns: `str`: A string containing a abbreviated file size and units. Example: >>> fs.filesize.decimal(30000) '30.0 kB' )kBrrrr r!r"r#ir%r&s rr r `s, 4I4 PPr')__doc__ __future__rrtyping TYPE_CHECKINGrrr__all__rrr r r'rr9s? 2  22 /=&Q4Y4Qr'