Render usage through Rich on option errors

[2ykwang]

Fixes #14136

print_usage() fell through to plain optparse and printed the Rich markup literally. override it to render through PipConsole, like print_help().

see below:

before

❯ python -m pip install --updrade

[optparse.groups]Usage:[/]
  ../python -m pip install \[options] <requirement specifier> \[package-index-options] ...
  ../python -m pip install \[options] -r <requirements file> \[package-index-options] ...
  ../python -m pip install \[options] [-e] <vcs project url> ...
  ../python -m pip install \[options] [-e] <local project path> ...
  ../python -m pip install \[options] <archive url/path> ...

no such option: --updrade

after

❯ PYTHONPATH=src python -m pip install --updrade

Usage:
  ../python -m pip install [options] <requirement specifier> [package-index-options] ...
  ../python -m pip install [options] -r <requirements file> [package-index-options] ...
  ../python -m pip install [options] [-e] <vcs project url> ...
  ../python -m pip install [options] [-e] <local project path> ...
  ../python -m pip install [options] <archive url/path> ...

no such option: --updrade

[2ykwang]

The trailing newline from get_usage() is intentional, so no rstrip() here.

pip install [options] ...
    <-- blank line
no such option: --updrade

[KRRT7]

whilst I don't disagree, I do think this should build on top of #14026

[2ykwang]

thanks @KRRT7 for the suggestion took a look.

here's my concern.

pip/src/pip/_internal/utils/logging.py

Lines 194 to 208 in c760425

	def get_console_or_create() -> Console:
	"""Return the stdout console, creating one if logging is not configured yet."""
	global _stdout_console
	if _stdout_console is None:
	_stdout_console = PipConsole(
	file=sys.stdout,
	no_color=(
	"--no-color" in sys.argv
	or os.getenv("PIP_NO_COLOR") == "1"
	or "NO_COLOR" in os.environ
	),
	soft_wrap=True,
	force_terminal=True,
	)
	return _stdout_console

the two need different args though (file, theme, soft_wrap), so they pull in different directions.
I think keeping them separate is cleaner. what would we gain by merging?

[ichard26]

Works and looks great, thank you!

I renamed the _create_console method to _create_console_for_help just so it's clear that this console isn't the main console used by pip. Its only purpose is for highlighting help output.

I agree this is logically separate from the linked PR.