[warsaw]

From the Change History section:

• __pprint__() describes an object's structure, and the printer makes all layout decisions.
• Section markers pprint.VALUES, pprint.KWARGS and pprint.ITEMS say how tuples are read, replacing the reading of tuples by their shape and the "false-y" name for positional tuple values.
• Add pprint.Layout for an object's chrome, the pprint.DELEGATE marker, and the pprint.Keyword and pprint.Entry types. The markers are PEP 661 sentinels.
• Specify that the default printer reads the stream permissively, and that other printers may define their own vocabulary.
• Add pprint.decompose(), and the pprint.LEAF sentinel that it returns for a leaf.
• Defer a table of markers in the default printer, and a way to change the default printer.
• Add pprint.DescriptionType for annotating __pprint__() methods.
• Add a hints attribute to pprint.Layout, for particular printers.
• Add a hug attribute to pprint.Layout, so that defaultdict and similar types keep PrettyPrinter's layout.
• Add a new default printer, pprint.Printer, and leave pprint.PrettyPrinter unchanged.
• A printer returns an iterable of lines, and !p joins them with '\n'.
• Specify how the default printer lays out, sorts and limits the depth of nested objects, including keys that wrap.
• The default printer's expand option takes a pprint.Expand member: NEVER, FIT or ALWAYS. Its defaults are width=78, indent=4 and expand=Expand.FIT.
• The default printer's compact option works with every expand mode.
• The built-in and standard library container types implement __pprint__(). str and bytes describe themselves with the new pprint.BreakableString and pprint.BreakableBytes, and int and float with the new pprint.FormattableNumber, so the printer handles no type natively.
• The default printer's number_format option replaces underscore_numbers.
• Specify when an inherited __pprint__() is used, and explain why.
• dataclasses and namedtuple() generate __pprint__() methods.
• The !p format spec is a single replacement field, f'{obj!p:{printer}}', whose value is called without first being converted to a string. Any other spec is a SyntaxError.
• A printer of None means the default printer, in f-strings, t-strings and PyObject_Pretty().
• In str.format(), a format spec after !p pads the pretty printed string.
• T-strings support !p. Interpolation gets a printer attribute, and string.templatelib.convert() handles 'p'.
• Describe compatibility with Rich, IPython and other pretty printing protocols.
• Move the Rationale section after the Specification, as PEP 12 now recommends.

[read-the-docs-community]

Documentation build overview

📚 pep-previews | 🛠️ Build #35369583 | 📁 Comparing 587a7d4 against latest (d999c84)

  🔍 Preview build  

12 files changed · ± 12 modified

± Modified

• pep-0011/index.html
• pep-0480/index.html
• pep-0694/index.html
• pep-0710/index.html
• pep-0711/index.html
• pep-0766/index.html
• pep-0777/index.html
• pep-0807/index.html
• pep-0813/index.html
• pep-0819/index.html
• and 2 more...