From 673353808b46f1e25241eec8a7f0e855de6218c4 Mon Sep 17 00:00:00 2001 From: Barry Warsaw Date: Sun, 19 Apr 2026 14:22:37 -0700 Subject: [PATCH 1/2] Describe encoding requirements --- peps/pep-0829.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/peps/pep-0829.rst b/peps/pep-0829.rst index 8e0904e94e2..bbb98add7ef 100644 --- a/peps/pep-0829.rst +++ b/peps/pep-0829.rst @@ -215,6 +215,20 @@ continues. continues to the next entry point. +Encoding +-------- + +``.start`` files **MUST** be encoded with `utf-8-sig +`_, +i.e. UTF-8 with optional byte-order mark. + +``.pth`` files **SHOULD** also be ``utf-8-sig`` encoded as well. +Currently, decoding ``.pth`` files falls back to the current locale if +not encoded with ``utf-8-sig``, but this PEP deprecates that support for 5 +years, after which ``.pth`` files **MUST** be encoded with ``utf-8-sig`` +as well. + + .. _future: Future Improvements @@ -467,6 +481,12 @@ Open Issues Change History ============== +``17-Apr-2026`` + +* Added a description of the encoding requirements for ``.start`` and + ``.pth`` files. +* Update the migration guidelines. + `15-Apr-2026 `__ * During the deprecation period, warnings about ``import`` lines in From 1b412ef1c4e09f331022d0e329fbbfc0422778c0 Mon Sep 17 00:00:00 2001 From: Barry Warsaw Date: Sun, 19 Apr 2026 14:23:27 -0700 Subject: [PATCH 2/2] Change History date --- peps/pep-0829.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/peps/pep-0829.rst b/peps/pep-0829.rst index bbb98add7ef..bf040ec815d 100644 --- a/peps/pep-0829.rst +++ b/peps/pep-0829.rst @@ -481,7 +481,7 @@ Open Issues Change History ============== -``17-Apr-2026`` +``19-Apr-2026`` * Added a description of the encoding requirements for ``.start`` and ``.pth`` files.