Coverage for devtools/prettier.py: 97.82%
209 statements
« prev ^ index » next coverage.py v7.16.2, created at 2026-10-11 17:56 +0000
« prev ^ index » next coverage.py v7.16.2, created at 2026-10-11 17:56 +0000
1import ast 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
2import io 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
3import os 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
4from collections import OrderedDict 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
5from collections.abc import Callable, Generator, Iterable, Mapping 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
6from functools import cache 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
7from typing import TYPE_CHECKING, Any, TextIO, cast 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
9from .utils import DataClassType, LaxMapping, SQLAlchemyClassType, auto_highlight, env_true 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
11if TYPE_CHECKING: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
12 from pygments.formatters import Terminal256Formatter
13 from pygments.lexer import Lexer
15try: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
16 from sqlalchemy import inspect as sa_inspect 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
17except ImportError:
18 sa_inspect = None
20__all__ = 'PrettyFormat', 'pformat', 'pprint' 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
22PARENTHESES_LOOKUP = [ 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
23 (list, '[', ']'),
24 (set, '{', '}'),
25 (frozenset, 'frozenset({', '})'),
26]
27DEFAULT_WIDTH = int(os.getenv('PY_DEVTOOLS_WIDTH', '120')) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
28MISSING = object() 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
29PRETTY_KEY = '__prettier_formatted_value__' 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
32def fmt(v: Any) -> Any: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
33 return {PRETTY_KEY: v} 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
36class SkipPretty(Exception): 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
37 pass 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
40@cache 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
41def get_pygments() -> 'tuple[Any, Lexer, Terminal256Formatter[str]] | None': 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
42 try: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
43 import pygments 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
44 from pygments.formatters import Terminal256Formatter 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
45 from pygments.lexers import PythonLexer # pyright: ignore[reportUnknownVariableType] 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
46 except ImportError: # pragma: no cover
47 return None
48 else:
49 # the lexers module is lazily populated, so the stubs don't know about individual lexers
50 lexer = cast('Lexer', PythonLexer()) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
51 formatter: Terminal256Formatter[str] = Terminal256Formatter(style='vim') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
52 return pygments, lexer, formatter 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
55# common generator types (this is not exhaustive: things like chain are not include to avoid the import)
56generator_types = Generator, map, filter, zip, enumerate 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
59class PrettyFormat: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
60 def __init__( 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
61 self,
62 indent_step: int = 4,
63 indent_char: str = ' ',
64 repr_strings: bool = False,
65 simple_cutoff: int = 10,
66 width: int = 120,
67 yield_from_generators: bool = True,
68 ):
69 self._stream = io.StringIO() 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
70 self._indent_step = indent_step 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
71 self._c = indent_char 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
72 self._repr_strings = repr_strings 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
73 self._repr_generators = not yield_from_generators 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
74 self._simple_cutoff = simple_cutoff 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
75 self._width = width 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
76 self._type_lookup: list[tuple[Any, Callable[[Any, str, int, int], None]]] = [ 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
77 (dict, self._format_dict),
78 ((str, bytes), self._format_str_bytes),
79 (tuple, self._format_tuples),
80 ((list, set, frozenset), self._format_list_like),
81 (bytearray, self._format_bytearray),
82 (generator_types, self._format_generator),
83 # put these last as the check can be slow
84 (ast.AST, self._format_ast_expression),
85 (LaxMapping, self._format_dict),
86 (DataClassType, self._format_dataclass),
87 (SQLAlchemyClassType, self._format_sqlalchemy_class),
88 ]
90 def __call__(self, value: Any, *, indent: int = 0, indent_first: bool = False, highlight: bool = False) -> str: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
91 # save and restore the stream so `pformat` can be called from inside a `__repr__` without clobbering
92 # the output of the outer call, see #162
93 previous_stream = self._stream 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
94 self._stream = io.StringIO() 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
95 try: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
96 self._format(value, indent_current=indent, indent_first=indent_first) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
97 s = self._stream.getvalue() 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
98 finally:
99 self._stream = previous_stream 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
100 pyg = get_pygments() 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
101 if highlight and pyg: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
102 pygments, pyg_lexer, pyg_formatter = pyg 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
103 # apparently highlight adds a trailing new line we don't want
104 s = pygments.highlight(s, lexer=pyg_lexer, formatter=pyg_formatter).rstrip('\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
105 return s 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
107 def _format(self, value: Any, indent_current: int, indent_first: bool) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
108 if indent_first: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
109 self._stream.write(indent_current * self._c) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
111 try: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
112 pretty_func = value.__pretty__ 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
113 except AttributeError: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
114 pass 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
115 else:
116 # `pretty_func.__class__.__name__ == 'method'` should only be true for bound methods,
117 # `hasattr(pretty_func, '__self__')` is more canonical but weirdly is true for unbound cython functions
118 from unittest.mock import _Call as MockCall # pyright: ignore[reportPrivateUsage] 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
120 if pretty_func.__class__.__name__ == 'method' and not isinstance(value, MockCall): 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
121 try: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
122 gen = pretty_func(fmt=fmt, skip_exc=SkipPretty) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
123 self._render_pretty(gen, indent_current) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
124 except SkipPretty: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
125 pass 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
126 else:
127 return 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
129 value_repr = repr(value) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
130 if len(value_repr) <= self._simple_cutoff and not isinstance(value, generator_types): 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
131 self._stream.write(value_repr) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
132 else:
133 indent_new = indent_current + self._indent_step 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
134 for t, func in self._type_lookup: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
135 if isinstance(value, t): 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
136 func(value, value_repr, indent_current, indent_new) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
137 return 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
139 self._format_raw(value, value_repr, indent_current, indent_new) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
141 def _render_pretty(self, gen: Iterable[str | int | dict[str, Any]], indent: int) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
142 prefix = False 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
143 for v in gen: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
144 if isinstance(v, int) and v in {-1, 0, 1}: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
145 indent += v * self._indent_step 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
146 prefix = True 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
147 else:
148 if prefix: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
149 self._stream.write('\n' + self._c * indent) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
150 prefix = False 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
152 pretty_value = v.get(PRETTY_KEY, MISSING) if (isinstance(v, dict) and len(v) == 1) else MISSING 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
153 if pretty_value is not MISSING: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
154 self._format(pretty_value, indent, False) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
155 elif isinstance(v, str): 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
156 self._stream.write(v) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
157 else:
158 # shouldn't happen but will
159 self._stream.write(repr(v)) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
161 def _format_dict(self, value: Mapping[Any, Any], _: str, indent_current: int, indent_new: int) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
162 open_, before_, split_, after_, close_ = '{\n', indent_new * self._c, ': ', ',\n', '}' 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
163 items: Iterable[tuple[Any, Any]] = value.items() 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
164 if isinstance(value, OrderedDict): 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
165 open_, split_, after_, close_ = 'OrderedDict([\n', ', ', '),\n', '])' 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
166 before_ += '(' 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
167 elif type(value) != dict: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
168 open_, close_ = f'<{value.__class__.__name__}({{\n', '})>' 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
170 self._stream.write(open_) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
171 for k, v in items: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
172 self._stream.write(before_) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
173 self._format(k, indent_new, False) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
174 self._stream.write(split_) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
175 self._format(v, indent_new, False) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
176 self._stream.write(after_) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
177 self._stream.write(indent_current * self._c + close_) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
179 def _format_list_like( 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
180 self, value: list[Any] | tuple[Any, ...] | set[Any], _: str, indent_current: int, indent_new: int
181 ) -> None:
182 open_, close_ = '(', ')' 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
183 for t, *oc in PARENTHESES_LOOKUP: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
184 if isinstance(value, t): 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
185 open_, close_ = oc 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
186 break 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
188 self._stream.write(open_ + '\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
189 for v in value: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
190 self._format(v, indent_new, True) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
191 self._stream.write(',\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
192 self._stream.write(indent_current * self._c + close_) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
194 def _format_tuples(self, value: tuple[Any, ...], value_repr: str, indent_current: int, indent_new: int) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
195 fields = getattr(value, '_fields', None) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
196 if fields: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
197 # named tuple
198 self._format_fields(value, zip(fields, value), indent_current, indent_new) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
199 else:
200 # normal tuples are just like other similar iterables
201 self._format_list_like(value, value_repr, indent_current, indent_new) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
203 def _format_str_bytes(self, value: str | bytes, value_repr: str, indent_current: int, indent_new: int) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
204 if self._repr_strings: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
205 self._stream.write(value_repr) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
206 else:
207 lines = list(self._wrap_lines(value, indent_new)) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
208 if len(lines) > 1: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
209 self._str_lines(lines, indent_current, indent_new) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
210 else:
211 self._stream.write(value_repr) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
213 def _str_lines(self, lines: Iterable[str | bytes], indent_current: int, indent_new: int) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
214 self._stream.write('(\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
215 prefix = indent_new * self._c 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
216 for line in lines: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
217 self._stream.write(prefix + repr(line) + '\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
218 self._stream.write(indent_current * self._c + ')') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
220 def _wrap_lines(self, s: str | bytes, indent_new: int) -> Generator[str | bytes, None, None]: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
221 width = self._width - indent_new - 3 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
222 for line in s.splitlines(True): 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
223 start = 0 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
224 for pos in range(width, len(line), width): 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
225 yield line[start:pos] 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
226 start = pos 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
227 yield line[start:] 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
229 def _format_generator( 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
230 self, value: Generator[Any, None, None], value_repr: str, indent_current: int, indent_new: int
231 ) -> None:
232 if self._repr_generators: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
233 self._stream.write(value_repr) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
234 else:
235 name = value.__class__.__name__ 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
236 if name == 'generator': 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
237 # no name if the name is just "generator"
238 self._stream.write('(\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
239 else:
240 self._stream.write(f'{name}(\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
241 for v in value: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
242 self._format(v, indent_new, True) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
243 self._stream.write(',\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
244 self._stream.write(indent_current * self._c + ')') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
246 def _format_bytearray(self, value: Any, _: str, indent_current: int, indent_new: int) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
247 self._stream.write('bytearray') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
248 lines = self._wrap_lines(bytes(value), indent_new) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
249 self._str_lines(lines, indent_current, indent_new) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
251 def _format_ast_expression(self, value: ast.AST, _: str, indent_current: int, indent_new: int) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
252 try: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
253 s = ast.dump(value, indent=self._indent_step) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
254 except TypeError:
255 # no indent before 3.9
256 s = ast.dump(value)
257 lines = s.splitlines(True) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
258 self._stream.write(lines[0]) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
259 for line in lines[1:]: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
260 self._stream.write(indent_current * self._c + line) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
262 def _format_dataclass(self, value: Any, _: str, indent_current: int, indent_new: int) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
263 try: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
264 field_items = value.__dict__.items() 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
265 except AttributeError: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
266 # slots
267 field_items = ((f, getattr(value, f)) for f in value.__slots__) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
268 self._format_fields(value, field_items, indent_current, indent_new) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
270 def _format_sqlalchemy_class(self, value: Any, _: str, indent_current: int, indent_new: int) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
271 if sa_inspect is not None: 271 ↛ 275line 271 didn't jump to line 275 because the condition on line 271 was always true1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
272 state = sa_inspect(value) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
273 deferred = state.unloaded 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
274 else:
275 deferred: set[str] = set()
277 fields = [ 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
278 (field, getattr(value, field) if field not in deferred else '<deferred>')
279 for field in dir(value)
280 if not (field.startswith('_') or field in ['metadata', 'registry'])
281 ]
282 self._format_fields(value, fields, indent_current, indent_new) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
284 def _format_raw(self, _: Any, value_repr: str, indent_current: int, indent_new: int) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
285 lines = value_repr.splitlines(True) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
286 if len(lines) > 1 or (len(value_repr) + indent_current) >= self._width: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
287 self._stream.write('(\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
288 wrap_at = self._width - indent_new 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
289 prefix = indent_new * self._c 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
291 from textwrap import wrap 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
293 for line in lines: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
294 sub_lines = wrap(line, wrap_at) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
295 for sline in sub_lines: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
296 self._stream.write(prefix + sline + '\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
297 self._stream.write(indent_current * self._c + ')') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
298 else:
299 self._stream.write(value_repr) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
301 def _format_fields( 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
302 self, value: Any, fields: Iterable[tuple[str, Any]], indent_current: int, indent_new: int
303 ) -> None:
304 self._stream.write(f'{value.__class__.__name__}(\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
305 for field, v in fields: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
306 self._stream.write(indent_new * self._c) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
307 if field: # field is falsy sometimes for odd things like call_args 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
308 self._stream.write(f'{field}=') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
309 self._format(v, indent_new, False) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
310 self._stream.write(',\n') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
311 self._stream.write(indent_current * self._c + ')') 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
314pformat = PrettyFormat() 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
315force_highlight = env_true('PY_DEVTOOLS_HIGHLIGHT', None) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
318def pprint(s: Any, file: TextIO | None = None) -> None: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
319 highlight = auto_highlight(file) if force_highlight is None else force_highlight 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ
320 print(pformat(s, highlight=highlight), file=file, flush=True) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ