rbs 3.2.2 → 3.3.0.pre.1

data/stdlib/net-http/0/net-http.rbs

@@ -1,59 +1,10 @@
 module Net
-  class Protocol
-    VERSION: String
-  end
-
-  class ProtocolError < StandardError
-  end
-
-  class ProtoSyntaxError < ProtocolError
-  end
-
-  class ProtoFatalError < ProtocolError
-  end
-
-  class ProtoUnknownError < ProtocolError
-  end
-
-  class ProtoServerError < ProtocolError
-  end
-
-  class ProtoAuthError < ProtocolError
-  end
-
-  class ProtoCommandError < ProtocolError
-  end
-
-  class ProtoRetriableError < ProtocolError
-  end
-
   class HTTPBadResponse < StandardError
   end
 
   class HTTPHeaderSyntaxError < StandardError
   end
 
-  # <!-- rdoc-file=lib/net/protocol.rb -->
-  # OpenTimeout, a subclass of Timeout::Error, is raised if a connection cannot be
-  # created within the open_timeout.
-  #
-  class OpenTimeout < Timeout::Error
-  end
-
-  # <!-- rdoc-file=lib/net/protocol.rb -->
-  # ReadTimeout, a subclass of Timeout::Error, is raised if a chunk of the
-  # response cannot be read within the read_timeout.
-  #
-  class ReadTimeout < Timeout::Error
-  end
-
-  # <!-- rdoc-file=lib/net/protocol.rb -->
-  # WriteTimeout, a subclass of Timeout::Error, is raised if a chunk of the
-  # response cannot be written within the write_timeout.  Not raised on Windows.
-  #
-  class WriteTimeout < Timeout::Error
-  end
-
   # <!-- rdoc-file=lib/net/http.rb -->
   # Class Net::HTTP provides a rich library that implements the client in a
   # client-server model that uses the HTTP request-response protocol. For
@@ -1128,7 +1079,7 @@ module Net
     # This class is obsolete.  You may pass these same parameters directly to
     # Net::HTTP.new.  See Net::HTTP.new for details of the arguments.
     #
-    def self.Proxy: (?Symbol | String p_addr, ?Integer? p_port, ?String? p_user, ?String? p_pass) -> untyped
+    def self.Proxy: (?interned p_addr, ?Integer? p_port, ?String? p_user, ?String? p_pass) -> untyped
 
     # <!--
     #   rdoc-file=lib/net/http.rb
@@ -1836,7 +1787,9 @@ module Net
 
     alias length size
 
-    type key = String | Symbol
+    # A previous incarnation of `interned` for backward-compatibility (see #1499)
+    %a{steep:deprecated}
+    type key = interned
 
     # <!--
     #   rdoc-file=lib/net/http/header.rb
@@ -1852,7 +1805,7 @@ module Net
     # Note that some field values may be retrieved via convenience methods; see
     # [Getters](rdoc-ref:Net::HTTPHeader@Getters).
     #
-    def []: (key key) -> (nil | String)
+    def []: (interned key) -> (nil | String)
 
     # <!--
     #   rdoc-file=lib/net/http/header.rb
@@ -1870,7 +1823,7 @@ module Net
     # Note that some field values may be set via convenience methods; see
     # [Setters](rdoc-ref:Net::HTTPHeader@Setters).
     #
-    def []=: (key key, untyped val) -> void
+    def []=: (interned key, untyped val) -> void
 
     # <!--
     #   rdoc-file=lib/net/http/header.rb
@@ -1889,7 +1842,7 @@ module Net
     #     req['Foo']            # => "bar, baz, baz, bam"
     #     req.get_fields('Foo') # => ["bar", "baz", "baz", "bam"]
     #
-    def add_field: (key key, untyped val) -> void
+    def add_field: (interned key, untyped val) -> void
 
     private
 
@@ -1898,7 +1851,7 @@ module Net
     #   - set_field(key, val)
     # -->
     #
-    def set_field: (key key, untyped val) -> void
+    def set_field: (interned key, untyped val) -> void
 
     # <!--
     #   rdoc-file=lib/net/http/header.rb
@@ -1920,7 +1873,7 @@ module Net
     #     res.get_fields('Connection') # => ["keep-alive"]
     #     res.get_fields('Nosuch')     # => nil
     #
-    def get_fields: (key key) -> (nil | Array[String])
+    def get_fields: (interned key) -> (nil | Array[String])
 
     # <!--
     #   rdoc-file=lib/net/http/header.rb
@@ -1950,9 +1903,9 @@ module Net
     #     res.fetch('Nosuch', 'Foo')     # => "Foo"
     #     res.fetch('Nosuch')            # Raises KeyError.
     #
-    def fetch: (key key) -> String
-             | (key key, untyped) -> untyped
-             | (key key) { (String) -> untyped } -> untyped
+    def fetch: (interned key) -> String
+             | (interned key, untyped) -> untyped
+             | (interned key) { (String) -> untyped } -> untyped
 
     # <!--
     #   rdoc-file=lib/net/http/header.rb
@@ -2081,7 +2034,7 @@ module Net
     #     req.delete('Accept') # => ["*/*"]
     #     req.delete('Nosuch') # => nil
     #
-    def delete: (key key) -> (Array[String] | nil)
+    def delete: (interned key) -> (Array[String] | nil)
 
     # <!--
     #   rdoc-file=lib/net/http/header.rb
@@ -2094,7 +2047,7 @@ module Net
     #     req.key?('Accept') # => true
     #     req.key?('Nosuch') # => false
     #
-    def key?: (key key) -> bool
+    def key?: (interned key) -> bool
 
     # <!--
     #   rdoc-file=lib/net/http/header.rb
@@ -2138,7 +2091,7 @@ module Net
     #   - capitalize(name)
     # -->
     #
-    def capitalize: (key name) -> String
+    def capitalize: (interned name) -> String
 
     public
 
@@ -2361,7 +2314,7 @@ module Net
     # Net::HTTPHeader#content_type= is an alias for
     # Net::HTTPHeader#set_content_type.
     #
-    def set_content_type: (key `type`, ?Hash[untyped, untyped] params) -> void
+    def set_content_type: (interned `type`, ?Hash[untyped, untyped] params) -> void
 
     # <!--
     #   rdoc-file=lib/net/http/header.rb

data/stdlib/net-protocol/0/manifest.yaml

@@ -0,0 +1,2 @@
+dependencies:
+  - name: timeout

data/stdlib/net-protocol/0/net-protocol.rbs

@@ -0,0 +1,56 @@
+module Net
+  class Protocol
+    VERSION: String
+  end
+
+  class ProtocolError < StandardError
+  end
+
+  class ProtoSyntaxError < ProtocolError
+  end
+
+  class ProtoFatalError < ProtocolError
+  end
+
+  class ProtoUnknownError < ProtocolError
+  end
+
+  class ProtoServerError < ProtocolError
+  end
+
+  class ProtoAuthError < ProtocolError
+  end
+
+  class ProtoCommandError < ProtocolError
+  end
+
+  class ProtoRetriableError < ProtocolError
+  end
+
+  class HTTPBadResponse < StandardError
+  end
+
+  class HTTPHeaderSyntaxError < StandardError
+  end
+
+  # <!-- rdoc-file=lib/net/protocol.rb -->
+  # OpenTimeout, a subclass of Timeout::Error, is raised if a connection cannot be
+  # created within the open_timeout.
+  #
+  class OpenTimeout < Timeout::Error
+  end
+
+  # <!-- rdoc-file=lib/net/protocol.rb -->
+  # ReadTimeout, a subclass of Timeout::Error, is raised if a chunk of the
+  # response cannot be read within the read_timeout.
+  #
+  class ReadTimeout < Timeout::Error
+  end
+
+  # <!-- rdoc-file=lib/net/protocol.rb -->
+  # WriteTimeout, a subclass of Timeout::Error, is raised if a chunk of the
+  # response cannot be written within the write_timeout.  Not raised on Windows.
+  #
+  class WriteTimeout < Timeout::Error
+  end
+end

data/stdlib/openssl/0/openssl.rbs

@@ -8418,7 +8418,7 @@ module OpenSSL
       # -->
       # See BasicSocket#shutdown for details.
       #
-      def shutdown: (Symbol | String | Integer how) -> void
+      def shutdown: (interned | Integer how) -> void
 
       # <!-- rdoc-file=ext/openssl/lib/openssl/ssl.rb -->
       # When true then #accept works exactly the same as TCPServer#accept

data/stdlib/pp/0/manifest.yaml

@@ -0,0 +1,2 @@
+dependencies:
+  - name: prettyprint

data/stdlib/pp/0/pp.rbs

@@ -0,0 +1,301 @@
+# <!-- rdoc-file=lib/pp.rb -->
+# A pretty-printer for Ruby objects.
+#
+# ## What PP Does
+#
+# Standard output by #p returns this:
+#     #<PP:0x81fedf0 @genspace=#<Proc:0x81feda0>, @group_queue=#<PrettyPrint::GroupQueue:0x81fed3c @queue=[[#<PrettyPrint::Group:0x81fed78 @breakables=[], @depth=0, @break=false>], []]>, @buffer=[], @newline="\n", @group_stack=[#<PrettyPrint::Group:0x81fed78 @breakables=[], @depth=0, @break=false>], @buffer_width=0, @indent=0, @maxwidth=79, @output_width=2, @output=#<IO:0x8114ee4>>
+#
+# Pretty-printed output returns this:
+#     #<PP:0x81fedf0
+#      @buffer=[],
+#      @buffer_width=0,
+#      @genspace=#<Proc:0x81feda0>,
+#      @group_queue=
+#       #<PrettyPrint::GroupQueue:0x81fed3c
+#        @queue=
+#         [[#<PrettyPrint::Group:0x81fed78 @break=false, @breakables=[], @depth=0>],
+#          []]>,
+#      @group_stack=
+#       [#<PrettyPrint::Group:0x81fed78 @break=false, @breakables=[], @depth=0>],
+#      @indent=0,
+#      @maxwidth=79,
+#      @newline="\n",
+#      @output=#<IO:0x8114ee4>,
+#      @output_width=2>
+#
+# ## Usage
+#
+#     pp(obj)             #=> obj
+#     pp obj              #=> obj
+#     pp(obj1, obj2, ...) #=> [obj1, obj2, ...]
+#     pp()                #=> nil
+#
+# Output `obj(s)` to `$>` in pretty printed format.
+#
+# It returns `obj(s)`.
+#
+# ## Output Customization
+#
+# To define a customized pretty printing function for your classes, redefine
+# method `#pretty_print(pp)` in the class.
+#
+# `#pretty_print` takes the `pp` argument, which is an instance of the PP class.
+# The method uses #text, #breakable, #nest, #group and #pp to print the object.
+#
+# ## Pretty-Print JSON
+#
+# To pretty-print JSON refer to JSON#pretty_generate.
+#
+# ## Author
+# Tanaka Akira <akr@fsij.org>
+#
+class PP < PrettyPrint
+  interface _PrettyPrint
+    def pretty_print: (untyped q) -> untyped
+
+    def pretty_print_cycle: (untyped q) -> untyped
+
+    def is_a?: (Module) -> bool
+  end
+
+  interface _LeftShift
+    def <<: (untyped obj) -> self
+  end
+
+  interface _PPMethodsRequired
+    def text: (String obj, ?Integer width) -> void
+
+    def breakable: (?String sep, ?Integer width) -> void
+
+    def group: (?Integer indent, ?String open_obj, ?String close_obj, ?Integer open_width, ?Integer close_width) { () -> untyped } -> void
+  end
+
+  module PPMethods : _PPMethodsRequired
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - guard_inspect_key() { || ... }
+    # -->
+    # Yields to a block and preserves the previous set of objects being printed.
+    #
+    def guard_inspect_key: () { () -> untyped } -> void
+
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - check_inspect_key(id)
+    # -->
+    # Check whether the object_id `id` is in the current buffer of objects to be
+    # pretty printed. Used to break cycles in chains of objects to be pretty
+    # printed.
+    #
+    def check_inspect_key: (_PrettyPrint id) -> bool
+
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - push_inspect_key(id)
+    # -->
+    # Adds the object_id `id` to the set of objects being pretty printed, so as to
+    # not repeat objects.
+    #
+    def push_inspect_key: (_PrettyPrint id) -> void
+
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - pop_inspect_key(id)
+    # -->
+    # Removes an object from the set of objects being pretty printed.
+    #
+    def pop_inspect_key: (_PrettyPrint id) -> void
+
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - pp(obj)
+    # -->
+    # Adds `obj` to the pretty printing buffer using Object#pretty_print or
+    # Object#pretty_print_cycle.
+    #
+    # Object#pretty_print_cycle is used when `obj` is already printed, a.k.a the
+    # object reference chain has a cycle.
+    #
+    def pp: (_PrettyPrint obj) -> untyped
+
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - object_group(obj) { || ... }
+    # -->
+    # A convenience method which is same as follows:
+    #
+    #     group(1, '#<' + obj.class.name, '>') { ... }
+    #
+    def object_group: (untyped obj) { () -> untyped } -> Integer
+
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - object_address_group(obj, &block)
+    # -->
+    # A convenience method, like object_group, but also reformats the Object's
+    # object_id.
+    #
+    def object_address_group: (untyped obj) { () -> untyped } -> Integer
+
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - comma_breakable()
+    # -->
+    # A convenience method which is same as follows:
+    #
+    #     text ','
+    #     breakable
+    #
+    def comma_breakable: () -> void
+
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - seplist(list, sep=nil, iter_method=:each) { |element| ... }
+    # -->
+    # Adds a separated list. The list is separated by comma with breakable space, by
+    # default.
+    #
+    # #seplist iterates the `list` using `iter_method`. It yields each object to the
+    # block given for #seplist. The procedure `separator_proc` is called between
+    # each yields.
+    #
+    # If the iteration is zero times, `separator_proc` is not called at all.
+    #
+    # If `separator_proc` is nil or not given, +lambda { comma_breakable }+ is used.
+    # If `iter_method` is not given, :each is used.
+    #
+    # For example, following 3 code fragments has similar effect.
+    #
+    #     q.seplist([1,2,3]) {|v| xxx v }
+    #
+    #     q.seplist([1,2,3], lambda { q.comma_breakable }, :each) {|v| xxx v }
+    #
+    #     xxx 1
+    #     q.comma_breakable
+    #     xxx 2
+    #     q.comma_breakable
+    #     xxx 3
+    #
+    def seplist: (untyped list, ?(^() -> void)? sep, ?interned iter_method) { (*untyped, **untyped) -> void } -> void
+
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - pp_object(obj)
+    # -->
+    # A present standard failsafe for pretty printing any given Object
+    #
+    def pp_object: (untyped obj) -> untyped
+
+    # <!--
+    #   rdoc-file=lib/pp.rb
+    #   - pp_hash(obj)
+    # -->
+    # A pretty print for a Hash
+    #
+    def pp_hash: (untyped obj) -> untyped
+  end
+  include PPMethods
+
+  class SingleLine < ::PrettyPrint::SingleLine
+    include PPMethods
+  end
+
+  module ObjectMixin : BasicObject
+    def pretty_print: (PP q) -> untyped
+
+    def pretty_print_cycle: (PP q) -> untyped
+
+    def pretty_print_instance_variables: () -> Array[Symbol]
+
+    def pretty_print_inspect: () -> untyped
+  end
+
+  # <!--
+  #   rdoc-file=lib/pp.rb
+  #   - width_for(out)
+  # -->
+  # Returns the usable width for `out`. As the width of `out`:
+  # 1.  If `out` is assigned to a tty device, its width is used.
+  # 2.  Otherwise, or it could not get the value, the `COLUMN` environment
+  #     variable is assumed to be set to the width.
+  # 3.  If `COLUMN` is not set to a non-zero number, 80 is assumed.
+  #
+  #
+  # And finally, returns the above width value - 1.
+  # *   This -1 is for Windows command prompt, which moves the cursor to the next
+  #     line if it reaches the last column.
+  #
+  def self.width_for: (untyped out) -> Integer
+
+  # <!--
+  #   rdoc-file=lib/pp.rb
+  #   - pp(obj, out=$>, width=width_for(out))
+  # -->
+  # Outputs `obj` to `out` in pretty printed format of `width` columns in width.
+  #
+  # If `out` is omitted, `$>` is assumed. If `width` is omitted, the width of
+  # `out` is assumed (see width_for).
+  #
+  # PP.pp returns `out`.
+  #
+  def self.pp: (_PrettyPrint obj, ?_LeftShift out, ?Integer width) -> untyped
+
+  # <!--
+  #   rdoc-file=lib/pp.rb
+  #   - singleline_pp(obj, out=$>)
+  # -->
+  # Outputs `obj` to `out` like PP.pp but with no indent and newline.
+  #
+  # PP.singleline_pp returns `out`.
+  #
+  def self.singleline_pp: (_PrettyPrint obj, ?_LeftShift out) -> untyped
+  def self.mcall: (untyped obj, Module mod, interned meth, *untyped args) ?{ (*untyped, **untyped) -> untyped } -> untyped
+
+  # <!--
+  #   rdoc-file=lib/pp.rb
+  #   - sharing_detection()
+  # -->
+  # Returns the sharing detection flag as a boolean value. It is false (nil) by
+  # default.
+  # ----
+  # <!--
+  #   rdoc-file=lib/pp.rb
+  #   - sharing_detection=(b)
+  # -->
+  # Sets the sharing detection flag to b.
+  #
+  attr_accessor self.sharing_detection: bool?
+end
+
+%a{annotate:rdoc:skip}
+class RubyVM::AbstractSyntaxTree::Node
+  # <!--
+  #   rdoc-file=lib/pp.rb
+  #   - pretty_print_children(q, names = [])
+  # -->
+  #
+  def pretty_print_children: (PP q, ?Array[untyped] names) -> void
+end
+
+%a{annotate:rdoc:skip}
+class Object
+  include PP::ObjectMixin
+end
+
+%a{annotate:rdoc:skip}
+module Kernel
+  # <!--
+  #   rdoc-file=lib/pp.rb
+  #   - pretty_inspect()
+  # -->
+  # Returns a pretty printed object as a string.
+  #
+  # In order to use this method you must first require the PP module:
+  #
+  #     require 'pp'
+  #
+  # See the PP module for more information.
+  #
+  def pretty_inspect: () -> String
+end

data/stdlib/{yaml → psych}/0/dbm.rbs

@@ -1,5 +1,5 @@
 %a{annotate:rdoc:skip}
-module YAML
+module Psych
   # <!-- rdoc-file=lib/yaml/dbm.rb -->
   # YAML + DBM = YDBM
   #
@@ -169,7 +169,7 @@ module YAML
     # object. Takes any object which implements the each_pair method, including Hash
     # and DBM objects.
     #
-    def replace: (Hash[untyped, untyped] | DBM hsh) -> YAML::DBM
+    def replace: (Hash[untyped, untyped] | DBM hsh) -> Psych::DBM
 
     # <!--
     #   rdoc-file=lib/yaml/dbm.rb
@@ -214,7 +214,7 @@ module YAML
     #
     # Returns `self`.
     #
-    def update: (Hash[untyped, untyped]) -> YAML::DBM
+    def update: (Hash[untyped, untyped]) -> Psych::DBM
 
     # <!--
     #   rdoc-file=lib/yaml/dbm.rb

data/stdlib/psych/0/manifest.yaml

@@ -0,0 +1,3 @@
+dependencies:
+  - name: dbm
+  - name: pstore