From 5d9cf79baf07fc4aed7ad1b06990532a65378155 Mon Sep 17 00:00:00 2001 From: Kees Hink Date: Wed, 9 Oct 2019 12:08:31 +0200 Subject: [PATCH] Fixed #27086 -- Doc'd fix for test suite hang on macOS. --- .../contributing/writing-code/unit-tests.txt | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/internals/contributing/writing-code/unit-tests.txt b/docs/internals/contributing/writing-code/unit-tests.txt index e9db0fe44a..a0c47824da 100644 --- a/docs/internals/contributing/writing-code/unit-tests.txt +++ b/docs/internals/contributing/writing-code/unit-tests.txt @@ -380,6 +380,20 @@ Ensure you have the latest point release of a :ref:`supported Python version `, 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`` ----------------------------------------------