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

# frozen_string_literal: false
#
#   forwardable.rb -
#       $Release Version: 1.1$
#       $Revision: 58085 $
#       by Keiju ISHITSUKA(keiju@ishitsuka.com)
#       original definition by delegator.rb
#       Revised by Daniel J. Berger with suggestions from Florian Gross.
#
#       Documentation by James Edward Gray II and Gavin Sinclair

# The Forwardable module provides delegation of specified
# methods to a designated object, using the methods #def_delegator
# and #def_delegators.
#
# For example, say you have a class RecordCollection which
# contains an array <tt>@records</tt>.  You could provide the lookup method
# #record_number(), which simply calls #[] on the <tt>@records</tt>
# array, like this:
#
#   require 'forwardable'
#
#   class RecordCollection
#     attr_accessor :records
#     extend Forwardable
#     def_delegator :@records, :[], :record_number
#   end
#
# We can use the lookup method like so:
#
#   r = RecordCollection.new
#   r.records = [4,5,6]
#   r.record_number(0)  # => 4
#
# Further, if you wish to provide the methods #size, #<<, and #map,
# all of which delegate to @records, this is how you can do it:
#
#   class RecordCollection # re-open RecordCollection class
#     def_delegators :@records, :size, :<<, :map
#   end
#
#   r = RecordCollection.new
#   r.records = [1,2,3]
#   r.record_number(0)   # => 1
#   r.size               # => 3
#   r << 4               # => [1, 2, 3, 4]
#   r.map { |x| x * 2 }  # => [2, 4, 6, 8]
#
# You can even extend regular objects with Forwardable.
#
#   my_hash = Hash.new
#   my_hash.extend Forwardable              # prepare object for delegation
#   my_hash.def_delegator "STDOUT", "puts"  # add delegation for STDOUT.puts()
#   my_hash.puts "Howdy!"
#
# == Another example
#
# We want to rely on what has come before obviously, but with delegation we can
# take just the methods we need and even rename them as appropriate.  In many
# cases this is preferable to inheritance, which gives us the entire old
# interface, even if much of it isn't needed.
#
#   class Queue
#     extend Forwardable
#
#     def initialize
#       @q = [ ]    # prepare delegate object
#     end
#
#     # setup preferred interface, enq() and deq()...
#     def_delegator :@q, :push, :enq
#     def_delegator :@q, :shift, :deq
#
#     # support some general Array methods that fit Queues well
#     def_delegators :@q, :clear, :first, :push, :shift, :size
#   end
#
#   q = Queue.new
#   q.enq 1, 2, 3, 4, 5
#   q.push 6
#
#   q.shift    # => 1
#   while q.size > 0
#     puts q.deq
#   end
#
#   q.enq "Ruby", "Perl", "Python"
#   puts q.first
#   q.clear
#   puts q.first
#
# This should output:
#
#   2
#   3
#   4
#   5
#   6
#   Ruby
#   nil
#
# == Notes
#
# Be advised, RDoc will not detect delegated methods.
#
# +forwardable.rb+ provides single-method delegation via the def_delegator and
# def_delegators methods. For full-class delegation via DelegateClass, see
# +delegate.rb+.
#
module Forwardable
  # Version of +forwardable.rb+
  FORWARDABLE_VERSION = "1.1.0"

FILE_REGEXP = %r"#{Regexp.quote(__FILE__)}"

@debug = nil
  class << self
    # If true, <tt>__FILE__</tt> will remain in the backtrace in the event an
    # Exception is raised.
    attr_accessor :debug
  end

# Takes a hash as its argument.  The key is a symbol or an array of
  # symbols.  These symbols correspond to method names.  The value is
  # the accessor to which the methods will be delegated.
  #
  # :call-seq:
  #    delegate method => accessor
  #    delegate [method, method, ...] => accessor
  #
  def instance_delegate(hash)
    hash.each{ |methods, accessor|
      methods = [methods] unless methods.respond_to?(:each)
      methods.each{ |method|
        def_instance_delegator(accessor, method)
      }
    }
  end

#
  # Shortcut for defining multiple delegator methods, but with no
  # provision for using a different name.  The following two code
  # samples have the same effect:
  #
  #   def_delegators :@records, :size, :<<, :map
  #
  #   def_delegator :@records, :size
  #   def_delegator :@records, :<<
  #   def_delegator :@records, :map
  #
  def def_instance_delegators(accessor, *methods)
    methods.delete("__send__")
    methods.delete("__id__")
    for method in methods
      def_instance_delegator(accessor, method)
    end
  end

# Define +method+ as delegator instance method with an optional
  # alias name +ali+. Method calls to +ali+ will be delegated to
  # +accessor.method+.
  #
  #   class MyQueue
  #     extend Forwardable
  #     attr_reader :queue
  #     def initialize
  #       @queue = []
  #     end
  #
  #     def_delegator :@queue, :push, :mypush
  #   end
  #
  #   q = MyQueue.new
  #   q.mypush 42
  #   q.queue    #=> [42]
  #   q.push 23  #=> NoMethodError
  #
  def def_instance_delegator(accessor, method, ali = method)
    gen = Forwardable._delegator_method(self, accessor, method, ali)

# If it's not a class or module, it's an instance
    (Module === self ? self : singleton_class).module_eval(&gen)
  end

alias delegate instance_delegate
  alias def_delegators def_instance_delegators
  alias def_delegator def_instance_delegator

def self._delegator_method(obj, accessor, method, ali)
    accessor = accessor.to_s unless Symbol === accessor

if Module === obj ?
         obj.method_defined?(accessor) || obj.private_method_defined?(accessor) :
         obj.respond_to?(accessor, true)
      accessor = "#{accessor}()"
    end

line_no = __LINE__+1; str = "#{<<-"begin;"}\n#{<<-"end;"}"
    begin;
      proc do
        def #{ali}(*args, &block)
          begin
            #{accessor}
          ensure
            $@.delete_if {|s| ::Forwardable::FILE_REGEXP =~ s} if $@ and !::Forwardable::debug
          end.__send__ :#{method}, *args, &block
        end
      end
    end;

RubyVM::InstructionSequence
      .compile(str, __FILE__, __FILE__, line_no,
               trace_instruction: false,
               tailcall_optimization: true)
      .eval
  end
end

# SingleForwardable can be used to setup delegation at the object level as well.
#
#    printer = String.new
#    printer.extend SingleForwardable        # prepare object for delegation
#    printer.def_delegator "STDOUT", "puts"  # add delegation for STDOUT.puts()
#    printer.puts "Howdy!"
#
# Also, SingleForwardable can be used to set up delegation for a Class or Module.
#
#   class Implementation
#     def self.service
#       puts "serviced!"
#     end
#   end
#
#   module Facade
#     extend SingleForwardable
#     def_delegator :Implementation, :service
#   end
#
#   Facade.service #=> serviced!
#
# If you want to use both Forwardable and SingleForwardable, you can
# use methods def_instance_delegator and def_single_delegator, etc.
module SingleForwardable
  # Takes a hash as its argument.  The key is a symbol or an array of
  # symbols.  These symbols correspond to method names.  The value is
  # the accessor to which the methods will be delegated.
  #
  # :call-seq:
  #    delegate method => accessor
  #    delegate [method, method, ...] => accessor
  #
  def single_delegate(hash)
    hash.each{ |methods, accessor|
      methods = [methods] unless methods.respond_to?(:each)
      methods.each{ |method|
        def_single_delegator(accessor, method)
      }
    }
  end

#
  # Shortcut for defining multiple delegator methods, but with no
  # provision for using a different name.  The following two code
  # samples have the same effect:
  #
  #   def_delegators :@records, :size, :<<, :map
  #
  #   def_delegator :@records, :size
  #   def_delegator :@records, :<<
  #   def_delegator :@records, :map
  #
  def def_single_delegators(accessor, *methods)
    methods.delete("__send__")
    methods.delete("__id__")
    for method in methods
      def_single_delegator(accessor, method)
    end
  end

# :call-seq:
  #   def_single_delegator(accessor, method, new_name=method)
  #
  # Defines a method _method_ which delegates to _accessor_ (i.e. it calls
  # the method of the same name in _accessor_).  If _new_name_ is
  # provided, it is used as the name for the delegate method.
  def def_single_delegator(accessor, method, ali = method)
    gen = Forwardable._delegator_method(self, accessor, method, ali)

instance_eval(&gen)
  end

alias delegate single_delegate
  alias def_delegators def_single_delegators
  alias def_delegator def_single_delegator
end