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

docs/tutorial/exceptions.md

@@ -196,6 +196,16 @@ $ 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
+(by default it's the maximum console width if it can be determined, or otherwise 100):
+
+{* docs_src/exceptions/tutorial005.py hl[3] *}
+
+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,37 @@
+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": "",
+            "PYTHONIOENCODING": "utf-8",
+        },
+    )
+
+    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

@@ -143,13 +143,15 @@ def __init__(
         pretty_exceptions_enable: bool = True,
         pretty_exceptions_show_locals: bool = True,
         pretty_exceptions_short: bool = True,
+        pretty_exceptions_width: Union[int, None] = Default(None),
     ):
         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,
@@ -325,6 +327,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

@@ -527,10 +527,12 @@ def __init__(
         pretty_exceptions_enable: bool = True,
         pretty_exceptions_show_locals: bool = True,
         pretty_exceptions_short: bool = True,
+        pretty_exceptions_width: Union[int, None] = 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
 
 
 class TyperPath(click.Path):

typer/rich_utils.py

@@ -765,6 +765,6 @@ def get_traceback(
         exc.__traceback__,
         show_locals=exception_config.pretty_exceptions_show_locals,
         suppress=internal_dir_names,
-        width=MAX_WIDTH,
+        width=exception_config.pretty_exceptions_width or MAX_WIDTH,
     )
     return rich_tb