[3.0.x] Fixed #27086 -- Doc'd fix for test suite hang on macOS.

Backport of 5d9cf79baf from master
This commit is contained in:
Kees Hink 2019-10-09 12:08:31 +02:00 committed by Carlton Gibson
parent 6801166a30
commit fffce1ac4c
1 changed files with 14 additions and 0 deletions

View File

@ -380,6 +380,20 @@ Ensure you have the latest point release of a :ref:`supported Python version
<faq-python-version-support>`, since there are often bugs in earlier versions
that may cause the test suite to fail or hang.
On **macOS** (High Sierra and newer versions), you might see this message
logged, after which the tests hang::
objc[42074]: +[__NSPlaceholderDate initialize] may have been in progress in
another thread when fork() was called.
To avoid this set a ``OBJC_DISABLE_INITIALIZE_FORK_SAFETY`` environment
variable, for example::
$ OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES ./runtests.py
Or add ``export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES`` to your shell's
startup file (e.g. ``~/.profile``).
Many test failures with ``UnicodeEncodeError``
----------------------------------------------