From 3e15ca5ee264d419249ff95f1b67df64a8e979a0 Mon Sep 17 00:00:00 2001 From: Paul Kehrer Date: Tue, 1 Aug 2017 21:21:19 -0500 Subject: deprecate unicode input for RFC822Name (#3836) * deprecate unicode input for RFC822Name * pep8...? --- docs/x509/reference.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) (limited to 'docs') diff --git a/docs/x509/reference.rst b/docs/x509/reference.rst index 5b0bcd45..8b976119 100644 --- a/docs/x509/reference.rst +++ b/docs/x509/reference.rst @@ -1232,8 +1232,24 @@ General Name Classes This corresponds to an email address. For example, ``user@example.com``. + ..note:: + + Starting with version 2.1 unicode input is deprecated. If passing an + internationalized domain name (IDN) you should first IDNA encode the + hostname and then pass the resulting bytes. + + .. attribute:: bytes_value + + .. versionadded:: 2.1 + + :type: bytes + .. attribute:: value + .. deprecated:: 2.1 + + Deprecated accessor for the idna-decoded value of :attr:`bytes_value` + :type: :term:`text` .. class:: DNSName(value) -- cgit v1.2.3