Improve bytestring docstring.

This commit is contained in:
voussoir 2021-11-10 23:02:22 -08:00
parent 691b293939
commit 729d3e5cf3
No known key found for this signature in database
GPG key ID: 5F7554F8C26DACCB

View file

@ -80,10 +80,13 @@ def bytestring(size, decimal_places=3, force_unit=None):
'762.939 MiB'
>>> bytestring(800000000, decimal_places=0)
'763 MiB'
decimal_places:
The number of digits after the decimal, including trailing zeros,
for all divisors except bytes.
force_unit:
You can provide one of the size constants to force that divisor.
If None, an appropriate size unit is chosen automatically.
Otherwise, you can provide one of the size constants to force that divisor.
'''
if force_unit is None:
divisor = get_appropriate_divisor(size)