Skip to content

Commit 74e0165

Browse files
Add recommended locales to the testing document (#1187)
* Add recommended locales to the testing document * Apply Ezio's review suggestion Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> * Add reference to locale command for linux/mac --------- Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
1 parent 642fc43 commit 74e0165

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

testing/run-write-tests.rst

+19
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,25 @@ CPython checkout. The script tries to balance speed with thoroughness. But if
9696
you want the most thorough tests you should use the strenuous approach shown
9797
above.
9898

99+
Locale support
100+
--------------
101+
102+
Some tests require specific locales to run successfully. These locales are
103+
often non-default, non-English, non-UTF-8 locales. If a necessary locale is
104+
unavailable, the test is skipped or runs in the dry-run mode.
105+
Additional locales that you may find helpful to set up on developer's machines
106+
or buildbots include:
107+
108+
* ``en_US`` (``en_US.utf8``, ``en_US.iso88591``) --- the standard default
109+
* ``de_DE`` (``de_DE.UTF-8``) or ``fr_FR`` (``fr_FR.utf8``, ``fr_FR.iso88591``,
110+
``fr_FR.iso885915@euro``) --- common non-English locales
111+
* ``tr_TR`` (``tr_TR.iso88599``) --- Turkish has different rules for upper/lower
112+
cases of "i" and "I".
113+
* ``ps_AF`` --- used in ``test_decimal``
114+
115+
On Linux and macOS, the ``locale`` command can be used to list available
116+
locales and change the settings. Environment variables ``LANG`` and those
117+
prefixed with ``LC_`` can be used to set the locale.
99118

100119
Unexpected skips
101120
----------------

0 commit comments

Comments
 (0)