# Copyright (c) 2008 AG Projects # Author: Denis Bilenko # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN # THE SOFTWARE. from __future__ import with_statement import sys import unittest import weakref import time from eventlet.api import sleep, timeout, TimeoutError, _SilentException DELAY = 0.01 class Error(Exception): pass class Test(unittest.TestCase): def test_api(self): # Nothing happens if with-block finishes before the timeout expires with timeout(DELAY*2): sleep(DELAY) sleep(DELAY*2) # check if timer was actually cancelled # An exception will be raised if it's not try: with timeout(DELAY): sleep(DELAY*2) except TimeoutError: pass else: raise AssertionError('must raise TimeoutError') # You can customize the exception raised: try: with timeout(DELAY, IOError("Operation takes way too long")): sleep(DELAY*2) except IOError, ex: assert str(ex)=="Operation takes way too long", repr(ex) # Providing classes instead of values should be possible too: try: with timeout(DELAY, ValueError): sleep(DELAY*2) except ValueError: pass # basically, anything that greenlet.throw accepts work: try: 1/0 except: try: with timeout(DELAY, *sys.exc_info()): sleep(DELAY*2) raise AssertionError('should not get there') raise AssertionError('should not get there') except ZeroDivisionError: pass else: raise AssertionError('should not get there') # It's possible to cancel the timer inside the block: with timeout(DELAY) as timer: timer.cancel() sleep(DELAY*2) # To silent the exception, pass None as second parameter. The with-block # will be interrupted with _SilentException, but it won't be propagated # outside. XDELAY=0.1 start = time.time() with timeout(XDELAY, None): sleep(XDELAY*2) delta = (time.time()-start) assert delta