summaryrefslogtreecommitdiff
path: root/docs/internals/contributing/writing-code
diff options
context:
space:
mode:
authorKees Hink <keeshink@gmail.com>2019-10-09 12:08:31 +0200
committerCarlton Gibson <carlton.gibson@noumenal.es>2019-10-09 15:51:00 +0200
commit4f7ba25e67681efbb67cc4810e919aa7369cbe34 (patch)
treebe7a456c538640eb9e1b5fa605669b96ee4e25d8 /docs/internals/contributing/writing-code
parentc22945f4c738f770f4842c6c939690684329a783 (diff)
[2.2.x] Fixed #27086 -- Doc'd fix for test suite hang on macOS.
Backport of 5d9cf79baf07fc4aed7ad1b06990532a65378155 from master
Diffstat (limited to 'docs/internals/contributing/writing-code')
-rw-r--r--docs/internals/contributing/writing-code/unit-tests.txt14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/internals/contributing/writing-code/unit-tests.txt b/docs/internals/contributing/writing-code/unit-tests.txt
index 185c6e4494..a26993141a 100644
--- a/docs/internals/contributing/writing-code/unit-tests.txt
+++ b/docs/internals/contributing/writing-code/unit-tests.txt
@@ -331,6 +331,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``
----------------------------------------------