Add a formatter that handles raw help text, optionally.
authorScott Gasch <[email protected]>
Thu, 3 Feb 2022 23:44:32 +0000 (15:44 -0800)
committerScott Gasch <[email protected]>
Thu, 3 Feb 2022 23:44:32 +0000 (15:44 -0800)
config.py

index 42a7044d21c6d86c0f4a793b81d7a70ed23b04e9..22660cc41c46fc92dba8c32e0caf61c4d5d207c5 100644 (file)
--- 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.',
 )