http://hg.omfa.de/prosody-hg/ en-us prosody-hg: util/human/io.lua history util/human/io.lua revision history Merge 13.0->trunk http://hg.omfa.de/prosody-hg/log/565debd9c37a/util/human/io.lua Matthew Wild <mwild1@gmail.com> Fri, 12 Jun 2026 13:05:10 +0100 util.human.io: Add simple version comparison http://hg.omfa.de/prosody-hg/log/7eb0e47418ab/util/human/io.lua
This is a small helper function that compares version string (it can be passed
to table.sort() as a comparator).

Full version sorts (e.g. semver, and natural/alphanumeric sort in general) are
more complex, and I would like to eventually support those. But this is a
stable branch and we don't need it for anything just yet.

Regarding justification for the stable branch:

The function is being committed with extensive tests, and isn't currently used
anywhere. The plan is to use it in an upcoming update of how TLS profiles are
configured, but the inputs in that case will be fixed (meaning that the risk
of breakage is lower than if we were running it against arbitrary data).]]> Matthew Wild <mwild1@gmail.com> Fri, 12 Jun 2026 11:38:39 +0100 Merge 13.0->trunk http://hg.omfa.de/prosody-hg/log/7008869fcce2/util/human/io.lua Matthew Wild <mwild1@gmail.com> Thu, 02 Apr 2026 20:54:46 +0100 util.human.io: Trim any trailing newline from password entry http://hg.omfa.de/prosody-hg/log/519c16c2eb21/util/human/io.lua
Newlines are invalid in passwords anyway, according to saslprep. Trailing
newlines can happen when pasting, e.g. when copying the output of command-line
password managers/generators to the clipboard.]]> Matthew Wild <mwild1@gmail.com> Thu, 02 Apr 2026 20:49:37 +0100 util.human.io: Support disabling column widths http://hg.omfa.de/prosody-hg/log/cfe3e85e715f/util/human/io.lua
This makes columns be of variable with, padding and ellipsis is
disabled. With the separator set to "\t", this produces TSV output]]> Kim Alvefur <zash@zash.se> Sat, 30 Aug 2025 21:55:03 +0200 util.human.io: Allow specifying a different column separator http://hg.omfa.de/prosody-hg/log/4f1b6f6e68c0/util/human/io.lua Kim Alvefur <zash@zash.se> Sat, 30 Aug 2025 21:54:07 +0200 util.human.io: Factor out column width calculation http://hg.omfa.de/prosody-hg/log/6a493e41c2cc/util/human/io.lua
Goal is to make it optional and have e.g. CSV/TSV output]]> Kim Alvefur <zash@zash.se> Sat, 30 Aug 2025 21:52:00 +0200 util.human.io: Don't accept ambiguous durations by default http://hg.omfa.de/prosody-hg/log/82513890a1d8/util/human/io.lua
The new method parse_duration_lax() exports the old behaviour, mainly for
compatibility purposes.]]> Matthew Wild <mwild1@gmail.com> Thu, 30 Nov 2023 13:42:44 +0000 util.human.io: Fix stray 'stty' error by only querying width of real ttys http://hg.omfa.de/prosody-hg/log/8dbe693ded6b/util/human/io.lua
This adds a dependency on a binary and *nix-specific module but then
stty is probably *nix-specific anyway so maybe that's fine.]]> Kim Alvefur <zash@zash.se> Sun, 16 Jul 2023 21:21:37 +0200 util.human.io: Fix pattern in parse_duration() to cover all used letters http://hg.omfa.de/prosody-hg/log/278920294dfe/util/human/io.lua
Notably 'h' was missing. Awkwardly, 'hour' would result in 'ho' which
was missing from table.]]> Kim Alvefur <zash@zash.se> Sun, 16 Jul 2023 19:27:18 +0200 util.human.io: Fix column width miscalculation http://hg.omfa.de/prosody-hg/log/7a75cbc4d87c/util/human/io.lua
Fixes that the more fixed width columns there are, the narrower the
resulting table becomes. A right-aligned variable-width column at the
last position should always be flush to the right side of the terminal.]]> Kim Alvefur <zash@zash.se> Sun, 09 Apr 2023 22:31:12 +0200 util.human.io: Fix error with ellipsis to negative length http://hg.omfa.de/prosody-hg/log/386ca97bec5b/util/human/io.lua
Can happen if you resize the terminal too narrow that the space left for
variable width columns end up negative.]]> Kim Alvefur <zash@zash.se> Sun, 09 Apr 2023 01:34:08 +0200 util.human.io: Add parse_duration() method to parse a duration string http://hg.omfa.de/prosody-hg/log/f4d7fe919969/util/human/io.lua
Similar logic occurs throughout various modules in the codebase. We might even
want a module:get_option_duration()??]]> Matthew Wild <mwild1@gmail.com> Fri, 07 Apr 2023 14:14:53 +0100 util.human.io: Coerce $COLUMNS to number http://hg.omfa.de/prosody-hg/log/164c2787901a/util/human/io.lua
os.getenv() returns a string but term_width() should return a number]]> Kim Alvefur <zash@zash.se> Fri, 07 Apr 2023 13:54:16 +0200 util.human.io: table: don't read $COLUMNS directly, just use term_width() http://hg.omfa.de/prosody-hg/log/115ce3ab5b8b/util/human/io.lua
...which now reads $COLUMNS for us and does the right thing.]]> Matthew Wild <mwild1@gmail.com> Fri, 07 Apr 2023 12:51:26 +0100 util.human.io: table: Return determined width as a second result http://hg.omfa.de/prosody-hg/log/946442df65d3/util/human/io.lua
This allows callers to adjust other things based on the width of the rows
(such as header lines).]]> Matthew Wild <mwild1@gmail.com> Fri, 07 Apr 2023 12:47:24 +0100 util.human.io: Prefer using the $COLUMNS environment variable if set (by readline) http://hg.omfa.de/prosody-hg/log/d939bf469057/util/human/io.lua
Feels like it should be faster.]]> Kim Alvefur <zash@zash.se> Fri, 07 Apr 2023 13:42:20 +0200 util.human.io: table: use term_width() to discover terminal width http://hg.omfa.de/prosody-hg/log/da0b3cb9a2ec/util/human/io.lua Matthew Wild <mwild1@gmail.com> Fri, 07 Apr 2023 12:35:39 +0100 util.human.io: Add term_width() method to discover the terminal width http://hg.omfa.de/prosody-hg/log/5bd272095388/util/human/io.lua
This is not standard POSIX, but apparently very widely supported. For
reference: https://www.austingroupbugs.net/view.php?id=1053]]> Matthew Wild <mwild1@gmail.com> Fri, 07 Apr 2023 12:33:17 +0100 util.human.io: Pass the whole column definition to mapper function http://hg.omfa.de/prosody-hg/log/0cbe400ebab4/util/human/io.lua
I forget why I wanted this, but it may allow doing things like pull
settings from the column, especially when the mapper function is reused
among many columns.]]> Kim Alvefur <zash@zash.se> Fri, 07 Apr 2023 13:02:20 +0200 util.human.io: Allow defining per column ellipsis function http://hg.omfa.de/prosody-hg/log/9ddb344b9fab/util/human/io.lua
As an alternative to doing it in the mapper function. Could be useful in
cases where one may want to put the ellipsis in the middle or beginning
instead of the start.]]> Kim Alvefur <zash@zash.se> Fri, 07 Apr 2023 13:00:58 +0200 util.human.io: Pass expected width to mapper function http://hg.omfa.de/prosody-hg/log/83b93ad08b23/util/human/io.lua
In order to allow it to adjust its output to available space, apply its
own ellipsis method or other compacting method.]]> Kim Alvefur <zash@zash.se> Fri, 07 Apr 2023 13:00:00 +0200 util.human.io: Fix pattern to support fractional proportions http://hg.omfa.de/prosody-hg/log/1023c3faffac/util/human/io.lua Matthew Wild <mwild1@gmail.com> Thu, 06 Apr 2023 15:03:45 +0100 util.human.io: Support for dynamic "proportional" columns http://hg.omfa.de/prosody-hg/log/1f89a2a9f532/util/human/io.lua
Instead of a percentage, this allows you to specify e.g. `width="[N]p"`, where
a width="2p" will be twice the width of a width="1p" column.

Compatibility with the old %-based widths is preserved, and percentages adding
up to more than 100 are handled more gracefully.]]> Matthew Wild <mwild1@gmail.com> Thu, 06 Apr 2023 14:51:52 +0100 util: Prefix module imports with prosody namespace http://hg.omfa.de/prosody-hg/log/d10957394a3c/util/human/io.lua Kim Alvefur <zash@zash.se> Fri, 17 Mar 2023 16:23:16 +0100 util.human.io: Fix handling of os.execute() return values in Lua 5.2+ http://hg.omfa.de/prosody-hg/log/d513e4bd4928/util/human/io.lua
Wrong part of Lua 5.1 compat removed in 0f4feaf9ca64]]> Kim Alvefur <zash@zash.se> Thu, 20 Oct 2022 17:35:01 +0200 util: Remove various Lua 5.1 compatibility hacks http://hg.omfa.de/prosody-hg/log/0f4feaf9ca64/util/human/io.lua
Part of #1600]]> Kim Alvefur <zash@zash.se> Sat, 02 Jul 2022 17:31:14 +0200 util.human.io: Use UTF-8-aware length check in padding functions http://hg.omfa.de/prosody-hg/log/e84ea5b58b29/util/human/io.lua Kim Alvefur <zash@zash.se> Fri, 12 Nov 2021 14:22:21 +0100 util.human.io: Fix cutting of UTF-8 into pieces http://hg.omfa.de/prosody-hg/log/93e9f7ae2f9b/util/human/io.lua
Down the rabbit hole we go...]]> Kim Alvefur <zash@zash.se> Fri, 12 Nov 2021 14:21:15 +0100 util.human.io: Trim any broken UTF-8 from ellipsis http://hg.omfa.de/prosody-hg/log/d278a4c6da7f/util/human/io.lua
This should fix basic problems with multi-byte UTF-8 sequences getting
cut in the middle.

Down the rabbit hole we go...]]> Kim Alvefur <zash@zash.se> Fri, 12 Nov 2021 12:19:01 +0100 util.human.io: Factor out ellipsis function http://hg.omfa.de/prosody-hg/log/57106c61d104/util/human/io.lua
Could be useful elsewhere]]> Kim Alvefur <zash@zash.se> Fri, 12 Nov 2021 12:14:27 +0100 util.human.io: Support specifying column defaults in tables http://hg.omfa.de/prosody-hg/log/afef1e170de7/util/human/io.lua Kim Alvefur <zash@zash.se> Fri, 12 Nov 2021 11:44:31 +0100 util.human.io: Pass nil to cell mapper to signal missing value http://hg.omfa.de/prosody-hg/log/e712133b4de1/util/human/io.lua
Seems more like conventional Lua than passing an empty string to signal
lack of value.]]> Kim Alvefur <zash@zash.se> Fri, 12 Nov 2021 11:43:24 +0100 util.human.io: Fix right-alignment http://hg.omfa.de/prosody-hg/log/1eb83bc6f706/util/human/io.lua Kim Alvefur <zash@zash.se> Sat, 06 Jun 2020 16:43:28 +0200 util.human.io.table: Allow a map callaback per column http://hg.omfa.de/prosody-hg/log/9dc34e1556d9/util/human/io.lua
This allows e.g. mapping booleans to "yes" or "no", specific number
formatting or generating virtual columns. All while not mutating the
underlying data or creating additional temporary tables.]]> Kim Alvefur <zash@zash.se> Thu, 04 Jun 2020 21:32:28 +0200 util.human.io: Consider separator when calculating remaining width http://hg.omfa.de/prosody-hg/log/e890b83f08cf/util/human/io.lua Kim Alvefur <zash@zash.se> Thu, 04 Jun 2020 18:40:37 +0200 util.human.io: Use literal ellipsis instead of \u escape http://hg.omfa.de/prosody-hg/log/3af3354366eb/util/human/io.lua
For compat with Lua 5.2 and before]]> Kim Alvefur <zash@zash.se> Thu, 04 Jun 2020 18:36:47 +0200 util.human.io: Replace overflow with ellipsis http://hg.omfa.de/prosody-hg/log/18dc4639442e/util/human/io.lua Kim Alvefur <zash@zash.se> Thu, 04 Jun 2020 18:32:33 +0200 util.human.io: Draw a separator between columns http://hg.omfa.de/prosody-hg/log/6af28c756752/util/human/io.lua Kim Alvefur <zash@zash.se> Thu, 04 Jun 2020 18:31:50 +0200 util.human.io: Remove padding option and use $COLUMNS as default width http://hg.omfa.de/prosody-hg/log/d009a79f723a/util/human/io.lua Matthew Wild <mwild1@gmail.com> Thu, 04 Jun 2020 17:24:30 +0100 util.human.io: table: Fix title printing when columns use named keys http://hg.omfa.de/prosody-hg/log/c7a0eab27165/util/human/io.lua Matthew Wild <mwild1@gmail.com> Thu, 04 Jun 2020 10:39:55 +0100 util.human.io: table: Return title row when no row data passed http://hg.omfa.de/prosody-hg/log/d15a4284fdf8/util/human/io.lua Matthew Wild <mwild1@gmail.com> Wed, 03 Jun 2020 22:58:29 +0100 util.human.io: table: switch row function to simply returning prepared row string http://hg.omfa.de/prosody-hg/log/a256044c1d12/util/human/io.lua Matthew Wild <mwild1@gmail.com> Wed, 03 Jun 2020 22:45:33 +0100 util.human.io: Add padleft, padright and a table printing function http://hg.omfa.de/prosody-hg/log/8d47858805c9/util/human/io.lua Matthew Wild <mwild1@gmail.com> Wed, 03 Jun 2020 22:21:17 +0100 util.human.io: Fix variable name [luacheck] http://hg.omfa.de/prosody-hg/log/a3f3f42736f2/util/human/io.lua Matthew Wild <mwild1@gmail.com> Tue, 02 Jun 2020 08:02:03 +0100 util.human.io: New central place for UI helpers http://hg.omfa.de/prosody-hg/log/3f1889608f3e/util/human/io.lua Matthew Wild <mwild1@gmail.com> Tue, 02 Jun 2020 08:00:37 +0100