Doc/library/dummy_thread.rst

   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.0.  The :term:`2to3` tool will automatically adapt imports when
  10    converting your sources to 3.0; however, you should consider using the
  11    high-lever :mod:`dummy_threading` module instead.
  12
  13
  14 This module provides a duplicate interface to the :mod:`thread` module.  It is
  15 meant to be imported when the :mod:`thread` module is not provided on a
  16 platform.
  17
  18 Suggested usage is::
  19
  20    try:
  21        import thread as _thread
  22    except ImportError:
  23        import dummy_thread as _thread
  24
  25 Be careful to not use this module where deadlock might occur from a thread
  26 being created that blocks waiting for another thread to be created.  This  often
  27 occurs with blocking I/O.
  28