diff options
Diffstat (limited to 'Doc/library/dummy_threading.rst')
| -rw-r--r-- | Doc/library/dummy_threading.rst | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/Doc/library/dummy_threading.rst b/Doc/library/dummy_threading.rst new file mode 100644 index 0000000..0ffb687 --- /dev/null +++ b/Doc/library/dummy_threading.rst @@ -0,0 +1,23 @@ + +:mod:`dummy_threading` --- Drop-in replacement for the :mod:`threading` module +============================================================================== + +.. module:: dummy_threading + :synopsis: Drop-in replacement for the threading module. + + +This module provides a duplicate interface to the :mod:`threading` module. It +is meant to be imported when the :mod:`thread` module is not provided on a +platform. + +Suggested usage is:: + + try: + import threading as _threading + except ImportError: + import dummy_threading as _threading + +Be careful to not use this module where deadlock might occur from a thread +being created that blocks waiting for another thread to be created. This often +occurs with blocking I/O. + |