From a0d16b1a88e27ee4a5e88cd2d75a1af98af6b6b3 Mon Sep 17 00:00:00 2001 From: William Woodruff Date: Wed, 24 Dec 2025 23:31:01 -0500 Subject: [PATCH 1/2] pypirc: stipulate UTF-8 encoding Signed-off-by: William Woodruff --- source/specifications/pypirc.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/specifications/pypirc.rst b/source/specifications/pypirc.rst index aeba72b0d..e2711614d 100644 --- a/source/specifications/pypirc.rst +++ b/source/specifications/pypirc.rst @@ -5,6 +5,13 @@ The :file:`.pypirc` file ======================== +.. important:: + + The :file:`.pypirc` file **SHOULD** be UTF-8 encoded. + + Tools that read or write :file:`.pypirc` files may not function correctly + if another character encoding is used. + A :file:`.pypirc` file allows you to define the configuration for :term:`package indexes ` (referred to here as "repositories"), so that you don't have to enter the URL, username, or password whenever you upload a package with From 78b4061aaca53a01ac26b07032ea2e962b506c4f Mon Sep 17 00:00:00 2001 From: William Woodruff Date: Tue, 10 Feb 2026 12:24:39 -0500 Subject: [PATCH 2/2] Feedback Signed-off-by: William Woodruff --- source/specifications/pypirc.rst | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/source/specifications/pypirc.rst b/source/specifications/pypirc.rst index e2711614d..b937a1d62 100644 --- a/source/specifications/pypirc.rst +++ b/source/specifications/pypirc.rst @@ -5,18 +5,16 @@ The :file:`.pypirc` file ======================== -.. important:: - - The :file:`.pypirc` file **SHOULD** be UTF-8 encoded. - - Tools that read or write :file:`.pypirc` files may not function correctly - if another character encoding is used. - A :file:`.pypirc` file allows you to define the configuration for :term:`package indexes ` (referred to here as "repositories"), so that you don't have to enter the URL, username, or password whenever you upload a package with :ref:`twine` or :ref:`flit`. +The :file:`.pypirc` file **SHOULD** be UTF-8 encoded. + +Tools that read or write :file:`.pypirc` files may not function correctly +if another character encoding is used. + The format (originally defined by the :ref:`distutils` package) is: .. code-block:: ini