gh-136278: Document codecs.escape_encode() and codecs.escape_decode()

[Toshaksha]

This PR adds documentation for the functions codecs.escape_encode() and codecs.escape_decode(), which provide a way to encode and decode byte sequences using escape sequences, similar to how repr(bytes) works.

These APIs are primarily used by the pickle module for handling escaped byte sequences safely.

The documentation includes function signatures, a usage example, and background information referencing the previous usage in Python 2's string_escape codec and considerations for reviving this as bytes_escape.

Closes: #136278

• Issue: Write documentation for codecs.escape_encode() and codecs.escape_decode() #136278

---

📚 Documentation preview 📚: https://cpython-previews--136314.org.readthedocs.build/

[Toshaksha]

Hi @StanFromIreland,

Thanks for the feedback and guidance throughout this process!
I have updated the documentation for codecs.escape_encode() and codecs.escape_decode() following the devguide and integrated it into the binary transforms section as suggested.
Please let me know if there are any further changes needed or if I missed anything.

Looking forward to your review!

Best regards,
Toshaksha

[StanFromIreland]

Hello, in the future please reuse prs, it creates clutter otherwise. I will review later.

[Toshaksha]

Thanks, noted! I'll make sure to reuse PRs going forward.

[StanFromIreland]

Where is errors='strict' from?

cpython/Modules/_codecsmodule.c

Line 178 in 5de7e3f

errors: str(accept={str, NoneType}) = None

[Toshaksha]

Thanks for catching that!
I've updated the function signature to use errors=None in accordance with the actual default in _codecsmodule.c.
Let me know if there's anything else you'd like me to adjust. Appreciate your time and feedback!