gh-145153: The PEP 813 (pretty print protocol) reference implementation - #144931

Draft

warsaw wants to merge 52 commits into

python:mainfrom

Commits on Oct 25, 2025

Plumb optional `pretty` argument into the `print()` function.
warsaw
committed
cbb0b0a
Kinda works, at least for passing in an explicit `pretty` object.
warsaw
committed
7de0338
Fix pretty=True and remove debugging
warsaw
committed
722a72b

Commits on Oct 26, 2025

Call object's __pprint__() function if it has one
warsaw
committed
e84ef57

Commits on Oct 28, 2025

Add some print(..., pretty=) tests
warsaw
committed
e800b63

Commits on Nov 3, 2025

Flesh out the pprint protocol documentation
warsaw
committed
9ed491a

Commits on Nov 4, 2025

The pre-PEP
warsaw
committed
fe61924
Fix a doc lint warning
warsaw
committed
8398cc5
Add some examples
warsaw
committed
955459e

Commits on Nov 5, 2025

__pretty__() is now exactly signatured as PrettyPrinter.format()
warsaw
committed
5b6ce45
Title
warsaw
committed
c304a29
Plumb optional `pretty` argument into the `print()` function.
warsaw
committed
ab0f4ec
Kinda works, at least for passing in an explicit `pretty` object.
warsaw
committed
313ccd1
Fix pretty=True and remove debugging
warsaw
committed
d6766c6
Call object's __pprint__() function if it has one
warsaw
committed
71dcfe7
Add some print(..., pretty=) tests
warsaw
committed
4d237da
Flesh out the pprint protocol documentation
warsaw
committed
bb23638
The pre-PEP
warsaw
committed
3965667
Fix a doc lint warning
warsaw
committed
3e20e37
Add some examples
warsaw
committed
7786ec1
__pretty__() is now exactly signatured as PrettyPrinter.format()
warsaw
committed
5060701
Title
warsaw
committed
41cd667
Merge branch 'pprint' of github.com:warsaw/cpython into pprint
warsaw
committed
52a6a46

Commits on Nov 7, 2025

PEP submitted: https://github.com/python/peps/pull/4690
warsaw
committed
5c6872f
Remove an obsolete comment
warsaw
committed
28fa67d

Commits on Dec 14, 2025

Use a rich.pretty compatible pretty printer API
warsaw
committed
055eda7

Commits on Dec 22, 2025

Commits on Feb 17, 2026

Merge branch 'main' into pprint-merge
warsaw
committed
8944f30
Fix doc lint error
warsaw
committed
3aaa402
Fix a cross-reference
warsaw
committed
7fc13b2

Commits on Feb 22, 2026

Initial version of !p with f-strings.
ericvsmith
committed
575e3f0

Commits on Feb 23, 2026

Update Objects/object.c
warsaw
authored
cb7e204
Update Objects/object.c
warsaw
authored
e1c45f2
Update Objects/object.c
warsaw
authored
bbf612c
Merge pull request #3 from ericvsmith/pprint
warsaw
authored
5355fe4
ruff can't handle the new !p specifier, so ignore that whole file for now
warsaw
committed
90f5b79
Merge branch 'main' into pprint-merge
warsaw
committed
ae8e6e8
Add a blurb for PEP 813 implementation
warsaw
committed
0d8320b

Commits on Feb 24, 2026

False-y names are treated as positional arguments.
warsaw
committed
b331439
Merge branch 'main' into pprint
warsaw
authored
04a776b
Update reference implementation
warsaw
committed
eb88192
Update the print(..., pretty=callable) API
warsaw
committed
556a20d
Flesh out PyObject_Pretty()
warsaw
committed
62a1c04
Use PyObject_Pretty to implement the print(pretty=True) case
warsaw
committed
cd49a51
Update documentation
warsaw
committed
c2fd8d5
Merge branch 'main' into pprint
warsaw
authored
695afcf
`make regen-all`
warsaw
committed
87faf5f
`make regen-limited-abi`
warsaw
committed
662685c

Commits on Mar 26, 2026

Merge branch 'main' into pprint
warsaw
committed
b091062