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.

                                         January 19 2017                         humanfriendly(1)