Update karton list command

[msm-cert]

No description provided.

[nazywam]

maybe -h for human? Similarly to du, for example

[msm-cert]

Makes sense, though in this case it's both more human readable and more machine-readable. The default format looks like this:

This suggests that maybe changing the default output format instead is a better idea (especially since the CLI is intended for humans). But it is obviously a backward incompatible change (assuming someone parses the output for some reason).

For now though: I'm not sure about -h since it's often used for --help. But I don't like --short either, so i've implemented this change. I used --human instead of --human-readable like in du, because in du any prefix of a valid command is accepted, so both will work.

[msm-cert]

Wait, I don't think this works (option -h conflicts with help indeed). Changing to draft for further discussion.

argparse.ArgumentError: argument -h/--human: conflicting option string: -h

[msm-cert]

Changed the default instead. The following invocations were tested:

karton list -o table  # uses the new human readable format
karton list -o json  # uses jsonl
karton list  # uses table by default
karton list -o foo  # shows a helpful error message
karton list --help  # shows a helpful message and the list of options

The syntax -o table and -o json was used to be compatible with mwdb cli, which uses the same convention.

[msm-cert]

🦭

[msm-cert]

(fixed ofc)

[psrok1]

Maybe shutil.get_terminal_size()? We can still set a max width to 72, but maybe we can set shorter padding on narrower terminal?

[psrok1]

Ok, maybe not worth it, 72 characters isn't very wide

------------------------------------------------------------------------