=========================================================
:mod:`PyObjCTools.AppHelper` -- Work with AppKit
=========================================================

.. module:: PyObjCTools.AppHelper
   :synopsis: Work with AppKit

This module exports functions that are useful when working with the
``AppKit`` framework (or more generally, run loops).

.. function:: callAfter(func, *args, **kwargs)

    Call a function on the main thread.  Returns immediately.

.. function:: callLater(delay, func, *args, **kwargs)

    Call a function on the main thread after a delay.  Returns immediately.

.. function:: endSheetMethod(method)

    Convert a method to a form that is suitable to use as the delegate callback
    for sheet methods.
    
    :rtype: selector

.. function:: stopEventLoop()

    Stops the event loop (if started by ``runConsoleEventLoop``) or sends the
    ``NSApplication`` a ``terminate:`` message.

.. function:: runConsoleEventLoop(argv=None, installInterrupt=False, mode=NSDefaultRunLoopMode)

    Run a ``NSRunLoop`` in a stoppable way (with ``stopEventLoop``).

.. function:: runEventLoop(argv=None, unexpectedErrorAlert=unexpectedErrorAlert, installInterrupt=None, pdb=None, main=NSApplicationMain)

    Run the event loop using ``NSApplicationMain`` and ask the user if we should
    continue if an exception is caught.

    This function doesn't return unless it throws an exception.