humanfriendly(1)

✨ humanfriendly — like, the whole vibe ✨

okay bestie, welcome to humanfriendly 💖 the General Commands Manual entry for a lil program that does human friendly input/output on your command line. she's not complicated, she's just ✨ thoughtful ✨.

🎀 NAME 🎀

humanfriendly — human friendly input/output formatter 🦋

🌸 SYNOPSIS 🌸

humanfriendly [options]

💅 DESCRIPTION 💅

so like, humanfriendly is a program that does human friendly input/output — that's the text formatting kind, not the talking-to-people kind, sorry 😭 — and it does it right there on the command line. no cap. she formats, she parses, she spits out stuff that actually makes sense to a human eyeball. iconic behavior fr fr 👑

⭐ OPTIONS ⭐

this program follows the usual GNU command line syntax, where the long options start with two dashes (-). a summary of the options is included below, and yes we're listing every single one because we don't skip 💖

• -h, --help — shows this message and then exits. short, sweet, slays.
• -c COMMAND, --run-command COMMAND — runs an external COMMAND (given as the positional arguments) and renders a spinner and a timer while it's running 🌀 the exit status of the command gets propagated, so no info gets lost, periodt.
• --format-table — reads tabular data from standard input (each line is a row, each whitespace separated field is a column), formats that data as a table, and prints the resulting table to standard output 🫶 see also the --delimiter option, they're besties.
• -d VALUE, --delimiter=VALUE — changes the delimiter used by --format-table to VALUE (a string). by default all whitespace is treated as a delimiter 🌈
• -l LENGTH, --format-length=LENGTH — converts a length count (given as the integer or float LENGTH) into a human readable string and prints that string to standard output 📏
• -n VALUE, --format-number=VALUE — formats a number (given as the integer or floating point number VALUE) with thousands separators and two decimal places (if needed) and prints the formatted number to standard output 🔢
• -s BYTES, --format-size=BYTES — converts a byte count (given as the integer BYTES) into a human readable string and prints that string to standard output 💾
• -t SECONDS, --format-timespan=SECONDS — converts a number of seconds (given as the floating point number SECONDS) into a human readable timespan and prints that string to standard output ⏱️
• --parse-size=VALUE — parses a human readable data size (given as the string VALUE) and prints the number of bytes to standard output 🍓
• --parse-length=VALUE — parses a human readable data length (given as the string VALUE) and prints the number of bytes to standard output 🌸

ngl, that's genuinely the whole page. ten options, zero drama, all vibes 💜

okay that's the tea ☕ this was the humanfriendly(1) page from the General Commands Manual, dated January 19 2017 — a whole classic, lowkey a time capsule 🎀 she ate and left no crumbs. mwah 💋 ✨