rbs 3.10.0 → 4.0.0.dev.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (202) hide show
  1. checksums.yaml +4 -4
  2. data/.github/workflows/comments.yml +3 -3
  3. data/.github/workflows/ruby.yml +24 -35
  4. data/.github/workflows/typecheck.yml +3 -1
  5. data/.github/workflows/windows.yml +2 -2
  6. data/.gitignore +0 -4
  7. data/CHANGELOG.md +0 -88
  8. data/README.md +1 -38
  9. data/Rakefile +20 -142
  10. data/Steepfile +1 -0
  11. data/config.yml +43 -1
  12. data/core/array.rbs +46 -100
  13. data/core/complex.rbs +21 -32
  14. data/core/dir.rbs +2 -2
  15. data/core/encoding.rbs +9 -6
  16. data/core/enumerable.rbs +3 -90
  17. data/core/enumerator.rbs +1 -18
  18. data/core/errno.rbs +0 -8
  19. data/core/errors.rbs +1 -28
  20. data/core/exception.rbs +2 -2
  21. data/core/fiber.rbs +4 -5
  22. data/core/file.rbs +12 -27
  23. data/core/file_test.rbs +1 -1
  24. data/core/float.rbs +22 -209
  25. data/core/gc.rbs +281 -417
  26. data/core/hash.rbs +727 -1024
  27. data/core/integer.rbs +38 -78
  28. data/core/io/buffer.rbs +7 -18
  29. data/core/io/wait.rbs +33 -11
  30. data/core/io.rbs +12 -14
  31. data/core/kernel.rbs +51 -57
  32. data/core/marshal.rbs +1 -1
  33. data/core/match_data.rbs +1 -1
  34. data/core/math.rbs +3 -42
  35. data/core/method.rbs +6 -14
  36. data/core/module.rbs +17 -88
  37. data/core/nil_class.rbs +3 -3
  38. data/core/numeric.rbs +16 -16
  39. data/core/object.rbs +3 -3
  40. data/core/object_space.rbs +15 -21
  41. data/core/proc.rbs +8 -15
  42. data/core/process.rbs +2 -2
  43. data/core/ractor.rbs +437 -278
  44. data/core/range.rbs +8 -7
  45. data/core/rational.rbs +24 -37
  46. data/core/rbs/unnamed/argf.rbs +2 -2
  47. data/core/rbs/unnamed/env_class.rbs +1 -1
  48. data/core/rbs/unnamed/random.rbs +2 -4
  49. data/core/regexp.rbs +20 -25
  50. data/core/ruby_vm.rbs +4 -6
  51. data/core/rubygems/errors.rbs +70 -3
  52. data/core/rubygems/rubygems.rbs +79 -11
  53. data/core/rubygems/version.rbs +3 -2
  54. data/core/set.rbs +359 -488
  55. data/core/string.rbs +1228 -3153
  56. data/core/struct.rbs +1 -1
  57. data/core/symbol.rbs +4 -4
  58. data/core/thread.rbs +29 -92
  59. data/core/time.rbs +9 -35
  60. data/core/trace_point.rbs +4 -7
  61. data/core/unbound_method.rbs +6 -14
  62. data/docs/collection.md +2 -2
  63. data/docs/gem.md +1 -0
  64. data/docs/sigs.md +3 -3
  65. data/ext/rbs_extension/ast_translation.c +1077 -944
  66. data/ext/rbs_extension/ast_translation.h +0 -7
  67. data/ext/rbs_extension/class_constants.c +83 -71
  68. data/ext/rbs_extension/class_constants.h +7 -4
  69. data/ext/rbs_extension/extconf.rb +2 -24
  70. data/ext/rbs_extension/legacy_location.c +172 -173
  71. data/ext/rbs_extension/legacy_location.h +3 -8
  72. data/ext/rbs_extension/main.c +289 -239
  73. data/ext/rbs_extension/rbs_extension.h +0 -3
  74. data/ext/rbs_extension/rbs_string_bridging.h +0 -4
  75. data/include/rbs/ast.h +98 -37
  76. data/include/rbs/defines.h +12 -38
  77. data/include/rbs/lexer.h +114 -126
  78. data/include/rbs/location.h +14 -14
  79. data/include/rbs/parser.h +37 -21
  80. data/include/rbs/string.h +5 -3
  81. data/include/rbs/util/rbs_allocator.h +19 -40
  82. data/include/rbs/util/rbs_assert.h +1 -12
  83. data/include/rbs/util/rbs_constant_pool.h +3 -3
  84. data/include/rbs/util/rbs_encoding.h +1 -3
  85. data/include/rbs/util/rbs_unescape.h +1 -2
  86. data/lib/rbs/ast/ruby/annotations.rb +119 -0
  87. data/lib/rbs/ast/ruby/comment_block.rb +221 -0
  88. data/lib/rbs/ast/ruby/declarations.rb +86 -0
  89. data/lib/rbs/ast/ruby/helpers/constant_helper.rb +24 -0
  90. data/lib/rbs/ast/ruby/helpers/location_helper.rb +15 -0
  91. data/lib/rbs/ast/ruby/members.rb +213 -0
  92. data/lib/rbs/buffer.rb +104 -24
  93. data/lib/rbs/cli/validate.rb +40 -35
  94. data/lib/rbs/cli.rb +5 -6
  95. data/lib/rbs/collection/config/lockfile_generator.rb +0 -1
  96. data/lib/rbs/collection.rb +0 -1
  97. data/lib/rbs/definition.rb +6 -1
  98. data/lib/rbs/definition_builder/ancestor_builder.rb +65 -62
  99. data/lib/rbs/definition_builder/method_builder.rb +45 -30
  100. data/lib/rbs/definition_builder.rb +44 -9
  101. data/lib/rbs/environment/class_entry.rb +69 -0
  102. data/lib/rbs/environment/module_entry.rb +66 -0
  103. data/lib/rbs/environment.rb +244 -218
  104. data/lib/rbs/environment_loader.rb +3 -3
  105. data/lib/rbs/errors.rb +5 -4
  106. data/lib/rbs/inline_parser/comment_association.rb +117 -0
  107. data/lib/rbs/inline_parser.rb +206 -0
  108. data/lib/rbs/location_aux.rb +35 -3
  109. data/lib/rbs/parser_aux.rb +11 -6
  110. data/lib/rbs/prototype/runtime.rb +2 -2
  111. data/lib/rbs/resolver/constant_resolver.rb +2 -2
  112. data/lib/rbs/resolver/type_name_resolver.rb +38 -124
  113. data/lib/rbs/source.rb +99 -0
  114. data/lib/rbs/subtractor.rb +4 -3
  115. data/lib/rbs/test/type_check.rb +0 -14
  116. data/lib/rbs/types.rb +1 -3
  117. data/lib/rbs/version.rb +1 -1
  118. data/lib/rbs.rb +13 -1
  119. data/lib/rdoc/discover.rb +1 -1
  120. data/lib/rdoc_plugin/parser.rb +1 -1
  121. data/rbs.gemspec +1 -0
  122. data/sig/ancestor_builder.rbs +1 -1
  123. data/sig/ast/ruby/annotations.rbs +110 -0
  124. data/sig/ast/ruby/comment_block.rbs +119 -0
  125. data/sig/ast/ruby/declarations.rbs +60 -0
  126. data/sig/ast/ruby/helpers/constant_helper.rbs +11 -0
  127. data/sig/ast/ruby/helpers/location_helper.rbs +15 -0
  128. data/sig/ast/ruby/members.rbs +72 -0
  129. data/sig/buffer.rbs +63 -5
  130. data/sig/definition.rbs +1 -0
  131. data/sig/definition_builder.rbs +1 -1
  132. data/sig/environment/class_entry.rbs +50 -0
  133. data/sig/environment/module_entry.rbs +50 -0
  134. data/sig/environment.rbs +28 -133
  135. data/sig/errors.rbs +13 -6
  136. data/sig/inline_parser/comment_association.rbs +71 -0
  137. data/sig/inline_parser.rbs +87 -0
  138. data/sig/location.rbs +32 -7
  139. data/sig/manifest.yaml +1 -0
  140. data/sig/method_builder.rbs +7 -4
  141. data/sig/parser.rbs +16 -20
  142. data/sig/resolver/type_name_resolver.rbs +7 -38
  143. data/sig/source.rbs +48 -0
  144. data/sig/types.rbs +1 -4
  145. data/src/ast.c +290 -201
  146. data/src/lexer.c +2813 -2902
  147. data/src/lexer.re +4 -0
  148. data/src/lexstate.c +155 -169
  149. data/src/location.c +40 -40
  150. data/src/parser.c +2665 -2433
  151. data/src/string.c +48 -0
  152. data/src/util/rbs_allocator.c +77 -80
  153. data/src/util/rbs_assert.c +10 -10
  154. data/src/util/rbs_buffer.c +2 -2
  155. data/src/util/rbs_constant_pool.c +15 -13
  156. data/src/util/rbs_encoding.c +4062 -20097
  157. data/src/util/rbs_unescape.c +48 -85
  158. data/stdlib/bigdecimal/0/big_decimal.rbs +82 -100
  159. data/stdlib/bigdecimal-math/0/big_math.rbs +8 -169
  160. data/stdlib/cgi/0/core.rbs +396 -2
  161. data/stdlib/cgi/0/manifest.yaml +0 -1
  162. data/stdlib/coverage/0/coverage.rbs +1 -3
  163. data/stdlib/date/0/date.rbs +59 -67
  164. data/stdlib/date/0/date_time.rbs +1 -1
  165. data/stdlib/delegate/0/delegator.rbs +7 -10
  166. data/stdlib/erb/0/erb.rbs +347 -737
  167. data/stdlib/fileutils/0/fileutils.rbs +13 -18
  168. data/stdlib/forwardable/0/forwardable.rbs +0 -3
  169. data/stdlib/json/0/json.rbs +48 -68
  170. data/stdlib/net-http/0/net-http.rbs +0 -3
  171. data/stdlib/objspace/0/objspace.rbs +4 -9
  172. data/stdlib/open-uri/0/open-uri.rbs +0 -40
  173. data/stdlib/openssl/0/openssl.rbs +228 -331
  174. data/stdlib/optparse/0/optparse.rbs +3 -3
  175. data/{core → stdlib/pathname/0}/pathname.rbs +355 -255
  176. data/stdlib/psych/0/psych.rbs +3 -3
  177. data/stdlib/rdoc/0/rdoc.rbs +1 -1
  178. data/stdlib/resolv/0/resolv.rbs +68 -25
  179. data/stdlib/ripper/0/ripper.rbs +2 -5
  180. data/stdlib/singleton/0/singleton.rbs +0 -3
  181. data/stdlib/socket/0/socket.rbs +1 -13
  182. data/stdlib/socket/0/tcp_socket.rbs +2 -10
  183. data/stdlib/stringio/0/stringio.rbs +85 -1176
  184. data/stdlib/strscan/0/string_scanner.rbs +31 -31
  185. data/stdlib/tempfile/0/tempfile.rbs +3 -3
  186. data/stdlib/time/0/time.rbs +1 -1
  187. data/stdlib/timeout/0/timeout.rbs +7 -63
  188. data/stdlib/tsort/0/cyclic.rbs +0 -3
  189. data/stdlib/uri/0/common.rbs +2 -11
  190. data/stdlib/uri/0/file.rbs +1 -1
  191. data/stdlib/uri/0/generic.rbs +16 -17
  192. data/stdlib/uri/0/rfc2396_parser.rbs +7 -6
  193. data/stdlib/zlib/0/zstream.rbs +0 -1
  194. metadata +40 -12
  195. data/.clang-format +0 -74
  196. data/.clangd +0 -2
  197. data/.github/workflows/c-check.yml +0 -54
  198. data/core/ruby.rbs +0 -53
  199. data/docs/aliases.md +0 -79
  200. data/docs/encoding.md +0 -56
  201. data/ext/rbs_extension/compat.h +0 -10
  202. data/stdlib/cgi-escape/0/escape.rbs +0 -153
@@ -28,7 +28,7 @@
28
28
  # * `match_values_cleared?(scanner)`:
29
29
  # Returns whether the scanner's [match
30
30
  # values](rdoc-ref:StringScanner@Match+Values) are cleared.
31
- # See examples at [helper methods](helper_methods.md).
31
+ # See examples [[here]](ext/strscan/helper_methods_md.html).
32
32
  # ## The `StringScanner` Object
33
33
  # This code creates a `StringScanner` object
34
34
  # (we'll call it simply a *scanner*),
@@ -85,10 +85,10 @@
85
85
  # and a zero-based *character position*.
86
86
  # Each of these methods explicitly sets positions:
87
87
  # Method | Effect
88
- # ------------------------|---------------------------------------------------------
89
- # #reset |Sets both positions to zero (beginning of stored string).
88
+ # ------------------------|--------------------------------------------------------
89
+ # #reset |Sets both positions to zero (begining of stored string).
90
90
  # #terminate | Sets both positions to the end of the stored string.
91
- # #pos=(new_byte_position)| Sets byte position; adjusts character position.
91
+ # #pos=(new_byte_position)| Sets byte position; adjusts character position.
92
92
  # ### Byte Position (Position)
93
93
  # The byte position (or simply *position*)
94
94
  # is a zero-based index into the bytes in the scanner's stored string;
@@ -159,7 +159,7 @@
159
159
  # # rest_size: 12
160
160
  #
161
161
  # ## Target Substring
162
- # The target substring is the part of the [stored
162
+ # The target substring is the the part of the [stored
163
163
  # string](rdoc-ref:StringScanner@Stored+String)
164
164
  # that extends from the current [byte
165
165
  # position](rdoc-ref:StringScanner@Byte+Position+-28Position-29) to the end of
@@ -211,12 +211,12 @@
211
211
  # This table summarizes (details and examples at the links):
212
212
  # Method | Returns |Sets Match Values?
213
213
  # ---------------------|---------------------------------------------|------------------
214
- # #check(pattern) | Matched leading substring or `nil`. | Yes.
215
- # #check_until(pattern)| Matched substring (anywhere) or `nil`. | Yes.
214
+ # #check(pattern) | Matched leading substring or +nil+. | Yes.
215
+ # #check_until(pattern)| Matched substring (anywhere) or +nil+. | Yes.
216
216
  # #exist?(pattern) | Matched substring (anywhere) end index. | Yes.
217
- # #match?(pattern) | Size of matched leading substring or `nil`. | Yes.
217
+ # #match?(pattern) | Size of matched leading substring or +nil+. | Yes.
218
218
  # #peek(size) | Leading substring of given length (bytes). | No.
219
- # #peek_byte | Integer leading byte or `nil`. | No.
219
+ # #peek_byte | Integer leading byte or +nil+. | No.
220
220
  # #rest |Target substring (from byte position to end).| No.
221
221
  # ### Traversing the Target Substring
222
222
  # A *traversal* method examines the target substring,
@@ -226,24 +226,24 @@
226
226
  # This table summarizes (details and examples at links):
227
227
  # Method | Returns |Sets Match Values?
228
228
  # --------------------|----------------------------------------------------|------------------
229
- # #get_byte | Leading byte or `nil`. | No.
230
- # #getch | Leading character or `nil`. | No.
231
- # #scan(pattern) | Matched leading substring or `nil`. | Yes.
232
- # #scan_byte | Integer leading byte or `nil`. | No.
233
- # #scan_until(pattern)| Matched substring (anywhere) or `nil`. | Yes.
234
- # #skip(pattern) | Matched leading substring size or `nil`. | Yes.
235
- # #skip_until(pattern)|Position delta to end-of-matched-substring or `nil`.| Yes.
236
- # #unscan | `self`. | No.
229
+ # #get_byte | Leading byte or +nil+. | No.
230
+ # #getch | Leading character or +nil+. | No.
231
+ # #scan(pattern) | Matched leading substring or +nil+. | Yes.
232
+ # #scan_byte | Integer leading byte or +nil+. | No.
233
+ # #scan_until(pattern)| Matched substring (anywhere) or +nil+. | Yes.
234
+ # #skip(pattern) | Matched leading substring size or +nil+. | Yes.
235
+ # #skip_until(pattern)|Position delta to end-of-matched-substring or +nil+.| Yes.
236
+ # #unscan | +self+. | No.
237
237
  # ## Querying the Scanner
238
238
  # Each of these methods queries the scanner object
239
239
  # without modifying it (details and examples at links)
240
240
  # Method | Returns
241
241
  # -------------------|--------------------------------
242
- # #beginning_of_line?| `true` or `false`.
242
+ # #beginning_of_line?| +true+ or +false+.
243
243
  # #charpos | Character position.
244
- # #eos? | `true` or `false`.
245
- # #fixed_anchor? | `true` or `false`.
246
- # #inspect |String representation of `self`.
244
+ # #eos? | +true+ or +false+.
245
+ # #fixed_anchor? | +true+ or +false+.
246
+ # #inspect |String representation of +self+.
247
247
  # #pos | Byte position.
248
248
  # #rest | Target substring.
249
249
  # #rest_size | Size of target substring.
@@ -312,11 +312,11 @@
312
312
  # Each of these methods returns a basic match value:
313
313
  # Method | Return After Match |Return After No Match
314
314
  # -------------|--------------------------------------|---------------------
315
- # #matched? | `true`. | `false`.
316
- # #matched_size| Size of matched substring. | `nil`.
317
- # #matched | Matched substring. | `nil`.
318
- # #pre_match |Substring preceding matched substring.| `nil`.
319
- # #post_match |Substring following matched substring.| `nil`.
315
+ # #matched? | +true+. | +false+.
316
+ # #matched_size| Size of matched substring. | +nil+.
317
+ # #matched | Matched substring. | +nil+.
318
+ # #pre_match |Substring preceding matched substring.| +nil+.
319
+ # #post_match |Substring following matched substring.| +nil+.
320
320
  #
321
321
  # See examples below.
322
322
  # #### Captured Match Values
@@ -326,11 +326,11 @@
326
326
  # Each of these methods returns a captured match value:
327
327
  # Method | Return After Match |Return After No Match
328
328
  # ---------------|---------------------------------------|---------------------
329
- # #size | Count of captured substrings. | `nil`.
330
- # #[](n) | `n`th captured substring. | `nil`.
331
- # #captures | Array of all captured substrings. | `nil`.
332
- # #values_at(*n) |Array of specified captured substrings.| `nil`.
333
- # #named_captures| Hash of named captures. | `{}`.
329
+ # #size | Count of captured substrings. | +nil+.
330
+ # #[](n) | <tt>n</tt>th captured substring. | +nil+.
331
+ # #captures | Array of all captured substrings. | +nil+.
332
+ # #values_at(*n) |Array of specified captured substrings.| +nil+.
333
+ # #named_captures| Hash of named captures. | <tt>{}</tt>.
334
334
  #
335
335
  # See examples below.
336
336
  # #### Match Values Examples
@@ -19,7 +19,7 @@
19
19
  # require 'tempfile'
20
20
  #
21
21
  # # Tempfile.create with a block
22
- # # The filename are chosen automatically.
22
+ # # The filename are choosen automatically.
23
23
  # # (You can specify the prefix and suffix of the filename by an optional argument.)
24
24
  # Tempfile.create {|f|
25
25
  # f.puts "foo"
@@ -248,8 +248,8 @@ class Tempfile < File
248
248
  #
249
249
  # Implementation note:
250
250
  #
251
- # The keyword argument `anonymous=true` is implemented using `FILE_SHARE_DELETE`
252
- # on Windows. `O_TMPFILE` is used on Linux.
251
+ # The keyword argument +anonymous=true+ is implemented using FILE_SHARE_DELETE
252
+ # on Windows. O_TMPFILE is used on Linux.
253
253
  #
254
254
  # Related: Tempfile.new.
255
255
  #
@@ -10,7 +10,7 @@ class Time
10
10
 
11
11
  # <!--
12
12
  # rdoc-file=lib/time.rb
13
- # - zone_offset(zone, year=nil)
13
+ # - zone_offset(zone, year=self.now.year)
14
14
  # -->
15
15
  # Return the number of seconds the specified time zone differs from UTC.
16
16
  #
@@ -26,7 +26,7 @@ module Timeout
26
26
  # rdoc-file=lib/timeout.rb
27
27
  # - timeout(sec, klass = nil, message = nil) { |sec| ... }
28
28
  # -->
29
- # Perform an operation in a block, raising an exception if it takes longer than
29
+ # Perform an operation in a block, raising an error if it takes longer than
30
30
  # `sec` seconds to complete.
31
31
  #
32
32
  # `sec`
@@ -45,20 +45,12 @@ module Timeout
45
45
  #
46
46
  #
47
47
  # Returns the result of the block **if** the block completed before `sec`
48
- # seconds, otherwise raises an exception, based on the value of `klass`.
48
+ # seconds, otherwise throws an exception, based on the value of `klass`.
49
49
  #
50
- # The exception raised to terminate the given block is the given `klass`, or
51
- # Timeout::ExitException if `klass` is not given. The reason for that behavior
52
- # is that Timeout::Error inherits from RuntimeError and might be caught
53
- # unexpectedly by `rescue`. Timeout::ExitException inherits from Exception so it
54
- # will only be rescued by `rescue Exception`. Note that the
55
- # Timeout::ExitException is translated to a Timeout::Error once it reaches the
56
- # Timeout.timeout call, so outside that call it will be a Timeout::Error.
57
- #
58
- # In general, be aware that the code block may rescue the exception, and in such
59
- # a case not respect the timeout. Also, the block can use `ensure` to prevent
60
- # the handling of the exception. For those reasons, this method cannot be relied
61
- # on to enforce timeouts for untrusted blocks.
50
+ # The exception thrown to terminate the given block cannot be rescued inside the
51
+ # block unless `klass` is given explicitly. However, the block can use ensure to
52
+ # prevent the handling of the exception. For that reason, this method cannot be
53
+ # relied on to enforce timeouts for untrusted blocks.
62
54
  #
63
55
  # If a scheduler is defined, it will be used to handle the timeout by invoking
64
56
  # Scheduler#timeout_after.
@@ -67,59 +59,11 @@ module Timeout
67
59
  # Timeout` into your classes so they have a #timeout method, as well as a module
68
60
  # method, so you can call it directly as Timeout.timeout().
69
61
  #
70
- # #### Ensuring the exception does not fire inside ensure blocks
71
- #
72
- # When using Timeout.timeout it can be desirable to ensure the timeout exception
73
- # does not fire inside an `ensure` block. The simplest and best way to do so it
74
- # to put the Timeout.timeout call inside the body of the begin/ensure/end:
75
- #
76
- # begin
77
- # Timeout.timeout(sec) { some_long_operation }
78
- # ensure
79
- # cleanup # safe, cannot be interrupt by timeout
80
- # end
81
- #
82
- # If that is not feasible, e.g. if there are `ensure` blocks inside
83
- # `some_long_operation`, they need to not be interrupted by timeout, and it's
84
- # not possible to move these ensure blocks outside, one can use
85
- # Thread.handle_interrupt to delay the timeout exception like so:
86
- #
87
- # Thread.handle_interrupt(Timeout::Error => :never) {
88
- # Timeout.timeout(sec, Timeout::Error) do
89
- # setup # timeout cannot happen here, no matter how long it takes
90
- # Thread.handle_interrupt(Timeout::Error => :immediate) {
91
- # some_long_operation # timeout can happen here
92
- # }
93
- # ensure
94
- # cleanup # timeout cannot happen here, no matter how long it takes
95
- # end
96
- # }
97
- #
98
- # An important thing to note is the need to pass an exception klass to
99
- # Timeout.timeout, otherwise it does not work. Specifically, using
100
- # +Thread.handle_interrupt(Timeout::ExitException => ...)+ is unsupported and
101
- # causes subtle errors like raising the wrong exception outside the block, do
102
- # not use that.
103
- #
104
- # Note that Thread.handle_interrupt is somewhat dangerous because if setup or
105
- # cleanup hangs then the current thread will hang too and the timeout will never
106
- # fire. Also note the block might run for longer than `sec` seconds: e.g.
107
- # some_long_operation executes for `sec` seconds + whatever time cleanup takes.
108
- #
109
- # If you want the timeout to only happen on blocking operations one can use
110
- # :on_blocking instead of :immediate. However, that means if the block uses no
111
- # blocking operations after `sec` seconds, the block will not be interrupted.
112
- # ----
113
- # <!--
114
- # rdoc-file=lib/timeout.rb
115
- # - timeout(*args, &block)
116
- # -->
117
- #
118
62
  def self?.timeout: [T] (Numeric? sec, ?singleton(Exception) klass, ?String message) { (Numeric sec) -> T } -> T
119
63
  end
120
64
 
121
65
  # <!-- rdoc-file=lib/timeout.rb -->
122
- # Internal exception raised to when a timeout is triggered.
66
+ # Internal error raised to when a timeout is triggered.
123
67
  #
124
68
  class Timeout::ExitException < Exception
125
69
  end
@@ -1,8 +1,5 @@
1
1
  %a{annotate:rdoc:skip}
2
2
  module TSort[Node]
3
- # <!-- rdoc-file=lib/tsort.rb -->
4
- # Exception class to be raised when a cycle is found.
5
- #
6
3
  class Cyclic < StandardError
7
4
  end
8
5
  end
@@ -420,8 +420,8 @@ module URI
420
420
  # URI.parse('http://john.doe@www.example.com:123/forum/questions/?tag=networking&order=newest#top')
421
421
  # # => #<URI::HTTP http://john.doe@www.example.com:123/forum/questions/?tag=networking&order=newest#top>
422
422
  #
423
- # It's recommended to first URI::RFC2396_PARSER.escape string `uri` if it may
424
- # contain invalid URI characters.
423
+ # It's recommended to first ::escape string `uri` if it may contain invalid URI
424
+ # characters.
425
425
  #
426
426
  def self.parse: (_ToStr uri) -> (File | FTP | HTTP | HTTPS | LDAP | LDAPS | MailTo | WS | WSS | Generic)
427
427
 
@@ -535,9 +535,6 @@ URI::ABS_URI: Regexp
535
535
 
536
536
  URI::ABS_URI_REF: Regexp
537
537
 
538
- # <!-- rdoc-file=lib/uri/common.rb -->
539
- # The default parser instance.
540
- #
541
538
  URI::DEFAULT_PARSER: URI::RFC2396_Parser
542
539
 
543
540
  URI::ESCAPED: Regexp
@@ -560,9 +557,6 @@ URI::REL_URI: Regexp
560
557
 
561
558
  URI::REL_URI_REF: Regexp
562
559
 
563
- # <!-- rdoc-file=lib/uri/common.rb -->
564
- # The default parser instance for RFC 3986.
565
- #
566
560
  URI::RFC3986_PARSER: URI::RFC3986_Parser
567
561
 
568
562
  URI::SCHEME: Regexp
@@ -594,7 +588,6 @@ module Kernel
594
588
  # Returns a URI object derived from the given `uri`, which may be a URI string
595
589
  # or an existing URI object:
596
590
  #
597
- # require 'uri'
598
591
  # # Returns a new URI.
599
592
  # uri = URI('http://github.com/ruby/ruby')
600
593
  # # => #<URI::HTTP http://github.com/ruby/ruby>
@@ -602,7 +595,5 @@ module Kernel
602
595
  # URI(uri)
603
596
  # # => #<URI::HTTP http://github.com/ruby/ruby>
604
597
  #
605
- # You must require 'uri' to use this method.
606
- #
607
598
  def self?.URI: (URI::Generic | String uri) -> URI::Generic
608
599
  end
@@ -43,7 +43,7 @@ module URI
43
43
  # :path => '/ruby/src'})
44
44
  # uri2.to_s # => "file://host.example.com/ruby/src"
45
45
  #
46
- # uri3 = URI::File.build({:path => URI::RFC2396_PARSER.escape('/path/my file.txt')})
46
+ # uri3 = URI::File.build({:path => URI::escape('/path/my file.txt')})
47
47
  # uri3.to_s # => "file:///path/my%20file.txt"
48
48
  #
49
49
  def self.build: (Array[String] args) -> URI::File
@@ -145,7 +145,7 @@ module URI
145
145
  #
146
146
  # At first, tries to create a new URI::Generic instance using
147
147
  # URI::Generic::build. But, if exception URI::InvalidComponentError is raised,
148
- # then it does URI::RFC2396_PARSER.escape all URI components and tries again.
148
+ # then it does URI::Escape.escape all URI components and tries again.
149
149
  #
150
150
  def self.build2: (Array[nil | String | Integer]) -> URI::Generic
151
151
  | ({ scheme: String?, userinfo: String?, host: String?, port: Integer?, registry: String?, path: String?, opaque: String?, query: String?, fragment: String? }) -> instance
@@ -293,7 +293,7 @@ module URI
293
293
  # -->
294
294
  # Returns the parser to be used.
295
295
  #
296
- # Unless the `parser` is defined, DEFAULT_PARSER is used.
296
+ # Unless a URI::Parser is defined, DEFAULT_PARSER is used.
297
297
  #
298
298
  def parser: () -> untyped
299
299
 
@@ -317,7 +317,7 @@ module URI
317
317
  # rdoc-file=lib/uri/generic.rb
318
318
  # - check_scheme(v)
319
319
  # -->
320
- # Checks the scheme `v` component against the `parser` Regexp for :SCHEME.
320
+ # Checks the scheme `v` component against the URI::Parser Regexp for :SCHEME.
321
321
  #
322
322
  def check_scheme: (String? v) -> true
323
323
 
@@ -374,8 +374,8 @@ module URI
374
374
  # rdoc-file=lib/uri/generic.rb
375
375
  # - check_user(v)
376
376
  # -->
377
- # Checks the user `v` component for RFC2396 compliance and against the `parser`
378
- # Regexp for :USERINFO.
377
+ # Checks the user `v` component for RFC2396 compliance and against the
378
+ # URI::Parser Regexp for :USERINFO.
379
379
  #
380
380
  # Can not have a registry or opaque component defined, with a user component
381
381
  # defined.
@@ -387,7 +387,7 @@ module URI
387
387
  # - check_password(v, user = @user)
388
388
  # -->
389
389
  # Checks the password `v` component for RFC2396 compliance and against the
390
- # `parser` Regexp for :USERINFO.
390
+ # URI::Parser Regexp for :USERINFO.
391
391
  #
392
392
  # Can not have a registry or opaque component defined, with a user component
393
393
  # defined.
@@ -424,7 +424,7 @@ module URI
424
424
  #
425
425
  # uri = URI.parse("http://john:S3nsit1ve@my.example.com")
426
426
  # uri.user = "sam"
427
- # uri.to_s #=> "http://sam@my.example.com"
427
+ # uri.to_s #=> "http://sam:V3ry_S3nsit1ve@my.example.com"
428
428
  #
429
429
  def user=: (String? user) -> String?
430
430
 
@@ -530,8 +530,8 @@ module URI
530
530
  # rdoc-file=lib/uri/generic.rb
531
531
  # - check_host(v)
532
532
  # -->
533
- # Checks the host `v` component for RFC2396 compliance and against the `parser`
534
- # Regexp for :HOST.
533
+ # Checks the host `v` component for RFC2396 compliance and against the
534
+ # URI::Parser Regexp for :HOST.
535
535
  #
536
536
  # Can not have a registry or opaque component defined, with a host component
537
537
  # defined.
@@ -611,8 +611,8 @@ module URI
611
611
  # rdoc-file=lib/uri/generic.rb
612
612
  # - check_port(v)
613
613
  # -->
614
- # Checks the port `v` component for RFC2396 compliance and against the `parser`
615
- # Regexp for :PORT.
614
+ # Checks the port `v` component for RFC2396 compliance and against the
615
+ # URI::Parser Regexp for :PORT.
616
616
  #
617
617
  # Can not have a registry or opaque component defined, with a port component
618
618
  # defined.
@@ -670,8 +670,8 @@ module URI
670
670
  # rdoc-file=lib/uri/generic.rb
671
671
  # - check_path(v)
672
672
  # -->
673
- # Checks the path `v` component for RFC2396 compliance and against the `parser`
674
- # Regexp for :ABS_PATH and :REL_PATH.
673
+ # Checks the path `v` component for RFC2396 compliance and against the
674
+ # URI::Parser Regexp for :ABS_PATH and :REL_PATH.
675
675
  #
676
676
  # Can not have a opaque component defined, with a path component defined.
677
677
  #
@@ -742,7 +742,7 @@ module URI
742
742
  # - check_opaque(v)
743
743
  # -->
744
744
  # Checks the opaque `v` component for RFC2396 compliance and against the
745
- # `parser` Regexp for :OPAQUE.
745
+ # URI::Parser Regexp for :OPAQUE.
746
746
  #
747
747
  # Can not have a host, port, user, or path component defined, with an opaque
748
748
  # component defined.
@@ -781,7 +781,8 @@ module URI
781
781
  # rdoc-file=lib/uri/generic.rb
782
782
  # - fragment=(v)
783
783
  # -->
784
- # Checks the fragment `v` component against the `parser` Regexp for :FRAGMENT.
784
+ # Checks the fragment `v` component against the URI::Parser Regexp for
785
+ # :FRAGMENT.
785
786
  #
786
787
  # ## Args
787
788
  #
@@ -1009,7 +1010,6 @@ module URI
1009
1010
  # rdoc-file=lib/uri/generic.rb
1010
1011
  # - hash()
1011
1012
  # -->
1012
- # Returns the hash value.
1013
1013
  #
1014
1014
  def hash: () -> Integer
1015
1015
 
@@ -1017,7 +1017,6 @@ module URI
1017
1017
  # rdoc-file=lib/uri/generic.rb
1018
1018
  # - eql?(oth)
1019
1019
  # -->
1020
- # Compares with *oth* for Hash.
1021
1020
  #
1022
1021
  def eql?: (URI::Generic oth) -> bool
1023
1022
 
@@ -17,14 +17,14 @@ module URI
17
17
  # <!-- rdoc-file=lib/uri/rfc2396_parser.rb -->
18
18
  # The Hash of patterns.
19
19
  #
20
- # See also #initialize_pattern.
20
+ # See also URI::Parser.initialize_pattern.
21
21
  #
22
22
  attr_reader pattern: Hash[Symbol, String]
23
23
 
24
24
  # <!-- rdoc-file=lib/uri/rfc2396_parser.rb -->
25
25
  # The Hash of Regexp.
26
26
  #
27
- # See also #initialize_regexp.
27
+ # See also URI::Parser.initialize_regexp.
28
28
  #
29
29
  attr_reader regexp: Hash[Symbol, Regexp]
30
30
 
@@ -34,7 +34,7 @@ module URI
34
34
  # -->
35
35
  # ## Synopsis
36
36
  #
37
- # URI::RFC2396_Parser.new([opts])
37
+ # URI::Parser.new([opts])
38
38
  #
39
39
  # ## Args
40
40
  #
@@ -52,7 +52,7 @@ module URI
52
52
  #
53
53
  # ## Examples
54
54
  #
55
- # p = URI::RFC2396_Parser.new(:ESCAPED => "(?:%[a-fA-F0-9]{2}|%u[a-fA-F0-9]{4})")
55
+ # p = URI::Parser.new(:ESCAPED => "(?:%[a-fA-F0-9]{2}|%u[a-fA-F0-9]{4})")
56
56
  # u = p.parse("http://example.jp/%uABCD") #=> #<URI::HTTP http://example.jp/%uABCD>
57
57
  # URI.parse(u.to_s) #=> raises URI::InvalidURIError
58
58
  #
@@ -105,7 +105,7 @@ module URI
105
105
  # Attempts to parse and merge a set of URIs. If no `block` given, then returns
106
106
  # the result, else it calls `block` for each element in result.
107
107
  #
108
- # See also #make_regexp.
108
+ # See also URI::Parser.make_regexp.
109
109
  #
110
110
  def extract: (String str, ?Array[String] schemes) -> Array[String]
111
111
  | (String str, ?Array[String] schemes) { (String) -> untyped } -> nil
@@ -152,7 +152,8 @@ module URI
152
152
  #
153
153
  # ## Usage
154
154
  #
155
- # URI::RFC2396_PARSER.parse("ldap://ldap.example.com/dc=example?user=john")
155
+ # p = URI::Parser.new
156
+ # p.parse("ldap://ldap.example.com/dc=example?user=john")
156
157
  # #=> #<URI::LDAP ldap://ldap.example.com/dc=example?user=john>
157
158
  #
158
159
  def parse: (String uri) -> URI::Generic
@@ -153,7 +153,6 @@ module Zlib
153
153
  # rdoc-file=ext/zlib/zlib.c
154
154
  # - flush_next_in -> input
155
155
  # -->
156
- # Flushes input buffer and returns all data in that buffer.
157
156
  #
158
157
  def flush_next_in: () -> String
159
158
 
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: rbs
3
3
  version: !ruby/object:Gem::Version
4
- version: 3.10.0
4
+ version: 4.0.0.dev.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Soutaro Matsumoto
8
8
  bindir: exe
9
9
  cert_chain: []
10
- date: 1980-01-02 00:00:00.000000000 Z
10
+ date: 2025-05-02 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: logger
@@ -23,6 +23,20 @@ dependencies:
23
23
  - - ">="
24
24
  - !ruby/object:Gem::Version
25
25
  version: '0'
26
+ - !ruby/object:Gem::Dependency
27
+ name: prism
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - ">="
31
+ - !ruby/object:Gem::Version
32
+ version: 1.3.0
33
+ type: :runtime
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - ">="
38
+ - !ruby/object:Gem::Version
39
+ version: 1.3.0
26
40
  description: RBS is the language for type signatures for Ruby and standard library
27
41
  definitions.
28
42
  email:
@@ -33,10 +47,7 @@ extensions:
33
47
  - ext/rbs_extension/extconf.rb
34
48
  extra_rdoc_files: []
35
49
  files:
36
- - ".clang-format"
37
- - ".clangd"
38
50
  - ".github/dependabot.yml"
39
- - ".github/workflows/c-check.yml"
40
51
  - ".github/workflows/comments.yml"
41
52
  - ".github/workflows/dependabot.yml"
42
53
  - ".github/workflows/ruby.yml"
@@ -93,7 +104,6 @@ files:
93
104
  - core/object.rbs
94
105
  - core/object_space.rbs
95
106
  - core/object_space/weak_key_map.rbs
96
- - core/pathname.rbs
97
107
  - core/proc.rbs
98
108
  - core/process.rbs
99
109
  - core/ractor.rbs
@@ -106,7 +116,6 @@ files:
106
116
  - core/rbs/unnamed/random.rbs
107
117
  - core/refinement.rbs
108
118
  - core/regexp.rbs
109
- - core/ruby.rbs
110
119
  - core/ruby_vm.rbs
111
120
  - core/rubygems/basic_specification.rbs
112
121
  - core/rubygems/config_file.rbs
@@ -136,11 +145,9 @@ files:
136
145
  - core/unbound_method.rbs
137
146
  - core/warning.rbs
138
147
  - docs/CONTRIBUTING.md
139
- - docs/aliases.md
140
148
  - docs/architecture.md
141
149
  - docs/collection.md
142
150
  - docs/data_and_struct.md
143
- - docs/encoding.md
144
151
  - docs/gem.md
145
152
  - docs/rbs_by_example.md
146
153
  - docs/repo.md
@@ -153,7 +160,6 @@ files:
153
160
  - ext/rbs_extension/ast_translation.h
154
161
  - ext/rbs_extension/class_constants.c
155
162
  - ext/rbs_extension/class_constants.h
156
- - ext/rbs_extension/compat.h
157
163
  - ext/rbs_extension/extconf.rb
158
164
  - ext/rbs_extension/legacy_location.c
159
165
  - ext/rbs_extension/legacy_location.h
@@ -187,6 +193,12 @@ files:
187
193
  - lib/rbs/ast/declarations.rb
188
194
  - lib/rbs/ast/directives.rb
189
195
  - lib/rbs/ast/members.rb
196
+ - lib/rbs/ast/ruby/annotations.rb
197
+ - lib/rbs/ast/ruby/comment_block.rb
198
+ - lib/rbs/ast/ruby/declarations.rb
199
+ - lib/rbs/ast/ruby/helpers/constant_helper.rb
200
+ - lib/rbs/ast/ruby/helpers/location_helper.rb
201
+ - lib/rbs/ast/ruby/members.rb
190
202
  - lib/rbs/ast/type_param.rb
191
203
  - lib/rbs/ast/visitor.rb
192
204
  - lib/rbs/buffer.rb
@@ -214,12 +226,16 @@ files:
214
226
  - lib/rbs/definition_builder/method_builder.rb
215
227
  - lib/rbs/diff.rb
216
228
  - lib/rbs/environment.rb
229
+ - lib/rbs/environment/class_entry.rb
230
+ - lib/rbs/environment/module_entry.rb
217
231
  - lib/rbs/environment/use_map.rb
218
232
  - lib/rbs/environment_loader.rb
219
233
  - lib/rbs/environment_walker.rb
220
234
  - lib/rbs/errors.rb
221
235
  - lib/rbs/factory.rb
222
236
  - lib/rbs/file_finder.rb
237
+ - lib/rbs/inline_parser.rb
238
+ - lib/rbs/inline_parser/comment_association.rb
223
239
  - lib/rbs/location_aux.rb
224
240
  - lib/rbs/locator.rb
225
241
  - lib/rbs/method_type.rb
@@ -239,6 +255,7 @@ files:
239
255
  - lib/rbs/resolver/constant_resolver.rb
240
256
  - lib/rbs/resolver/type_name_resolver.rb
241
257
  - lib/rbs/sorter.rb
258
+ - lib/rbs/source.rb
242
259
  - lib/rbs/substitution.rb
243
260
  - lib/rbs/subtractor.rb
244
261
  - lib/rbs/test.rb
@@ -283,6 +300,12 @@ files:
283
300
  - sig/annotate/rdoc_annotater.rbs
284
301
  - sig/annotate/rdoc_source.rbs
285
302
  - sig/annotation.rbs
303
+ - sig/ast/ruby/annotations.rbs
304
+ - sig/ast/ruby/comment_block.rbs
305
+ - sig/ast/ruby/declarations.rbs
306
+ - sig/ast/ruby/helpers/constant_helper.rbs
307
+ - sig/ast/ruby/helpers/location_helper.rbs
308
+ - sig/ast/ruby/members.rbs
286
309
  - sig/buffer.rbs
287
310
  - sig/builtin_names.rbs
288
311
  - sig/cli.rbs
@@ -304,11 +327,15 @@ files:
304
327
  - sig/diff.rbs
305
328
  - sig/directives.rbs
306
329
  - sig/environment.rbs
330
+ - sig/environment/class_entry.rbs
331
+ - sig/environment/module_entry.rbs
307
332
  - sig/environment_loader.rbs
308
333
  - sig/environment_walker.rbs
309
334
  - sig/errors.rbs
310
335
  - sig/factory.rbs
311
336
  - sig/file_finder.rbs
337
+ - sig/inline_parser.rbs
338
+ - sig/inline_parser/comment_association.rbs
312
339
  - sig/location.rbs
313
340
  - sig/locator.rbs
314
341
  - sig/manifest.yaml
@@ -332,6 +359,7 @@ files:
332
359
  - sig/shims/enumerable.rbs
333
360
  - sig/shims/rubygems.rbs
334
361
  - sig/sorter.rbs
362
+ - sig/source.rbs
335
363
  - sig/substitution.rbs
336
364
  - sig/subtractor.rbs
337
365
  - sig/test.rbs
@@ -375,7 +403,6 @@ files:
375
403
  - stdlib/bigdecimal-math/0/big_math.rbs
376
404
  - stdlib/bigdecimal-math/0/manifest.yaml
377
405
  - stdlib/bigdecimal/0/big_decimal.rbs
378
- - stdlib/cgi-escape/0/escape.rbs
379
406
  - stdlib/cgi/0/core.rbs
380
407
  - stdlib/cgi/0/manifest.yaml
381
408
  - stdlib/coverage/0/coverage.rbs
@@ -460,6 +487,7 @@ files:
460
487
  - stdlib/openssl/0/manifest.yaml
461
488
  - stdlib/openssl/0/openssl.rbs
462
489
  - stdlib/optparse/0/optparse.rbs
490
+ - stdlib/pathname/0/pathname.rbs
463
491
  - stdlib/pp/0/manifest.yaml
464
492
  - stdlib/pp/0/pp.rbs
465
493
  - stdlib/prettyprint/0/prettyprint.rbs
@@ -562,7 +590,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
562
590
  - !ruby/object:Gem::Version
563
591
  version: '0'
564
592
  requirements: []
565
- rubygems_version: 4.0.2
593
+ rubygems_version: 3.6.2
566
594
  specification_version: 4
567
595
  summary: Type signature for Ruby.
568
596
  test_files: []