gh-142035: Make TextWrapper ANSI-aware

[kdeldycke]

Description

Add a text_len parameter to textwrap.wrap, textwrap.fill, textwrap.shorten and textwrap.TextWrapper. It customizes how the visible width of a string is measured, so text that contains zero-width or double-width characters, or invisible ANSI escape sequences, can be wrapped correctly.

Context

I am a maintainer of Click and had to maintain my own local fork of TextWrapper to make it strip ANSI strings properly. See my initial code at: pallets/click#3420 . This PR is a direct port of that code to Python standard library.

This PR:

• Closes Argparse wrapping is bugged when colors are involved #142035
• Closes textwrap.wrap: add control for fonts with different character widths #56708
• Supersede gh-56708: support custom len function in textwrap.wrap #28136 which has been stuck for 5 years.

• Issue: Argparse wrapping is bugged when colors are involved #142035

[bedevere-app]

Most changes to Python require a NEWS entry. Add one using the blurb_it web app or the blurb command-line tool.

If this change has little impact on Python users, wait for a maintainer to apply the skip news label instead.

[python-cla-bot]

All commit authors signed the Contributor License Agreement.

[bedevere-app]

Most changes to Python require a NEWS entry. Add one using the blurb_it web app or the blurb command-line tool.

If this change has little impact on Python users, wait for a maintainer to apply the skip news label instead.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #33377445 | 📁 Comparing 090c887 against main (f1c5363)

  🔍 Preview build  

3 files changed

± library/textwrap.html
± whatsnew/3.16.html
± whatsnew/changelog.html