gh-156414: Document tomllib's limits & "extensions"

[encukou]

• Issue: Document tomllib's limits & extensions #156414

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #34353793 | 📁 Comparing 00640b0 against main (f54fd2a)

  🔍 Preview build  

26 files changed · ± 26 modified

± Modified

• library/ast.html
• library/asyncio-task.html
• library/concurrent.interpreters.html
• library/ctypes.html
• library/doctest.html
• library/fileformats.html
• library/functions.html
• library/imaplib.html
• library/markup.html
• library/mimetypes.html
• and 16 more...

[hauntsaninja]

Thank you! This is okay, but I feel like it still is a little "well you can do this if you want to", when I think we should probably want to mildly discourage people relying on ordering of TOML tables (especially given TOML's stance on the matter toml-lang/toml#162)

[encukou]

I think we should probably want to mildly discourage people relying on ordering of TOML tables

There's a bit of nuance here. I definitely want people to not rely on ordering for interop or semantics. But if you generate something based on a TOML config file, you can assume that the output will be reproducible (if you do everything else right).

[miss-islington-app]

Thanks @encukou for the PR 🌮🎉.. I'm working now to backport this PR to: 3.14.
🐍🍒⛏🤖

[miss-islington-app]

Thanks @encukou for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖

[miss-islington-app]

Thanks @encukou for the PR 🌮🎉.. I'm working now to backport this PR to: 3.15.
🐍🍒⛏🤖

[bedevere-app]

GH-156833 is a backport of this pull request to the 3.14 branch.

[bedevere-app]

GH-156834 is a backport of this pull request to the 3.13 branch.

[bedevere-app]

GH-156835 is a backport of this pull request to the 3.15 branch.