rbs 2.8.4 → 3.8.1

data/stdlib/date/0/date_time.rbs

@@ -133,16 +133,9 @@
 class DateTime < Date
   # <!--
   #   rdoc-file=ext/date/date_core.c
-  #   - DateTime.civil([year=-4712[, month=1[, mday=1[, hour=0[, minute=0[, second=0[, offset=0[, start=Date::ITALY]]]]]]]])  ->  datetime
-  #   - DateTime.new([year=-4712[, month=1[, mday=1[, hour=0[, minute=0[, second=0[, offset=0[, start=Date::ITALY]]]]]]]])    ->  datetime
+  #   - new(*args)
   # -->
-  # Creates a DateTime object denoting the given calendar date.
-  #
-  #     DateTime.new(2001,2,3)    #=> #<DateTime: 2001-02-03T00:00:00+00:00 ...>
-  #     DateTime.new(2001,2,3,4,5,6,'+7')
-  #                               #=> #<DateTime: 2001-02-03T04:05:06+07:00 ...>
-  #     DateTime.new(2001,-11,-26,-20,-55,-54,'+7')
-  #                               #=> #<DateTime: 2001-02-03T04:05:06+07:00 ...>
+  # Same as DateTime.new.
   #
   def initialize: (?Integer year, ?Integer month, ?Integer mday, ?Integer hour, ?Integer minute, ?Integer second, ?Integer offset, ?Integer start) -> void
 
@@ -160,16 +153,9 @@ class DateTime < Date
 
   # <!--
   #   rdoc-file=ext/date/date_core.c
-  #   - DateTime.civil([year=-4712[, month=1[, mday=1[, hour=0[, minute=0[, second=0[, offset=0[, start=Date::ITALY]]]]]]]])  ->  datetime
-  #   - DateTime.new([year=-4712[, month=1[, mday=1[, hour=0[, minute=0[, second=0[, offset=0[, start=Date::ITALY]]]]]]]])    ->  datetime
+  #   - civil(*args)
   # -->
-  # Creates a DateTime object denoting the given calendar date.
-  #
-  #     DateTime.new(2001,2,3)    #=> #<DateTime: 2001-02-03T00:00:00+00:00 ...>
-  #     DateTime.new(2001,2,3,4,5,6,'+7')
-  #                               #=> #<DateTime: 2001-02-03T04:05:06+07:00 ...>
-  #     DateTime.new(2001,-11,-26,-20,-55,-54,'+7')
-  #                               #=> #<DateTime: 2001-02-03T04:05:06+07:00 ...>
+  # Same as DateTime.new.
   #
   def self.civil: (?Integer year, ?Integer month, ?Integer mday, ?Integer hour, ?Integer minute, ?Integer second, ?Integer offset, ?Integer start) -> DateTime
 
@@ -287,9 +273,9 @@ class DateTime < Date
   # Parses the given representation of date and time, and creates a DateTime
   # object.
   #
-  # This method *does not* function as a validator.  If the input string does not
-  # match valid formats strictly, you may get a cryptic result.  Should consider
-  # to use `DateTime.strptime` instead of this method as possible.
+  # This method **does** **not** function as a validator.  If the input string
+  # does not match valid formats strictly, you may get a cryptic result.  Should
+  # consider to use DateTime.strptime instead of this method as possible.
   #
   # If the optional second argument is true and the detected year is in the range
   # "00" to "99", makes it full.
@@ -402,15 +388,48 @@ class DateTime < Date
   #
   def self.xmlschema: (String str, ?Integer start) -> DateTime
 
-  public
+  # <!--
+  #   rdoc-file=ext/date/date_core.c
+  #   - deconstruct_keys(array_of_names_or_nil) -> hash
+  # -->
+  # Returns a hash of the name/value pairs, to use in pattern matching. Possible
+  # keys are: `:year`, `:month`, `:day`, `:wday`, `:yday`, `:hour`, `:min`,
+  # `:sec`, `:sec_fraction`, `:zone`.
+  #
+  # Possible usages:
+  #
+  #     dt = DateTime.new(2022, 10, 5, 13, 30)
+  #
+  #     if d in wday: 1..5, hour: 10..18  # uses deconstruct_keys underneath
+  #       puts "Working time"
+  #     end
+  #     #=> prints "Working time"
+  #
+  #     case dt
+  #     in year: ...2022
+  #       puts "too old"
+  #     in month: ..9
+  #       puts "quarter 1-3"
+  #     in wday: 1..5, month:
+  #       puts "working day in month #{month}"
+  #     end
+  #     #=> prints "working day in month 10"
+  #
+  # Note that deconstruction by pattern can also be combined with class check:
+  #
+  #     if d in DateTime(wday: 1..5, hour: 10..18, day: ..7)
+  #       puts "Working time, first week of the month"
+  #     end
+  #
+  def deconstruct_keys: (Array[Symbol]?) -> Hash[Symbol, untyped]
 
   # <!--
   #   rdoc-file=ext/date/date_core.c
-  #   - d.hour  ->  fixnum
+  #   - hour -> integer
   # -->
-  # Returns the hour (0-23).
+  # Returns the hour in range (0..23):
   #
-  #     DateTime.new(2001,2,3,4,5,6).hour         #=> 4
+  #     DateTime.new(2001, 2, 3, 4, 5, 6).hour # => 4
   #
   def hour: () -> Integer
 
@@ -441,19 +460,18 @@ class DateTime < Date
 
   # <!--
   #   rdoc-file=ext/date/date_core.c
-  #   - d.min     ->  fixnum
-  #   - d.minute  ->  fixnum
+  #   - min -> integer
   # -->
-  # Returns the minute (0-59).
+  # Returns the minute in range (0..59):
   #
-  #     DateTime.new(2001,2,3,4,5,6).min          #=> 5
+  #     DateTime.new(2001, 2, 3, 4, 5, 6).min # => 5
   #
   def min: () -> Integer
 
   # <!-- rdoc-file=ext/date/date_core.c -->
-  # Returns the minute (0-59).
+  # Returns the minute in range (0..59):
   #
-  #     DateTime.new(2001,2,3,4,5,6).min          #=> 5
+  #     DateTime.new(2001, 2, 3, 4, 5, 6).min # => 5
   #
   def minute: () -> Integer
 
@@ -493,210 +511,51 @@ class DateTime < Date
 
   # <!--
   #   rdoc-file=ext/date/date_core.c
-  #   - d.sec     ->  fixnum
-  #   - d.second  ->  fixnum
+  #   - sec -> integer
   # -->
-  # Returns the second (0-59).
+  # Returns the second in range (0..59):
   #
-  #     DateTime.new(2001,2,3,4,5,6).sec          #=> 6
+  #     DateTime.new(2001, 2, 3, 4, 5, 6).sec # => 6
   #
   def sec: () -> Integer
 
   # <!--
   #   rdoc-file=ext/date/date_core.c
-  #   - d.sec_fraction     ->  rational
-  #   - d.second_fraction  ->  rational
+  #   - sec_fraction -> rational
   # -->
-  # Returns the fractional part of the second.
+  # Returns the fractional part of the second in range (Rational(0,
+  # 1)...Rational(1, 1)):
   #
-  #     DateTime.new(2001,2,3,4,5,6.5).sec_fraction       #=> (1/2)
+  #     DateTime.new(2001, 2, 3, 4, 5, 6.5).sec_fraction # => (1/2)
   #
   def sec_fraction: () -> Rational
 
   # <!-- rdoc-file=ext/date/date_core.c -->
-  # Returns the second (0-59).
+  # Returns the second in range (0..59):
   #
-  #     DateTime.new(2001,2,3,4,5,6).sec          #=> 6
+  #     DateTime.new(2001, 2, 3, 4, 5, 6).sec # => 6
   #
   def second: () -> Integer
 
   # <!-- rdoc-file=ext/date/date_core.c -->
-  # Returns the fractional part of the second.
+  # Returns the fractional part of the second in range (Rational(0,
+  # 1)...Rational(1, 1)):
   #
-  #     DateTime.new(2001,2,3,4,5,6.5).sec_fraction       #=> (1/2)
+  #     DateTime.new(2001, 2, 3, 4, 5, 6.5).sec_fraction # => (1/2)
   #
   def second_fraction: () -> Rational
 
   # <!--
   #   rdoc-file=ext/date/date_core.c
-  #   - dt.strftime([format='%FT%T%:z'])  ->  string
-  # -->
-  # Formats date according to the directives in the given format string. The
-  # directives begin with a percent (%) character. Any text not listed as a
-  # directive will be passed through to the output string.
-  #
-  # A directive consists of a percent (%) character, zero or more flags, an
-  # optional minimum field width, an optional modifier, and a conversion specifier
-  # as follows.
-  #
-  #     %<flags><width><modifier><conversion>
-  #
-  # Flags:
-  #     -  don't pad a numerical output.
-  #     _  use spaces for padding.
-  #     0  use zeros for padding.
-  #     ^  upcase the result string.
-  #     #  change case.
-  #     :  use colons for %z.
-  #
-  # The minimum field width specifies the minimum width.
-  #
-  # The modifiers are "E" and "O". They are ignored.
-  #
-  # Format directives:
-  #
-  #     Date (Year, Month, Day):
-  #       %Y - Year with century (can be negative, 4 digits at least)
-  #               -0001, 0000, 1995, 2009, 14292, etc.
-  #       %C - year / 100 (round down.  20 in 2009)
-  #       %y - year % 100 (00..99)
-  #
-  #       %m - Month of the year, zero-padded (01..12)
-  #               %_m  blank-padded ( 1..12)
-  #               %-m  no-padded (1..12)
-  #       %B - The full month name (``January'')
-  #               %^B  uppercased (``JANUARY'')
-  #       %b - The abbreviated month name (``Jan'')
-  #               %^b  uppercased (``JAN'')
-  #       %h - Equivalent to %b
-  #
-  #       %d - Day of the month, zero-padded (01..31)
-  #               %-d  no-padded (1..31)
-  #       %e - Day of the month, blank-padded ( 1..31)
-  #
-  #       %j - Day of the year (001..366)
-  #
-  #     Time (Hour, Minute, Second, Subsecond):
-  #       %H - Hour of the day, 24-hour clock, zero-padded (00..23)
-  #       %k - Hour of the day, 24-hour clock, blank-padded ( 0..23)
-  #       %I - Hour of the day, 12-hour clock, zero-padded (01..12)
-  #       %l - Hour of the day, 12-hour clock, blank-padded ( 1..12)
-  #       %P - Meridian indicator, lowercase (``am'' or ``pm'')
-  #       %p - Meridian indicator, uppercase (``AM'' or ``PM'')
-  #
-  #       %M - Minute of the hour (00..59)
-  #
-  #       %S - Second of the minute (00..60)
-  #
-  #       %L - Millisecond of the second (000..999)
-  #       %N - Fractional seconds digits, default is 9 digits (nanosecond)
-  #               %3N  millisecond (3 digits)   %15N femtosecond (15 digits)
-  #               %6N  microsecond (6 digits)   %18N attosecond  (18 digits)
-  #               %9N  nanosecond  (9 digits)   %21N zeptosecond (21 digits)
-  #               %12N picosecond (12 digits)   %24N yoctosecond (24 digits)
-  #
-  #     Time zone:
-  #       %z - Time zone as hour and minute offset from UTC (e.g. +0900)
-  #               %:z - hour and minute offset from UTC with a colon (e.g. +09:00)
-  #               %::z - hour, minute and second offset from UTC (e.g. +09:00:00)
-  #               %:::z - hour, minute and second offset from UTC
-  #                                                 (e.g. +09, +09:30, +09:30:30)
-  #       %Z - Equivalent to %:z (e.g. +09:00)
-  #
-  #     Weekday:
-  #       %A - The full weekday name (``Sunday'')
-  #               %^A  uppercased (``SUNDAY'')
-  #       %a - The abbreviated name (``Sun'')
-  #               %^a  uppercased (``SUN'')
-  #       %u - Day of the week (Monday is 1, 1..7)
-  #       %w - Day of the week (Sunday is 0, 0..6)
-  #
-  #     ISO 8601 week-based year and week number:
-  #     The week 1 of YYYY starts with a Monday and includes YYYY-01-04.
-  #     The days in the year before the first week are in the last week of
-  #     the previous year.
-  #       %G - The week-based year
-  #       %g - The last 2 digits of the week-based year (00..99)
-  #       %V - Week number of the week-based year (01..53)
-  #
-  #     Week number:
-  #     The week 1 of YYYY starts with a Sunday or Monday (according to %U
-  #     or %W).  The days in the year before the first week are in week 0.
-  #       %U - Week number of the year.  The week starts with Sunday.  (00..53)
-  #       %W - Week number of the year.  The week starts with Monday.  (00..53)
-  #
-  #     Seconds since the Unix Epoch:
-  #       %s - Number of seconds since 1970-01-01 00:00:00 UTC.
-  #       %Q - Number of milliseconds since 1970-01-01 00:00:00 UTC.
-  #
-  #     Literal string:
-  #       %n - Newline character (\n)
-  #       %t - Tab character (\t)
-  #       %% - Literal ``%'' character
-  #
-  #     Combination:
-  #       %c - date and time (%a %b %e %T %Y)
-  #       %D - Date (%m/%d/%y)
-  #       %F - The ISO 8601 date format (%Y-%m-%d)
-  #       %v - VMS date (%e-%^b-%Y)
-  #       %x - Same as %D
-  #       %X - Same as %T
-  #       %r - 12-hour time (%I:%M:%S %p)
-  #       %R - 24-hour time (%H:%M)
-  #       %T - 24-hour time (%H:%M:%S)
-  #       %+ - date(1) (%a %b %e %H:%M:%S %Z %Y)
-  #
-  # This method is similar to the strftime() function defined in ISO C and POSIX.
-  # Several directives (%a, %A, %b, %B, %c, %p, %r, %x, %X, %E*, %O* and %Z) are
-  # locale dependent in the function. However, this method is locale independent.
-  # So, the result may differ even if the same format string is used in other
-  # systems such as C. It is good practice to avoid %x and %X because there are
-  # corresponding locale independent representations, %D and %T.
-  #
-  # Examples:
-  #
-  #     d = DateTime.new(2007,11,19,8,37,48,"-06:00")
-  #                               #=> #<DateTime: 2007-11-19T08:37:48-0600 ...>
-  #     d.strftime("Printed on %m/%d/%Y")   #=> "Printed on 11/19/2007"
-  #     d.strftime("at %I:%M%p")            #=> "at 08:37AM"
-  #
-  # Various ISO 8601 formats:
-  #     %Y%m%d           => 20071119                  Calendar date (basic)
-  #     %F               => 2007-11-19                Calendar date (extended)
-  #     %Y-%m            => 2007-11                   Calendar date, reduced accuracy, specific month
-  #     %Y               => 2007                      Calendar date, reduced accuracy, specific year
-  #     %C               => 20                        Calendar date, reduced accuracy, specific century
-  #     %Y%j             => 2007323                   Ordinal date (basic)
-  #     %Y-%j            => 2007-323                  Ordinal date (extended)
-  #     %GW%V%u          => 2007W471                  Week date (basic)
-  #     %G-W%V-%u        => 2007-W47-1                Week date (extended)
-  #     %GW%V            => 2007W47                   Week date, reduced accuracy, specific week (basic)
-  #     %G-W%V           => 2007-W47                  Week date, reduced accuracy, specific week (extended)
-  #     %H%M%S           => 083748                    Local time (basic)
-  #     %T               => 08:37:48                  Local time (extended)
-  #     %H%M             => 0837                      Local time, reduced accuracy, specific minute (basic)
-  #     %H:%M            => 08:37                     Local time, reduced accuracy, specific minute (extended)
-  #     %H               => 08                        Local time, reduced accuracy, specific hour
-  #     %H%M%S,%L        => 083748,000                Local time with decimal fraction, comma as decimal sign (basic)
-  #     %T,%L            => 08:37:48,000              Local time with decimal fraction, comma as decimal sign (extended)
-  #     %H%M%S.%L        => 083748.000                Local time with decimal fraction, full stop as decimal sign (basic)
-  #     %T.%L            => 08:37:48.000              Local time with decimal fraction, full stop as decimal sign (extended)
-  #     %H%M%S%z         => 083748-0600               Local time and the difference from UTC (basic)
-  #     %T%:z            => 08:37:48-06:00            Local time and the difference from UTC (extended)
-  #     %Y%m%dT%H%M%S%z  => 20071119T083748-0600      Date and time of day for calendar date (basic)
-  #     %FT%T%:z         => 2007-11-19T08:37:48-06:00 Date and time of day for calendar date (extended)
-  #     %Y%jT%H%M%S%z    => 2007323T083748-0600       Date and time of day for ordinal date (basic)
-  #     %Y-%jT%T%:z      => 2007-323T08:37:48-06:00   Date and time of day for ordinal date (extended)
-  #     %GW%V%uT%H%M%S%z => 2007W471T083748-0600      Date and time of day for week date (basic)
-  #     %G-W%V-%uT%T%:z  => 2007-W47-1T08:37:48-06:00 Date and time of day for week date (extended)
-  #     %Y%m%dT%H%M      => 20071119T0837             Calendar date and local time (basic)
-  #     %FT%R            => 2007-11-19T08:37          Calendar date and local time (extended)
-  #     %Y%jT%H%MZ       => 2007323T0837Z             Ordinal date and UTC of day (basic)
-  #     %Y-%jT%RZ        => 2007-323T08:37Z           Ordinal date and UTC of day (extended)
-  #     %GW%V%uT%H%M%z   => 2007W471T0837-0600        Week date and local time and difference from UTC (basic)
-  #     %G-W%V-%uT%R%:z  => 2007-W47-1T08:37-06:00    Week date and local time and difference from UTC (extended)
-  #
-  # See also strftime(3) and ::strptime.
+  #   - strftime(format = '%FT%T%:z') -> string
+  # -->
+  # Returns a string representation of `self`, formatted according the given
+  # +format:
+  #
+  #     DateTime.now.strftime # => "2022-07-01T11:03:19-05:00"
+  #
+  # For other formats, see [Formats for Dates and
+  # Times](rdoc-ref:strftime_formatting.rdoc):
   #
   def strftime: (?String format) -> String
 

data/stdlib/dbm/0/dbm.rbs

@@ -74,8 +74,6 @@ class DBM
   def self.open: (String filename, ?Integer mode, ?Integer flags) -> DBM
                | [T] (String filename, ?Integer mode, ?Integer flags) { (DBM) -> T } -> T
 
-  public
-
   # <!--
   #   rdoc-file=ext/dbm/dbm.c
   #   - dbm[key] -> string value or nil

data/stdlib/delegate/0/delegator.rbs

@@ -0,0 +1,184 @@
+# <!-- rdoc-file=lib/delegate.rb -->
+# This library provides three different ways to delegate method calls to an
+# object.  The easiest to use is SimpleDelegator.  Pass an object to the
+# constructor and all methods supported by the object will be delegated.  This
+# object can be changed later.
+#
+# Going a step further, the top level DelegateClass method allows you to easily
+# setup delegation through class inheritance.  This is considerably more
+# flexible and thus probably the most common use for this library.
+#
+# Finally, if you need full control over the delegation scheme, you can inherit
+# from the abstract class Delegator and customize as needed.  (If you find
+# yourself needing this control, have a look at Forwardable which is also in the
+# standard library.  It may suit your needs better.)
+#
+# SimpleDelegator's implementation serves as a nice example of the use of
+# Delegator:
+#
+#     require 'delegate'
+#
+#     class SimpleDelegator < Delegator
+#       def __getobj__
+#         @delegate_sd_obj # return object we are delegating to, required
+#       end
+#
+#       def __setobj__(obj)
+#         @delegate_sd_obj = obj # change delegation object,
+#                                # a feature we're providing
+#       end
+#     end
+#
+# ## Notes
+#
+# Be advised, RDoc will not detect delegated methods.
+#
+class Delegator < BasicObject
+  def self.const_missing: (Symbol n) -> untyped
+
+  def self.delegating_block: (Symbol mid) -> Proc
+
+  def self.public_api: () -> untyped
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - !()
+  # -->
+  # Delegates ! to the _*getobj*_
+  #
+  def !: () -> untyped
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - !=(obj)
+  # -->
+  # Returns true if two objects are not considered of equal value.
+  #
+  def !=: (untyped obj) -> bool
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - ==(obj)
+  # -->
+  # Returns true if two objects are considered of equal value.
+  #
+  def ==: (untyped obj) -> bool
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - __getobj__()
+  # -->
+  # This method must be overridden by subclasses and should return the object
+  # method calls are being delegated to.
+  #
+  def __getobj__: () -> untyped
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - __setobj__(obj)
+  # -->
+  # This method must be overridden by subclasses and change the object delegate to
+  # *obj*.
+  #
+  def __setobj__: (untyped obj) -> untyped
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - eql?(obj)
+  # -->
+  # Returns true if two objects are considered of equal value.
+  #
+  def eql?: (untyped obj) -> bool
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - freeze()
+  # -->
+  # :method: freeze Freeze both the object returned by _*getobj*_ and self.
+  #
+  def freeze: () -> self
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - marshal_dump()
+  # -->
+  # Serialization support for the object returned by _*getobj*_.
+  #
+  def marshal_dump: () -> untyped
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - marshal_load(data)
+  # -->
+  # Reinitializes delegation from a serialized object.
+  #
+  def marshal_load: (untyped data) -> void
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - method_missing(m, *args, &block)
+  # -->
+  #
+  def method_missing: (Symbol m, *untyped args, **untyped) { (*untyped, **untyped) -> untyped } -> untyped
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - methods(all=true)
+  # -->
+  # Returns the methods available to this delegate object as the union of this
+  # object's and _*getobj*_ methods.
+  #
+  def methods: (?boolish all) -> Array[Symbol]
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - protected_methods(all=true)
+  # -->
+  # Returns the methods available to this delegate object as the union of this
+  # object's and _*getobj*_ protected methods.
+  #
+  def protected_methods: (?boolish all) -> Array[Symbol]
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - public_methods(all=true)
+  # -->
+  # Returns the methods available to this delegate object as the union of this
+  # object's and _*getobj*_ public methods.
+  #
+  def public_methods: (?untyped all) -> Array[Symbol]
+
+  private
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - new(obj)
+  # -->
+  # Pass in the *obj* to delegate method calls to.  All methods supported by *obj*
+  # will be delegated to.
+  #
+  def initialize: (untyped obj) -> void
+
+  def initialize_clone: (self obj, ?freeze: bool?) -> self
+
+  def initialize_dup: (self obj) -> self
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - respond_to_missing?(m, include_private)
+  # -->
+  # Checks for a method provided by this the delegate object by forwarding the
+  # call through _*getobj*_.
+  #
+  def respond_to_missing?: (Symbol m, bool include_private) -> bool
+
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - target_respond_to?(target, m, include_private)
+  # -->
+  # Handle BasicObject instances
+  #
+  def target_respond_to?: (untyped target, Symbol m, bool include_private) -> bool
+
+  VERSION: String
+end

data/stdlib/delegate/0/kernel.rbs

@@ -0,0 +1,47 @@
+%a{annotate:rdoc:skip}
+class Object
+  # <!--
+  #   rdoc-file=lib/delegate.rb
+  #   - DelegateClass(superclass, &block)
+  # -->
+  # The primary interface to this library.  Use to setup delegation when defining
+  # your class.
+  #
+  #     class MyClass < DelegateClass(ClassToDelegateTo) # Step 1
+  #       def initialize
+  #         super(obj_of_ClassToDelegateTo)              # Step 2
+  #       end
+  #     end
+  #
+  # or:
+  #
+  #     MyClass = DelegateClass(ClassToDelegateTo) do    # Step 1
+  #       def initialize
+  #         super(obj_of_ClassToDelegateTo)              # Step 2
+  #       end
+  #     end
+  #
+  # Here's a sample of use from Tempfile which is really a File object with a few
+  # special rules about storage location and when the File should be deleted.
+  # That makes for an almost textbook perfect example of how to use delegation.
+  #
+  #     class Tempfile < DelegateClass(File)
+  #       # constant and class member data initialization...
+  #
+  #       def initialize(basename, tmpdir=Dir::tmpdir)
+  #         # build up file path/name in var tmpname...
+  #
+  #         @tmpfile = File.open(tmpname, File::RDWR|File::CREAT|File::EXCL, 0600)
+  #
+  #         # ...
+  #
+  #         super(@tmpfile)
+  #
+  #         # below this point, all methods of File are supported...
+  #       end
+  #
+  #       # ...
+  #     end
+  #
+  def DelegateClass: (Class) -> Class
+end