gh-131524: Update platform CLI to use argparse

[Harry-Lees]

Closes: #131524
Related To: #131178

This PR updates the platform CLI to use argparse which adds --help flags and a usage section which was previously unavailable.

• Issue: Improve platform CLI #131524

[sobolevn]

And don't forget about a NEWS entry :)

[hugovk]

We now have help which shows the arguments:

❯ ./python.exe -m platform -h
usage: python.exe -m platform [-h] [--terse] [--nonaliased] [{nonaliased,terse} ...]

positional arguments:
  {nonaliased,terse}

options:
  -h, --help          show this help message and exit
  --terse
  --nonaliased

But doesn't say what they do. Please can you add short descriptions?

[Harry-Lees]

But doesn't say what they do. Please can you add short descriptions?

The help message now gives a short description of each flag

usage: python.exe -m platform [-h] [--terse] [--nonaliased] [{nonaliased,terse} ...]

positional arguments:
  {nonaliased,terse}

options:
  -h, --help          show this help message and exit
  --terse             return only the absolute minimum information needed to identify the platform
  --nonaliased        disable system/ OS name aliasing. If aliasing is enabled, some platforms will report system names which differ from their common names, e.g. SunOS will be reported
                      as Solaris

[donBarbos]

Maybe it's worth adding a Command-line Usage section to the platform documentation?

[hugovk]

Maybe it's worth adding a Command-line Usage section to the platform documentation?

This can be a followup PR.

[hugovk]

Thanks!

[hugovk]

@donBarbos GitHub says you requested changes, is there anything outstanding on this PR?

[donBarbos]

sorry, I thought I was only leaving comments