gh-130578: clarify urllib.parse.quote parameter defaults behavior

[Mr-Sunglasses]

fix: #130578

• Issue: urllib.parse.quote is not consistent about encoding and errors defaults #130578

---

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

[StanFromIreland]

Requesting @gvanrossum since you originally added this.

[gvanrossum]

Sorry, I no longer do such code reviews.

[vadmium]

This looks like an improvement to me, although it would be more complete to explicitly allow passing None even when string is a byte string.

FWIW I would write something like

If string is a str object, encoding and errors specify how to deal with non-ASCII characters. If encoding is None, the 'utf-8' encoding is used as default. If errors is None, the 'strict' error handler is used as default. All other encoding and error values accepted by str.encode are also allowed.

If string is a bytes object, encoding and errors must be None, or a TypeError is raised.

[github-actions]

This PR is stale because it has been open for 30 days with no activity.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #32799520 | 📁 Comparing 40a8925 against main (65f9932)

  🔍 Preview build  

1 file changed

± library/urllib.parse.html