@ai-ecoverse/wasix-ruby 3.4.11-2 → 3.4.11-20

package/lib/ruby/gems/3.4.0/gems/rbs-3.8.0/core/exception.rbs

@@ -1,376 +0,0 @@
-# <!-- rdoc-file=error.c -->
-# Class `Exception` and its subclasses are used to indicate that an error or
-# other problem has occurred, and may need to be handled. See
-# [Exceptions](rdoc-ref:exceptions.md).
-#
-# An `Exception` object carries certain information:
-#
-# *   The type (the exception's class), commonly StandardError, RuntimeError, or
-#     a subclass of one or the other; see [Built-In Exception Class
-#     Hierarchy](rdoc-ref:Exception@Built-In+Exception+Class+Hierarchy).
-# *   An optional descriptive message; see methods ::new, #message.
-# *   Optional backtrace information; see methods #backtrace,
-#     #backtrace_locations, #set_backtrace.
-# *   An optional cause; see method #cause.
-#
-# ## Built-In Exception Class Hierarchy
-#
-# The hierarchy of built-in subclasses of class `Exception`:
-#
-# *   NoMemoryError
-# *   ScriptError
-#     *   LoadError
-#     *   NotImplementedError
-#     *   SyntaxError
-# *   SecurityError
-# *   SignalException
-#     *   Interrupt
-# *   StandardError
-#     *   ArgumentError
-#         *   UncaughtThrowError
-#     *   EncodingError
-#     *   FiberError
-#     *   IOError
-#         *   EOFError
-#     *   IndexError
-#         *   KeyError
-#         *   StopIteration
-#             *   ClosedQueueError
-#     *   LocalJumpError
-#     *   NameError
-#         *   NoMethodError
-#     *   RangeError
-#         *   FloatDomainError
-#     *   RegexpError
-#     *   RuntimeError
-#         *   FrozenError
-#     *   SystemCallError
-#         *   Errno (and its subclasses, representing system errors)
-#     *   ThreadError
-#     *   TypeError
-#     *   ZeroDivisionError
-# *   SystemExit
-# *   SystemStackError
-# *   [fatal](rdoc-ref:fatal)
-#
-class Exception
-  # <!--
-  #   rdoc-file=error.c
-  #   - Exception.to_tty? -> true or false
-  # -->
-  # Returns `true` if exception messages will be sent to a terminal device.
-  #
-  def self.to_tty?: () -> bool
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - exception(message = nil) -> self or new_exception
-  # -->
-  # Returns an exception object of the same class as `self`; useful for creating a
-  # similar exception, but with a different message.
-  #
-  # With `message` `nil`, returns `self`:
-  #
-  #     x0 = StandardError.new('Boom') # => #<StandardError: Boom>
-  #     x1 = x0.exception              # => #<StandardError: Boom>
-  #     x0.__id__ == x1.__id__         # => true
-  #
-  # With [string-convertible
-  # object](rdoc-ref:implicit_conversion.rdoc@String-Convertible+Objects)
-  # `message` (even the same as the original message), returns a new exception
-  # object whose class is the same as `self`, and whose message is the given
-  # `message`:
-  #
-  #     x1 = x0.exception('Boom') # => #<StandardError: Boom>
-  #     x0..equal?(x1)            # => false
-  #
-  def self.exception: (?string | _ToS msg) -> instance
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - self == object -> true or false
-  # -->
-  # Returns whether `object` is the same class as `self` and its #message and
-  # #backtrace are equal to those of `self`.
-  #
-  def ==: (untyped obj) -> bool
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - backtrace -> array or nil
-  # -->
-  # Returns a backtrace value for `self`; the returned value depends on the form
-  # of the stored backtrace value:
-  #
-  # *   Array of Thread::Backtrace::Location objects: returns the array of strings
-  #     given by `Exception#backtrace_locations.map {|loc| loc.to_s }`. This is
-  #     the normal case, where the backtrace value was stored by Kernel#raise.
-  # *   Array of strings: returns that array. This is the unusual case, where the
-  #     backtrace value was explicitly stored as an array of strings.
-  # *   `nil`: returns `nil`.
-  #
-  # Example:
-  #
-  #     begin
-  #       1 / 0
-  #     rescue => x
-  #       x.backtrace.take(2)
-  #     end
-  #     # => ["(irb):132:in `/'", "(irb):132:in `<top (required)>'"]
-  #
-  # see [Backtraces](rdoc-ref:exceptions.md@Backtraces).
-  #
-  def backtrace: () -> Array[String]?
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - backtrace_locations -> array or nil
-  # -->
-  # Returns a backtrace value for `self`; the returned value depends on the form
-  # of the stored backtrace value:
-  #
-  # *   Array of Thread::Backtrace::Location objects: returns that array.
-  # *   Array of strings or `nil`: returns `nil`.
-  #
-  # Example:
-  #
-  #     begin
-  #       1 / 0
-  #     rescue => x
-  #       x.backtrace_locations.take(2)
-  #     end
-  #     # => ["(irb):150:in `/'", "(irb):150:in `<top (required)>'"]
-  #
-  # See [Backtraces](rdoc-ref:exceptions.md@Backtraces).
-  #
-  def backtrace_locations: () -> Array[Thread::Backtrace::Location]?
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - cause -> exception or nil
-  # -->
-  # Returns the previous value of global variable `$!`, which may be `nil` (see
-  # [Global Variables](rdoc-ref:exceptions.md@Global+Variables)):
-  #
-  #     begin
-  #       raise('Boom 0')
-  #     rescue => x0
-  #       puts "Exception: #{x0};  $!: #{$!};  cause: #{x0.cause.inspect}."
-  #       begin
-  #         raise('Boom 1')
-  #       rescue => x1
-  #         puts "Exception: #{x1};  $!: #{$!};  cause: #{x1.cause}."
-  #         begin
-  #           raise('Boom 2')
-  #         rescue => x2
-  #           puts "Exception: #{x2};  $!: #{$!};  cause: #{x2.cause}."
-  #         end
-  #       end
-  #     end
-  #
-  # Output:
-  #
-  #     Exception: Boom 0;  $!: Boom 0;  cause: nil.
-  #     Exception: Boom 1;  $!: Boom 1;  cause: Boom 0.
-  #     Exception: Boom 2;  $!: Boom 2;  cause: Boom 1.
-  #
-  def cause: () -> Exception?
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - detailed_message(highlight: false, **kwargs) -> string
-  # -->
-  # Returns the message string with enhancements:
-  #
-  # *   Includes the exception class name in the first line.
-  # *   If the value of keyword `highlight` is `true`, includes bolding and
-  #     underlining ANSI codes (see below) to enhance the appearance of the
-  #     message.
-  #
-  # Examples:
-  #
-  #     begin
-  #       1 / 0
-  #     rescue => x
-  #       p x.message
-  #       p x.detailed_message                  # Class name added.
-  #       p x.detailed_message(highlight: true) # Class name, bolding, and underlining added.
-  #     end
-  #
-  # Output:
-  #
-  #     "divided by 0"
-  #     "divided by 0 (ZeroDivisionError)"
-  #     "\e[1mdivided by 0 (\e[1;4mZeroDivisionError\e[m\e[1m)\e[m"
-  #
-  # This method is overridden by some gems in the Ruby standard library to add
-  # information:
-  #
-  # *   DidYouMean::Correctable#detailed_message.
-  # *   ErrorHighlight::CoreExt#detailed_message.
-  # *   SyntaxSuggest#detailed_message.
-  #
-  # An overriding method must be tolerant of passed keyword arguments, which may
-  # include (but may not be limited to):
-  #
-  # *   `:highlight`.
-  # *   `:did_you_mean`.
-  # *   `:error_highlight`.
-  # *   `:syntax_suggest`.
-  #
-  # An overriding method should also be careful with ANSI code enhancements; see
-  # [Messages](rdoc-ref:exceptions.md@Messages).
-  #
-  def detailed_message: (?highlight: bool?, **untyped ignored) -> String
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - exception(message = nil) -> self or new_exception
-  # -->
-  # Returns an exception object of the same class as `self`; useful for creating a
-  # similar exception, but with a different message.
-  #
-  # With `message` `nil`, returns `self`:
-  #
-  #     x0 = StandardError.new('Boom') # => #<StandardError: Boom>
-  #     x1 = x0.exception              # => #<StandardError: Boom>
-  #     x0.__id__ == x1.__id__         # => true
-  #
-  # With [string-convertible
-  # object](rdoc-ref:implicit_conversion.rdoc@String-Convertible+Objects)
-  # `message` (even the same as the original message), returns a new exception
-  # object whose class is the same as `self`, and whose message is the given
-  # `message`:
-  #
-  #     x1 = x0.exception('Boom') # => #<StandardError: Boom>
-  #     x0..equal?(x1)            # => false
-  #
-  def exception: (?self) -> self
-               | (string | _ToS message) -> instance
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - Exception.new(message = nil) -> exception
-  # -->
-  # Returns a new exception object.
-  #
-  # The given `message` should be a [string-convertible
-  # object](rdoc-ref:implicit_conversion.rdoc@String-Convertible+Objects); see
-  # method #message; if not given, the message is the class name of the new
-  # instance (which may be the name of a subclass):
-  #
-  # Examples:
-  #
-  #     Exception.new         # => #<Exception: Exception>
-  #     LoadError.new         # => #<LoadError: LoadError> # Subclass of Exception.
-  #     Exception.new('Boom') # => #<Exception: Boom>
-  #
-  def initialize: (?string | _ToS message) -> void
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - inspect -> string
-  # -->
-  # Returns a string representation of `self`:
-  #
-  #     x = RuntimeError.new('Boom')
-  #     x.inspect # => "#<RuntimeError: Boom>"
-  #     x = RuntimeError.new
-  #     x.inspect # => "#<RuntimeError: RuntimeError>"
-  #
-  def inspect: () -> String
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - message -> string
-  # -->
-  # Returns #to_s.
-  #
-  # See [Messages](rdoc-ref:exceptions.md@Messages).
-  #
-  def message: () -> String
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - set_backtrace(value) -> value
-  # -->
-  # Sets the backtrace value for `self`; returns the given +value:
-  #
-  #     x = RuntimeError.new('Boom')
-  #     x.set_backtrace(%w[foo bar baz]) # => ["foo", "bar", "baz"]
-  #     x.backtrace                      # => ["foo", "bar", "baz"]
-  #
-  # The given `value` must be an array of strings, a single string, or `nil`.
-  #
-  # Does not affect the value returned by #backtrace_locations.
-  #
-  # See [Backtraces](rdoc-ref:exceptions.md@Backtraces).
-  #
-  def set_backtrace: (String | Array[String]) -> Array[String]
-                   | (Array[Thread::Backtrace::Location]) -> Array[Thread::Backtrace::Location]
-                   | (nil) -> nil
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - to_s -> string
-  # -->
-  # Returns a string representation of `self`:
-  #
-  #     x = RuntimeError.new('Boom')
-  #     x.to_s # => "Boom"
-  #     x = RuntimeError.new
-  #     x.to_s # => "RuntimeError"
-  #
-  def to_s: () -> String
-
-  # <!--
-  #   rdoc-file=error.c
-  #   - full_message(highlight: true, order: :top) -> string
-  # -->
-  # Returns an enhanced message string:
-  #
-  # *   Includes the exception class name.
-  # *   If the value of keyword `highlight` is true (not `nil` or `false`),
-  #     includes bolding ANSI codes (see below) to enhance the appearance of the
-  #     message.
-  # *   Includes the [backtrace](rdoc-ref:exceptions.md@Backtraces):
-  #
-  #     *   If the value of keyword `order` is `:top` (the default), lists the
-  #         error message and the innermost backtrace entry first.
-  #     *   If the value of keyword `order` is `:bottom`, lists the error message
-  #         the the innermost entry last.
-  #
-  # Example:
-  #
-  #     def baz
-  #       begin
-  #         1 / 0
-  #       rescue => x
-  #         pp x.message
-  #         pp x.full_message(highlight: false).split("\n")
-  #         pp x.full_message.split("\n")
-  #       end
-  #     end
-  #     def bar; baz; end
-  #     def foo; bar; end
-  #     foo
-  #
-  # Output:
-  #
-  #     "divided by 0"
-  #     ["t.rb:3:in `/': divided by 0 (ZeroDivisionError)",
-  #      "\tfrom t.rb:3:in `baz'",
-  #      "\tfrom t.rb:10:in `bar'",
-  #      "\tfrom t.rb:11:in `foo'",
-  #      "\tfrom t.rb:12:in `<main>'"]
-  #     ["t.rb:3:in `/': \e[1mdivided by 0 (\e[1;4mZeroDivisionError\e[m\e[1m)\e[m",
-  #      "\tfrom t.rb:3:in `baz'",
-  #      "\tfrom t.rb:10:in `bar'",
-  #      "\tfrom t.rb:11:in `foo'",
-  #      "\tfrom t.rb:12:in `<main>'"]
-  #
-  # An overriding method should be careful with ANSI code enhancements; see
-  # [Messages](rdoc-ref:exceptions.md@Messages).
-  #
-  def full_message: (?highlight: bool?, ?order: (:top | :bottom | string)?) -> String
-end

package/lib/ruby/gems/3.4.0/gems/rbs-3.8.0/core/false_class.rbs

@@ -1,82 +0,0 @@
-# <!-- rdoc-file=object.c -->
-# The global value `false` is the only instance of class FalseClass and
-# represents a logically false value in boolean expressions. The class provides
-# operators allowing `false` to participate correctly in logical expressions.
-#
-class FalseClass
-  def !: () -> true
-
-  # <!--
-  #   rdoc-file=object.c
-  #   - false & object -> false
-  #   - nil & object   -> false
-  # -->
-  # Returns `false`:
-  #
-  #     false & true       # => false
-  #     false & Object.new # => false
-  #
-  # Argument `object` is evaluated:
-  #
-  #     false & raise # Raises RuntimeError.
-  #
-  def &: (untyped obj) -> false
-
-  # <!--
-  #   rdoc-file=object.c
-  #   - true === other -> true or false
-  #   - false === other -> true or false
-  #   - nil === other -> true or false
-  # -->
-  # Returns `true` or `false`.
-  #
-  # Like Object#==, if `object` is an instance of Object (and not an instance of
-  # one of its many subclasses).
-  #
-  # This method is commonly overridden by those subclasses, to provide meaningful
-  # semantics in `case` statements.
-  #
-  def ===: (false) -> true
-         | (untyped obj) -> bool
-
-  # <!--
-  #   rdoc-file=object.c
-  #   - false ^ object -> true or false
-  #   - nil ^ object   -> true or false
-  # -->
-  # Returns `false` if `object` is `nil` or `false`, `true` otherwise:
-  #
-  #     nil ^ nil        # => false
-  #     nil ^ false      # => false
-  #     nil ^ Object.new # => true
-  #
-  def ^: (false | nil) -> false
-       | (untyped obj) -> bool
-
-  # <!-- rdoc-file=object.c -->
-  # The string representation of `false` is "false".
-  #
-  alias inspect to_s
-
-  # <!--
-  #   rdoc-file=object.c
-  #   - false.to_s   ->  "false"
-  # -->
-  # The string representation of `false` is "false".
-  #
-  def to_s: () -> "false"
-
-  # <!--
-  #   rdoc-file=object.c
-  #   - false | object -> true or false
-  #   - nil   | object -> true or false
-  # -->
-  # Returns `false` if `object` is `nil` or `false`, `true` otherwise:
-  #
-  #     nil | nil        # => false
-  #     nil | false      # => false
-  #     nil | Object.new # => true
-  #
-  def |: (nil | false) -> false
-       | (untyped obj) -> bool
-end