execution timeout
require 'timeout' status = Timeout::timeout(5) { # Something that should be interrupted if it takes too much time... }
A way of performing a potentially long-running operation in a thread, and terminating it’s execution if it hasn’t finished by a fixed amount of time.
Previous versions of timeout didn’t provide use a module for namespace. This version provides both ::timeout, and a backwards-compatible timeout.
(C) 2000 Network Applied Communication Laboratory, Inc.
(C) 2000 Information-technology Promotion Agency, Japan
Executes the method’s block. If the block execution terminates before
sec
seconds has passed, it returns the result value of the
block. If not, it terminates the execution and raises
exception
(which defaults to Timeout::Error).
Note that this is both a method of module Timeout, so you can ‘include Timeout’ into your classes so they have a timeout method, as well as a module method, so you can call it directly as ::timeout.
# File timeout.rb, line 43 def timeout(sec, klass = nil) #:yield: +sec+ return yield(sec) if sec == nil or sec.zero? exception = klass || Class.new(ExitException) begin x = Thread.current y = Thread.start { sleep sec x.raise exception, "execution expired" if x.alive? } return yield(sec) rescue exception => e rej = /\A#{Regexp.quote(__FILE__)}:#{__LINE__-4}\z/o (bt = e.backtrace).reject! {|m| rej =~ m} level = -caller(CALLER_OFFSET).size while THIS_FILE =~ bt[level] bt.delete_at(level) level += 1 end raise if klass # if exception class is specified, it # would be expected outside. raise Error, e.message, e.backtrace ensure if y and y.alive? y.kill y.join # make sure y is dead. end end end
Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.
If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.
If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.
If you want to help improve the Ruby documentation, please visit Documenting-ruby.org.