Gecko [ emad.team ]

Name	Size	Permission	Date
bigdecimal	[ DIR ]	drwxr-xr-x	2023-09-19 09:14
bundler	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
cgi	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
csv	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
digest	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
drb	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
e2mmap	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
fiddle	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
fileutils	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
forwardable	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
io	[ DIR ]	drwxr-xr-x	2023-07-26 18:21
irb	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
json	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
matrix	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
net	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
openssl	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
optparse	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
psych	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
racc	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
rdoc	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
rexml	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
rinda	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
ripper	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
rss	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
rubygems	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
shell	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
syslog	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
thwait	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
tracer	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
unicode_normalize	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
uri	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
webrick	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
x86_64-linux	[ DIR ]	drwxr-xr-x	2023-09-19 09:14
yaml	[ DIR ]	drwxr-xr-x	2023-09-19 08:52
English.rb	6.31 KB	-rw-r--r--	2022-04-12 16:20
abbrev.rb	3.49 KB	-rw-r--r--	2022-04-12 16:20
base64.rb	3.3 KB	-rw-r--r--	2022-04-12 16:20
benchmark.rb	18.07 KB	-rw-r--r--	2022-04-12 16:20
bigdecimal.rb	179 B	-rw-r--r--	2023-07-26 18:21
bundler.rb	17.82 KB	-rw-r--r--	2022-04-12 16:20
cgi.rb	9.8 KB	-rw-r--r--	2022-04-12 16:20
cmath.rb	9.49 KB	-rw-r--r--	2022-04-12 16:20
coverage.rb	368 B	-rw-r--r--	2023-07-26 18:21
csv.rb	52 KB	-rw-r--r--	2022-04-12 16:20
date.rb	1.01 KB	-rw-r--r--	2023-07-26 18:21
debug.rb	29.97 KB	-rw-r--r--	2022-04-12 16:20
delegate.rb	10.44 KB	-rw-r--r--	2022-04-12 16:20
digest.rb	2.83 KB	-rw-r--r--	2023-07-26 18:21
drb.rb	50 B	-rw-r--r--	2022-04-12 16:20
e2mmap.rb	3.94 KB	-rw-r--r--	2022-04-12 16:20
erb.rb	28.73 KB	-rw-r--r--	2022-04-12 16:20
expect.rb	2.17 KB	-rw-r--r--	2023-07-26 18:21
fiddle.rb	1.68 KB	-rw-r--r--	2023-07-26 18:21
fileutils.rb	47.16 KB	-rw-r--r--	2022-04-12 16:20
find.rb	2.47 KB	-rw-r--r--	2022-04-12 16:20
forwardable.rb	8.49 KB	-rw-r--r--	2022-04-12 16:20
getoptlong.rb	15.42 KB	-rw-r--r--	2022-04-12 16:20
ipaddr.rb	19.56 KB	-rw-r--r--	2022-04-12 16:20
irb.rb	22.53 KB	-rw-r--r--	2022-04-12 16:20
json.rb	1.77 KB	-rw-r--r--	2023-07-26 18:21
kconv.rb	5.77 KB	-rw-r--r--	2023-07-26 18:21
logger.rb	23.47 KB	-rw-r--r--	2022-04-12 16:20
matrix.rb	60.17 KB	-rw-r--r--	2022-04-12 16:20
mkmf.rb	84.87 KB	-rw-r--r--	2022-04-12 16:20
monitor.rb	7.87 KB	-rw-r--r--	2022-04-12 16:20
mutex_m.rb	2.16 KB	-rw-r--r--	2022-04-12 16:20
observer.rb	5.83 KB	-rw-r--r--	2022-04-12 16:20
open-uri.rb	25.13 KB	-rw-r--r--	2022-04-12 16:20
open3.rb	21.81 KB	-rw-r--r--	2022-04-12 16:20
openssl.rb	469 B	-rw-r--r--	2023-07-26 18:21
optionparser.rb	59 B	-rw-r--r--	2022-04-12 16:20
optparse.rb	57.74 KB	-rw-r--r--	2022-04-12 16:20
ostruct.rb	10.65 KB	-rw-r--r--	2022-04-12 16:20
pathname.rb	16.17 KB	-rw-r--r--	2023-07-26 18:21
pp.rb	15.08 KB	-rw-r--r--	2022-04-12 16:20
prettyprint.rb	15.89 KB	-rw-r--r--	2022-04-12 16:20
prime.rb	12.37 KB	-rw-r--r--	2022-04-12 16:20
profile.rb	235 B	-rw-r--r--	2022-04-12 16:20
profiler.rb	4.54 KB	-rw-r--r--	2022-04-12 16:20
pstore.rb	14.7 KB	-rw-r--r--	2022-04-12 16:20
psych.rb	21.11 KB	-rw-r--r--	2023-07-26 18:21
rdoc.rb	4.88 KB	-rw-r--r--	2022-04-12 16:20
resolv-replace.rb	1.76 KB	-rw-r--r--	2022-04-12 16:20
resolv.rb	73.44 KB	-rw-r--r--	2022-04-12 16:20
ripper.rb	2.44 KB	-rw-r--r--	2023-07-26 18:21
rss.rb	2.87 KB	-rw-r--r--	2022-04-12 16:20
rubygems.rb	36.11 KB	-rw-r--r--	2022-04-12 16:20
scanf.rb	23.55 KB	-rw-r--r--	2022-04-12 16:20
securerandom.rb	8.98 KB	-rw-r--r--	2022-04-12 16:20
set.rb	24.07 KB	-rw-r--r--	2022-04-12 16:20
shell.rb	11.39 KB	-rw-r--r--	2022-04-12 16:20
shellwords.rb	6.66 KB	-rw-r--r--	2022-04-12 16:20
singleton.rb	4.04 KB	-rw-r--r--	2022-04-12 16:20
socket.rb	43.51 KB	-rw-r--r--	2023-07-26 18:21
sync.rb	7.23 KB	-rw-r--r--	2022-04-12 16:20
tempfile.rb	11.21 KB	-rw-r--r--	2022-04-12 16:20
thwait.rb	3.33 KB	-rw-r--r--	2022-04-12 16:20
time.rb	23.56 KB	-rw-r--r--	2022-04-12 16:20
timeout.rb	3.81 KB	-rw-r--r--	2022-04-12 16:20
tmpdir.rb	4.25 KB	-rw-r--r--	2022-04-12 16:20
tracer.rb	6.42 KB	-rw-r--r--	2022-04-12 16:20
tsort.rb	14.3 KB	-rw-r--r--	2022-04-12 16:20
un.rb	9.95 KB	-rw-r--r--	2022-04-12 16:20
uri.rb	3.12 KB	-rw-r--r--	2022-04-12 16:20
weakref.rb	1.44 KB	-rw-r--r--	2022-04-12 16:20
webrick.rb	6.72 KB	-rw-r--r--	2022-04-12 16:20
yaml.rb	1.81 KB	-rw-r--r--	2022-04-12 16:20

Rename

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

require "e2mmap"

#
# 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 = Thread::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.