diff options
| author | Kees Hink <keeshink@gmail.com> | 2019-10-09 12:08:31 +0200 |
|---|---|---|
| committer | Carlton Gibson <carlton.gibson@noumenal.es> | 2019-10-09 15:49:19 +0200 |
| commit | fffce1ac4c412ec49bde659b79dd943266c9434f (patch) | |
| tree | be588b475511288dfe956e9565b4410a4b7bba20 /docs/internals/contributing/writing-code/unit-tests.txt | |
| parent | 6801166a30f67a4e5e4ac4cede84a4e85ce8882a (diff) | |
[3.0.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/unit-tests.txt')
| -rw-r--r-- | docs/internals/contributing/writing-code/unit-tests.txt | 14 |
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 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 <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`` ---------------------------------------------- |