✨ Add option to set the width of the Rich exception output

docs/tutorial/exceptions.md

@@ -202,6 +202,17 @@ $ python main.py
 
 </div>
 
+
+## Set Output Width
+
+If you want to control the width of the yellow and red Rich exception borders, you can set the parameter `pretty_exceptions_width` to a specific integer (it's 100 by default):
+
+```Python hl_lines="3"
+{!../docs_src/exceptions/tutorial005.py!}
+```
+
+This prevents artificial line breaks in cases where there is sufficient horizontal space on the console.
+
 ## Disable Pretty Exceptions
 
 You can also entirely disable pretty exceptions with the parameter `pretty_exceptions_enable=False`:

docs_src/exceptions/tutorial005.py

@@ -0,0 +1,39 @@
+import typer
+
+app = typer.Typer(pretty_exceptions_width=120)
+
+
+@app.command()
+def main(name: str = "morty"):
+    deep_dict_or_json = {
+        "this_is_a_long_key": {
+            "this_is_the_next_long_key": {
+                "this_is_the_next_long_key": {
+                    "this_is_the_next_long_key": {
+                        "this_is_the_next_long_key": {
+                            "this_is_the_next_long_key": {
+                                "this_is_the_next_long_key": {
+                                    "this_is_the_next_long_key": {
+                                        "this_is_the_next_long_key": {
+                                            "this_is_the_next_long_key": {
+                                                "and_once_again_a_very_long_key": {
+                                                    "but_this_is_not_the_end": {
+                                                        "end": True
+                                                    }
+                                                }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+    print(name + deep_dict_or_json + 3)
+
+
+if __name__ == "__main__":
+    app()

tests/test_tutorial/test_exceptions/test_tutorial005.py

@@ -0,0 +1,34 @@
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+from typer.testing import CliRunner
+
+from docs_src.exceptions import tutorial005 as mod
+
+runner = CliRunner()
+
+
+def test_traceback_rich_pretty_width():
+    file_path = Path(mod.__file__)
+    result = subprocess.run(
+        [sys.executable, "-m", "coverage", "run", str(file_path)],
+        capture_output=True,
+        encoding="utf-8",
+        env={**os.environ, "_TYPER_STANDARD_TRACEBACK": ""},
+    )
+    print(result.stderr)
+
+    assert "print(name + deep_dict_or_json + 3)" in result.stderr
+    assert 'TypeError: can only concatenate str (not "dict") to str' in result.stderr
+    assert "name = 'morty'" in result.stderr
+
+
+def test_script():
+    result = subprocess.run(
+        [sys.executable, "-m", "coverage", "run", mod.__file__, "--help"],
+        capture_output=True,
+        encoding="utf-8",
+    )
+    assert "Usage" in result.stdout

typer/main.py

@@ -75,6 +75,7 @@ def except_hook(
             exc.__traceback__,
             show_locals=exception_config.pretty_exceptions_show_locals,
             suppress=supress_internal_dir_names,
+            width=exception_config.pretty_exceptions_width,
         )
         console_stderr.print(rich_tb)
         return
@@ -137,13 +138,15 @@ def __init__(
         pretty_exceptions_enable: bool = True,
         pretty_exceptions_show_locals: bool = True,
         pretty_exceptions_short: bool = True,
+        pretty_exceptions_width: int = 100,
     ):
         self._add_completion = add_completion
         self.rich_markup_mode: MarkupMode = rich_markup_mode
         self.rich_help_panel = rich_help_panel
         self.pretty_exceptions_enable = pretty_exceptions_enable
         self.pretty_exceptions_show_locals = pretty_exceptions_show_locals
         self.pretty_exceptions_short = pretty_exceptions_short
+        self.pretty_exceptions_width = pretty_exceptions_width
         self.info = TyperInfo(
             name=name,
             cls=cls,
@@ -321,6 +324,7 @@ def __call__(self, *args: Any, **kwargs: Any) -> Any:
                     pretty_exceptions_enable=self.pretty_exceptions_enable,
                     pretty_exceptions_show_locals=self.pretty_exceptions_show_locals,
                     pretty_exceptions_short=self.pretty_exceptions_short,
+                    pretty_exceptions_width=self.pretty_exceptions_width,
                 ),
             )
             raise e

typer/models.py

@@ -513,7 +513,9 @@ def __init__(
         pretty_exceptions_enable: bool = True,
         pretty_exceptions_show_locals: bool = True,
         pretty_exceptions_short: bool = True,
+        pretty_exceptions_width: int = 100,
     ) -> None:
         self.pretty_exceptions_enable = pretty_exceptions_enable
         self.pretty_exceptions_show_locals = pretty_exceptions_show_locals
         self.pretty_exceptions_short = pretty_exceptions_short
+        self.pretty_exceptions_width = pretty_exceptions_width