Add support for click 8.1.x

click 8.1.0 changed the behavior of the various stored help strings:

  Store unprocessed Command.help, epilog and short_help strings.
  Processing is only done when formatting help text for output.

[1] https://click.palletsprojects.com/en/8.1.x/changes/#version-8-1-0

Signed-off-by: Stephen Finucane <stephen@that.guru>

Author: stephenfin

sphinx_click/ext.py

@@ -1,3 +1,4 @@
+import inspect
 import re
 import traceback
 import warnings
@@ -101,7 +102,7 @@ def _write_opts(opts):
 
 
 def _format_help(help_string):
-    help_string = ANSI_ESC_SEQ_RE.sub('', help_string)
+    help_string = inspect.cleandoc(ANSI_ESC_SEQ_RE.sub('', help_string))
 
     bar_enabled = False
     for line in statemachine.string2lines(

tests/test_formatter.py

@@ -377,7 +377,6 @@ def foobar():
 
             foobar [OPTIONS]
 
-
         An epilog containing pre-wrapped text.
 
         | This is