Gecko [ goons4good.org ]

Name	Size	Permission	Date
cgi	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
digest	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
drb	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
fiddle	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
io	[ DIR ]	drwxr-xr-x	2023-07-26 10:21
irb	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
json	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
matrix	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
net	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
openssl	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
optparse	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
psych	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
racc	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
rake	[ DIR ]	drwxr-xr-x	2023-08-27 00:27
rbconfig	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
rdoc	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
rexml	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
rinda	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
ripper	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
rss	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
rubygems	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
shell	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
syslog	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
unicode_normalize	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
uri	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
webrick	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
x86_64-linux	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
xmlrpc	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
yaml	[ DIR ]	drwxr-xr-x	2023-08-27 00:26
English.rb	6.42 KB	-rw-r--r--	2014-05-31 15:54
abbrev.rb	3.46 KB	-rw-r--r--	2014-07-11 04:16
base64.rb	2.63 KB	-rw-r--r--	2013-05-18 23:10
benchmark.rb	17.73 KB	-rw-r--r--	2014-09-11 04:09
cgi.rb	9.77 KB	-rw-r--r--	2014-08-07 02:14
cmath.rb	9.34 KB	-rw-r--r--	2015-07-03 15:31
csv.rb	82.45 KB	-rw-r--r--	2014-11-03 22:21
date.rb	980 B	-rw-r--r--	2023-07-26 10:21
debug.rb	29.08 KB	-rw-r--r--	2013-12-14 09:48
delegate.rb	10.71 KB	-rw-r--r--	2014-07-26 13:11
digest.rb	2.79 KB	-rw-r--r--	2023-07-26 10:21
drb.rb	19 B	-rw-r--r--	2009-10-02 06:45
e2mmap.rb	3.77 KB	-rw-r--r--	2014-08-24 03:16
erb.rb	26.35 KB	-rw-r--r--	2014-12-12 05:48
expect.rb	2.14 KB	-rw-r--r--	2023-07-26 10:21
fiddle.rb	1.65 KB	-rw-r--r--	2023-07-26 10:21
fileutils.rb	47.46 KB	-rw-r--r--	2017-03-25 14:24
find.rb	2.48 KB	-rw-r--r--	2014-10-13 03:34
forwardable.rb	8.22 KB	-rw-r--r--	2017-03-25 10:43
getoptlong.rb	15.38 KB	-rw-r--r--	2013-05-19 10:50
ipaddr.rb	17.06 KB	-rw-r--r--	2015-11-24 10:49
irb.rb	20.03 KB	-rw-r--r--	2016-03-28 11:07
json.rb	1.74 KB	-rw-r--r--	2023-07-26 10:21
kconv.rb	5.74 KB	-rw-r--r--	2023-07-26 10:21
logger.rb	20.33 KB	-rw-r--r--	2016-10-27 03:47
mathn.rb	3.84 KB	-rw-r--r--	2014-08-26 08:07
matrix.rb	53.14 KB	-rw-r--r--	2014-11-26 20:03
mkmf.rb	82.59 KB	-rw-r--r--	2023-07-26 10:18
monitor.rb	6.93 KB	-rw-r--r--	2012-11-16 11:55
mutex_m.rb	2 KB	-rw-r--r--	2013-02-19 21:51
observer.rb	5.8 KB	-rw-r--r--	2014-08-27 08:21
open-uri.rb	24.58 KB	-rw-r--r--	2014-12-24 04:11
open3.rb	20.55 KB	-rw-r--r--	2014-11-03 22:09
openssl.rb	528 B	-rw-r--r--	2023-07-26 10:21
optionparser.rb	28 B	-rw-r--r--	2014-05-25 23:25
optparse.rb	52.05 KB	-rw-r--r--	2017-03-25 14:28
ostruct.rb	8.66 KB	-rw-r--r--	2017-03-25 14:35
pathname.rb	15.58 KB	-rw-r--r--	2023-07-26 10:21
pp.rb	14.16 KB	-rw-r--r--	2014-12-05 14:35
prettyprint.rb	15.85 KB	-rw-r--r--	2014-08-21 22:38
prime.rb	13.11 KB	-rw-r--r--	2014-12-10 15:38
profile.rb	205 B	-rw-r--r--	2009-10-02 06:45
profiler.rb	4.51 KB	-rw-r--r--	2013-05-19 19:04
pstore.rb	14.55 KB	-rw-r--r--	2014-07-23 15:31
psych.rb	14.88 KB	-rw-r--r--	2023-07-26 10:21
rake.rb	2.23 KB	-rw-r--r--	2014-12-05 19:22
rdoc.rb	4.96 KB	-rw-r--r--	2014-12-06 20:22
resolv-replace.rb	1.73 KB	-rw-r--r--	2013-03-11 09:47
resolv.rb	72.06 KB	-rw-r--r--	2015-05-19 13:05
ripper.rb	2.53 KB	-rw-r--r--	2023-07-26 10:21
rss.rb	2.84 KB	-rw-r--r--	2011-05-11 06:22
rubygems.rb	31.85 KB	-rw-r--r--	2018-02-16 11:27
scanf.rb	23.54 KB	-rw-r--r--	2014-02-14 20:33
securerandom.rb	9.2 KB	-rw-r--r--	2016-04-22 05:17
set.rb	19.15 KB	-rw-r--r--	2014-08-06 07:28
shell.rb	11.3 KB	-rw-r--r--	2014-08-24 03:16
shellwords.rb	5.96 KB	-rw-r--r--	2014-09-05 06:00
singleton.rb	4.02 KB	-rw-r--r--	2011-05-18 10:09
socket.rb	25.6 KB	-rw-r--r--	2023-07-26 10:21
sync.rb	7.25 KB	-rw-r--r--	2013-05-18 23:10
tempfile.rb	11.11 KB	-rw-r--r--	2014-09-20 21:40
thwait.rb	3.31 KB	-rw-r--r--	2014-08-27 08:10
time.rb	22.25 KB	-rw-r--r--	2015-08-03 15:11
timeout.rb	3.64 KB	-rw-r--r--	2015-08-10 13:08
tmpdir.rb	4.13 KB	-rw-r--r--	2018-03-28 10:34
tracer.rb	6.4 KB	-rw-r--r--	2013-07-18 09:50
tsort.rb	14.27 KB	-rw-r--r--	2014-11-26 05:46
ubygems.rb	268 B	-rw-r--r--	2009-10-02 06:45
un.rb	8.87 KB	-rw-r--r--	2013-07-05 09:43
unicode_normalize.rb	3.16 KB	-rw-r--r--	2015-01-15 21:06
uri.rb	3.07 KB	-rw-r--r--	2014-11-02 19:33
weakref.rb	2.92 KB	-rw-r--r--	2014-07-26 13:12
webrick.rb	6.69 KB	-rw-r--r--	2013-10-05 19:39
xmlrpc.rb	8.49 KB	-rw-r--r--	2013-12-11 22:09
yaml.rb	1.7 KB	-rw-r--r--	2014-06-25 22:52

Rename

#
#   thwait.rb - thread synchronization class
#       $Release Version: 0.9 $
#       $Revision: 1.3 $
#       by Keiju ISHITSUKA(Nihon Rational Software Co.,Ltd.)

require "thread.rb"
require "e2mmap.rb"

#
# This class watches for termination of multiple threads.  Basic functionality
# (wait until specified threads have terminated) can be accessed through the
# class method ThreadsWait::all_waits.  Finer control can be gained using
# instance methods.
#
# Example:
#
#   ThreadsWait.all_waits(thr1, thr2, ...) do |t|
#     STDERR.puts "Thread #{t} has terminated."
#   end
#
#
#   th = ThreadsWait.new(thread1,...)
#   th.next_wait # next one to be done
#
#
class ThreadsWait
  extend Exception2MessageMapper
  def_exception("ErrNoWaitingThread", "No threads for waiting.")
  def_exception("ErrNoFinishedThread", "No finished threads.")

#
  # Waits until all specified threads have terminated.  If a block is provided,
  # it is executed for each thread as they terminate.
  #
  def ThreadsWait.all_waits(*threads) # :yield: thread
    tw = ThreadsWait.new(*threads)
    if block_given?
      tw.all_waits do |th|
        yield th
      end
    else
      tw.all_waits
    end
  end

#
  # Creates a ThreadsWait object, specifying the threads to wait on.
  # Non-blocking.
  #
  def initialize(*threads)
    @threads = []
    @wait_queue = Queue.new
    join_nowait(*threads) unless threads.empty?
  end

# Returns the array of threads that have not terminated yet.
  attr_reader :threads

#
  # Returns +true+ if there are no threads in the pool still running.
  #
  def empty?
    @threads.empty?
  end

#
  # Returns +true+ if any thread has terminated and is ready to be collected.
  #
  def finished?
    !@wait_queue.empty?
  end

#
  # Waits for specified threads to terminate, and returns when one of
  # the threads terminated.
  #
  def join(*threads)
    join_nowait(*threads)
    next_wait
  end

#
  # Specifies the threads that this object will wait for, but does not actually
  # wait.
  #
  def join_nowait(*threads)
    threads.flatten!
    @threads.concat threads
    for th in threads
      Thread.start(th) do |t|
        begin
          t.join
        ensure
          @wait_queue.push t
        end
      end
    end
  end

#
  # Waits until any of the specified threads has terminated, and returns the one
  # that does.
  #
  # If there is no thread to wait, raises +ErrNoWaitingThread+.  If +nonblock+
  # is true, and there is no terminated thread, raises +ErrNoFinishedThread+.
  #
  def next_wait(nonblock = nil)
    ThreadsWait.fail ErrNoWaitingThread if @threads.empty?
    begin
      @threads.delete(th = @wait_queue.pop(nonblock))
      th
    rescue ThreadError
      ThreadsWait.fail ErrNoFinishedThread
    end
  end

#
  # Waits until all of the specified threads are terminated.  If a block is
  # supplied for the method, it is executed for each thread termination.
  #
  # Raises exceptions in the same manner as +next_wait+.
  #
  def all_waits
    until @threads.empty?
      th = next_wait
      yield th if block_given?
    end
  end
end

##
# An alias for ThreadsWait from thwait.rb

ThWait = ThreadsWait

# Documentation comments:
#  - Source of documentation is evenly split between Nutshell, existing
#    comments, and my own rephrasing.
#  - I'm not particularly confident that the comments are all exactly correct.