rbs 3.0.0.dev.2 → 3.0.0.dev.3

data/stdlib/socket/0/addrinfo.rbs

@@ -403,7 +403,7 @@ class Addrinfo
   #   rdoc-file=ext/socket/raddrinfo.c
   #   - ipv6_linklocal?()
   # -->
-  # Returns true for IPv6 link local address (ff80::/10). It returns false
+  # Returns true for IPv6 link local address (fe80::/10). It returns false
   # otherwise.
   #
   def ipv6_linklocal?: () -> bool
@@ -474,7 +474,7 @@ class Addrinfo
   #   rdoc-file=ext/socket/raddrinfo.c
   #   - ipv6_sitelocal?()
   # -->
-  # Returns true for IPv6 site local address (ffc0::/10). It returns false
+  # Returns true for IPv6 site local address (fec0::/10). It returns false
   # otherwise.
   #
   def ipv6_sitelocal?: () -> bool
@@ -632,19 +632,13 @@ class Addrinfo
   # sockaddr as generated by Socket.sockaddr_in or Socket.unpack_sockaddr_un.
   #
   # sockaddr examples:
-  #
-  #     "AF_INET", 46102, "localhost.localdomain", "127.0.0.1"
-  # :
-  #
-  #     "AF_INET6", 42304, "ip6-localhost", "::1"
-  # :
-  #
-  #     "AF_UNIX", "/tmp/sock"
-  # :
-  # *   Socket.sockaddr_in("smtp", "2001:DB8::1")
-  # *   Socket.sockaddr_in(80, "172.18.22.42")
-  # *   Socket.sockaddr_in(80, "www.ruby-lang.org")
-  # *   Socket.sockaddr_un("/tmp/sock")
+  # *   `["AF_INET", 46102, "localhost.localdomain", "127.0.0.1"]`
+  # *   `["AF_INET6", 42304, "ip6-localhost", "::1"]`
+  # *   `["AF_UNIX", "/tmp/sock"]`
+  # *   `Socket.sockaddr_in("smtp", "2001:DB8::1")`
+  # *   `Socket.sockaddr_in(80, "172.18.22.42")`
+  # *   `Socket.sockaddr_in(80, "www.ruby-lang.org")`
+  # *   `Socket.sockaddr_un("/tmp/sock")`
   #
   #
   # In an AF_INET/AF_INET6 sockaddr array, the 4th element, numeric IP address, is

data/stdlib/socket/0/socket.rbs

@@ -469,8 +469,6 @@ class Socket < BasicSocket
   #
   # :connect_timeout
   # :   specify the timeout in seconds.
-  # :resolv_timeout
-  # :   specify the name resolution timeout in seconds.
   #
   #
   # If a block is given, the block is called with the socket. The value of the
@@ -1416,7 +1414,7 @@ class Socket < BasicSocket
   #     Socket.new(:UNIX, :STREAM) # UNIX stream socket
   #     Socket.new(:UNIX, :DGRAM)  # UNIX datagram socket
   #
-  def initialize: (Symbol domain, Symbol socktype, ?Integer protocol) -> untyped
+  def initialize: (Symbol | Integer domain, Symbol | Integer socktype, ?Integer protocol) -> untyped
 end
 
 # <!-- rdoc-file=ext/socket/constdefs.c -->
@@ -3346,6 +3344,16 @@ Socket::SO_ERROR: Integer
 #
 Socket::SO_GET_FILTER: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Receive the cpu attached to the socket (Linux 3.19)
+#
+Socket::SO_INCOMING_CPU: Integer
+
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Receive the napi ID attached to a RX queue (Linux 4.12)
+#
+Socket::SO_INCOMING_NAPI_ID: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # Keep connections alive
 #
@@ -3481,6 +3489,11 @@ Socket::SO_REUSEADDR: Integer
 #
 Socket::SO_REUSEPORT: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Set the routing table for this socket (OpenBSD)
+#
+Socket::SO_RTABLE: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # Toggle cmsg for number of packets dropped (Linux 2.6.33)
 #
@@ -3494,6 +3507,11 @@ Socket::SO_SECURITY_ENCRYPTION_TRANSPORT: Integer
 #
 Socket::SO_SELECT_ERR_QUEUE: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Set the associated routing table for the socket (FreeBSD)
+#
+Socket::SO_SETFIB: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # Send buffer size
 #
@@ -3539,6 +3557,11 @@ Socket::SO_TYPE: Integer
 #
 Socket::SO_USELOOPBACK: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Setting an identifier for ipfw purpose mainly
+#
+Socket::SO_USER_COOKIE: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # Give a hint when more data is ready
 #
@@ -3554,6 +3577,11 @@ Socket::SO_WANTOOBFLAG: Integer
 #
 Socket::SO_WIFI_STATUS: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Retrieve information about this socket (macOS)
+#
+Socket::TCP_CONNECTION_INFO: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # TCP congestion control algorithm (Linux 2.6.13, glibc 2.6)
 #
@@ -3584,6 +3612,11 @@ Socket::TCP_FASTOPEN: Integer
 #
 Socket::TCP_INFO: Integer
 
+# <!-- rdoc-file=ext/socket/constdefs.c -->
+# Idle time before keepalive probes are sent (macOS)
+#
+Socket::TCP_KEEPALIVE: Integer
+
 # <!-- rdoc-file=ext/socket/constdefs.c -->
 # Maximum number of keepalive probes allowed before dropping a connection (Linux
 # 2.4, glibc 2.2)

data/stdlib/strscan/0/string_scanner.rbs

@@ -2,6 +2,8 @@
 # StringScanner provides for lexical scanning operations on a String.  Here is
 # an example of its usage:
 #
+#     require 'strscan'
+#
 #     s = StringScanner.new('This is an example string')
 #     s.eos?               # -> false
 #
@@ -199,11 +201,11 @@ class StringScanner
   #
   # In short, it's a 0-based index into the string.
   #
-  #     s = StringScanner.new("abcädeföghi")
-  #     s.charpos           # -> 0
-  #     s.scan_until(/ä/)   # -> "abcä"
-  #     s.pos               # -> 5
-  #     s.charpos           # -> 4
+  #     s = StringScanner.new("abc\u00e4def\u00f6ghi")
+  #     s.charpos                # -> 0
+  #     s.scan_until(/\u00e4/)   # -> "abc\u00E4"
+  #     s.pos                    # -> 5
+  #     s.charpos                # -> 4
   #
   def charpos: () -> Integer
 

data/stdlib/tempfile/0/tempfile.rbs

@@ -82,24 +82,65 @@ class Tempfile < File
   #   rdoc-file=lib/tempfile.rb
   #   - create(basename="", tmpdir=nil, mode: 0, **options) { |tmpfile| ... }
   # -->
-  # Creates a temporary file as a usual File object (not a Tempfile). It does not
-  # use finalizer and delegation, which makes it more efficient and reliable.
+  # Creates a file in the underlying file system; returns a new File object based
+  # on that file.
   #
-  # If no block is given, this is similar to Tempfile.new except creating File
-  # instead of Tempfile. In that case, the created file is not removed
-  # automatically. You should use File.unlink to remove it.
+  # With no block given and no arguments, creates and returns file whose:
   #
-  # If a block is given, then a File object will be constructed, and the block is
-  # invoked with the object as the argument. The File object will be automatically
-  # closed and the temporary file is removed after the block terminates, releasing
-  # all resources that the block created. The call returns the value of the block.
+  # *   Class is [File](rdoc-ref:File) (not Tempfile).
+  # *   Directory is the system temporary directory (system-dependent).
+  # *   Generated filename is unique in that directory.
+  # *   Permissions are `0600`; see [File
+  #     Permissions](rdoc-ref:File@File+Permissions).
+  # *   Mode is `'w+'` (read/write mode, positioned at the end).
   #
-  # In any case, all arguments (`basename`, `tmpdir`, `mode`, and `**options`)
-  # will be treated the same as for Tempfile.new.
   #
-  #     Tempfile.create('foo', '/home/temp') do |f|
-  #        # ... do something with f ...
-  #     end
+  # With no block, the file is not removed automatically, and so should be
+  # explicitly removed.
+  #
+  # Example:
+  #
+  #     f = Tempfile.create     # => #<File:/tmp/20220505-9795-17ky6f6>
+  #     f.class                 # => File
+  #     f.path                  # => "/tmp/20220505-9795-17ky6f6"
+  #     f.stat.mode.to_s(8)     # => "100600"
+  #     File.exist?(f.path)     # => true
+  #     File.unlink(f.path)
+  #     File.exist?(f.path)     # => false
+  #
+  # Argument `basename`, if given, may be one of:
+  #
+  # *   A string: the generated filename begins with `basename`:
+  #
+  #         Tempfile.create('foo') # => #<File:/tmp/foo20220505-9795-1gok8l9>
+  #
+  # *   An array of two strings `[prefix, suffix]`: the generated filename begins
+  #     with `prefix` and ends with `suffix`:
+  #
+  #         Tempfile.create(%w/foo .jpg/) # => #<File:/tmp/foo20220505-17839-tnjchh.jpg>
+  #
+  #
+  # With arguments `basename` and `tmpdir`, the file is created in directory
+  # `tmpdir`:
+  #
+  #     Tempfile.create('foo', '.') # => #<File:./foo20220505-9795-1emu6g8>
+  #
+  # Keyword arguments `mode` and `options` are passed directly to method
+  # [File.open](rdoc-ref:File.open):
+  #
+  # *   The value given with `mode` must be an integer, and may be expressed as
+  #     the logical OR of constants defined in
+  #     [File::Constants](rdoc-ref:File::Constants).
+  # *   For `options`, see [Open Options](rdoc-ref:IO@Open+Options).
+  #
+  #
+  # With a block given, creates the file as above, passes it to the block, and
+  # returns the block's value; before the return, the file object is closed and
+  # the underlying file is removed:
+  #
+  #     Tempfile.create {|file| file.path } # => "/tmp/20220505-9795-rkists"
+  #
+  # Related: Tempfile.new.
   #
   def self.create: (?String | [ String, String ] basename, ?String? tmpdir, ?mode: Integer, **untyped) -> File
                  | [A] (?String | [ String, String ] basename, ?String? tmpdir, ?mode: Integer, **untyped) { (File) -> A } -> A
@@ -268,48 +309,67 @@ class Tempfile < File
   #   rdoc-file=lib/tempfile.rb
   #   - new(basename="", tmpdir=nil, mode: 0, **options)
   # -->
-  # Creates a temporary file with permissions 0600 (= only readable and writable
-  # by the owner) and opens it with mode "w+".
+  # Creates a file in the underlying file system; returns a new Tempfile object
+  # based on that file.
+  #
+  # If possible, consider instead using Tempfile.create, which:
+  #
+  # *   Avoids the performance cost of delegation, incurred when Tempfile.new
+  #     calls its superclass `DelegateClass(File)`.
+  # *   Does not rely on a finalizer to close and unlink the file, which can be
+  #     unreliable.
+  #
+  #
+  # Creates and returns file whose:
+  #
+  # *   Class is Tempfile (not File, as in Tempfile.create).
+  # *   Directory is the system temporary directory (system-dependent).
+  # *   Generated filename is unique in that directory.
+  # *   Permissions are `0600`; see [File
+  #     Permissions](rdoc-ref:File@File+Permissions).
+  # *   Mode is `'w+'` (read/write mode, positioned at the end).
+  #
+  #
+  # The underlying file is removed when the Tempfile object dies and is reclaimed
+  # by the garbage collector.
+  #
+  # Example:
+  #
+  #     f = Tempfile.new # => #<Tempfile:/tmp/20220505-17839-1s0kt30>
+  #     f.class               # => Tempfile
+  #     f.path                # => "/tmp/20220505-17839-1s0kt30"
+  #     f.stat.mode.to_s(8)   # => "100600"
+  #     File.exist?(f.path)   # => true
+  #     File.unlink(f.path)   #
+  #     File.exist?(f.path)   # => false
   #
-  # It is recommended to use Tempfile.create { ... } instead when possible,
-  # because that method avoids the cost of delegation and does not rely on a
-  # finalizer to close and unlink the file, which is unreliable.
+  # Argument `basename`, if given, may be one of:
   #
-  # The `basename` parameter is used to determine the name of the temporary file.
-  # You can either pass a String or an Array with 2 String elements. In the former
-  # form, the temporary file's base name will begin with the given string. In the
-  # latter form, the temporary file's base name will begin with the array's first
-  # element, and end with the second element. For example:
+  # *   A string: the generated filename begins with `basename`:
   #
-  #     file = Tempfile.new('hello')
-  #     file.path  # => something like: "/tmp/hello2843-8392-92849382--0"
+  #         Tempfile.new('foo') # => #<Tempfile:/tmp/foo20220505-17839-1whk2f>
   #
-  #     # Use the Array form to enforce an extension in the filename:
-  #     file = Tempfile.new(['hello', '.jpg'])
-  #     file.path  # => something like: "/tmp/hello2843-8392-92849382--0.jpg"
+  # *   An array of two strings `[prefix, suffix]`: the generated filename begins
+  #     with `prefix` and ends with `suffix`:
   #
-  # The temporary file will be placed in the directory as specified by the
-  # `tmpdir` parameter. By default, this is `Dir.tmpdir`.
+  #         Tempfile.new(%w/foo .jpg/) # => #<Tempfile:/tmp/foo20220505-17839-58xtfi.jpg>
   #
-  #     file = Tempfile.new('hello', '/home/aisaka')
-  #     file.path  # => something like: "/home/aisaka/hello2843-8392-92849382--0"
   #
-  # You can also pass an options hash. Under the hood, Tempfile creates the
-  # temporary file using `File.open`. These options will be passed to `File.open`.
-  # This is mostly useful for specifying encoding options, e.g.:
+  # With arguments `basename` and `tmpdir`, the file is created in directory
+  # `tmpdir`:
   #
-  #     Tempfile.new('hello', '/home/aisaka', encoding: 'ascii-8bit')
+  #     Tempfile.new('foo', '.') # => #<Tempfile:./foo20220505-17839-xfstr8>
   #
-  #     # You can also omit the 'tmpdir' parameter:
-  #     Tempfile.new('hello', encoding: 'ascii-8bit')
+  # Keyword arguments `mode` and `options` are passed directly to method
+  # [File.open](rdoc-ref:File.open):
   #
-  # Note: `mode` keyword argument, as accepted by Tempfile, can only be numeric,
-  # combination of the modes defined in File::Constants.
+  # *   The value given with `mode` must be an integer, and may be expressed as
+  #     the logical OR of constants defined in
+  #     [File::Constants](rdoc-ref:File::Constants).
+  # *   For `options`, see [Open Options](rdoc-ref:IO@Open+Options).
   #
-  # ### Exceptions
   #
-  # If Tempfile.new cannot find a unique filename within a limited number of
-  # tries, then it will raise an exception.
+  # Related: Tempfile.create.
   #
   def self.new: (?String | [ String, String ] basename, ?String? tmpdir, ?mode: Integer, **untyped) -> instance
               | [A] (?String | [ String, String ] basename, ?String? tmpdir, ?mode: Integer, **untyped) { (instance) -> A } -> A

data/stdlib/time/0/time.rbs

@@ -398,8 +398,8 @@ class Time
   #
   # If self is a UTC time, Z is used as TZD.  [+-]hh:mm is used otherwise.
   #
-  # `fractional_digits` specifies a number of digits to use for fractional
-  # seconds.  Its default value is 0.
+  # `fraction_digits` specifies a number of digits to use for fractional seconds.
+  # Its default value is 0.
   #
   #     require 'time'
   #

data/stdlib/uri/0/file.rbs

@@ -30,6 +30,8 @@ module URI
     # If an Array is used, the components must be passed in the order `[host,
     # path]`.
     #
+    # A path from e.g. the File class should be escaped before being passed.
+    #
     # Examples:
     #
     #     require 'uri'
@@ -41,6 +43,9 @@ module URI
     #       :path => '/ruby/src'})
     #     uri2.to_s  # => "file://host.example.com/ruby/src"
     #
+    #     uri3 = URI::File.build({:path => URI::escape('/path/my file.txt')})
+    #     uri3.to_s  # => "file:///path/my%20file.txt"
+    #
     def self.build: (Array[String] args) -> URI::File
                   | ({ host: String?, path: String? }) -> URI::File
 

data/stdlib/uri/0/generic.rbs

@@ -510,7 +510,7 @@ module URI
     #   rdoc-file=lib/uri/generic.rb
     #   - user()
     # -->
-    # Returns the user component.
+    # Returns the user component (without URI decoding).
     #
     def user: () -> String?
 
@@ -518,7 +518,7 @@ module URI
     #   rdoc-file=lib/uri/generic.rb
     #   - password()
     # -->
-    # Returns the password component.
+    # Returns the password component (without URI decoding).
     #
     def password: () -> String?
 

data/stdlib/yaml/0/yaml.rbs

@@ -182,8 +182,8 @@ module YAML
   # A Psych::DisallowedClass exception will be raised if the yaml contains a class
   # that isn't in the `permitted_classes` list.
   #
-  # A Psych::BadAlias exception will be raised if the yaml contains aliases but
-  # the `aliases` keyword argument is set to false.
+  # 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.

data/stdlib/zlib/0/zlib.rbs

@@ -95,7 +95,7 @@ module Zlib
   #   rdoc-file=ext/zlib/zlib.c
   #   - Zlib.adler32_combine(adler1, adler2, len2)
   # -->
-  # Combine two Adler-32 check values in to one.  `alder1` is the first Adler-32
+  # Combine two Adler-32 check values in to one.  `adler1` is the first Adler-32
   # value, `adler2` is the second Adler-32 value.  `len2` is the length of the
   # string used to generate `adler2`.
   #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rbs
 version: !ruby/object:Gem::Version
-  version: 3.0.0.dev.2
+  version: 3.0.0.dev.3
 platform: ruby
 authors:
 - Soutaro Matsumoto
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-02-08 00:00:00.000000000 Z
+date: 2023-02-17 00:00:00.000000000 Z
 dependencies: []
 description: RBS is the language for type signatures for Ruby and standard library
   definitions.
@@ -41,11 +41,12 @@ files:
 - core/comparable.rbs
 - core/complex.rbs
 - core/constants.rbs
-- core/deprecated.rbs
+- core/data.rbs
 - core/dir.rbs
 - core/encoding.rbs
 - core/enumerable.rbs
 - core/enumerator.rbs
+- core/enumerator/product.rbs
 - core/env.rbs
 - core/errno.rbs
 - core/errors.rbs
@@ -101,6 +102,7 @@ files:
 - core/rubygems/stream_ui.rbs
 - core/rubygems/uninstaller.rbs
 - core/rubygems/version.rbs
+- core/set.rbs
 - core/signal.rbs
 - core/string.rbs
 - core/string_io.rbs
@@ -166,6 +168,7 @@ files:
 - lib/rbs/collection/sources.rb
 - lib/rbs/collection/sources/base.rb
 - lib/rbs/collection/sources/git.rb
+- lib/rbs/collection/sources/local.rb
 - lib/rbs/collection/sources/rubygems.rb
 - lib/rbs/collection/sources/stdlib.rb
 - lib/rbs/constant.rb
@@ -275,11 +278,10 @@ files:
 - sig/resolver/context.rbs
 - sig/resolver/type_name_resolver.rbs
 - sig/shims.rbs
-- sig/shims/abstract_syntax_tree.rbs
+- sig/shims/_abstract_syntax_tree.rbs
 - sig/shims/bundler.rbs
 - sig/shims/enumerable.rbs
 - sig/shims/pp.rbs
-- sig/shims/ripper.rbs
 - sig/shims/rubygems.rbs
 - sig/sorter.rbs
 - sig/substitution.rbs
@@ -382,8 +384,8 @@ files:
 - stdlib/rdoc/0/rdoc.rbs
 - stdlib/resolv/0/manifest.yaml
 - stdlib/resolv/0/resolv.rbs
+- stdlib/ripper/0/ripper.rbs
 - stdlib/securerandom/0/securerandom.rbs
-- stdlib/set/0/set.rbs
 - stdlib/shellwords/0/shellwords.rbs
 - stdlib/singleton/0/singleton.rbs
 - stdlib/socket/0/addrinfo.rbs

data/core/deprecated.rbs

@@ -1,9 +0,0 @@
-# <!-- rdoc-file=numeric.c -->
-# An obsolete class, use Integer
-#
-Fixnum: singleton(Integer)
-
-# <!-- rdoc-file=bignum.c -->
-# An obsolete class, use Integer
-#
-Bignum: singleton(Integer)

data/sig/shims/ripper.rbs

@@ -1,8 +0,0 @@
-class Ripper
-  def self.lex: (String src, ?String filename, ?Integer lineno, ?raise_errors: bool) -> Array[[[Integer, Integer], Symbol, String, Lexer::State]]
-
-  class Lexer
-    class State
-    end
-  end
-end