Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
87 lines (52 sloc) 1.69 KB

The bitmath command-line Tool

:mod:`bitmath` includes a CLI utility for easily converting units in a shell. For reference, there is also a manpage included, :manpage:`bitmath (1)`.


bitmath [--from-stdin] [-f IN_UNIT] [-t OUT_UNIT] VALUE ...


.. program:: bitmath

.. option:: -f <IN_UNIT>

   Specify the input unit to convert from. Defaults to

.. option:: -t <OUT_UNIT>

   Specify the output unit to convert to. Defaults to the :ref:`best
   human-readable <instances_best_prefix>` prefix unit.

.. option:: --from-stdin

   Reads number from stdin rather than as a CLI argument.

.. describe:: VALUE

   The value to convert.


Convert 1024 into the best human-readable unit. Without specifying any from or to values this examples defaults to treating the input value as a :class:`bitmath.Byte`:

$ bitmath 1024
1.0 KiB

Convert 1024 KiB into kBs:

$ bitmath -f KiB -t kb 1024
8388.608 kb

Convert 1073741824 bytes into the best human-readable unit:

$ bitmath -f Byte 1073741824
1.0 GiB

Use the :command:`stat` command to print the size of :file:`bitmath/` in bytes, pipe the output into the :command:`bitmath` command, and print the result in MBs:

$ stat -c '%s' bitmath/ | bitmath --from-stdin -t MB
0.038374 MB

Convert several values at once from Bytes (the default behavior) into MBs:

$ bitmath -t MB 1234567 9876543 1337 42
1.234567 MB
9.876543 MB
0.001337 MB
4.2e-05 MB
You can’t perform that action at this time.