Rich Click breaks contract of Click's format_help and its callers

[BrutalSimplicity]

In Click, get_help calls the format_help method with a formatter that is expected to hold a buffer of the text that should be returned from the method as a string. Since rich_click does not write the terminal output to the buffer, but directly to the console, it breaks callers of get_help that expect to receive the console output.

def get_help(self, ctx: Context) -> str:
    """Formats the help into a string and returns it.

    Calls :meth:`format_help` internally.
    """
    formatter = ctx.make_formatter()
    self.format_help(ctx, formatter)
    return formatter.getvalue().rstrip("\n")

This may not be a problem for rich_click to solve, as I'm not sure the formatter interface would support all of the capabilities of Rich. But, it would be great if the API of Click could be maintained.

Is this a problem that can be fixed by the following:

1. Pass a string buffer to Rich Console that writes help output.
2. Create a stub formatter implementing the getvalue method that returns the string buffer, or, override the get_help method to call format_help without the formatter and return the string buffer directly from Rich.

Rich Reference:

• https://rich.readthedocs.io/en/stable/console.html#capturing-output