[fedonman]

The array_hook parameter added to the JSON decoders in gh-146440 has version notes but no example, while the "Customizing JSON object decoding" section only shows object_hook and parse_float.

This adds two short examples there: one turning every JSON array into a tuple, and one pairing array_hook with object_pairs_hook to get a deeply immutable result, which is the use case the JSONDecoder docstring already describes. Both are marked # doctest: +SKIP, since the parameter needs Python 3.15 or later and the docs are often built with an older interpreter.

While there, it fixes a small wording slip in the array_hook parameter description ("decoded with as a Python list") and a typo ("structute") in the JSONDecoder docstring.

Documentation only, so there is no news entry.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #33765008 | 📁 Comparing 4f627df against main (206788a)

  🔍 Preview build  

11 files changed · ± 11 modified

± Modified

• license.html
• library/asyncio-eventloop.html
• library/ctypes.html
• library/difflib.html
• library/exceptions.html
• library/json.html
• library/logging.handlers.html
• library/msvcrt.html
• library/stdtypes.html
• whatsnew/3.16.html
• and 1 more...

[miss-islington-app]

Thanks @fedonman for the PR, and @ambv for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14, 3.15.
🐍🍒⛏🤖

[miss-islington-app]

Sorry, @fedonman and @ambv, I could not cleanly backport this to 3.14 due to a conflict.

Please backport manually with cherry_picker, see the devguide for more information.

cherry_picker 6d6b1ab4c8a8f3d1c94b3fa94e691cf9a81d2589 3.14

[bedevere-app]

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