rbs 2.8.4 → 3.8.1

data/stdlib/cgi/0/core.rbs

@@ -91,8 +91,10 @@
 #
 # #local_path()
 # :   the path of the uploaded file on the local filesystem
+#
 # #original_filename()
 # :   the name of the file on the client computer
+#
 # #content_type()
 # :   the content type of the file
 #
@@ -285,6 +287,7 @@ class CGI
   #     :tag_maker => tag_maker }` Note that it is recommended to use the
   #     `options_hash` form, since it also allows you specify the charset you will
   #     accept.
+  #
   # `options_hash`
   # :   A Hash that recognizes three options:
   #
@@ -303,6 +306,7 @@ class CGI
   #
   #             cgi=CGI.new(:accept_charset => "EUC-JP") # => "EUC-JP"
   #
+  #
   #     `:tag_maker`
   # :       String that specifies which version of the HTML generation methods to
   #         use.  If not specified, no HTML generation methods will be loaded.
@@ -311,16 +315,21 @@ class CGI
   #
   #         "html3"
   # :           HTML 3.x
+  #
   #         "html4"
   # :           HTML 4.0
+  #
   #         "html4Tr"
   # :           HTML 4.0 Transitional
+  #
   #         "html4Fr"
   # :           HTML 4.0 with Framesets
+  #
   #         "html5"
   # :           HTML 5
   #
   #
+  #
   #     `:max_multipart_length`
   # :       Specifies maximum length of multipart data. Can be an Integer scalar
   #         or a lambda, that will be evaluated when the request is parsed. This
@@ -334,6 +343,7 @@ class CGI
   #             cgi=CGI.new(:max_multipart_length => -> {check_filesystem}) # lambda
   #
   #
+  #
   # `block`
   # :   If provided, the block is called when an invalid encoding is encountered.
   #     For example:
@@ -360,7 +370,7 @@ class CGI
   # -->
   # Return the accept character set for all new CGI instances.
   #
-  def self.accept_charset: () -> String
+  def self.accept_charset: () -> encoding
 
   # <!--
   #   rdoc-file=lib/cgi/core.rb
@@ -368,7 +378,7 @@ class CGI
   # -->
   # Set the accept character set for all new CGI instances.
   #
-  def self.accept_charset=: (String accept_charset) -> String
+  def self.accept_charset=: (encoding accept_charset) -> encoding
 
   # <!--
   #   rdoc-file=lib/cgi/core.rb
@@ -382,12 +392,10 @@ class CGI
   #
   def self.parse: (String query) -> Hash[String, Array[String]]
 
-  public
-
   # <!-- rdoc-file=lib/cgi/core.rb -->
   # Return the accept character set for this CGI instance.
   #
-  attr_reader accept_charset: String
+  attr_reader accept_charset: encoding
 
   # <!-- rdoc-file=lib/cgi/core.rb -->
   # This method is an alias for #http_header, when HTML5 tag maker is inactive.
@@ -410,72 +418,99 @@ class CGI
   #
   # `content_type_string`
   # :   If this form is used, this string is the `Content-Type`
+  #
   # `headers_hash`
   # :   A Hash of header values. The following header keys are recognized:
   #
   #     type
   # :       The Content-Type header.  Defaults to "text/html"
+  #
   #     charset
   # :       The charset of the body, appended to the Content-Type header.
+  #
   #     nph
   # :       A boolean value.  If true, prepend protocol string and status code,
   #         and date; and sets default values for "server" and "connection" if not
   #         explicitly set.
+  #
   #     status
   # :       The HTTP status code as a String, returned as the Status header.  The
   #         values are:
   #
   #         OK
   # :           200 OK
+  #
   #         PARTIAL_CONTENT
   # :           206 Partial Content
+  #
   #         MULTIPLE_CHOICES
   # :           300 Multiple Choices
+  #
   #         MOVED
   # :           301 Moved Permanently
+  #
   #         REDIRECT
   # :           302 Found
+  #
   #         NOT_MODIFIED
   # :           304 Not Modified
+  #
   #         BAD_REQUEST
   # :           400 Bad Request
+  #
   #         AUTH_REQUIRED
   # :           401 Authorization Required
+  #
   #         FORBIDDEN
   # :           403 Forbidden
+  #
   #         NOT_FOUND
   # :           404 Not Found
+  #
   #         METHOD_NOT_ALLOWED
   # :           405 Method Not Allowed
+  #
   #         NOT_ACCEPTABLE
   # :           406 Not Acceptable
+  #
   #         LENGTH_REQUIRED
   # :           411 Length Required
+  #
   #         PRECONDITION_FAILED
   # :           412 Precondition Failed
+  #
   #         SERVER_ERROR
   # :           500 Internal Server Error
+  #
   #         NOT_IMPLEMENTED
   # :           501 Method Not Implemented
+  #
   #         BAD_GATEWAY
   # :           502 Bad Gateway
+  #
   #         VARIANT_ALSO_VARIES
   # :           506 Variant Also Negotiates
   #
   #
+  #
   #     server
   # :       The server software, returned as the Server header.
+  #
   #     connection
   # :       The connection type, returned as the Connection header (for instance,
   #         "close".
+  #
   #     length
   # :       The length of the content that will be sent, returned as the
   #         Content-Length header.
+  #
   #     language
   # :       The language of the content, returned as the Content-Language header.
+  #
   #     expires
   # :       The time on which the current content expires, as a `Time` object,
   #         returned as the Expires header.
+  #
   #     cookie
   # :       A cookie or cookies, returned as one or more Set-Cookie headers.  The
   #         value can be the literal string of the cookie; a CGI::Cookie object;
@@ -515,7 +550,7 @@ class CGI
   # This method does not perform charset conversion.
   #
   def http_header: (?String options) -> String
-                 | (?Hash[String | Symbol, untyped] header_hash) -> String
+                 | (?Hash[interned, untyped] header_hash) -> String
 
   def nph?: () -> untyped
 
@@ -528,8 +563,10 @@ class CGI
   #
   # `content_type_string`
   # :   If a string is passed, it is assumed to be the content type.
+  #
   # `headers_hash`
   # :   This is a Hash of headers, similar to that used by #http_header.
+  #
   # `block`
   # :   A block is required and should evaluate to the body of the response.
   #
@@ -586,7 +623,7 @@ class CGI
   #        # string
   #
   def out: (?String content_type_string) { () -> String } -> void
-         | (Hash[String | Symbol, untyped] headers_hash) { () -> String } -> void
+         | (Hash[interned, untyped] headers_hash) { () -> String } -> void
 
   # <!--
   #   rdoc-file=lib/cgi/core.rb
@@ -706,8 +743,6 @@ class CGI
     #
     def self.parse: (String raw_cookie) -> Hash[String, instance]
 
-    public
-
     # <!-- rdoc-file=lib/cgi/cookie.rb -->
     # Domain for which this cookie applies, as a `String`
     #
@@ -833,25 +868,33 @@ class CGI
     # :   The name of the cookie; in this form, there is no #domain or #expiration.
     #     The #path is gleaned from the `SCRIPT_NAME` environment variable, and
     #     #secure is false.
+    #
     # `*value`
     # :   value or list of values of the cookie
+    #
     # `options_hash`
     # :   A Hash of options to initialize this Cookie.  Possible options are:
     #
     #     name
     # :       the name of the cookie.  Required.
+    #
     #     value
     # :       the cookie's value or list of values.
+    #
     #     path
     # :       the path for which this cookie applies.  Defaults to the value of the
     #         `SCRIPT_NAME` environment variable.
+    #
     #     domain
     # :       the domain for which this cookie applies.
+    #
     #     expires
     # :       the time at which this cookie expires, as a `Time` object.
+    #
     #     secure
     # :       whether this cookie is a secure cookie or not (default to false).
     #         Secure cookies are only transmitted to HTTPS servers.
+    #
     #     httponly
     # :       whether this cookie is a HttpOnly cookie or not (default to
     #
@@ -864,8 +907,6 @@ class CGI
   end
 
   module Escape
-    public
-
     # <!--
     #   rdoc-file=ext/cgi/escape/escape.c
     #   - CGI.escape(string) -> string
@@ -882,6 +923,14 @@ class CGI
     #
     def escapeHTML: (string str) -> String
 
+    # <!--
+    #   rdoc-file=ext/cgi/escape/escape.c
+    #   - CGI.escapeURIComponent(string) -> string
+    # -->
+    # Returns URL-escaped string following RFC 3986.
+    #
+    def escapeURIComponent: (string) -> String
+
     # <!--
     #   rdoc-file=ext/cgi/escape/escape.c
     #   - CGI.unescape(string, encoding=@@accept_charset) -> string
@@ -897,6 +946,14 @@ class CGI
     # Returns HTML-unescaped string.
     #
     def unescapeHTML: (string str) -> String
+
+    # <!--
+    #   rdoc-file=ext/cgi/escape/escape.c
+    #   - CGI.unescapeURIComponent(string, encoding=@@accept_charset) -> string
+    # -->
+    # Returns URL-unescaped string following RFC 3986.
+    #
+    def unescapeURIComponent: (string) -> String
   end
 
   # <!-- rdoc-file=lib/cgi/core.rb -->
@@ -924,8 +981,6 @@ class CGI
   #     mode.
   #
   module QueryExtension
-    public
-
     # <!--
     #   rdoc-file=lib/cgi/core.rb
     #   - [](key)
@@ -1119,8 +1174,6 @@ class CGI
   module Util
     include CGI::Escape
 
-    public
-
     # <!--
     #   rdoc-file=lib/cgi/util.rb
     #   - escapeElement(string, *elements)

data/stdlib/cgi/0/manifest.yaml

@@ -1,2 +1,3 @@
 dependencies:
   - name: tempfile
+  - name: stringio

data/stdlib/coverage/0/coverage.rbs

@@ -3,7 +3,7 @@
 # experimental, so these APIs may be changed in future.
 #
 # Caveat: Currently, only process-global coverage measurement is supported. You
-# cannot measure per-thread covearge.
+# cannot measure per-thread coverage.
 #
 # # Usage
 #
@@ -15,7 +15,6 @@
 #     of line execution by the interpreter. A `nil` value means coverage is
 #     disabled for this line (lines like `else` and `end`).
 #
-#
 # # Examples
 #
 #     [foo.rb]
@@ -95,7 +94,6 @@
 # 5.  The ending line number it appears on in the file.
 # 6.  The ending column number it appears on in the file.
 #
-#
 # ## Methods Coverage
 #
 # Methods coverage reports how many times each method was executed.
@@ -134,7 +132,6 @@
 # 5.  The ending line number the method appears on in the file.
 # 6.  The ending column number the method appears on in the file.
 #
-#
 # ## All Coverage Modes
 #
 # You can also run all modes of coverage simultaneously with this shortcut. Note
@@ -153,7 +150,7 @@ module Coverage
   #   - line_stub(file)
   # -->
   #
-  def self.line_stub: () -> Array[Integer?]
+  def self.line_stub: (String) -> Array[Integer?]
 
   # <!--
   #   rdoc-file=ext/coverage/coverage.c
@@ -190,15 +187,41 @@ module Coverage
 
   # <!--
   #   rdoc-file=ext/coverage/coverage.c
-  #   - Coverage.start                                              => nil
-  #   - Coverage.start(:all)                                        => nil
-  #   - Coverage.start(lines: bool, branches: bool, methods: bool)  => nil
-  #   - Coverage.start(oneshot_lines: true)                         => nil
+  #   - Coverage.setup                                                          => nil
+  #   - Coverage.setup(:all)                                                    => nil
+  #   - Coverage.setup(lines: bool, branches: bool, methods: bool, eval: bool)  => nil
+  #   - Coverage.setup(oneshot_lines: true)                                     => nil
+  # -->
+  # Set up the coverage measurement.
+  #
+  # Note that this method does not start the measurement itself. Use
+  # Coverage.resume to start the measurement.
+  #
+  # You may want to use Coverage.start to setup and then start the measurement.
+  #
+  def self.setup: (?lines: bool, ?branches: bool, ?methods: bool, ?eval: bool) -> nil
+                | (oneshot_lines: bool, ?branches: bool, ?methods: bool, ?eval: bool) -> nil
+                | (:all) -> nil
+
+  # <!--
+  #   rdoc-file=ext/coverage/coverage.c
+  #   - Coverage.start                                                          => nil
+  #   - Coverage.start(:all)                                                    => nil
+  #   - Coverage.start(lines: bool, branches: bool, methods: bool, eval: bool)  => nil
+  #   - Coverage.start(oneshot_lines: true)                                     => nil
   # -->
   # Enables the coverage measurement. See the documentation of Coverage class in
   # detail. This is equivalent to Coverage.setup and Coverage.resume.
   #
-  def self.start: (?lines: boolish, ?branches: boolish, ?methods: boolish, ?oneshot_lines: boolish) -> nil
+  alias self.start self.setup
+
+  # <!--
+  #   rdoc-file=ext/coverage/coverage.c
+  #   - Coverage.state  => :idle, :suspended, :running
+  # -->
+  # Returns the state of the coverage measurement.
+  #
+  def self.state: () -> (:idle | :suspended | :running)
 
   # <!--
   #   rdoc-file=ext/coverage/coverage.c
@@ -207,12 +230,28 @@ module Coverage
   # Start/resume the coverage measurement.
   #
   # Caveat: Currently, only process-global coverage measurement is supported. You
-  # cannot measure per-thread covearge. If your process has multiple thread, using
+  # cannot measure per-thread coverage. If your process has multiple thread, using
   # Coverage.resume/suspend to capture code coverage executed from only a limited
   # code block, may yield misleading results.
   #
   def self.resume: () -> nil
 
+  # <!--
+  #   rdoc-file=ext/coverage/coverage.c
+  #   - Coverage.supported?(mode) -> true or false
+  # -->
+  # Returns true if coverage measurement is supported for the given mode.
+  #
+  # The mode should be one of the following symbols: `:lines`, `:oneshot_lines`,
+  # `:branches`, `:methods`, `:eval`.
+  #
+  # Example:
+  #
+  #     Coverage.supported?(:lines)  #=> true
+  #     Coverage.supported?(:all)    #=> false
+  #
+  def self.supported?: (Symbol) -> bool
+
   # <!--
   #   rdoc-file=ext/coverage/coverage.c
   #   - Coverage.suspend  => nil