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

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

8 

9from .utils import DataClassType, LaxMapping, SQLAlchemyClassType, auto_highlight, env_true 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

10 

11if TYPE_CHECKING: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

12 from pygments.formatters import Terminal256Formatter 

13 from pygments.lexer import Lexer 

14 

15try: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

16 from sqlalchemy import inspect as sa_inspect 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

17except ImportError: 

18 sa_inspect = None 

19 

20__all__ = 'PrettyFormat', 'pformat', 'pprint' 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

21 

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

30 

31 

32def fmt(v: Any) -> Any: 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

33 return {PRETTY_KEY: v} 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

34 

35 

36class SkipPretty(Exception): 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

37 pass 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

38 

39 

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

53 

54 

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

57 

58 

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 ] 

89 

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

106 

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

110 

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

119 

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

128 

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

138 

139 self._format_raw(value, value_repr, indent_current, indent_new) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

140 

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

151 

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

160 

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

169 

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

178 

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

187 

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

193 

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

202 

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

212 

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

219 

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

228 

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

245 

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

250 

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

261 

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

269 

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() 

276 

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

283 

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

290 

291 from textwrap import wrap 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

292 

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

300 

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

312 

313 

314pformat = PrettyFormat() 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

315force_highlight = env_true('PY_DEVTOOLS_HIGHLIGHT', None) 1abcdefghijklmnopqrstuvwxyzABCDEFGHIJ

316 

317 

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