polars-df 0.2.5 → 0.3.0

data/lib/polars/list_expr.rb

@@ -24,7 +24,6 @@ module Polars
     #   # │ u32 │
     #   # ╞═════╡
     #   # │ 2   │
-    #   # ├╌╌╌╌╌┤
     #   # │ 1   │
     #   # └─────┘
     def lengths
@@ -46,7 +45,6 @@ module Polars
     #   # │ i64    │
     #   # ╞════════╡
     #   # │ 1      │
-    #   # ├╌╌╌╌╌╌╌╌┤
     #   # │ 5      │
     #   # └────────┘
     def sum
@@ -68,7 +66,6 @@ module Polars
     #   # │ i64    │
     #   # ╞════════╡
     #   # │ 1      │
-    #   # ├╌╌╌╌╌╌╌╌┤
     #   # │ 3      │
     #   # └────────┘
     def max
@@ -90,7 +87,6 @@ module Polars
     #   # │ i64    │
     #   # ╞════════╡
     #   # │ 1      │
-    #   # ├╌╌╌╌╌╌╌╌┤
     #   # │ 2      │
     #   # └────────┘
     def min
@@ -112,7 +108,6 @@ module Polars
     #   # │ f64    │
     #   # ╞════════╡
     #   # │ 1.0    │
-    #   # ├╌╌╌╌╌╌╌╌┤
     #   # │ 2.5    │
     #   # └────────┘
     def mean
@@ -138,7 +133,6 @@ module Polars
     #   # │ list[i64] │
     #   # ╞═══════════╡
     #   # │ [1, 2, 3] │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ [1, 2, 9] │
     #   # └───────────┘
     def sort(reverse: false)
@@ -164,7 +158,6 @@ module Polars
     #   # │ list[i64] │
     #   # ╞═══════════╡
     #   # │ [1, 2, 3] │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ [2, 1, 9] │
     #   # └───────────┘
     def reverse
@@ -218,7 +211,6 @@ module Polars
     #   # │ list[str]       │
     #   # ╞═════════════════╡
     #   # │ ["a", "b", "c"] │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ ["x", "y", "z"] │
     #   # └─────────────────┘
     def concat(other)
@@ -258,9 +250,7 @@ module Polars
     #   # │ i64  │
     #   # ╞══════╡
     #   # │ 3    │
-    #   # ├╌╌╌╌╌╌┤
     #   # │ null │
-    #   # ├╌╌╌╌╌╌┤
     #   # │ 1    │
     #   # └──────┘
     def get(index)
@@ -290,9 +280,7 @@ module Polars
     #   # │ i64  │
     #   # ╞══════╡
     #   # │ 3    │
-    #   # ├╌╌╌╌╌╌┤
     #   # │ null │
-    #   # ├╌╌╌╌╌╌┤
     #   # │ 1    │
     #   # └──────┘
     def first
@@ -314,9 +302,7 @@ module Polars
     #   # │ i64  │
     #   # ╞══════╡
     #   # │ 1    │
-    #   # ├╌╌╌╌╌╌┤
     #   # │ null │
-    #   # ├╌╌╌╌╌╌┤
     #   # │ 2    │
     #   # └──────┘
     def last
@@ -341,9 +327,7 @@ module Polars
     #   # │ bool  │
     #   # ╞═══════╡
     #   # │ true  │
-    #   # ├╌╌╌╌╌╌╌┤
     #   # │ false │
-    #   # ├╌╌╌╌╌╌╌┤
     #   # │ true  │
     #   # └───────┘
     def contains(item)
@@ -370,7 +354,6 @@ module Polars
     #   # │ str   │
     #   # ╞═══════╡
     #   # │ a b c │
-    #   # ├╌╌╌╌╌╌╌┤
     #   # │ x y   │
     #   # └───────┘
     def join(separator)
@@ -396,7 +379,6 @@ module Polars
     #   # │ u32 │
     #   # ╞═════╡
     #   # │ 0   │
-    #   # ├╌╌╌╌╌┤
     #   # │ 1   │
     #   # └─────┘
     def arg_min
@@ -422,7 +404,6 @@ module Polars
     #   # │ u32 │
     #   # ╞═════╡
     #   # │ 1   │
-    #   # ├╌╌╌╌╌┤
     #   # │ 0   │
     #   # └─────┘
     def arg_max
@@ -443,7 +424,7 @@ module Polars
     #   s.arr.diff
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'a' [list]
+    #   # Series: 'a' [list[i64]]
     #   # [
     #   #         [null, 1, ... 1]
     #   #         [null, -8, -1]
@@ -464,7 +445,7 @@ module Polars
     #   s.arr.shift
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'a' [list]
+    #   # Series: 'a' [list[i64]]
     #   # [
     #   #         [null, 1, ... 3]
     #   #         [null, 10, 2]
@@ -488,7 +469,7 @@ module Polars
     #   s.arr.slice(1, 2)
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'a' [list]
+    #   # Series: 'a' [list[i64]]
     #   # [
     #   #         [2, 3]
     #   #         [2, 1]
@@ -511,7 +492,7 @@ module Polars
     #   s.arr.head(2)
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'a' [list]
+    #   # Series: 'a' [list[i64]]
     #   # [
     #   #         [1, 2]
     #   #         [10, 2]
@@ -532,7 +513,7 @@ module Polars
     #   s.arr.tail(2)
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'a' [list]
+    #   # Series: 'a' [list[i64]]
     #   # [
     #   #         [3, 4]
     #   #         [2, 1]
@@ -563,7 +544,6 @@ module Polars
     #   # │ struct[3]  │
     #   # ╞════════════╡
     #   # │ {1,2,3}    │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ {1,2,null} │
     #   # └────────────┘
     def to_struct(n_field_strategy: "first_non_null", name_generator: nil)
@@ -598,9 +578,7 @@ module Polars
     #   # │ i64 ┆ i64 ┆ list[f32]  │
     #   # ╞═════╪═════╪════════════╡
     #   # │ 1   ┆ 4   ┆ [1.0, 2.0] │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 8   ┆ 5   ┆ [2.0, 1.0] │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 3   ┆ 2   ┆ [2.0, 1.0] │
     #   # └─────┴─────┴────────────┘
     def eval(expr, parallel: false)

data/lib/polars/list_name_space.rb

@@ -183,7 +183,7 @@ module Polars
     #   s.arr.diff
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'a' [list]
+    #   # Series: 'a' [list[i64]]
     #   # [
     #   #         [null, 1, ... 1]
     #   #         [null, -8, -1]
@@ -204,7 +204,7 @@ module Polars
     #   s.arr.shift
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'a' [list]
+    #   # Series: 'a' [list[i64]]
     #   # [
     #   #         [null, 1, ... 3]
     #   #         [null, 10, 2]
@@ -228,7 +228,7 @@ module Polars
     #   s.arr.slice(1, 2)
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'a' [list]
+    #   # Series: 'a' [list[i64]]
     #   # [
     #   #         [2, 3]
     #   #         [2, 1]
@@ -249,7 +249,7 @@ module Polars
     #   s.arr.head(2)
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'a' [list]
+    #   # Series: 'a' [list[i64]]
     #   # [
     #   #         [1, 2]
     #   #         [10, 2]
@@ -270,7 +270,7 @@ module Polars
     #   s.arr.tail(2)
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'a' [list]
+    #   # Series: 'a' [list[i64]]
     #   # [
     #   #         [3, 4]
     #   #         [2, 1]
@@ -300,7 +300,6 @@ module Polars
     #   # │ struct[3]  │
     #   # ╞════════════╡
     #   # │ {1,2,3}    │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ {1,2,null} │
     #   # └────────────┘
     def to_struct(n_field_strategy: "first_non_null", name_generator: nil)
@@ -334,9 +333,7 @@ module Polars
     #   # │ i64 ┆ i64 ┆ list[f32]  │
     #   # ╞═════╪═════╪════════════╡
     #   # │ 1   ┆ 4   ┆ [1.0, 2.0] │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 8   ┆ 5   ┆ [2.0, 1.0] │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 3   ┆ 2   ┆ [2.0, 1.0] │
     #   # └─────┴─────┴────────────┘
     def eval(expr, parallel: false)

data/lib/polars/series.rb

@@ -259,6 +259,17 @@ module Polars
       0 - self
     end
 
+    # Returns an enumerator.
+    #
+    # @return [Object]
+    def each
+      return to_enum(:each) unless block_given?
+
+      length.times do |i|
+        yield self[i]
+      end
+    end
+
     # Returns elements of the Series.
     #
     # @return [Object]
@@ -432,15 +443,10 @@ module Polars
     #   # │ str        ┆ f64      │
     #   # ╞════════════╪══════════╡
     #   # │ min        ┆ 1.0      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ max        ┆ 5.0      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ null_count ┆ 0.0      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ mean       ┆ 3.0      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ std        ┆ 1.581139 │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ count      ┆ 5.0      │
     #   # └────────────┴──────────┘
     #
@@ -455,9 +461,7 @@ module Polars
     #   # │ str        ┆ i64   │
     #   # ╞════════════╪═══════╡
     #   # │ unique     ┆ 4     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ null_count ┆ 1     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┤
     #   # │ count      ┆ 5     │
     #   # └────────────┴───────┘
     def describe
@@ -660,13 +664,11 @@ module Polars
     #   # │ u8  ┆ u8  ┆ u8  │
     #   # ╞═════╪═════╪═════╡
     #   # │ 1   ┆ 0   ┆ 0   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 0   ┆ 1   ┆ 0   │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌┤
     #   # │ 0   ┆ 0   ┆ 1   │
     #   # └─────┴─────┴─────┘
-    def to_dummies
-      Utils.wrap_df(_s.to_dummies)
+    def to_dummies(separator: "_")
+      Utils.wrap_df(_s.to_dummies(separator))
     end
 
     # Count the unique values in a Series.
@@ -687,9 +689,7 @@ module Polars
     #   # │ i64 ┆ u32    │
     #   # ╞═════╪════════╡
     #   # │ 1   ┆ 1      │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 2   ┆ 2      │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 3   ┆ 1      │
     #   # └─────┴────────┘
     def value_counts(sort: false)
@@ -1285,8 +1285,12 @@ module Polars
     #   Expression or scalar value.
     #
     # @return [Integer]
-    def search_sorted(element)
-      Polars.select(Polars.lit(self).search_sorted(element))[0, 0]
+    def search_sorted(element, side: "any")
+      if element.is_a?(Integer) || element.is_a?(Float)
+        return Polars.select(Polars.lit(self).search_sorted(element, side: side)).item
+      end
+      element = Series.new(element)
+      Polars.select(Polars.lit(self).search_sorted(element, side: side)).to_series
     end
 
     # Get unique elements in series.
@@ -1500,7 +1504,7 @@ module Polars
     #   sets = Polars::Series.new("sets", [[1, 2, 3], [1, 2], [9, 10]])
     #   # =>
     #   # shape: (3,)
-    #   # Series: 'sets' [list]
+    #   # Series: 'sets' [list[i64]]
     #   # [
     #   #         [1, 2, 3]
     #   #         [1, 2]

data/lib/polars/string_expr.rb

@@ -22,6 +22,9 @@ module Polars
     # @param exact [Boolean]
     #   - If true, require an exact format match.
     #   - If false, allow the format to match anywhere in the target string.
+    # @param utc [Boolean]
+    #   Parse timezone aware datetimes as UTC. This may be useful if you have data
+    #   with mixed offsets.
     #
     # @return [Expr]
     #
@@ -57,14 +60,11 @@ module Polars
     #   # │ date       │
     #   # ╞════════════╡
     #   # │ 2021-04-22 │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2022-01-04 │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2022-01-31 │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2001-07-08 │
     #   # └────────────┘
-    def strptime(datatype, fmt = nil, strict: true, exact: true, cache: true, tz_aware: false)
+    def strptime(datatype, fmt = nil, strict: true, exact: true, cache: true, tz_aware: false, utc: false)
       if !Utils.is_polars_dtype(datatype)
         raise ArgumentError, "expected: {DataType} got: #{datatype}"
       end
@@ -74,7 +74,7 @@ module Polars
       elsif datatype == :datetime
         # TODO fix
         tu = nil # datatype.tu
-        dtcol = Utils.wrap_expr(_rbexpr.str_parse_datetime(fmt, strict, exact, cache, tz_aware))
+        dtcol = Utils.wrap_expr(_rbexpr.str_parse_datetime(fmt, strict, exact, cache, tz_aware, utc))
         if tu.nil?
           dtcol
         else
@@ -111,11 +111,8 @@ module Polars
     #   # │ str  ┆ u32    ┆ u32    │
     #   # ╞══════╪════════╪════════╡
     #   # │ Café ┆ 5      ┆ 4      │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ null ┆ null   ┆ null   │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 345  ┆ 3      ┆ 3      │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 東京 ┆ 6      ┆ 2      │
     #   # └──────┴────────┴────────┘
     def lengths
@@ -146,11 +143,8 @@ module Polars
     #   # │ str  ┆ u32    ┆ u32    │
     #   # ╞══════╪════════╪════════╡
     #   # │ Café ┆ 5      ┆ 4      │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ null ┆ null   ┆ null   │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 345  ┆ 3      ┆ 3      │
-    #   # ├╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 東京 ┆ 6      ┆ 2      │
     #   # └──────┴────────┴────────┘
     def n_chars
@@ -195,7 +189,6 @@ module Polars
     #   # │ str │
     #   # ╞═════╡
     #   # │ CAT │
-    #   # ├╌╌╌╌╌┤
     #   # │ DOG │
     #   # └─────┘
     def to_uppercase
@@ -217,7 +210,6 @@ module Polars
     #   # │ str │
     #   # ╞═════╡
     #   # │ cat │
-    #   # ├╌╌╌╌╌┤
     #   # │ dog │
     #   # └─────┘
     def to_lowercase
@@ -242,9 +234,7 @@ module Polars
     #   # │ str   │
     #   # ╞═══════╡
     #   # │ lead  │
-    #   # ├╌╌╌╌╌╌╌┤
     #   # │ trail │
-    #   # ├╌╌╌╌╌╌╌┤
     #   # │ both  │
     #   # └───────┘
     def strip(matches = nil)
@@ -272,9 +262,7 @@ module Polars
     #   # │ str    │
     #   # ╞════════╡
     #   # │ lead   │
-    #   # ├╌╌╌╌╌╌╌╌┤
     #   # │ trail  │
-    #   # ├╌╌╌╌╌╌╌╌┤
     #   # │ both   │
     #   # └────────┘
     def lstrip(matches = nil)
@@ -302,9 +290,7 @@ module Polars
     #   # │ str   │
     #   # ╞═══════╡
     #   # │  lead │
-    #   # ├╌╌╌╌╌╌╌┤
     #   # │ trail │
-    #   # ├╌╌╌╌╌╌╌┤
     #   # │  both │
     #   # └───────┘
     def rstrip(matches = nil)
@@ -343,21 +329,13 @@ module Polars
     #   # │ str     │
     #   # ╞═════════╡
     #   # │ -0010   │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ -0001   │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ 00000   │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ 00001   │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ ...     │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ 10000   │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ 100000  │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ 1000000 │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ null    │
     #   # └─────────┘
     def zfill(alignment)
@@ -388,11 +366,8 @@ module Polars
     #   # │ str          │
     #   # ╞══════════════╡
     #   # │ cow*****     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ monkey**     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ null         │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ hippopotamus │
     #   # └──────────────┘
     def ljust(width, fillchar = " ")
@@ -423,11 +398,8 @@ module Polars
     #   # │ str          │
     #   # ╞══════════════╡
     #   # │ *****cow     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ **monkey     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ null         │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ hippopotamus │
     #   # └──────────────┘
     def rjust(width, fillchar = " ")
@@ -460,15 +432,13 @@ module Polars
     #   # │ str         ┆ bool  ┆ bool    │
     #   # ╞═════════════╪═══════╪═════════╡
     #   # │ Crab        ┆ false ┆ false   │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ cat and dog ┆ true  ┆ false   │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ rab$bit     ┆ true  ┆ true    │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ null        ┆ null  ┆ null    │
     #   # └─────────────┴───────┴─────────┘
-    def contains(pattern, literal: false)
-      Utils.wrap_expr(_rbexpr.str_contains(pattern, literal))
+    def contains(pattern, literal: false, strict: true)
+      pattern = Utils.expr_to_lit_or_expr(pattern, str_to_lit: true)._rbexpr
+      Utils.wrap_expr(_rbexpr.str_contains(pattern, literal, strict))
     end
 
     # Check if string values end with a substring.
@@ -491,9 +461,7 @@ module Polars
     #   # │ str    ┆ bool       │
     #   # ╞════════╪════════════╡
     #   # │ apple  ┆ false      │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ mango  ┆ true       │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ null   ┆ null       │
     #   # └────────┴────────────┘
     #
@@ -509,6 +477,7 @@ module Polars
     #   # │ mango  │
     #   # └────────┘
     def ends_with(sub)
+      sub = Utils.expr_to_lit_or_expr(sub, str_to_lit: true)._rbexpr
       Utils.wrap_expr(_rbexpr.str_ends_with(sub))
     end
 
@@ -532,9 +501,7 @@ module Polars
     #   # │ str    ┆ bool       │
     #   # ╞════════╪════════════╡
     #   # │ apple  ┆ true       │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ mango  ┆ false      │
-    #   # ├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ null   ┆ null       │
     #   # └────────┴────────────┘
     #
@@ -550,6 +517,7 @@ module Polars
     #   # │ apple  │
     #   # └────────┘
     def starts_with(sub)
+      sub = Utils.expr_to_lit_or_expr(sub, str_to_lit: true)._rbexpr
       Utils.wrap_expr(_rbexpr.str_starts_with(sub))
     end
 
@@ -579,13 +547,9 @@ module Polars
     #   # │ str      │
     #   # ╞══════════╡
     #   # │ 1        │
-    #   # ├╌╌╌╌╌╌╌╌╌╌┤
     #   # │ null     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2        │
-    #   # ├╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 2.1      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌┤
     #   # │ true     │
     #   # └──────────┘
     def json_path_match(json_path)
@@ -609,18 +573,16 @@ module Polars
     #   df.select(Polars.col("encoded").str.decode("hex"))
     #   # =>
     #   # shape: (3, 1)
-    #   # ┌─────────┐
-    #   # │ encoded │
-    #   # │ ---     │
-    #   # │ str     │
-    #   # ╞═════════╡
-    #   # │ foo     │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
-    #   # │ bar     │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
-    #   # │ null    │
-    #   # └─────────┘
-    def decode(encoding, strict: false)
+    #   # ┌───────────────┐
+    #   # │ encoded       │
+    #   # │ ---           │
+    #   # │ binary        │
+    #   # ╞═══════════════╡
+    #   # │ [binary data] │
+    #   # │ [binary data] │
+    #   # │ null          │
+    #   # └───────────────┘
+    def decode(encoding, strict: true)
       if encoding == "hex"
         Utils.wrap_expr(_rbexpr.str_hex_decode(strict))
       elsif encoding == "base64"
@@ -648,9 +610,7 @@ module Polars
     #   # │ str     │
     #   # ╞═════════╡
     #   # │ 666f6f  │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ 626172  │
-    #   # ├╌╌╌╌╌╌╌╌╌┤
     #   # │ null    │
     #   # └─────────┘
     def encode(encoding)
@@ -689,7 +649,6 @@ module Polars
     #   # │ str │
     #   # ╞═════╡
     #   # │ 123 │
-    #   # ├╌╌╌╌╌┤
     #   # │ 678 │
     #   # └─────┘
     def extract(pattern, group_index: 1)
@@ -721,7 +680,6 @@ module Polars
     #   # │ list[str]      │
     #   # ╞════════════════╡
     #   # │ ["123", "45"]  │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ ["678", "910"] │
     #   # └────────────────┘
     def extract_all(pattern)
@@ -751,7 +709,6 @@ module Polars
     #   # │ u32          │
     #   # ╞══════════════╡
     #   # │ 5            │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ 6            │
     #   # └──────────────┘
     def count_match(pattern)
@@ -778,9 +735,7 @@ module Polars
     #   # │ list[str]             │
     #   # ╞═══════════════════════╡
     #   # │ ["foo", "bar"]        │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ ["foo-bar"]           │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ ["foo", "bar", "baz"] │
     #   # └───────────────────────┘
     def split(by, inclusive: false)
@@ -821,11 +776,8 @@ module Polars
     #   # │ struct[2]   │
     #   # ╞═════════════╡
     #   # │ {"a","1"}   │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ {null,null} │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ {"c",null}  │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ {"d","4"}   │
     #   # └─────────────┘
     def split_exact(by, n, inclusive: false)
@@ -860,11 +812,8 @@ module Polars
     #   # │ struct[2]         │
     #   # ╞═══════════════════╡
     #   # │ {"foo","bar"}     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ {null,null}       │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ {"foo-bar",null}  │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ {"foo","bar baz"} │
     #   # └───────────────────┘
     def splitn(by, n)
@@ -895,7 +844,6 @@ module Polars
     #   # │ i64 ┆ str    │
     #   # ╞═════╪════════╡
     #   # │ 1   ┆ 123ABC │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
     #   # │ 2   ┆ abc456 │
     #   # └─────┴────────┘
     def replace(pattern, value, literal: false)
@@ -926,7 +874,6 @@ module Polars
     #   # │ i64 ┆ str     │
     #   # ╞═════╪═════════╡
     #   # │ 1   ┆ -bc-bc  │
-    #   # ├╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤
     #   # │ 2   ┆ 123-123 │
     #   # └─────┴─────────┘
     def replace_all(pattern, value, literal: false)
@@ -958,11 +905,8 @@ module Polars
     #   # │ str         ┆ str      │
     #   # ╞═════════════╪══════════╡
     #   # │ pear        ┆ ear      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ null        ┆ null     │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ papaya      ┆ aya      │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌┤
     #   # │ dragonfruit ┆ uit      │
     #   # └─────────────┴──────────┘
     def slice(offset, length = nil)