natural.size

natural.size.binarysize(value)

Wrapper for filesize().

>>> binarysize(123)
'123.00 iB'
>>> binarysize(123456)
'123.46 KiB'
>>> binarysize(1234567890)
'1.23 GiB'
natural.size.decimalsize(value)

Wrapper for filesize().

>>> decimalsize(123)
'123.00 B'
>>> decimalsize(123456)
'120.56 kB'
>>> decimalsize(1234567890)
'1.15 GB'
natural.size.filesize(value, format='decimal', digits=2)

Convert a file size into natural readable format. Multiple formats are supported.

Parameters:
  • value – size
  • format – default decimal, choices binary, decimal or gnu
  • digits – default 2
 
>>> filesize(123)
'123.00 B'
>>> filesize(123456)
'120.56 kB'
>>> filesize(1234567890)
'1.15 GB'
natural.size.gnusize(value, digits=1)

Wrapper for filesize().

>>> gnusize(123)
'123.0B'
>>> gnusize(123456)
'120.6K'
>>> gnusize(1234567890)
'1.1G'