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