rbs 2.8.4 → 3.8.1

data/stdlib/csv/0/csv.rbs

@@ -1,15 +1,6 @@
 # <!-- rdoc-file=lib/csv.rb -->
 # ## CSV
 #
-# ### In a Hurry?
-#
-# If you are familiar with CSV data and have a particular task in mind, you may
-# want to go directly to the:
-# *   [Recipes for CSV](doc/csv/recipes/recipes_rdoc.html).
-#
-#
-# Otherwise, read on here, about the API: classes, methods, and constants.
-#
 # ### CSV Data
 #
 # CSV (comma-separated values) data is a text representation of a table:
@@ -18,7 +9,6 @@
 # *   A *column* *separator* delimits fields in a row. A common column separator
 #     is the comma character `","`.
 #
-#
 # This CSV String, with row separator `"\n"` and column separator `","`, has
 # three rows and two columns:
 #     "foo,0\nbar,1\nbaz,2\n"
@@ -37,7 +27,6 @@
 #     IO object.
 # *   Generating CSV data to a String object.
 #
-#
 # To make CSV available:
 #     require 'csv'
 #
@@ -60,11 +49,9 @@
 #     *   The outer Array is the entire "table".
 #     *   Each inner Array is a row.
 #     *   Each String is a field.
-#
 # *   A CSV::Table object.  For details, see [\CSV with
 #     Headers](#class-CSV-label-CSV+with+Headers).
 #
-#
 # #### Parsing a String
 #
 # The input to be parsed can be a string:
@@ -177,7 +164,6 @@
 # *   Method CSV.instance returns a new or cached CSV object.
 # *   Method CSV() also returns a new or cached CSV object.
 #
-#
 # ### Instance Methods
 #
 # CSV has three groups of instance methods:
@@ -185,7 +171,6 @@
 # *   Methods included by module Enumerable.
 # *   Methods delegated to class IO. See below.
 #
-#
 # #### Delegated Methods
 #
 # For convenience, a CSV object will delegate to many methods in class IO. (A
@@ -224,7 +209,6 @@
 # *   IO#truncate
 # *   IO#tty?
 #
-#
 # ### Options
 #
 # The default values for options are:
@@ -283,7 +267,6 @@
 # *   `empty_value`: Specifies the object that is to be substituted for each
 #     empty field.
 #
-#
 # ###### Option `row_sep`
 #
 # Specifies the row separator, a String or the Symbol `:auto` (see below), to be
@@ -374,21 +357,11 @@
 # *   Data is `ARGF`, `STDIN`, `STDOUT`, or `STDERR`.
 # *   The stream is only available for output.
 #
-#
 # Obviously, discovery takes a little time. Set manually if speed is important.
 # Also note that IO objects should be opened in binary mode on Windows if this
 # feature will be used as the line-ending translation can cause problems with
 # resetting the document position to where it was before the read ahead.
 #
-# ---
-#
-# Raises an exception if the given value is not String-convertible:
-#     row_sep = BasicObject.new
-#     # Raises NoMethodError (undefined method `to_s' for #<BasicObject:>)
-#     CSV.generate(ary, row_sep: row_sep)
-#     # Raises NoMethodError (undefined method `to_s' for #<BasicObject:>)
-#     CSV.parse(str, row_sep: row_sep)
-#
 # ###### Option `col_sep`
 #
 # Specifies the String field separator to be used for both parsing and
@@ -445,13 +418,6 @@
 #     # Raises ArgumentError (:col_sep must be 1 or more characters: "")
 #     CSV.parse("foo0\nbar1\nbaz2\n", col_sep: col_sep)
 #
-# Raises an exception if the given value is not String-convertible:
-#     col_sep = BasicObject.new
-#     # Raises NoMethodError (undefined method `to_s' for #<BasicObject:>)
-#     CSV.generate(line, col_sep: col_sep)
-#     # Raises NoMethodError (undefined method `to_s' for #<BasicObject:>)
-#     CSV.parse(str, col_sep: col_sep)
-#
 # ###### Option `quote_char`
 #
 # Specifies the character (String of length 1) used used to quote fields in both
@@ -709,7 +675,6 @@
 # *   The converters apply only to the header row.
 # *   The built-in header converters are `:downcase` and `:symbol`.
 #
-#
 # This section assumes prior execution of:
 #     str = <<-EOT
 #     Name,Value
@@ -781,7 +746,6 @@
 # *   If a String, converts it to a Regexp, ignores lines that match it.
 # *   If `nil`, no lines are considered to be comments.
 #
-#
 # Default value:
 #     CSV::DEFAULT_OPTIONS.fetch(:skip_lines) # => nil
 #
@@ -832,13 +796,14 @@
 #
 # ###### Option `liberal_parsing`
 #
-# Specifies the boolean value that determines whether CSV will attempt to parse
-# input not conformant with RFC 4180, such as double quotes in unquoted fields.
+# Specifies the boolean or hash value that determines whether CSV will attempt
+# to parse input not conformant with RFC 4180, such as double quotes in unquoted
+# fields.
 #
 # Default value:
 #     CSV::DEFAULT_OPTIONS.fetch(:liberal_parsing) # => false
 #
-# For examples in this section:
+# For the next two examples:
 #     str = 'is,this "three, or four",fields'
 #
 # Without `liberal_parsing`:
@@ -849,6 +814,24 @@
 #     ary = CSV.parse_line(str, liberal_parsing: true)
 #     ary # => ["is", "this \"three", " or four\"", "fields"]
 #
+# Use the `backslash_quote` sub-option to parse values that use a backslash to
+# escape a double-quote character.  This causes the parser to treat `\"` as if
+# it were `""`.
+#
+# For the next two examples:
+#     str = 'Show,"Harry \"Handcuff\" Houdini, the one and only","Tampa Theater"'
+#
+# With `liberal_parsing`, but without the `backslash_quote` sub-option:
+#     # Incorrect interpretation of backslash; incorrectly interprets the quoted comma as a field separator.
+#     ary = CSV.parse_line(str, liberal_parsing: true)
+#     ary # => ["Show", "\"Harry \\\"Handcuff\\\" Houdini", " the one and only\"", "Tampa Theater"]
+#     puts ary[1] # => "Harry \"Handcuff\" Houdini
+#
+# With `liberal_parsing` and its `backslash_quote` sub-option:
+#     ary = CSV.parse_line(str, liberal_parsing: { backslash_quote: true })
+#     ary # => ["Show", "Harry \"Handcuff\" Houdini, the one and only", "Tampa Theater"]
+#     puts ary[1] # => Harry "Handcuff" Houdini, the one and only
+#
 # ###### Option `nil_value`
 #
 # Specifies the object that is to be substituted for each null (no-text) field.
@@ -891,7 +874,6 @@
 # *   `write_empty_value`: Specifies the object that is to be substituted for
 #     each empty field.
 #
-#
 # ###### Option `row_sep`
 #
 # Specifies the row separator, a String or the Symbol `:auto` (see below), to be
@@ -982,21 +964,11 @@
 # *   Data is `ARGF`, `STDIN`, `STDOUT`, or `STDERR`.
 # *   The stream is only available for output.
 #
-#
 # Obviously, discovery takes a little time. Set manually if speed is important.
 # Also note that IO objects should be opened in binary mode on Windows if this
 # feature will be used as the line-ending translation can cause problems with
 # resetting the document position to where it was before the read ahead.
 #
-# ---
-#
-# Raises an exception if the given value is not String-convertible:
-#     row_sep = BasicObject.new
-#     # Raises NoMethodError (undefined method `to_s' for #<BasicObject:>)
-#     CSV.generate(ary, row_sep: row_sep)
-#     # Raises NoMethodError (undefined method `to_s' for #<BasicObject:>)
-#     CSV.parse(str, row_sep: row_sep)
-#
 # ###### Option `col_sep`
 #
 # Specifies the String field separator to be used for both parsing and
@@ -1053,13 +1025,6 @@
 #     # Raises ArgumentError (:col_sep must be 1 or more characters: "")
 #     CSV.parse("foo0\nbar1\nbaz2\n", col_sep: col_sep)
 #
-# Raises an exception if the given value is not String-convertible:
-#     col_sep = BasicObject.new
-#     # Raises NoMethodError (undefined method `to_s' for #<BasicObject:>)
-#     CSV.generate(line, col_sep: col_sep)
-#     # Raises NoMethodError (undefined method `to_s' for #<BasicObject:>)
-#     CSV.parse(str, col_sep: col_sep)
-#
 # ###### Option `quote_char`
 #
 # Specifies the character (String of length 1) used used to quote fields in both
@@ -1124,7 +1089,7 @@
 #
 # With `write_headers`":
 #     CSV.open(file_path,'w',
-#         :write_headers=> true,
+#         :write_headers => true,
 #         :headers => ['Name','Value']
 #       ) do |csv|
 #         csv << ['foo', '0']
@@ -1192,14 +1157,6 @@
 #
 # See also [Write Converters](#class-CSV-label-Write+Converters)
 #
-# ---
-#
-# Raises an exception if the converter returns a value that is neither `nil` nor
-# String-convertible:
-#     bad_converter = proc {|field| BasicObject.new }
-#     # Raises NoMethodError (undefined method `is_a?' for #<BasicObject:>)
-#     CSV.generate_line(['a', 'b', 'c'], write_converters: bad_converter)#
-#
 # ###### Option `write_nil_value`
 #
 # Specifies the object that is to be substituted for each `nil`-valued field.
@@ -1261,12 +1218,10 @@
 # *   See [Field Converters](#class-CSV-label-Field+Converters).
 # *   See [Header Converters](#class-CSV-label-Header+Converters).
 #
-#
 # Also by default, each value to be written during generation is written
 # 'as-is'. You can use a *write* *converter* to modify values before writing.
 # *   See [Write Converters](#class-CSV-label-Write+Converters).
 #
-#
 # #### Specifying Converters
 #
 # You can specify converters for parsing or generating in the `options` argument
@@ -1275,14 +1230,12 @@
 # *   Option `header_converters` for converting parsed header values.
 # *   Option `write_converters` for converting values to be written (generated).
 #
-#
 # There are three forms for specifying converters:
 # *   A converter proc: executable code to be used for conversion.
 # *   A converter name: the name of a stored converter.
 # *   A converter list: an array of converter procs, converter names, and
 #     converter lists.
 #
-#
 # ##### Converter Procs
 #
 # This converter proc, `strip_converter`, accepts a value `field` and returns
@@ -1293,7 +1246,6 @@
 # string_converter` specifies that:
 # *   Proc `string_converter` is to be called for each parsed field.
 # *   The converter's return value is to replace the `field` value.
-#
 # Example:
 #     string = " foo , 0 \n bar , 1 \n baz , 2 \n"
 #     array = CSV.parse(string, converters: strip_converter)
@@ -1323,7 +1275,6 @@
 # *   The 1-based line index.
 # *   The field header, if any.
 #
-#
 # ##### Stored Converters
 #
 # A converter may be given a name and stored in a structure where the parsing
@@ -1335,7 +1286,6 @@
 # *   `:float`: converts each String-embedded float into a true Float.
 # *   `:date`: converts each String-embedded date into a true Date.
 # *   `:date_time`: converts each String-embedded date-time into a true DateTime
-#
 # . This example creates a converter proc, then stores it:
 #     strip_converter = proc {|field| field.strip }
 #     CSV::Converters[:strip] = strip_converter
@@ -1350,7 +1300,6 @@
 # *   `:downcase`: Downcases each header.
 # *   `:symbol`: Converts each header to a Symbol.
 #
-#
 # There is no such storage structure for write headers.
 #
 # In order for the parsing methods to access stored converters in
@@ -1368,7 +1317,6 @@
 # *   Names of stored converters.
 # *   Nested converter lists.
 #
-#
 # Examples:
 #     numeric_converters = [:integer, :float]
 #     date_converters = [:date, :date_time]
@@ -1417,7 +1365,6 @@
 #         csv.converters # => [:integer]
 #         csv.read # => [["foo", 0], ["bar", 1], ["baz", 2]]
 #
-#
 # Installing a field converter does not affect already-read rows:
 #     csv = CSV.new(string)
 #     csv.shift # => ["foo", "0"]
@@ -1437,8 +1384,6 @@
 #     *   A Proc field converter.
 #     *   An Array of field converter names.
 #
-#
-#
 # Display:
 #     CSV::Converters.each_pair do |name, value|
 #       if value.kind_of?(Proc)
@@ -1552,7 +1497,6 @@
 #         tbl = CSV.parse(string, headers: true)
 #         tbl.headers # => ["Name", "Count"]
 #
-#
 # ##### Built-In Header Converters
 #
 # The built-in header converters are in Hash CSV::HeaderConverters. The keys
@@ -1577,7 +1521,6 @@
 # *   Removes non-word characters.
 # *   Makes the string into a Symbol.
 #
-#
 # ##### Custom Header Converters
 #
 # You can define a custom header converter:
@@ -1737,8 +1680,8 @@ class CSV < Object
   #
   # Arguments:
   # *   Argument `path_or_io` must be a file path or an IO stream.
-  # *   Argument `mode`, if given, must be a File mode See [Open
-  #     Mode](https://ruby-doc.org/core/IO.html#method-c-new-label-Open+Mode).
+  # *   Argument `mode`, if given, must be a File mode. See [Access
+  #     Modes](rdoc-ref:File@Access+Modes).
   # *   Arguments `**options` must be keyword options. See [Options for
   #     Parsing](#class-CSV-label-Options+for+Parsing).
   # *   This method optionally accepts an additional `:encoding` option that you
@@ -1752,7 +1695,10 @@ class CSV < Object
   #     would read `UTF-32BE` data from the file but transcode it to `UTF-8`
   #     before parsing.
   #
-  def self.foreach: [U] (String | IO | StringIO path, ?::Hash[Symbol, U] options) { (::Array[String?] arg0) -> void } -> void
+  def self.foreach: (String | IO path, ?String mode, headers: true | :first_row | Array[untyped] | String, **untyped options) { (::CSV::Row arg0) -> void } -> void
+                  | (String | IO path, ?String mode, headers: true | :first_row | Array[untyped] | String, **untyped options) -> Enumerator[::CSV::Row, void]
+                  | (String | IO path, ?String mode, **untyped options) { (::Array[String?] arg0) -> void } -> void
+                  | (String | IO path, ?String mode, **untyped options) -> Enumerator[::Array[String?], void]
 
   # <!--
   #   rdoc-file=lib/csv.rb
@@ -1771,15 +1717,12 @@ class CSV < Object
   #     *   Positioned at the beginning. To position at the end, for appending,
   #         use method CSV.generate. For any other positioning, pass a preset
   #         StringIO object instead.
-  #
   # *   Argument `options`: See:
   #     *   [Options for Parsing](#class-CSV-label-Options+for+Parsing)
   #     *   [Options for Generating](#class-CSV-label-Options+for+Generating)
-  #
   #     For performance reasons, the options cannot be overridden in a CSV object,
   #     so those specified here will endure.
   #
-  #
   # In addition to the CSV instance methods, several IO methods are delegated. See
   # [Delegated Methods](#class-CSV-label-Delegated+Methods).
   #
@@ -1820,11 +1763,9 @@ class CSV < Object
   #     *   Positioned at the beginning. To position at the end, for appending,
   #         use method CSV.generate. For any other positioning, pass a preset
   #         StringIO object instead.
-  #
   # *   Argument `options`: see [Options for
   #     Parsing](#class-CSV-label-Options+for+Parsing)
   #
-  #
   # ###### Without Option `headers`
   #
   # Without {option `headers`[}](#class-CSV-label-Option+headers) case.
@@ -1943,11 +1884,9 @@ class CSV < Object
   #     *   Positioned at the beginning. To position at the end, for appending,
   #         use method CSV.generate. For any other positioning, pass a preset
   #         StringIO object instead.
-  #
   # *   Argument `options`: see [Options for
   #     Parsing](#class-CSV-label-Options+for+Parsing)
   #
-  #
   # ###### Without Option `headers`
   #
   # Without option `headers`, returns the first row as a new Array.
@@ -2002,7 +1941,6 @@ class CSV < Object
   # *   A CSV::Table object, if headers are in use.
   # *   An Array of Arrays, otherwise.
   #
-  #
   # The data source must be opened for reading.
   #
   # Without headers:
@@ -2058,7 +1996,8 @@ class CSV < Object
   #     File.write(path, string)
   #     CSV.read(path, headers: true) # => #<CSV::Table mode:col_or_row row_count:4>
   #
-  def self.read: (String path, ?::Hash[Symbol, untyped] options) -> ::Array[::Array[String?]]
+  def self.read: (String | IO path, headers: true | :first_row | Array[untyped] | String, **untyped options) -> ::CSV::Table[CSV::Row]
+               | (String | IO path, ?::Hash[Symbol, untyped] options) -> ::Array[::Array[String?]]
 
   # <!--
   #   rdoc-file=lib/csv.rb
@@ -2069,7 +2008,6 @@ class CSV < Object
   # *   Argument `row` must be an Array object or a CSV::Row object.
   # *   The output stream must be open for writing.
   #
-  #
   # ---
   #
   # Append Arrays:
@@ -2125,7 +2063,6 @@ class CSV < Object
   # *   Arguments `options`, if given, should be generating options. See [Options
   #     for Generating](#class-CSV-label-Options+for+Generating).
   #
-  #
   # ---
   #
   # Creates a new CSV object via `CSV.new(csv_string, **options)`; calls the block
@@ -2222,6 +2159,16 @@ class CSV < Object
   #
   def each: () -> Enumerator[untyped, Integer]
           | () { (untyped) -> void } -> Integer
+
+  # <!--
+  #   rdoc-file=lib/csv.rb
+  #   - csv.headers -> object
+  # -->
+  # Returns the value that determines whether headers are used; used for parsing;
+  # see {Option `headers`[}](#class-CSV-label-Option+headers):
+  #     CSV.new('').headers # => nil
+  #
+  def headers: () -> (Array[String] | true | nil)
 end
 
 # <!-- rdoc-file=lib/csv.rb -->
@@ -2243,7 +2190,6 @@ CSV::VERSION: String
 # *   Fields: each is an object, not necessarily a String.
 # *   Headers: each serves a key, and also need not be a String.
 #
-#
 # ### Instance Methods
 #
 # CSV::Row has three groups of instance methods:
@@ -2254,8 +2200,6 @@ CSV::VERSION: String
 #     *   Array#length
 #     *   Array#size
 #
-#
-#
 # ## Creating a CSV::Row Instance
 #
 # Commonly, a new CSV::Row instance is created by parsing CSV source that has
@@ -2314,6 +2258,33 @@ class CSV::Row < Object
   include Enumerable[Array[String]]
   extend Forwardable
 
+  # <!--
+  #   rdoc-file=lib/csv/row.rb
+  #   - CSV::Row.new(headers, fields, header_row = false) -> csv_row
+  # -->
+  # Returns the new CSV::Row instance constructed from arguments `headers` and
+  # `fields`; both should be Arrays; note that the fields need not be Strings:
+  #     row = CSV::Row.new(['Name', 'Value'], ['foo', 0])
+  #     row # => #<CSV::Row "Name":"foo" "Value":0>
+  #
+  # If the Array lengths are different, the shorter is `nil`-filled:
+  #     row = CSV::Row.new(['Name', 'Value', 'Date', 'Size'], ['foo', 0])
+  #     row # => #<CSV::Row "Name":"foo" "Value":0 "Date":nil "Size":nil>
+  #
+  # Each CSV::Row object is either a *field row* or a *header row*; by default, a
+  # new row is a field row;  for the row created above:
+  #     row.field_row? # => true
+  #     row.header_row? # => false
+  #
+  # If the optional argument `header_row` is given as `true`, the created row is a
+  # header row:
+  #     row = CSV::Row.new(['Name', 'Value'], ['foo', 0], header_row = true)
+  #     row # => #<CSV::Row "Name":"foo" "Value":0>
+  #     row.field_row? # => false
+  #     row.header_row? # => true
+  #
+  def initialize: (Array[untyped] headers, Array[untyped] fields, ?header_row: bool) -> void
+
   # <!--
   #   rdoc-file=lib/csv/row.rb
   #   - row << [header, value] -> self
@@ -2488,7 +2459,7 @@ class CSV::Row < Object
   # `index_or_header` and `specifiers`.
   #
   # The nested objects may be instances of various classes. See [Dig
-  # Methods](https://docs.ruby-lang.org/en/master/dig_methods_rdoc.html).
+  # Methods](rdoc-ref:dig_methods.rdoc).
   #
   # Examples:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
@@ -2647,7 +2618,6 @@ class CSV::Row < Object
   # *   Header.
   # *   Range of headers.
   #
-  #
   # For `specifier` in one of the first four cases above, returns the result of
   # `self.field(specifier)`;  see #field.
   #
@@ -2754,7 +2724,6 @@ class CSV::Row < Object
   # Returns an ASCII-compatible String showing:
   # *   Class CSV::Row.
   # *   Header-value pairs.
-  #
   # Example:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -2864,7 +2833,6 @@ end
 # *   Rows: each is a Table::Row object.
 # *   Headers: names for the columns.
 #
-#
 # ### Instance Methods
 #
 # CSV::Table has three groups of instance methods:
@@ -2875,8 +2843,6 @@ end
 #     *   Array#length
 #     *   Array#size
 #
-#
-#
 # ## Creating a CSV::Table Instance
 #
 # Commonly, a new CSV::Table instance is created by parsing CSV source using
@@ -2910,7 +2876,6 @@ end
 # *   Column mode.
 # *   Mixed mode (the default for a new table).
 #
-#
 # The access mode for aCSV::Table instance affects the behavior of some of its
 # instance methods:
 # *   #[]
@@ -2920,7 +2885,6 @@ end
 # *   #each
 # *   #values_at
 #
-#
 # ### Row Mode
 #
 # Set a table to row mode with method #by_row!:
@@ -2973,7 +2937,6 @@ end
 # *   A Range index refers to multiple rows.
 # *   A String index refers to a column.
 #
-#
 # Set a table to mixed mode with method #by_col_or_row!:
 #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
 #     table = CSV.parse(source, headers: true)
@@ -3002,7 +2965,7 @@ end
 #     table['Name'] # => ["Foo", "Bar", "Baz"]
 #
 class CSV::Table[out Elem] < Object
-  include Enumerable[untyped]
+  include Enumerable[Elem]
   extend Forwardable
 
   # <!--
@@ -3014,7 +2977,6 @@ class CSV::Table[out Elem] < Object
   # *   Argument `array_of_rows` must be an Array of CSV::Row objects.
   # *   Argument `headers`, if given, may be an Array of Strings.
   #
-  #
   # ---
   #
   # Create an empty CSV::Table object:
@@ -3124,7 +3086,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:row` or `:col_or_row`.
   # *   Return value: *nth* row of the table, if that row exists; otherwise `nil`.
   #
-  #
   # Returns the *nth* row of the table if that row exists:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3155,7 +3116,6 @@ class CSV::Table[out Elem] < Object
   # *   Return value: *nth* column of the table, if that column exists; otherwise
   #     an Array of `nil` fields of length `self.size`.
   #
-  #
   # Returns the *nth* column of the table if that column exists:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3179,7 +3139,6 @@ class CSV::Table[out Elem] < Object
   # *   Return value: rows from the table, beginning at row `range.start`, if
   #     those rows exists.
   #
-  #
   # Returns rows from the table, beginning at row `range.first`, if those rows
   # exist:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
@@ -3219,7 +3178,6 @@ class CSV::Table[out Elem] < Object
   # *   Return value: column data from the table, beginning at column
   #     `range.start`, if those columns exist.
   #
-  #
   # Returns column values from the table, if the column exists; the values are
   # arranged by row:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
@@ -3250,7 +3208,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:col` or `:col_or_row`
   # *   Return value: column data from the table, if that `header` exists.
   #
-  #
   # Returns column values from the table, if the column exists:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3288,7 +3245,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:row` or `:col_or_row`.
   # *   Return value: `row`.
   #
-  #
   # If the row exists, it is replaced:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3330,7 +3286,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:col`.
   # *   Return value: `array_of_fields`.
   #
-  #
   # If the column exists, it is replaced:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3369,7 +3324,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:col` or `:col_or_row`.
   # *   Return value: `field_or_array_of_fields`.
   #
-  #
   # If the column exists, it is replaced:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3633,8 +3587,8 @@ class CSV::Table[out Elem] < Object
   # Returns a new Enumerator if no block is given:
   #     table.each # => #<Enumerator: #<CSV::Table mode:col row_count:4>:each>
   #
-  def each: () -> Enumerator[untyped, self]
-          | () { (untyped) -> void } -> self
+  def each: () -> Enumerator[Elem, self]
+          | () { (Elem) -> void } -> self
           | () { (*untyped) -> void } -> self
 
   def empty?: (*untyped args) { (*untyped) -> untyped } -> untyped
@@ -3673,7 +3627,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:row`, `:col`, or `:col_or_row`.
   # *   Size:  Row count, including the header row.
   #
-  #
   # Example:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3803,3 +3756,21 @@ class CSV::Table[out Elem] < Object
   #
   def values_at: (*untyped indices_or_headers) -> untyped
 end
+
+%a{annotate:rdoc:skip}
+class Array[unchecked out Elem] < Object
+  # Equivalent to CSV::generate_line(self, options)
+  #
+  #   ["CSV", "data"].to_csv
+  #     #=> "CSV,data\n"
+  def to_csv: (**untyped options) -> String
+end
+
+%a{annotate:rdoc:skip}
+class String
+  # Equivalent to CSV::parse_line(self, options)
+  #
+  #   "CSV,data".parse_csv
+  #     #=> ["CSV", "data"]
+  def parse_csv: (**untyped options) -> ::Array[String?]?
+end

data/stdlib/csv/0/manifest.yaml

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