Metadata-Version: 1.0
Name: interruptingcow
Version: 0.3
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.3.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 timeout
        
            try:
                with timeout(5):
                    # perform a potentially very slow operation
                    pass
            except RuntimeError:
                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. Python signal handlers only apply to the main thread, so you cannot use this
           from other threads
        2. 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
