diff options
Diffstat (limited to 'Doc/library/dummy_thread.rst')
-rw-r--r-- | Doc/library/dummy_thread.rst | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/Doc/library/dummy_thread.rst b/Doc/library/dummy_thread.rst new file mode 100644 index 0000000000..0b2cb179a6 --- /dev/null +++ b/Doc/library/dummy_thread.rst @@ -0,0 +1,23 @@ + +:mod:`dummy_thread` --- Drop-in replacement for the :mod:`thread` module +======================================================================== + +.. module:: dummy_thread + :synopsis: Drop-in replacement for the thread module. + + +This module provides a duplicate interface to the :mod:`thread` module. It is +meant to be imported when the :mod:`thread` module is not provided on a +platform. + +Suggested usage is:: + + try: + import thread as _thread + except ImportError: + import dummy_thread as _thread + +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. + |