/Doc/library/autogil.rst

http://unladen-swallow.googlecode.com/ · ReStructuredText · 35 lines · 21 code · 14 blank · 0 comment · 0 complexity · e5baa3749effbca7d1acbc63d89e3d1b MD5 · raw file 

    

  1. :mod:`autoGIL` --- Global Interpreter Lock handling in event loops
    2. 

  2. ==================================================================
    3. 

  3. 

  4. .. module:: autoGIL
    5. 

  5.    :platform: Mac
    6. 

  6.    :synopsis: Global Interpreter Lock handling in event loops.
    7. 

  7.    :deprecated:
    8. 

  8. .. moduleauthor:: Just van Rossum <just@letterror.com>
    9. 

  9. 

  10. 

  11. The :mod:`autoGIL` module provides a function :func:`installAutoGIL` that
    12. 

  12. automatically locks and unlocks Python's :term:`Global Interpreter Lock` when
    13. 

  13. running an event loop.
    14. 

  14. 

  15. .. note::
    16. 

  16. 

  17.    This module has been removed in Python 3.x.
    18. 

  18. 

  19. 

  20. .. exception:: AutoGILError
    21. 

  21. 

  22.    Raised if the observer callback cannot be installed, for example because the
    23. 

  23.    current thread does not have a run loop.
    24. 

  24. 

  25. 

  26. .. function:: installAutoGIL()
    27. 

  27. 

  28.    Install an observer callback in the event loop (CFRunLoop) for the current
    29. 

  29.    thread, that will lock and unlock the Global Interpreter Lock (GIL) at
    30. 

  30.    appropriate times, allowing other Python threads to run while the event loop is
    31. 

  31.    idle.
    32. 

  32. 

  33.    Availability: OSX 10.1 or later.
    34.