Improve `platform` CLI

[Harry-Lees]

Feature or enhancement

Proposal:

Currently, the platform module's CLI is fairly hidden and inaccessible. I think there are two main issues with the module CLI.

1. There is no "Command Line Interface" section of the docs like there is with some other modules e.g. random. (It is, however, listed under the Modules command-line interface section)
2. There is no help section when running the platform CLI, the CLI takes two arguments --terse and --nonaliased, which I could only find from looking at the source in Lib/platform.py.

Has this already been discussed elsewhere?

No response given

Links to previous discussion of this feature:

No response

Linked PRs

• gh-131524: Update platform CLI to use argparse #131542

[Harry-Lees]

I am open to adding the missing documentation/ updating the CLI to use argparse for a help section. I came across this while looking into #131178, so it might be possible to add tests and update the CLI at the same time if this proposal is acceptable.

[sobolevn]

In my opinion, this is a good idea. I also think that we can add better CLI tools for arg parsing (like argparse).

CC @hugovk

[donbarbos]

we also don't have help messages for many other CLI modules that parse flags themselves or use legacy modules to implement cli

I wrote about it here: #93096 (comment)

as already said (in comment) this makes the behavior implicit maybe it's worth opening a new issue to add help flags to each module

[hugovk]

Interestingly, the CLI has been part of the module since it was added in 2003 for Python 2.3 and hasn't changed (beyond print and whitespace): 246d847

In my opinion, this is a good idea. I also think that we can add better CLI tools for arg parsing (like argparse).

Fine by me too.

@Harry-Lees Would you like to open a PR?