A watchdog that interrupts long running code.
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, exception=RuntimeError): # perform a potentially very slow operation pass except RuntimeError: print "didn't finish within 5 seconds"
Timeouts are specified in seconds (as floats with theoretical microsecond precision).
$ pip install interruptingcow
Interruptingcow is fully reentrant, which means that you can have nested timeouts:
from interruptingcow import timeout class Outer(RuntimeError): pass class Inner(RuntimeError): pass try: with timeout(20.0, Outer): try: with timeout(1.0, Inner): # some expensive operation try_the_expensive_thing() except Inner: do_the_cheap_thing_instead() except Outer: print 'Program as a whole failed to return in 20 secs'
Nested timeouts allow a large outer timeout to contain smaller timeouts. If the inner timeout is larger than the outer timeout, it is treated as a no-op.
Interruptingcow can be used both as inline with-statements, as shown in the above examples, as well as function decorator:
from interruptingcow import timeout @timeout(.5) def foo(): with timeout(.3): # some expensive operation pass
Interruptingcow uses signal(SIGALRM) to let the operating system interrupt program execution. This has the following limitations: