Add linewrap arg in top-level docstring and allow disabling by False

Author: cknd

demo_complex.py

@@ -6,4 +6,7 @@
         Hovercraft().eels()
     except:
         # raise
-        stackprinter.show(style='darkbg2', reverse=False, suppressed_paths=[r"lib/python.*/site-packages/numpy"])
+        stackprinter.show(style='darkbg2',
+                          line_wrap=40,
+                          reverse=False,
+                          suppressed_paths=[r"lib/python.*/site-packages/numpy"])

stackprinter/__init__.py

@@ -106,6 +106,10 @@ def format(thing=None, **kwargs):
         Maximum number of characters to be used for each variable value.
         Default: 500
 
+    line_wrap: int (default 60)
+        Limit how many columns are available to print each variable
+        (excluding its name). Set to 0 or False to disable wrapping.
+
     suppressed_paths: list of regex patterns
         Set less verbose formatting for frames whose code lives in certain paths
         (e.g. library code). Files whose path matches any of the given regex

stackprinter/frame_formatting.py

@@ -22,7 +22,8 @@ class FrameFormatter():
     val_tpl = ' ' * var_indent + "%s = %s\n"
 
     def __init__(self, source_lines=5, source_lines_after=1,
-                 show_signature=True, show_vals='like_source', truncate_vals=500, line_wrap: int = 60,
+                 show_signature=True, show_vals='like_source',
+                 truncate_vals=500, line_wrap: int = 60,
                  suppressed_paths=None):
         """
         Formatter for single frames.
@@ -56,7 +57,8 @@ def __init__(self, source_lines=5, source_lines_after=1,
             Maximum number of characters to be used for each variable value
 
         line_wrap: int (default 60)
-            insert linebreaks after this nr of characters, use 0 to never insert a linebreak
+            insert linebreaks after this nr of characters, use 0 to never insert
+            a linebreak
 
         suppressed_paths: list of regex patterns
             Set less verbose formatting for frames whose code lives in certain paths
@@ -86,7 +88,7 @@ def __init__(self, source_lines=5, source_lines_after=1,
         self.show_vals = show_vals
         self.truncate_vals = truncate_vals
         self.line_wrap = line_wrap
-        self.suppressed_paths = suppressed_paths  # already compile regexes and make a `match` callable?
+        self.suppressed_paths = suppressed_paths
 
     def __call__(self, frame, lineno=None):
         """
@@ -178,7 +180,8 @@ def _format_assignments(self, assignments):
         for name, value in assignments.items():
             val_str = format_value(value,
                                    indent=len(name) + self.var_indent + 3,
-                                   truncation=self.truncate_vals, wrap=self.line_wrap)
+                                   truncation=self.truncate_vals,
+                                   wrap=self.line_wrap)
             assign_str = self.val_tpl % (name, val_str)
             msgs.append(assign_str)
         if len(msgs) > 0:
@@ -333,7 +336,8 @@ def _format_assignments(self, assignments, colormap):
         for name, value in assignments.items():
             val_str = format_value(value,
                                    indent=len(name) + self.var_indent + 3,
-                                   truncation=self.truncate_vals, wrap=self.line_wrap)
+                                   truncation=self.truncate_vals,
+                                   wrap=self.line_wrap)
             assign_str = self.val_tpl % (name, val_str)
             hue, sat, val, bold = colormap.get(name, self.colors['var_invisible'])
             clr_str = get_ansi_tpl(hue, sat, val, bold) % assign_str

stackprinter/prettyprinting.py

@@ -241,7 +241,7 @@ def truncate(string, n):
 
 
 def wrap_lines(string, max_width=80):
-    if max_width <= 0:
+    if not max_width or max_width <= 0:
         return string
 
     def wrap(lines):