polars-df 0.2.4-x86_64-linux → 0.3.0-x86_64-linux

data/lib/polars/data_frame.rb

@@ -94,7 +94,7 @@ module Polars
       sample_size: 1024,
       eol_char: "\n"
     )
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         path = Utils.format_path(file)
       else
         path = nil
@@ -124,7 +124,39 @@ module Polars
         columns = [columns]
       end
       if file.is_a?(String) && file.include?("*")
-        raise Todo
+        dtypes_dict = nil
+        if !dtype_list.nil?
+          dtypes_dict = dtype_list.to_h
+        end
+        if !dtype_slice.nil?
+          raise ArgumentError, "cannot use glob patterns and unnamed dtypes as `dtypes` argument; Use dtypes: Mapping[str, Type[DataType]"
+        end
+        scan = Polars.scan_csv(
+          file,
+          has_header: has_header,
+          sep: sep,
+          comment_char: comment_char,
+          quote_char: quote_char,
+          skip_rows: skip_rows,
+          dtypes: dtypes_dict,
+          null_values: null_values,
+          ignore_errors: ignore_errors,
+          infer_schema_length: infer_schema_length,
+          n_rows: n_rows,
+          low_memory: low_memory,
+          rechunk: rechunk,
+          skip_rows_after_header: skip_rows_after_header,
+          row_count_name: row_count_name,
+          row_count_offset: row_count_offset,
+          eol_char: eol_char
+        )
+        if columns.nil?
+          return _from_rbdf(scan.collect._df)
+        elsif is_str_sequence(columns, allow_str: false)
+          return _from_rbdf(scan.select(columns).collect._df)
+        else
+          raise ArgumentError, "cannot use glob patterns and integer based projection as `columns` argument; Use columns: List[str]"
+        end
       end
 
       projection, columns = Utils.handle_projection_columns(columns)
@@ -170,7 +202,7 @@ module Polars
       row_count_offset: 0,
       low_memory: false
     )
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
 
@@ -194,7 +226,7 @@ module Polars
 
     # @private
     def self._read_avro(file, columns: nil, n_rows: nil)
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
       projection, columns = Utils.handle_projection_columns(columns)
@@ -211,7 +243,7 @@ module Polars
       rechunk: true,
       memory_map: true
     )
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
       if columns.is_a?(String)
@@ -237,7 +269,7 @@ module Polars
 
     # @private
     def self._read_json(file)
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
 
@@ -246,7 +278,7 @@ module Polars
 
     # @private
     def self._read_ndjson(file)
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
 
@@ -335,9 +367,7 @@ module Polars
     #   # │ i64   ┆ i64    ┆ str    │
     #   # ╞═══════╪════════╪════════╡
     #   # │ 1     ┆ 6      ┆ a      │
-    #   # ├╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 2     ┆ 7      ┆ b      │
-    #   # ├╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 3     ┆ 8      ┆ c      │
     #   # └───────┴────────┴────────┘
     def columns=(columns)
@@ -497,8 +527,12 @@ module Polars
       columns.include?(name)
     end
 
-    # def each
-    # end
+    # Returns an enumerator.
+    #
+    # @return [Object]
+    def each(&block)
+      get_columns.each(&block)
+    end
 
     # Returns subset of the DataFrame.
     #
@@ -605,6 +639,7 @@ module Polars
     # Set item.
     #
     # @return [Object]
+    #
     # def []=(key, value)
     #   if key.is_a?(String)
     #     raise TypeError, "'DataFrame' object does not support 'Series' assignment by index. Use 'DataFrame.with_columns'"
@@ -613,6 +648,25 @@ module Polars
     #   raise Todo
     # end
 
+
+    # Return the dataframe as a scalar.
+    #
+    # Equivalent to `df[0,0]`, with a check that the shape is (1,1).
+    #
+    # @return [Object]
+    #
+    # @example
+    #   df = Polars::DataFrame.new({"a" => [1, 2, 3], "b" => [4, 5, 6]})
+    #   result = df.select((Polars.col("a") * Polars.col("b")).sum)
+    #   result.item
+    #   # => 32
+    def item
+      if shape != [1, 1]
+        raise ArgumentError, "Can only call .item if the dataframe is of shape (1,1), dataframe is of shape #{shape}"
+      end
+      self[0, 0]
+    end
+
     # no to_arrow
 
     # Convert DataFrame to a hash mapping column name to values.
@@ -698,7 +752,7 @@ module Polars
       pretty: false,
       row_oriented: false
     )
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
 
@@ -713,7 +767,7 @@ module Polars
     #
     # @return [nil]
     def write_ndjson(file)
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
 
@@ -803,7 +857,7 @@ module Polars
         return buffer.string.force_encoding(Encoding::UTF_8)
       end
 
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
 
@@ -841,7 +895,7 @@ module Polars
       if compression.nil?
         compression = "uncompressed"
       end
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
 
@@ -860,7 +914,7 @@ module Polars
       if compression.nil?
         compression = "uncompressed"
       end
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
 
@@ -902,7 +956,7 @@ module Polars
       if compression.nil?
         compression = "uncompressed"
       end
-      if file.is_a?(String) || (defined?(Pathname) && file.is_a?(Pathname))
+      if Utils.pathlike?(file)
         file = Utils.format_path(file)
       end
 
@@ -976,7 +1030,6 @@ module Polars
     #   # │ str    ┆ i64      ┆ i64      ┆ i64      │
     #   # ╞════════╪══════════╪══════════╪══════════╡
     #   # │ a      ┆ 1        ┆ 2        ┆ 3        │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ b      ┆ 1        ┆ 2        ┆ 3        │
     #   # └────────┴──────────┴──────────┴──────────┘
     #
@@ -990,7 +1043,6 @@ module Polars
     #   # │ i64 ┆ i64 ┆ i64 │
     #   # ╞═════╪═════╪═════╡
     #   # │ 1   ┆ 2   ┆ 3   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 1   ┆ 2   ┆ 3   │
     #   # └─────┴─────┴─────┘
     #
@@ -1006,7 +1058,6 @@ module Polars
     #   # │ str ┆ i64 ┆ i64 ┆ i64 │
     #   # ╞═════╪═════╪═════╪═════╡
     #   # │ a   ┆ 1   ┆ 2   ┆ 3   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ b   ┆ 1   ┆ 2   ┆ 3   │
     #   # └─────┴─────┴─────┴─────┘
     def transpose(include_header: false, header_name: "column", column_names: nil)
@@ -1048,9 +1099,7 @@ module Polars
     #   # │ str ┆ i64 │
     #   # ╞═════╪═════╡
     #   # │ c   ┆ 3   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ b   ┆ 2   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ a   ┆ 1   │
     #   # └─────┴─────┘
     def reverse
@@ -1081,9 +1130,7 @@ module Polars
     #   # │ i64   ┆ i64 ┆ str │
     #   # ╞═══════╪═════╪═════╡
     #   # │ 1     ┆ 6   ┆ a   │
-    #   # ├╌╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2     ┆ 7   ┆ b   │
-    #   # ├╌╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3     ┆ 8   ┆ c   │
     #   # └───────┴─────┴─────┘
     def rename(mapping)
@@ -1111,9 +1158,7 @@ module Polars
     #   # │ i64 ┆ i64 ┆ i64 │
     #   # ╞═════╪═════╪═════╡
     #   # │ 1   ┆ 97  ┆ 4   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 98  ┆ 5   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 99  ┆ 6   │
     #   # └─────┴─────┴─────┘
     #
@@ -1135,11 +1180,8 @@ module Polars
     #   # │ i64 ┆ f64  ┆ bool  ┆ f64  │
     #   # ╞═════╪══════╪═══════╪══════╡
     #   # │ 1   ┆ 0.5  ┆ true  ┆ -2.5 │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2   ┆ 4.0  ┆ true  ┆ 15.0 │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 3   ┆ 10.0 ┆ false ┆ 20.5 │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 4   ┆ 13.0 ┆ true  ┆ 0.0  │
     #   # └─────┴──────┴───────┴──────┘
     def insert_at_idx(index, series)
@@ -1174,7 +1216,6 @@ module Polars
     #   # │ i64 ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 1   ┆ 6   ┆ a   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 7   ┆ b   │
     #   # └─────┴─────┴─────┘
     #
@@ -1216,17 +1257,11 @@ module Polars
     #   # │ str        ┆ f64      ┆ f64      ┆ f64      ┆ str  ┆ str  │
     #   # ╞════════════╪══════════╪══════════╪══════════╪══════╪══════╡
     #   # │ count      ┆ 3.0      ┆ 3.0      ┆ 3.0      ┆ 3    ┆ 3    │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ null_count ┆ 0.0      ┆ 1.0      ┆ 0.0      ┆ 1    ┆ 1    │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ mean       ┆ 2.266667 ┆ 4.5      ┆ 0.666667 ┆ null ┆ null │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ std        ┆ 1.101514 ┆ 0.707107 ┆ 0.57735  ┆ null ┆ null │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ min        ┆ 1.0      ┆ 4.0      ┆ 0.0      ┆ b    ┆ eur  │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ max        ┆ 3.0      ┆ 5.0      ┆ 1.0      ┆ c    ┆ usd  │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ median     ┆ 2.8      ┆ 4.5      ┆ 1.0      ┆ null ┆ null │
     #   # └────────────┴──────────┴──────────┴──────────┴──────┴──────┘
     def describe
@@ -1313,9 +1348,7 @@ module Polars
     #   # │ i64   ┆ i64 ┆ str │
     #   # ╞═══════╪═════╪═════╡
     #   # │ 10    ┆ 6   ┆ a   │
-    #   # ├╌╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 20    ┆ 7   ┆ b   │
-    #   # ├╌╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 30    ┆ 8   ┆ c   │
     #   # └───────┴─────┴─────┘
     def replace_at_idx(index, series)
@@ -1354,9 +1387,7 @@ module Polars
     #   # │ i64 ┆ f64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 3   ┆ 8.0 ┆ c   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 7.0 ┆ b   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 1   ┆ 6.0 ┆ a   │
     #   # └─────┴─────┴─────┘
     #
@@ -1373,9 +1404,7 @@ module Polars
     #   # │ i64 ┆ f64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 3   ┆ 8.0 ┆ c   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 7.0 ┆ b   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 1   ┆ 6.0 ┆ a   │
     #   # └─────┴─────┴─────┘
     def sort(by, reverse: false, nulls_last: false)
@@ -1441,9 +1470,7 @@ module Polars
     #   # │ i64 ┆ i64 │
     #   # ╞═════╪═════╡
     #   # │ 10  ┆ 4   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 20  ┆ 5   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 30  ┆ 6   │
     #   # └─────┴─────┘
     def replace(column, new_col)
@@ -1478,7 +1505,6 @@ module Polars
     #   # │ i64 ┆ f64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 2   ┆ 7.0 ┆ b   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 8.0 ┆ c   │
     #   # └─────┴─────┴─────┘
     def slice(offset, length = nil)
@@ -1510,11 +1536,8 @@ module Polars
     #   # │ i64 ┆ str │
     #   # ╞═════╪═════╡
     #   # │ 1   ┆ a   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ b   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ c   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 4   ┆ d   │
     #   # └─────┴─────┘
     def limit(n = 5)
@@ -1545,9 +1568,7 @@ module Polars
     #   # │ i64 ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 1   ┆ 6   ┆ a   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 7   ┆ b   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 8   ┆ c   │
     #   # └─────┴─────┴─────┘
     def head(n = 5)
@@ -1578,9 +1599,7 @@ module Polars
     #   # │ i64 ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 3   ┆ 8   ┆ c   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 4   ┆ 9   ┆ d   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 5   ┆ 10  ┆ e   │
     #   # └─────┴─────┴─────┘
     def tail(n = 5)
@@ -1611,7 +1630,6 @@ module Polars
     #   # │ i64 ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 1   ┆ 6   ┆ a   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 8   ┆ c   │
     #   # └─────┴─────┴─────┘
     def drop_nulls(subset: nil)
@@ -1653,11 +1671,8 @@ module Polars
     #   # │ i64 ┆ i64 │
     #   # ╞═════╪═════╡
     #   # │ 1   ┆ 10  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 20  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 30  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 4   ┆ 40  │
     #   # └─────┴─────┘
     def pipe(func, *args, **kwargs, &block)
@@ -1689,9 +1704,7 @@ module Polars
     #   # │ u32    ┆ i64 ┆ i64 │
     #   # ╞════════╪═════╪═════╡
     #   # │ 0      ┆ 1   ┆ 2   │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 1      ┆ 3   ┆ 4   │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2      ┆ 5   ┆ 6   │
     #   # └────────┴─────┴─────┘
     def with_row_count(name: "row_nr", offset: 0)
@@ -1726,18 +1739,13 @@ module Polars
     #   # │ str ┆ i64 │
     #   # ╞═════╪═════╡
     #   # │ a   ┆ 4   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ b   ┆ 11  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ c   ┆ 6   │
     #   # └─────┴─────┘
     def groupby(by, maintain_order: false)
       if !Utils.bool?(maintain_order)
         raise TypeError, "invalid input for groupby arg `maintain_order`: #{maintain_order}."
       end
-      if by.is_a?(String)
-        by = [by]
-      end
       GroupBy.new(
         _df,
         by,
@@ -1824,15 +1832,10 @@ module Polars
     #   # │ datetime[μs]        ┆ i64   ┆ i64   ┆ i64   │
     #   # ╞═════════════════════╪═══════╪═══════╪═══════╡
     #   # │ 2020-01-01 13:45:48 ┆ 3     ┆ 3     ┆ 3     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2020-01-01 16:42:13 ┆ 10    ┆ 3     ┆ 7     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2020-01-01 16:45:09 ┆ 15    ┆ 3     ┆ 7     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2020-01-02 18:12:48 ┆ 24    ┆ 3     ┆ 9     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2020-01-03 19:45:32 ┆ 11    ┆ 2     ┆ 9     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2020-01-08 23:16:43 ┆ 1     ┆ 1     ┆ 1     │
     #   # └─────────────────────┴───────┴───────┴───────┘
     def groupby_rolling(
@@ -1929,17 +1932,11 @@ module Polars
     #   # │ datetime[μs]        ┆ i64 │
     #   # ╞═════════════════════╪═════╡
     #   # │ 2021-12-16 00:00:00 ┆ 0   │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2021-12-16 00:30:00 ┆ 1   │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2021-12-16 01:00:00 ┆ 2   │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2021-12-16 01:30:00 ┆ 3   │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2021-12-16 02:00:00 ┆ 4   │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2021-12-16 02:30:00 ┆ 5   │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2021-12-16 03:00:00 ┆ 6   │
     #   # └─────────────────────┴─────┘
     #
@@ -1958,11 +1955,8 @@ module Polars
     #   # │ datetime[μs]        ┆ datetime[μs]        ┆ datetime[μs]        │
     #   # ╞═════════════════════╪═════════════════════╪═════════════════════╡
     #   # │ 2021-12-15 23:00:00 ┆ 2021-12-16 00:00:00 ┆ 2021-12-16 00:00:00 │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 00:00:00 ┆ 2021-12-16 00:30:00 ┆ 2021-12-16 01:00:00 │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 01:00:00 ┆ 2021-12-16 01:30:00 ┆ 2021-12-16 02:00:00 │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 02:00:00 ┆ 2021-12-16 02:30:00 ┆ 2021-12-16 03:00:00 │
     #   # └─────────────────────┴─────────────────────┴─────────────────────┘
     #
@@ -1978,11 +1972,8 @@ module Polars
     #   # │ datetime[μs]        ┆ datetime[μs]        ┆ datetime[μs]        ┆ u32        │
     #   # ╞═════════════════════╪═════════════════════╪═════════════════════╪════════════╡
     #   # │ 2021-12-15 23:00:00 ┆ 2021-12-16 00:00:00 ┆ 2021-12-15 23:00:00 ┆ 1          │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 00:00:00 ┆ 2021-12-16 01:00:00 ┆ 2021-12-16 00:00:00 ┆ 2          │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 01:00:00 ┆ 2021-12-16 02:00:00 ┆ 2021-12-16 01:00:00 ┆ 2          │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 02:00:00 ┆ 2021-12-16 03:00:00 ┆ 2021-12-16 02:00:00 ┆ 2          │
     #   # └─────────────────────┴─────────────────────┴─────────────────────┴────────────┘
     #
@@ -2001,11 +1992,8 @@ module Polars
     #   # │ datetime[μs]        ┆ u32        ┆ list[datetime[μs]]                  │
     #   # ╞═════════════════════╪════════════╪═════════════════════════════════════╡
     #   # │ 2021-12-16 00:00:00 ┆ 2          ┆ [2021-12-16 00:00:00, 2021-12-16... │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 01:00:00 ┆ 2          ┆ [2021-12-16 01:00:00, 2021-12-16... │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 02:00:00 ┆ 2          ┆ [2021-12-16 02:00:00, 2021-12-16... │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 03:00:00 ┆ 1          ┆ [2021-12-16 03:00:00]               │
     #   # └─────────────────────┴────────────┴─────────────────────────────────────┘
     #
@@ -2021,13 +2009,9 @@ module Polars
     #   # │ datetime[μs]        ┆ u32        │
     #   # ╞═════════════════════╪════════════╡
     #   # │ 2021-12-15 23:00:00 ┆ 1          │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 00:00:00 ┆ 3          │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 01:00:00 ┆ 3          │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 02:00:00 ┆ 3          │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2021-12-16 03:00:00 ┆ 1          │
     #   # └─────────────────────┴────────────┘
     #
@@ -2057,17 +2041,11 @@ module Polars
     #   # │ str    ┆ datetime[μs]        ┆ datetime[μs]        ┆ datetime[μs]        ┆ u32        │
     #   # ╞════════╪═════════════════════╪═════════════════════╪═════════════════════╪════════════╡
     #   # │ a      ┆ 2021-12-15 23:00:00 ┆ 2021-12-16 00:00:00 ┆ 2021-12-15 23:00:00 ┆ 1          │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ a      ┆ 2021-12-16 00:00:00 ┆ 2021-12-16 01:00:00 ┆ 2021-12-16 00:00:00 ┆ 3          │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ a      ┆ 2021-12-16 01:00:00 ┆ 2021-12-16 02:00:00 ┆ 2021-12-16 01:00:00 ┆ 1          │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ a      ┆ 2021-12-16 02:00:00 ┆ 2021-12-16 03:00:00 ┆ 2021-12-16 02:00:00 ┆ 2          │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ a      ┆ 2021-12-16 03:00:00 ┆ 2021-12-16 04:00:00 ┆ 2021-12-16 03:00:00 ┆ 1          │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ b      ┆ 2021-12-16 01:00:00 ┆ 2021-12-16 02:00:00 ┆ 2021-12-16 01:00:00 ┆ 2          │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ b      ┆ 2021-12-16 02:00:00 ┆ 2021-12-16 03:00:00 ┆ 2021-12-16 02:00:00 ┆ 1          │
     #   # └────────┴─────────────────────┴─────────────────────┴─────────────────────┴────────────┘
     #
@@ -2093,9 +2071,7 @@ module Polars
     #   # │ i64             ┆ i64             ┆ i64 ┆ list[str]       │
     #   # ╞═════════════════╪═════════════════╪═════╪═════════════════╡
     #   # │ 0               ┆ 3               ┆ 0   ┆ ["A", "B", "B"] │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2               ┆ 5               ┆ 2   ┆ ["B", "B", "C"] │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 4               ┆ 7               ┆ 4   ┆ ["C"]           │
     #   # └─────────────────┴─────────────────┴─────┴─────────────────┘
     def groupby_dynamic(
@@ -2181,17 +2157,11 @@ module Polars
     #   # │ datetime[ns]        ┆ str    ┆ i64    │
     #   # ╞═════════════════════╪════════╪════════╡
     #   # │ 2021-02-01 00:00:00 ┆ A      ┆ 0      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 2021-03-01 00:00:00 ┆ A      ┆ 0      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 2021-04-01 00:00:00 ┆ A      ┆ 0      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 2021-05-01 00:00:00 ┆ A      ┆ 2      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 2021-04-01 00:00:00 ┆ B      ┆ 1      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 2021-05-01 00:00:00 ┆ B      ┆ 1      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 2021-06-01 00:00:00 ┆ B      ┆ 3      │
     #   # └─────────────────────┴────────┴────────┘
     def upsample(
@@ -2316,11 +2286,8 @@ module Polars
     #   # │ datetime[ns]        ┆ f64        ┆ i64  │
     #   # ╞═════════════════════╪════════════╪══════╡
     #   # │ 2016-05-12 00:00:00 ┆ 82.19      ┆ 4164 │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2017-05-12 00:00:00 ┆ 82.66      ┆ 4411 │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2018-05-12 00:00:00 ┆ 83.12      ┆ 4566 │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2019-05-12 00:00:00 ┆ 83.52      ┆ 4696 │
     #   # └─────────────────────┴────────────┴──────┘
     def join_asof(
@@ -2395,7 +2362,6 @@ module Polars
     #   # │ i64 ┆ f64 ┆ str ┆ str   │
     #   # ╞═════╪═════╪═════╪═══════╡
     #   # │ 1   ┆ 6.0 ┆ a   ┆ x     │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2   ┆ 7.0 ┆ b   ┆ y     │
     #   # └─────┴─────┴─────┴───────┘
     #
@@ -2409,11 +2375,8 @@ module Polars
     #   # │ i64  ┆ f64  ┆ str ┆ str   │
     #   # ╞══════╪══════╪═════╪═══════╡
     #   # │ 1    ┆ 6.0  ┆ a   ┆ x     │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2    ┆ 7.0  ┆ b   ┆ y     │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ null ┆ null ┆ d   ┆ z     │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 3    ┆ 8.0  ┆ c   ┆ null  │
     #   # └──────┴──────┴─────┴───────┘
     #
@@ -2427,9 +2390,7 @@ module Polars
     #   # │ i64 ┆ f64 ┆ str ┆ str   │
     #   # ╞═════╪═════╪═════╪═══════╡
     #   # │ 1   ┆ 6.0 ┆ a   ┆ x     │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2   ┆ 7.0 ┆ b   ┆ y     │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 3   ┆ 8.0 ┆ c   ┆ null  │
     #   # └─────┴─────┴─────┴───────┘
     #
@@ -2443,7 +2404,6 @@ module Polars
     #   # │ i64 ┆ f64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 1   ┆ 6.0 ┆ a   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 7.0 ┆ b   │
     #   # └─────┴─────┴─────┘
     #
@@ -2514,9 +2474,7 @@ module Polars
     #   # │ i64      ┆ i64      │
     #   # ╞══════════╪══════════╡
     #   # │ 2        ┆ -3       │
-    #   # ├╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 4        ┆ 15       │
-    #   # ├╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 6        ┆ 24       │
     #   # └──────────┴──────────┘
     #
@@ -2530,9 +2488,7 @@ module Polars
     #   # │ i64   │
     #   # ╞═══════╡
     #   # │ 1     │
-    #   # ├╌╌╌╌╌╌╌┤
     #   # │ 9     │
-    #   # ├╌╌╌╌╌╌╌┤
     #   # │ 14    │
     #   # └───────┘
     def apply(return_dtype: nil, inference_size: 256, &f)
@@ -2567,9 +2523,7 @@ module Polars
     #   # │ i64 ┆ i64 ┆ f64       │
     #   # ╞═════╪═════╪═══════════╡
     #   # │ 1   ┆ 2   ┆ 4.0       │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 3   ┆ 4   ┆ 16.0      │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 5   ┆ 6   ┆ 36.0      │
     #   # └─────┴─────┴───────────┘
     #
@@ -2583,9 +2537,7 @@ module Polars
     #   # │ f64  ┆ i64 │
     #   # ╞══════╪═════╡
     #   # │ 1.0  ┆ 2   │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 9.0  ┆ 4   │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 25.0 ┆ 6   │
     #   # └──────┴─────┘
     def with_column(column)
@@ -2621,9 +2573,7 @@ module Polars
     #   # │ i64 ┆ i64 ┆ str ┆ i64   │
     #   # ╞═════╪═════╪═════╪═══════╡
     #   # │ 1   ┆ 6   ┆ a   ┆ 10    │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2   ┆ 7   ┆ b   ┆ 20    │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 3   ┆ 8   ┆ c   ┆ 30    │
     #   # └─────┴─────┴─────┴───────┘
     def hstack(columns, in_place: false)
@@ -2671,11 +2621,8 @@ module Polars
     #   # │ i64 ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 1   ┆ 6   ┆ a   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 7   ┆ b   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 8   ┆ c   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 4   ┆ 9   ┆ d   │
     #   # └─────┴─────┴─────┘
     def vstack(df, in_place: false)
@@ -2721,15 +2668,10 @@ module Polars
     #   # │ i64 ┆ i64 │
     #   # ╞═════╪═════╡
     #   # │ 1   ┆ 4   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 5   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 6   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 10  ┆ 40  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 20  ┆ 50  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 30  ┆ 60  │
     #   # └─────┴─────┘
     def extend(other)
@@ -2761,9 +2703,7 @@ module Polars
     #   # │ i64 ┆ f64 │
     #   # ╞═════╪═════╡
     #   # │ 1   ┆ 6.0 │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 7.0 │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 8.0 │
     #   # └─────┴─────┘
     def drop(columns)
@@ -2894,11 +2834,8 @@ module Polars
     #   # │ i64 ┆ f64  │
     #   # ╞═════╪══════╡
     #   # │ 1   ┆ 0.5  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2   ┆ 4.0  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 99  ┆ 99.0 │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 4   ┆ 13.0 │
     #   # └─────┴──────┘
     #
@@ -2912,11 +2849,8 @@ module Polars
     #   # │ i64 ┆ f64  │
     #   # ╞═════╪══════╡
     #   # │ 1   ┆ 0.5  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2   ┆ 4.0  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2   ┆ 4.0  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 4   ┆ 13.0 │
     #   # └─────┴──────┘
     #
@@ -2930,11 +2864,8 @@ module Polars
     #   # │ i64 ┆ f64  │
     #   # ╞═════╪══════╡
     #   # │ 1   ┆ 0.5  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2   ┆ 4.0  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 4   ┆ 13.0 │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 4   ┆ 13.0 │
     #   # └─────┴──────┘
     #
@@ -2948,11 +2879,8 @@ module Polars
     #   # │ i64 ┆ f64  │
     #   # ╞═════╪══════╡
     #   # │ 1   ┆ 0.5  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2   ┆ 4.0  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 0   ┆ 0.0  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 4   ┆ 13.0 │
     #   # └─────┴──────┘
     def fill_null(value = nil, strategy: nil, limit: nil, matches_supertype: true)
@@ -2991,11 +2919,8 @@ module Polars
     #   # │ f64  ┆ f64  │
     #   # ╞══════╪══════╡
     #   # │ 1.5  ┆ 0.5  │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2.0  ┆ 4.0  │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 99.0 ┆ 99.0 │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 4.0  ┆ 13.0 │
     #   # └──────┴──────┘
     def fill_nan(fill_value)
@@ -3025,19 +2950,12 @@ module Polars
     #   # │ str     ┆ i64     │
     #   # ╞═════════╪═════════╡
     #   # │ a       ┆ 1       │
-    #   # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ a       ┆ 2       │
-    #   # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ a       ┆ 3       │
-    #   # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ b       ┆ 4       │
-    #   # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ b       ┆ 5       │
-    #   # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ c       ┆ 6       │
-    #   # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ c       ┆ 7       │
-    #   # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ c       ┆ 8       │
     #   # └─────────┴─────────┘
     def explode(columns)
@@ -3079,7 +2997,6 @@ module Polars
     #   # │ str ┆ i64 ┆ i64 ┆ i64 │
     #   # ╞═════╪═════╪═════╪═════╡
     #   # │ one ┆ 1   ┆ 2   ┆ 3   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ two ┆ 4   ┆ 5   ┆ 6   │
     #   # └─────┴─────┴─────┴─────┘
     def pivot(
@@ -3088,7 +3005,8 @@ module Polars
       columns:,
       aggregate_fn: "first",
       maintain_order: true,
-      sort_columns: false
+      sort_columns: false,
+      separator: "_"
     )
       if values.is_a?(String)
         values = [values]
@@ -3130,7 +3048,8 @@ module Polars
           columns,
           aggregate_fn._rbexpr,
           maintain_order,
-          sort_columns
+          sort_columns,
+          separator
         )
       )
     end
@@ -3173,15 +3092,10 @@ module Polars
     #   # │ str ┆ str      ┆ i64   │
     #   # ╞═════╪══════════╪═══════╡
     #   # │ x   ┆ b        ┆ 1     │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ y   ┆ b        ┆ 3     │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ z   ┆ b        ┆ 5     │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ x   ┆ c        ┆ 2     │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ y   ┆ c        ┆ 4     │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ z   ┆ c        ┆ 6     │
     #   # └─────┴──────────┴───────┘
     def melt(id_vars: nil, value_vars: nil, variable_name: nil, value_name: nil)
@@ -3236,21 +3150,13 @@ module Polars
     #   # │ str  ┆ i64  │
     #   # ╞══════╪══════╡
     #   # │ A    ┆ 0    │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ B    ┆ 1    │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ C    ┆ 2    │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ D    ┆ 3    │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ ...  ┆ ...  │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ F    ┆ 5    │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ G    ┆ 6    │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ H    ┆ 7    │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ I    ┆ 8    │
     #   # └──────┴──────┘
     #
@@ -3264,9 +3170,7 @@ module Polars
     #   # │ str    ┆ str    ┆ str    ┆ i64    ┆ i64    ┆ i64    │
     #   # ╞════════╪════════╪════════╪════════╪════════╪════════╡
     #   # │ A      ┆ D      ┆ G      ┆ 0      ┆ 3      ┆ 6      │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ B      ┆ E      ┆ H      ┆ 1      ┆ 4      ┆ 7      │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ C      ┆ F      ┆ I      ┆ 2      ┆ 5      ┆ 8      │
     #   # └────────┴────────┴────────┴────────┴────────┴────────┘
     #
@@ -3280,9 +3184,7 @@ module Polars
     #   # │ str    ┆ str    ┆ str    ┆ i64    ┆ i64    ┆ i64    │
     #   # ╞════════╪════════╪════════╪════════╪════════╪════════╡
     #   # │ A      ┆ B      ┆ C      ┆ 0      ┆ 1      ┆ 2      │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ D      ┆ E      ┆ F      ┆ 3      ┆ 4      ┆ 5      │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ G      ┆ H      ┆ I      ┆ 6      ┆ 7      ┆ 8      │
     #   # └────────┴────────┴────────┴────────┴────────┴────────┘
     def unstack(step:, how: "vertical", columns: nil, fill_values: nil)
@@ -3368,7 +3270,6 @@ module Polars
     #   # │ str ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ A   ┆ 1   ┆ k   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ A   ┆ 2   ┆ l   │
     #   # └─────┴─────┴─────┘, shape: (2, 3)
     #   # ┌─────┬─────┬─────┐
@@ -3377,7 +3278,6 @@ module Polars
     #   # │ str ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ B   ┆ 2   ┆ m   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ B   ┆ 4   ┆ m   │
     #   # └─────┴─────┴─────┘, shape: (1, 3)
     #   # ┌─────┬─────┬─────┐
@@ -3398,7 +3298,6 @@ module Polars
     #   # │ str ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ A   ┆ 1   ┆ k   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ A   ┆ 2   ┆ l   │
     #   # └─────┴─────┴─────┘, "B"=>shape: (2, 3)
     #   # ┌─────┬─────┬─────┐
@@ -3407,7 +3306,6 @@ module Polars
     #   # │ str ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ B   ┆ 2   ┆ m   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ B   ┆ 4   ┆ m   │
     #   # └─────┴─────┴─────┘, "C"=>shape: (1, 3)
     #   # ┌─────┬─────┬─────┐
@@ -3467,9 +3365,7 @@ module Polars
     #   # │ i64  ┆ i64  ┆ str  │
     #   # ╞══════╪══════╪══════╡
     #   # │ null ┆ null ┆ null │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 1    ┆ 6    ┆ a    │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 2    ┆ 7    ┆ b    │
     #   # └──────┴──────┴──────┘
     #
@@ -3483,9 +3379,7 @@ module Polars
     #   # │ i64  ┆ i64  ┆ str  │
     #   # ╞══════╪══════╪══════╡
     #   # │ 2    ┆ 7    ┆ b    │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ 3    ┆ 8    ┆ c    │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┤
     #   # │ null ┆ null ┆ null │
     #   # └──────┴──────┴──────┘
     def shift(periods)
@@ -3518,9 +3412,7 @@ module Polars
     #   # │ i64 ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 0   ┆ 0   ┆ 0   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 1   ┆ 6   ┆ a   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 7   ┆ b   │
     #   # └─────┴─────┴─────┘
     def shift_and_fill(periods, fill_value)
@@ -3610,9 +3502,7 @@ module Polars
     #   # │ i64 │
     #   # ╞═════╡
     #   # │ 1   │
-    #   # ├╌╌╌╌╌┤
     #   # │ 2   │
-    #   # ├╌╌╌╌╌┤
     #   # │ 3   │
     #   # └─────┘
     #
@@ -3626,9 +3516,7 @@ module Polars
     #   # │ i64 ┆ i64 │
     #   # ╞═════╪═════╡
     #   # │ 1   ┆ 6   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 7   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 8   │
     #   # └─────┴─────┘
     #
@@ -3642,9 +3530,7 @@ module Polars
     #   # │ i64 │
     #   # ╞═════╡
     #   # │ 2   │
-    #   # ├╌╌╌╌╌┤
     #   # │ 3   │
-    #   # ├╌╌╌╌╌┤
     #   # │ 4   │
     #   # └─────┘
     #
@@ -3658,9 +3544,7 @@ module Polars
     #   # │ i64 ┆ i64 │
     #   # ╞═════╪═════╡
     #   # │ 2   ┆ 7   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 8   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 4   ┆ 9   │
     #   # └─────┴─────┘
     #
@@ -3674,9 +3558,7 @@ module Polars
     #   # │ i64     │
     #   # ╞═════════╡
     #   # │ 0       │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ 0       │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ 10      │
     #   # └─────────┘
     def select(exprs)
@@ -3718,11 +3600,8 @@ module Polars
     #   # │ i64 ┆ f64  ┆ bool  ┆ f64  ┆ f64  ┆ bool  │
     #   # ╞═════╪══════╪═══════╪══════╪══════╪═══════╡
     #   # │ 1   ┆ 0.5  ┆ true  ┆ 1.0  ┆ 0.25 ┆ false │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2   ┆ 4.0  ┆ true  ┆ 4.0  ┆ 2.0  ┆ false │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 3   ┆ 10.0 ┆ false ┆ 9.0  ┆ 5.0  ┆ true  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 4   ┆ 13.0 ┆ true  ┆ 16.0 ┆ 6.5  ┆ false │
     #   # └─────┴──────┴───────┴──────┴──────┴───────┘
     def with_columns(exprs)
@@ -4105,14 +3984,13 @@ module Polars
     #   # │ u8    ┆ u8    ┆ u8    ┆ u8    ┆ u8    ┆ u8    │
     #   # ╞═══════╪═══════╪═══════╪═══════╪═══════╪═══════╡
     #   # │ 1     ┆ 0     ┆ 1     ┆ 0     ┆ 1     ┆ 0     │
-    #   # ├╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 0     ┆ 1     ┆ 0     ┆ 1     ┆ 0     ┆ 1     │
     #   # └───────┴───────┴───────┴───────┴───────┴───────┘
-    def to_dummies(columns: nil)
+    def to_dummies(columns: nil, separator: "_")
       if columns.is_a?(String)
         columns = [columns]
       end
-      _from_rbdf(_df.to_dummies(columns))
+      _from_rbdf(_df.to_dummies(columns, separator))
     end
 
     # Drop duplicate rows from this DataFrame.
@@ -4148,13 +4026,9 @@ module Polars
     #   # │ i64 ┆ f64 ┆ bool  │
     #   # ╞═════╪═════╪═══════╡
     #   # │ 1   ┆ 0.5 ┆ true  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 2   ┆ 1.0 ┆ true  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 3   ┆ 2.0 ┆ false │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 4   ┆ 3.0 ┆ true  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ 5   ┆ 3.0 ┆ true  │
     #   # └─────┴─────┴───────┘
     def unique(maintain_order: true, subset: nil, keep: "first")
@@ -4288,7 +4162,6 @@ module Polars
     #   # │ i64 ┆ i64 ┆ str │
     #   # ╞═════╪═════╪═════╡
     #   # │ 3   ┆ 8   ┆ c   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 2   ┆ 7   ┆ b   │
     #   # └─────┴─────┴─────┘
     def sample(
@@ -4408,6 +4281,10 @@ module Polars
     #   Row index.
     # @param by_predicate [Object]
     #   Select the row according to a given expression/predicate.
+    # @param named [Boolean]
+    #   Return a hash instead of an array. The hash is a mapping of
+    #   column name to row value. This is more expensive than returning an
+    #   array, but allows for accessing values by column name.
     #
     # @return [Object]
     #
@@ -4430,25 +4307,44 @@ module Polars
     #   df.row(2)
     #   # => [3, 8, "c"]
     #
+    # @example Get a hash instead with a mapping of column names to row values
+    #   df.row(2, named: true)
+    #   # => {"foo"=>3, "bar"=>8, "ham"=>"c"}
+    #
     # @example Return the row that matches the given predicate
     #   df.row(by_predicate: Polars.col("ham") == "b")
     #   # => [2, 7, "b"]
-    def row(index = nil, by_predicate: nil)
+    def row(index = nil, by_predicate: nil, named: false)
       if !index.nil? && !by_predicate.nil?
         raise ArgumentError, "Cannot set both 'index' and 'by_predicate'; mutually exclusive"
       elsif index.is_a?(Expr)
         raise TypeError, "Expressions should be passed to the 'by_predicate' param"
-      elsif index.is_a?(Integer)
-        _df.row_tuple(index)
-      elsif by_predicate.is_a?(Expr)
+      end
+
+      if !index.nil?
+        row = _df.row_tuple(index)
+        if named
+          columns.zip(row).to_h
+        else
+          row
+        end
+      elsif !by_predicate.nil?
+        if !by_predicate.is_a?(Expr)
+          raise TypeError, "Expected by_predicate to be an expression; found #{by_predicate.class.name}"
+        end
         rows = filter(by_predicate).rows
         n_rows = rows.length
         if n_rows > 1
           raise TooManyRowsReturned, "Predicate #{by_predicate} returned #{n_rows} rows"
         elsif n_rows == 0
-          raise NoRowsReturned, "Predicate <{by_predicate!s}> returned no rows"
+          raise NoRowsReturned, "Predicate #{by_predicate} returned no rows"
+        end
+        row = rows[0]
+        if named
+          columns.zip(row).to_h
+        else
+          row
         end
-        rows[0]
       else
         raise ArgumentError, "One of 'index' or 'by_predicate' must be set"
       end
@@ -4456,6 +4352,11 @@ module Polars
 
     # Convert columnar data to rows as Ruby arrays.
     #
+    # @param named [Boolean]
+    #   Return hashes instead of arrays. The hashes are a mapping of
+    #   column name to row value. This is more expensive than returning an
+    #   array, but allows for accessing values by column name.
+    #
     # @return [Array]
     #
     # @example
@@ -4467,8 +4368,79 @@ module Polars
     #   )
     #   df.rows
     #   # => [[1, 2], [3, 4], [5, 6]]
-    def rows
-      _df.row_tuples
+    # @example
+    #   df.rows(named: true)
+    #   # => [{"a"=>1, "b"=>2}, {"a"=>3, "b"=>4}, {"a"=>5, "b"=>6}]
+    def rows(named: false)
+      if named
+        columns = columns()
+        _df.row_tuples.map do |v|
+          columns.zip(v).to_h
+        end
+      else
+        _df.row_tuples
+      end
+    end
+
+    # Returns an iterator over the DataFrame of rows of python-native values.
+    #
+    # @param named [Boolean]
+    #   Return hashes instead of arrays. The hashes are a mapping of
+    #   column name to row value. This is more expensive than returning an
+    #   array, but allows for accessing values by column name.
+    # @param buffer_size [Integer]
+    #   Determines the number of rows that are buffered internally while iterating
+    #   over the data; you should only modify this in very specific cases where the
+    #   default value is determined not to be a good fit to your access pattern, as
+    #   the speedup from using the buffer is significant (~2-4x). Setting this
+    #   value to zero disables row buffering.
+    #
+    # @return [Object]
+    #
+    # @example
+    #   df = Polars::DataFrame.new(
+    #     {
+    #       "a" => [1, 3, 5],
+    #       "b" => [2, 4, 6]
+    #     }
+    #   )
+    #   df.iter_rows.map { |row| row[0] }
+    #   # => [1, 3, 5]
+    #
+    # @example
+    #   df.iter_rows(named: true).map { |row| row["b"] }
+    #   # => [2, 4, 6]
+    def iter_rows(named: false, buffer_size: 500, &block)
+      return to_enum(:iter_rows, named: named, buffer_size: buffer_size) unless block_given?
+
+      # load into the local namespace for a modest performance boost in the hot loops
+      columns = columns()
+
+      # note: buffering rows results in a 2-4x speedup over individual calls
+      # to ".row(i)", so it should only be disabled in extremely specific cases.
+      if buffer_size
+        offset = 0
+        while offset < height
+          zerocopy_slice = slice(offset, buffer_size)
+          rows_chunk = zerocopy_slice.rows(named: false)
+          if named
+            rows_chunk.each do |row|
+              yield columns.zip(row).to_h
+            end
+          else
+            rows_chunk.each(&block)
+          end
+          offset += buffer_size
+        end
+      elsif named
+        height.times do |i|
+          yield columns.zip(row(i)).to_h
+        end
+      else
+        height.times do |i|
+          yield row(i)
+        end
+      end
     end
 
     # Shrink DataFrame memory usage.
@@ -4502,7 +4474,6 @@ module Polars
     #   # │ i64 ┆ i64 │
     #   # ╞═════╪═════╡
     #   # │ 1   ┆ 5   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 3   ┆ 7   │
     #   # └─────┴─────┘
     def take_every(n)
@@ -4570,11 +4541,8 @@ module Polars
     #   # │ i64 ┆ i64  ┆ i64 │
     #   # ╞═════╪══════╪═════╡
     #   # │ 1   ┆ 6    ┆ 1   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 5   ┆ 7    ┆ 3   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 9   ┆ 9    ┆ 6   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 10  ┆ null ┆ 9   │
     #   # └─────┴──────┴─────┘
     def interpolate
@@ -4655,7 +4623,6 @@ module Polars
     #   # │ str    ┆ i64 ┆ str ┆ bool ┆ list[i64] ┆ str   │
     #   # ╞════════╪═════╪═════╪══════╪═══════════╪═══════╡
     #   # │ foo    ┆ 1   ┆ a   ┆ true ┆ [1, 2]    ┆ baz   │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ bar    ┆ 2   ┆ b   ┆ null ┆ [3]       ┆ womp  │
     #   # └────────┴─────┴─────┴──────┴───────────┴───────┘
     def unnest(names)