Scroll to navigation
NAME¶
humanfriendly - human friendly input/output formatter
SYNOPSIS¶
humanfriendly [options]
DESCRIPTION¶
humanfriendly is a program that performs human friendly input/output
(text formatting) on the command line.
OPTIONS¶
This program follow the usual GNU command line syntax, with long options
starting with two dashes (`-'). A summary of options is included below.
- -h, --help
- Show this message and exit.
- -c COMMAND, --run-command COMMAND
- Execute an external COMMAND (given as the positional arguments) and
render a spinner and timer while the command is running. The exit status
of the command is propagated.
- --format-table
- Read tabular data from standard input (each line is a row and each
whitespace separated field is a column), format the data as a table and
print the resulting table to standard output. See also the
--delimiter option.
- -d VALUE, --delimiter=VALUE
- Change the delimiter used by --format-table to VALUE (a
string). By default all whitespace is treated as a delimiter.
- -l LENGTH, --format-length=LENGTH
- Convert a length count (given as the integer or float LENGTH) into
a human readable string and print that string to standard output.
- -n VALUE, --format-number=VALUE
- Format a number (given as the integer or floating point number
VALUE) with thousands separators and two decimal places (if needed)
and print the formatted number to standard output.
- -s BYTES, --format-size=BYTES
- Convert a byte count (given as the integer BYTES) into a human
readable string and print that string to standard output.
- -t SECONDS, --format-timespan=SECONDS
- Convert a number of seconds (given as the floating point number
SECONDS) into a human readable timespan and print that string to
standard output.
- --parse-size=VALUE
- Parse a human readable data size (given as the string VALUE) and
print the number of bytes to standard output.
- --parse-length=VALUE
- Parse a human readable data length (given as the string VALUE) and
print the number of bytes to standard output.