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

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)

data/lib/polars/string_name_space.rb

@@ -53,14 +53,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)
       super
     end
 
@@ -224,10 +221,10 @@ module Polars
     #   s.str.decode("hex")
     #   # =>
     #   # shape: (3,)
-    #   # Series: '' [str]
+    #   # Series: '' [binary]
     #   # [
-    #   #         "foo"
-    #   #         "bar"
+    #   #         [binary data]
+    #   #         [binary data]
     #   #         null
     #   # ]
     def decode(encoding, strict: false)
@@ -310,7 +307,6 @@ module Polars
     #   # │ str │
     #   # ╞═════╡
     #   # │ 123 │
-    #   # ├╌╌╌╌╌┤
     #   # │ 678 │
     #   # └─────┘
     def extract(pattern, group_index: 1)
@@ -332,7 +328,7 @@ module Polars
     #   s.str.extract_all('(\d+)')
     #   # =>
     #   # shape: (2,)
-    #   # Series: 'foo' [list]
+    #   # Series: 'foo' [list[str]]
     #   # [
     #   #         ["123", "45"]
     #   #         ["678", "910"]
@@ -417,11 +413,8 @@ module Polars
     #   # │ str        ┆ str         │
     #   # ╞════════════╪═════════════╡
     #   # │ a          ┆ 1           │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ null       ┆ null        │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ c          ┆ null        │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ d          ┆ 4           │
     #   # └────────────┴─────────────┘
     def split_exact(by, n, inclusive: false)
@@ -469,11 +462,8 @@ module Polars
     #   # │ str        ┆ str         │
     #   # ╞════════════╪═════════════╡
     #   # │ foo        ┆ bar         │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ null       ┆ null        │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ foo-bar    ┆ null        │
-    #   # ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
     #   # │ foo        ┆ bar baz     │
     #   # └────────────┴─────────────┘
     def splitn(by, n)

data/lib/polars/struct_expr.rb

@@ -51,7 +51,6 @@ module Polars
     #   # │ str │
     #   # ╞═════╡
     #   # │ a   │
-    #   # ├╌╌╌╌╌┤
     #   # │ b   │
     #   # └─────┘
     def field(name)
@@ -90,7 +89,6 @@ module Polars
     #   # │ i64 │
     #   # ╞═════╡
     #   # │ 1   │
-    #   # ├╌╌╌╌╌┤
     #   # │ 2   │
     #   # └─────┘
     def rename_fields(names)

data/lib/polars/utils.rb

@@ -177,6 +177,14 @@ module Polars
       value == true || value == false
     end
 
+    def self.strlike?(value)
+      value.is_a?(String) || value.is_a?(Symbol)
+    end
+
+    def self.pathlike?(value)
+      value.is_a?(String) || (defined?(Pathname) && value.is_a?(Pathname))
+    end
+
     def self._is_iterable_of(val, eltype)
       val.all? { |x| x.is_a?(eltype) }
     end

data/lib/polars/version.rb

@@ -1,4 +1,4 @@
 module Polars
   # @private
-  VERSION = "0.2.4"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: polars-df
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.3.0
 platform: x86_64-linux
 authors:
 - Andrew Kane
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-30 00:00:00.000000000 Z
+date: 2023-02-16 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: andrew@ankane.org