Add a formatter that handles raw help text, optionally.

1 files changed, 15 insertions, 1 deletions

diff --git a/config.py b/config.py
index 42a7044..22660cc 100644
--- a/config.py
+++ b/config.py
@@ -84,10 +84,24 @@ program_name: str = os.path.basename(sys.argv[0])
 original_argv: List[str] = [arg for arg in sys.argv]
 
 
+class OptionalRawFormatter(argparse.HelpFormatter):
+    """This formatter has the same bahavior as the normal argparse text
+    formatter except when the help text of an argument begins with
+    "RAW|".  In that case, the line breaks are preserved and the text
+    is not wrapped.
+
+    """
+
+    def _split_lines(self, text, width):
+        if text.startswith('RAW|'):
+            return text[4:].splitlines()
+        return argparse.HelpFormatter._split_lines(self, text, width)
+
+
 # A global parser that we will collect arguments into.
 args = argparse.ArgumentParser(
     description=None,
-    formatter_class=argparse.ArgumentDefaultsHelpFormatter,
+    formatter_class=OptionalRawFormatter,
     fromfile_prefix_chars="@",
     epilog=f'{program_name} uses config.py ({__file__}) for global, cross-module configuration setup and parsing.',
 )