Metadata-Version: 1.0
Name: interruptingcow
Version: 0.2
Summary: A watchdog that interrupts long running code.
Home-page: https://bitbucket.org/evzijst/interruptingcow
Author: Erik van Zijst
Author-email: erik.van.zijst@gmail.com
License: GNU LGPL
Download-URL: https://bitbucket.org/evzijst/interruptingcow/downloads/interruptingcow-0.2.tar.gz
Description: Interrupting Cow
        ================
        
        MOOOOO!
        
        
        Overview
        --------
        
        Interruptingcow is a generic utility can relatively gracefully interrupt your
        Python code when it doesn't execute within a specific number of seconds::
        
            from interruptingcow import interruptingcow, InterruptedException
        
            try:
                with interruptingcow(timeout=5):
                    # perform a potentially very slow operation
                    pass
            except InterruptedException:
                print "didn't finish within 5 seconds"
        
        
        Installation
        ------------
        ::
        
            $ pip install interruptingcow
        
        Caveats
        -------
        
        Interruptingcow uses ``signal(SIGALRM)`` to let the operating system interrupt
        program execution. This has the following limitations:
        
        1. ``SIGALRM`` is not reentrant so you can not nest timeouts
        2. Python signal handlers only apply to the main thread, so you cannot use this
           from other threads
        3. You must not use this in a program that uses ``SIGALRM`` itself
        
Keywords: debug watchdog timer interrupt
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Utilities
