Home | History | Annotate | Download | only in library
      1 :mod:`dummy_thread` --- Drop-in replacement for the :mod:`thread` module
      2 ========================================================================
      3 
      4 .. module:: dummy_thread
      5    :synopsis: Drop-in replacement for the thread module.
      6 
      7 .. note::
      8    The :mod:`dummy_thread` module has been renamed to :mod:`_dummy_thread` in
      9    Python 3.  The :term:`2to3` tool will automatically adapt imports when
     10    converting your sources to Python 3; however, you should consider using the
     11    high-lever :mod:`dummy_threading` module instead.
     12 
     13 **Source code:** :source:`Lib/dummy_thread.py`
     14 
     15 --------------
     16 
     17 This module provides a duplicate interface to the :mod:`thread` module.  It is
     18 meant to be imported when the :mod:`thread` module is not provided on a
     19 platform.
     20 
     21 Suggested usage is::
     22 
     23    try:
     24        import thread as _thread
     25    except ImportError:
     26        import dummy_thread as _thread
     27 
     28 Be careful to not use this module where deadlock might occur from a thread
     29 being created that blocks waiting for another thread to be created.  This  often
     30 occurs with blocking I/O.
     31 
     32