| Georg Brandl | 8ec7f65 | 2007-08-15 14:28:01 +0000 | [diff] [blame] | 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 | |
| Georg Brandl | 8a710dc | 2008-05-25 12:34:57 +0000 | [diff] [blame] | 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 | |
| Georg Brandl | 8ec7f65 | 2007-08-15 14:28:01 +0000 | [diff] [blame] | 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 | |