rbs 3.2.2 → 3.3.0.pre.1

data/stdlib/rdoc/0/top_level.rbs

@@ -0,0 +1,97 @@
+%a{annotate:rdoc:skip}
+module RDoc
+  # <!-- rdoc-file=lib/rdoc/top_level.rb -->
+  # A TopLevel context is a representation of the contents of a single file
+  #
+  class TopLevel < Context
+    MARSHAL_VERSION: 0
+
+    # <!-- rdoc-file=lib/rdoc/top_level.rb -->
+    # Relative name of this file
+    #
+    attr_accessor relative_name: String
+
+    # <!--
+    #   rdoc-file=lib/rdoc/top_level.rb
+    #   - new(absolute_name, relative_name = absolute_name)
+    # -->
+    # Creates a new TopLevel for the file at `absolute_name`.  If documentation is
+    # being generated outside the source dir `relative_name` is relative to the
+    # source directory.
+    #
+    def initialize: (String absolute_name, ?String relative_name) -> void
+
+    # <!--
+    #   rdoc-file=lib/rdoc/top_level.rb
+    #   - ==(other)
+    # -->
+    # An RDoc::TopLevel is equal to another with the same relative_name
+    #
+    def ==: (untyped other) -> bool
+
+    # <!--
+    #   rdoc-file=lib/rdoc/top_level.rb
+    #   - eql?(other)
+    # -->
+    #
+    alias eql? ==
+
+    # <!--
+    #   rdoc-file=lib/rdoc/top_level.rb
+    #   - add_alias(an_alias)
+    # -->
+    # Adds `an_alias` to `Object` instead of `self`.
+    #
+    def add_alias: (RDoc::Alias an_alias) -> RDoc::Alias
+
+    # <!--
+    #   rdoc-file=lib/rdoc/top_level.rb
+    #   - add_constant(constant)
+    # -->
+    # Adds `constant` to `Object` instead of `self`.
+    #
+    def add_constant: (RDoc::Constant constant) -> RDoc::Constant
+
+    # <!--
+    #   rdoc-file=lib/rdoc/top_level.rb
+    #   - add_include(include)
+    # -->
+    # Adds `include` to `Object` instead of `self`.
+    #
+    def add_include: (RDoc::Include `include`) -> RDoc::Include
+
+    # <!--
+    #   rdoc-file=lib/rdoc/top_level.rb
+    #   - add_method(method)
+    # -->
+    # Adds `method` to `Object` instead of `self`.
+    #
+    def add_method: (RDoc::AnyMethod method) -> RDoc::AnyMethod
+
+    # <!--
+    #   rdoc-file=lib/rdoc/top_level.rb
+    #   - find_class_or_module(name)
+    # -->
+    # See RDoc::TopLevel::find_class_or_module
+    #
+    def find_class_or_module: (::String name) -> RDoc::Context
+
+    # <!--
+    #   rdoc-file=lib/rdoc/top_level.rb
+    #   - find_module_named(name)
+    # -->
+    # Finds a module or class with `name`
+    #
+    def find_module_named: (String name) -> RDoc::Context
+
+    # <!--
+    #   rdoc-file=lib/rdoc/top_level.rb
+    #   - full_name()
+    # -->
+    # Returns the relative name of this file
+    #
+    def full_name: () -> String
+
+    def to_s: () -> ::String
+  end
+end

data/stdlib/socket/0/basic_socket.rbs

@@ -579,7 +579,7 @@ class BasicSocket < IO
   #
   #     }
   #
-  def shutdown: (Symbol | String | Integer flags) -> void
+  def shutdown: (interned | Integer flags) -> void
 
   private
 

data/stdlib/socket/0/socket.rbs

@@ -4155,5 +4155,5 @@ class Socket::AncillaryData
   #     p Socket::AncillaryData.new(:INET6, :IPV6, :PKTINFO, "")
   #     #=> #<Socket::AncillaryData: INET6 IPV6 PKTINFO "">
   #
-  def initialize: (Symbol | String | Integer family, Symbol | String | Integer cmsg_level, Symbol | String | Integer cmsg_data, String cmsg_data) -> untyped
+  def initialize: (interned | Integer family, interned | Integer cmsg_level, interned | Integer cmsg_data, String cmsg_data) -> untyped
 end

data/stdlib/uri/0/common.rbs

@@ -278,7 +278,7 @@ module URI
   #     URI.join('http://example.com', '/foo/', 'bar')
   #     # => #<URI::HTTP http://example.com/foo/bar>
   #
-  def self.join: (String str, *String strs) -> URI::Generic
+  def self.join: (_ToStr | URI::Generic str, *_ToStr | URI::Generic strs) -> URI::Generic
 
   # <!--
   #   rdoc-file=lib/uri/common.rb

data/stdlib/yaml/0/manifest.yaml

@@ -1,3 +1,2 @@
 dependencies:
-  - name: dbm
-  - name: pstore
+  - name: psych

data/stdlib/yaml/0/yaml.rbs

@@ -1,199 +1 @@
-# <!-- rdoc-file=lib/yaml.rb -->
-# YAML Ain't Markup Language
-#
-# This module provides a Ruby interface for data serialization in YAML format.
-#
-# The YAML module is an alias of Psych, the YAML engine for Ruby.
-#
-# ## Usage
-#
-# Working with YAML can be very simple, for example:
-#
-#     require 'yaml'
-#     # Parse a YAML string
-#     YAML.load("--- foo") #=> "foo"
-#
-#     # Emit some YAML
-#     YAML.dump("foo")     # => "--- foo\n...\n"
-#     { :a => 'b'}.to_yaml  # => "---\n:a: b\n"
-#
-# As the implementation is provided by the Psych library, detailed documentation
-# can be found in that library's docs (also part of standard library).
-#
-# ## Security
-#
-# Do not use YAML to load untrusted data. Doing so is unsafe and could allow
-# malicious input to execute arbitrary code inside your application. Please see
-# doc/security.rdoc for more information.
-#
-# ## History
-#
-# Syck was the original YAML implementation in Ruby's standard library developed
-# by why the lucky stiff.
-#
-# You can still use Syck, if you prefer, for parsing and emitting YAML, but you
-# must install the 'syck' gem now in order to use it.
-#
-# In older Ruby versions, ie. <= 1.9, Syck is still provided, however it was
-# completely removed with the release of Ruby 2.0.0.
-#
-# ## More info
-#
-# For more advanced details on the implementation see Psych, and also check out
-# http://yaml.org for spec details and other helpful information.
-#
-# Psych is maintained by Aaron Patterson on github:
-# https://github.com/ruby/psych
-#
-# Syck can also be found on github: https://github.com/ruby/syck
-#
-module YAML
-  # <!--
-  #   rdoc-file=ext/psych/lib/psych.rb
-  #   - Psych.dump(o)               -> string of yaml
-  #   - Psych.dump(o, options)      -> string of yaml
-  #   - Psych.dump(o, io)           -> io object passed in
-  #   - Psych.dump(o, io, options)  -> io object passed in
-  # -->
-  # Dump Ruby object `o` to a YAML string.  Optional `options` may be passed in to
-  # control the output format.  If an IO object is passed in, the YAML will be
-  # dumped to that IO object.
-  #
-  # Currently supported options are:
-  #
-  # `:indentation`
-  # :   Number of space characters used to indent. Acceptable value should be in
-  #     `0..9` range, otherwise option is ignored.
-  #
-  #     Default: `2`.
-  # `:line_width`
-  # :   Max character to wrap line at.
-  #
-  #     Default: `0` (meaning "wrap at 81").
-  # `:canonical`
-  # :   Write "canonical" YAML form (very verbose, yet strictly formal).
-  #
-  #     Default: `false`.
-  # `:header`
-  # :   Write `%YAML [version]` at the beginning of document.
-  #
-  #     Default: `false`.
-  #
-  #
-  # Example:
-  #
-  #     # Dump an array, get back a YAML string
-  #     Psych.dump(['a', 'b'])  # => "---\n- a\n- b\n"
-  #
-  #     # Dump an array to an IO object
-  #     Psych.dump(['a', 'b'], StringIO.new)  # => #<StringIO:0x000001009d0890>
-  #
-  #     # Dump an array with indentation set
-  #     Psych.dump(['a', ['b']], indentation: 3) # => "---\n- a\n-  - b\n"
-  #
-  #     # Dump an array to an IO with indentation set
-  #     Psych.dump(['a', ['b']], StringIO.new, indentation: 3)
-  #
-  %a{annotate:rdoc:copy:Psych.dump}
-  def self.dump: (untyped o, ?indentation: Integer, ?line_width: Integer, ?canonical: bool, ?header: bool) -> String
-               | [IO] (untyped o, IO, ?indentation: Integer, ?line_width: Integer, ?canonical: bool, ?header: bool) -> IO
-
-  # <!--
-  #   rdoc-file=ext/psych/lib/psych.rb
-  #   - load(yaml, permitted_classes: [Symbol], permitted_symbols: [], aliases: false, filename: nil, fallback: nil, symbolize_names: false, freeze: false, strict_integer: false)
-  # -->
-  # Load `yaml` in to a Ruby data structure.  If multiple documents are provided,
-  # the object contained in the first document will be returned. `filename` will
-  # be used in the exception message if any exception is raised while parsing.  If
-  # `yaml` is empty, it returns the specified `fallback` return value, which
-  # defaults to `false`.
-  #
-  # Raises a Psych::SyntaxError when a YAML syntax error is detected.
-  #
-  # Example:
-  #
-  #     Psych.load("--- a")             # => 'a'
-  #     Psych.load("---\n - a\n - b")   # => ['a', 'b']
-  #
-  #     begin
-  #       Psych.load("--- `", filename: "file.txt")
-  #     rescue Psych::SyntaxError => ex
-  #       ex.file    # => 'file.txt'
-  #       ex.message # => "(file.txt): found character that cannot start any token"
-  #     end
-  #
-  # When the optional `symbolize_names` keyword argument is set to a true value,
-  # returns symbols for keys in Hash objects (default: strings).
-  #
-  #     Psych.load("---\n foo: bar")                         # => {"foo"=>"bar"}
-  #     Psych.load("---\n foo: bar", symbolize_names: true)  # => {:foo=>"bar"}
-  #
-  # Raises a TypeError when `yaml` parameter is NilClass.  This method is similar
-  # to `safe_load` except that `Symbol` objects are allowed by default.
-  #
-  %a{annotate:rdoc:copy:Psych.load}
-  def self.load: (String yaml, ?filename: String | _ToStr | _ToS?, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool) -> untyped
-
-  # <!--
-  #   rdoc-file=ext/psych/lib/psych.rb
-  #   - load_file(filename, **kwargs)
-  # -->
-  # Loads the document contained in `filename`.  Returns the yaml contained in
-  # `filename` as a Ruby object, or if the file is empty, it returns the specified
-  # `fallback` return value, which defaults to `false`. See load for options.
-  #
-  %a{annotate:rdoc:copy:Psych.load_file}
-  def self.load_file: (string | _ToPath, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool) -> untyped
-
-  # <!--
-  #   rdoc-file=ext/psych/lib/psych.rb
-  #   - safe_load(yaml, permitted_classes: [], permitted_symbols: [], aliases: false, filename: nil, fallback: nil, symbolize_names: false, freeze: false, strict_integer: false)
-  # -->
-  # Safely load the yaml string in `yaml`.  By default, only the following classes
-  # are allowed to be deserialized:
-  #
-  # *   TrueClass
-  # *   FalseClass
-  # *   NilClass
-  # *   Integer
-  # *   Float
-  # *   String
-  # *   Array
-  # *   Hash
-  #
-  #
-  # Recursive data structures are not allowed by default.  Arbitrary classes can
-  # be allowed by adding those classes to the `permitted_classes` keyword
-  # argument.  They are additive.  For example, to allow Date deserialization:
-  #
-  #     Psych.safe_load(yaml, permitted_classes: [Date])
-  #
-  # Now the Date class can be loaded in addition to the classes listed above.
-  #
-  # Aliases can be explicitly allowed by changing the `aliases` keyword argument.
-  # For example:
-  #
-  #     x = []
-  #     x << x
-  #     yaml = Psych.dump x
-  #     Psych.safe_load yaml               # => raises an exception
-  #     Psych.safe_load yaml, aliases: true # => loads the aliases
-  #
-  # A Psych::DisallowedClass exception will be raised if the yaml contains a class
-  # that isn't in the `permitted_classes` list.
-  #
-  # A Psych::AliasesNotEnabled exception will be raised if the yaml contains
-  # aliases but the `aliases` keyword argument is set to false.
-  #
-  # `filename` will be used in the exception message if any exception is raised
-  # while parsing.
-  #
-  # When the optional `symbolize_names` keyword argument is set to a true value,
-  # returns symbols for keys in Hash objects (default: strings).
-  #
-  #     Psych.safe_load("---\n foo: bar")                         # => {"foo"=>"bar"}
-  #     Psych.safe_load("---\n foo: bar", symbolize_names: true)  # => {:foo=>"bar"}
-  #
-  %a{annotate:rdoc:copy:Psych.safe_load}
-  def self.safe_load: (String yaml, ?permitted_classes: Array[Class], ?permitted_symbols: Array[Symbol], ?aliases: bool, ?filename: String | _ToStr | _ToS?, ?fallback: untyped, ?symbolize_names: bool, ?freeze: bool) -> untyped
-end
+module YAML = Psych

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: rbs
 version: !ruby/object:Gem::Version
-  version: 3.2.2
+  version: 3.3.0.pre.1
 platform: ruby
 authors:
 - Soutaro Matsumoto
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-09-28 00:00:00.000000000 Z
-dependencies: []
+date: 2023-10-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: abbrev
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: RBS is the language for type signatures for Ruby and standard library
   definitions.
 email:
@@ -117,6 +131,7 @@ files:
 - core/warning.rbs
 - docs/CONTRIBUTING.md
 - docs/collection.md
+- docs/data_and_struct.md
 - docs/rbs_by_example.md
 - docs/repo.md
 - docs/sigs.md
@@ -159,6 +174,8 @@ files:
 - lib/rbs/buffer.rb
 - lib/rbs/builtin_names.rb
 - lib/rbs/cli.rb
+- lib/rbs/cli/colored_io.rb
+- lib/rbs/cli/diff.rb
 - lib/rbs/collection.rb
 - lib/rbs/collection/cleaner.rb
 - lib/rbs/collection/config.rb
@@ -176,6 +193,7 @@ files:
 - lib/rbs/definition_builder.rb
 - lib/rbs/definition_builder/ancestor_builder.rb
 - lib/rbs/definition_builder/method_builder.rb
+- lib/rbs/diff.rb
 - lib/rbs/environment.rb
 - lib/rbs/environment/use_map.rb
 - lib/rbs/environment_loader.rb
@@ -197,6 +215,8 @@ files:
 - lib/rbs/prototype/rb.rb
 - lib/rbs/prototype/rbi.rb
 - lib/rbs/prototype/runtime.rb
+- lib/rbs/prototype/runtime/helpers.rb
+- lib/rbs/prototype/runtime/value_object_generator.rb
 - lib/rbs/repository.rb
 - lib/rbs/resolver/constant_resolver.rb
 - lib/rbs/resolver/type_name_resolver.rb
@@ -205,6 +225,7 @@ files:
 - lib/rbs/subtractor.rb
 - lib/rbs/test.rb
 - lib/rbs/test/errors.rb
+- lib/rbs/test/guaranteed.rb
 - lib/rbs/test/hook.rb
 - lib/rbs/test/observer.rb
 - lib/rbs/test/setup.rb
@@ -243,6 +264,8 @@ files:
 - sig/buffer.rbs
 - sig/builtin_names.rbs
 - sig/cli.rbs
+- sig/cli/colored_io.rbs
+- sig/cli/diff.rbs
 - sig/collection.rbs
 - sig/collection/cleaner.rbs
 - sig/collection/config.rbs
@@ -255,6 +278,7 @@ files:
 - sig/declarations.rbs
 - sig/definition.rbs
 - sig/definition_builder.rbs
+- sig/diff.rbs
 - sig/directives.rbs
 - sig/environment.rbs
 - sig/environment_loader.rbs
@@ -274,16 +298,15 @@ files:
 - sig/prototype/node_usage.rbs
 - sig/prototype/rb.rbs
 - sig/prototype/rbi.rbs
+- sig/prototype/runtime.rbs
 - sig/rbs.rbs
 - sig/rdoc/rbs.rbs
 - sig/repository.rbs
 - sig/resolver/constant_resolver.rbs
 - sig/resolver/context.rbs
 - sig/resolver/type_name_resolver.rbs
-- sig/shims.rbs
 - sig/shims/bundler.rbs
 - sig/shims/enumerable.rbs
-- sig/shims/pp.rbs
 - sig/shims/rubygems.rbs
 - sig/sorter.rbs
 - sig/substitution.rbs
@@ -372,6 +395,8 @@ files:
 - stdlib/mutex_m/0/mutex_m.rbs
 - stdlib/net-http/0/manifest.yaml
 - stdlib/net-http/0/net-http.rbs
+- stdlib/net-protocol/0/manifest.yaml
+- stdlib/net-protocol/0/net-protocol.rbs
 - stdlib/nkf/0/nkf.rbs
 - stdlib/objspace/0/objspace.rbs
 - stdlib/observable/0/observable.rbs
@@ -379,10 +404,24 @@ files:
 - stdlib/openssl/0/openssl.rbs
 - stdlib/optparse/0/optparse.rbs
 - stdlib/pathname/0/pathname.rbs
+- stdlib/pp/0/manifest.yaml
+- stdlib/pp/0/pp.rbs
 - stdlib/prettyprint/0/prettyprint.rbs
 - stdlib/pstore/0/pstore.rbs
+- stdlib/psych/0/dbm.rbs
+- stdlib/psych/0/manifest.yaml
+- stdlib/psych/0/psych.rbs
+- stdlib/psych/0/store.rbs
 - stdlib/pty/0/pty.rbs
+- stdlib/rdoc/0/code_object.rbs
+- stdlib/rdoc/0/comment.rbs
+- stdlib/rdoc/0/context.rbs
+- stdlib/rdoc/0/markup.rbs
+- stdlib/rdoc/0/parser.rbs
 - stdlib/rdoc/0/rdoc.rbs
+- stdlib/rdoc/0/ri.rbs
+- stdlib/rdoc/0/store.rbs
+- stdlib/rdoc/0/top_level.rbs
 - stdlib/resolv/0/manifest.yaml
 - stdlib/resolv/0/resolv.rbs
 - stdlib/ripper/0/ripper.rbs
@@ -421,9 +460,7 @@ files:
 - stdlib/uri/0/rfc3986_parser.rbs
 - stdlib/uri/0/ws.rbs
 - stdlib/uri/0/wss.rbs
-- stdlib/yaml/0/dbm.rbs
 - stdlib/yaml/0/manifest.yaml
-- stdlib/yaml/0/store.rbs
 - stdlib/yaml/0/yaml.rbs
 - stdlib/zlib/0/buf_error.rbs
 - stdlib/zlib/0/data_error.rbs
@@ -463,9 +500,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.4.10
 signing_key:

data/sig/shims/pp.rbs

@@ -1,3 +0,0 @@
-class PP
-  def self.pp: (untyped obj, IO out, ?Integer width) -> void
-end

data/sig/shims.rbs

@@ -1,47 +0,0 @@
-module RDoc
-  class Store
-    def initialize: (?String? path, ?Symbol? type) -> void
-
-    def find_class_or_module: (String) -> ClassModule?
-
-    def load_all: () -> void
-  end
-
-  module RI
-    module Paths
-      type path_type = :system | :site | :home | :gem | :extra
-
-      type gem_filter = :latest | :all
-
-      def self.each: (?bool system, ?bool site, ?bool home, ?gem_filter | false gems, *String extra_dirs) { (String, path_type) -> void } -> void
-    end
-  end
-
-  class Context < CodeObject
-
-  end
-
-  class ClassModule < Context
-    def constants: () -> Array[Constant]
-
-    def method_list: () -> Array[AnyMethod]
-
-    def attributes: () -> Array[Attr]
-  end
-
-  class Markup
-    class Document
-      include Enumerable[Document]
-
-      def each: () { (Document) -> void } -> void
-              | () -> Enumerator[Document, void]
-
-      def file: () -> String?
-
-      def accept: (untyped) -> String
-    end
-
-    class ToMarkdown
-    end
-  end
-end