From: Stan Ulbrych <stan@python.org>
Date: Mon, 22 Jun 2026 11:54:26 +0000 (+0100)
Subject: gh-144133: Add a warning to the `encodings.punycode` documentation (#151812)
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7ec70e1df33098de24d4b2cb181586d04cdde441;p=thirdparty%2FPython%2Fcpython.git

gh-144133: Add a warning to the `encodings.punycode` documentation (#151812)
---

diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst
index 059ed2c03acf..99fcf35aa893 100644
--- a/Doc/library/codecs.rst
+++ b/Doc/library/codecs.rst
@@ -1399,6 +1399,14 @@ encodings.
 | punycode           |         | Implement :rfc:`3492`.    |
 |                    |         | Stateful codecs are not   |
 |                    |         | supported.                |
+|                    |         |                           |
+|                    |         | .. warning::              |
+|                    |         |                           |
+|                    |         |    The decoding and       |
+|                    |         |    encoding algorithms    |
+|                    |         |    scale poorly, so       |
+|                    |         |    limit the length of    |
+|                    |         |    untrusted input.       |
 +--------------------+---------+---------------------------+
 | raw_unicode_escape |         | Latin-1 encoding with     |
 |                    |         | :samp:`\\u{XXXX}` and     |