rbs 4.0.0.dev.4 → 4.0.0

data/stdlib/objspace/0/objspace.rbs

@@ -2,7 +2,7 @@
 # The objspace library extends the ObjectSpace module and adds several methods
 # to get internal statistic information about object/memory management.
 #
-# You need to `require 'objspace'` to use this extension module.
+# You need to <code>require 'objspace'</code> to use this extension module.
 #
 # Generally, you **SHOULD** **NOT** use this library if you do not know about
 # the MRI implementation.  Mainly, this library is for (memory) profiler
@@ -126,29 +126,6 @@ module ObjectSpace
   #
   def self?.count_imemo_objects: (?Hash[Symbol, Integer] result_hash) -> Hash[Symbol, Integer]
 
-  # <!--
-  #   rdoc-file=ext/objspace/objspace.c
-  #   - ObjectSpace.count_nodes([result_hash]) -> hash
-  # -->
-  # Counts nodes for each node type.
-  #
-  # This method is only for MRI developers interested in performance and memory
-  # usage of Ruby programs.
-  #
-  # It returns a hash as:
-  #
-  #     {:NODE_METHOD=>2027, :NODE_FBODY=>1927, :NODE_CFUNC=>1798, ...}
-  #
-  # If the optional argument, result_hash, is given, it is overwritten and
-  # returned. This is intended to avoid probe effect.
-  #
-  # Note: The contents of the returned hash is implementation defined. It may be
-  # changed in future.
-  #
-  # This method is only expected to work with C Ruby.
-  #
-  def self?.count_nodes: (?Hash[Symbol, Integer] result_hash) -> Hash[Symbol, Integer]
-
   # <!--
   #   rdoc-file=ext/objspace/objspace.c
   #   - ObjectSpace.count_objects_size([result_hash]) -> hash
@@ -237,12 +214,13 @@ module ObjectSpace
   # -->
   # Dump the contents of a ruby object as JSON.
   #
-  # *output* can be one of: `:stdout`, `:file`, `:string`, or IO object.
+  # *output* can be one of: <code>:stdout</code>, <code>:file</code>,
+  # <code>:string</code>, or IO object.
   #
-  # *   `:file` means dumping to a tempfile and returning corresponding File
-  #     object;
-  # *   `:stdout` means printing the dump and returning `nil`;
-  # *   `:string` means returning a string with the dump;
+  # *   <code>:file</code> means dumping to a tempfile and returning corresponding
+  #     File object;
+  # *   <code>:stdout</code> means printing the dump and returning `nil`;
+  # *   <code>:string</code> means returning a string with the dump;
   # *   if an instance of IO object is provided, the output goes there, and the
   #     object is returned.
   #
@@ -277,7 +255,7 @@ module ObjectSpace
   #
   # If *shapes* is a positive integer, only shapes newer than the provided shape
   # id are dumped. The current shape_id can be accessed using
-  # `RubyVM.stat(:next_shape_id)`.
+  # <code>RubyVM.stat(:next_shape_id)</code>.
   #
   # If *shapes* is `false`, no shapes are dumped.
   #
@@ -332,9 +310,11 @@ module ObjectSpace
   # information as only a **HINT**. Especially, the size of `T_DATA` may not be
   # correct.
   #
-  # This method is only expected to work with C Ruby.
+  # This method is only expected to work with CRuby.
   #
-  # From Ruby 2.2, memsize_of(obj) returns a memory size includes sizeof(RVALUE).
+  # From Ruby 3.2 with Variable Width Allocation, it returns the actual slot size
+  # used plus any additional memory allocated outside the slot (such as external
+  # strings, arrays, or hash tables).
   #
   def self?.memsize_of: (untyped) -> Integer
 
@@ -409,7 +389,7 @@ module ObjectSpace
   #     ObjectSpace.reachable_objects_from(1)
   #     #=> nil # 1 is not markable (heap managed) object
   #
-  def self?.reachable_objects_from: (untyped) -> ([ untyped ] | nil)
+  def self?.reachable_objects_from: (untyped) -> (Array[untyped] | nil)
 
   # <!--
   #   rdoc-file=ext/objspace/objspace.c
@@ -461,8 +441,11 @@ module ObjectSpace
 
   # <!--
   #   rdoc-file=ext/objspace/object_tracing.c
-  #   - trace_object_allocations_debug_start()
+  #   - trace_object_allocations_debug_start
   # -->
+  # Starts tracing object allocations for GC debugging. If you encounter the BUG
+  # "... is T_NONE" (and so on) on your application, please try this method at the
+  # beginning of your app.
   #
   def self?.trace_object_allocations_debug_start: () -> void
 

data/stdlib/open-uri/0/open-uri.rbs

@@ -9,9 +9,9 @@ module URI
   # If the first argument responds to the 'open' method, 'open' is called on it
   # with the rest of the arguments.
   #
-  # If the first argument is a string that begins with `(protocol)://`, it is
-  # parsed by URI.parse.  If the parsed object responds to the 'open' method,
-  # 'open' is called on it with the rest of the arguments.
+  # If the first argument is a string that begins with <code>(protocol)://</code>,
+  # it is parsed by URI.parse.  If the parsed object responds to the 'open'
+  # method, 'open' is called on it with the rest of the arguments.
   #
   # Otherwise, Kernel#open is called.
   #
@@ -83,6 +83,46 @@ end
 # :   Tanaka Akira <akr@m17n.org>
 #
 module OpenURI
+  # <!-- rdoc-file=lib/open-uri.rb -->
+  # Raised on HTTP session failure
+  #
+  class HTTPError < StandardError
+    # <!--
+    #   rdoc-file=lib/open-uri.rb
+    #   - new(message, io)
+    # -->
+    #
+    def initialize: (String message, (StringIO & OpenURI::Meta) io) -> void
+
+    # <!-- rdoc-file=lib/open-uri.rb -->
+    # StringIO having the received data
+    #
+    attr_reader io: StringIO & OpenURI::Meta
+  end
+
+  # <!-- rdoc-file=lib/open-uri.rb -->
+  # Raised on redirection, only occurs when `redirect` option for HTTP is `false`.
+  #
+  class HTTPRedirect < HTTPError
+    # <!--
+    #   rdoc-file=lib/open-uri.rb
+    #   - new(message, io, uri)
+    # -->
+    #
+    def initialize: (String message, (StringIO & OpenURI::Meta) io, URI uri) -> void
+
+    # <!-- rdoc-file=lib/open-uri.rb -->
+    # URI to redirect
+    #
+    attr_reader uri: URI
+  end
+
+  # <!-- rdoc-file=lib/open-uri.rb -->
+  # Raised on too many redirection,
+  #
+  class TooManyRedirects < HTTPError
+  end
+
   # <!-- rdoc-file=lib/open-uri.rb -->
   # Mixin for holding meta-information.
   #
@@ -309,17 +349,17 @@ module OpenURI
     # :   Synopsis:
     #         :ftp_active_mode=>bool
     #
-    #     `:ftp_active_mode => true` is used to make ftp active mode. Ruby 1.9 uses
-    #     passive mode by default. Note that the active mode is default in Ruby 1.8
-    #     or prior.
+    #     <code>:ftp_active_mode => true</code> is used to make ftp active mode.
+    #     Ruby 1.9 uses passive mode by default. Note that the active mode is
+    #     default in Ruby 1.8 or prior.
     #
     #
     # :redirect
     # :   Synopsis:
     #         :redirect=>bool
     #
-    #     `:redirect` is true by default.  `:redirect => false` is used to disable
-    #     all HTTP redirects.
+    #     <code>:redirect</code> is true by default.  <code>:redirect =>
+    #     false</code> is used to disable all HTTP redirects.
     #
     #     OpenURI::HTTPRedirect exception raised on redirection. Using `true` also
     #     means that redirections between http and ftp are permitted.