polars-df 0.8.0 → 0.10.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (76) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +42 -1
  3. data/Cargo.lock +159 -66
  4. data/Cargo.toml +0 -3
  5. data/LICENSE.txt +1 -1
  6. data/README.md +3 -2
  7. data/ext/polars/Cargo.toml +18 -8
  8. data/ext/polars/src/batched_csv.rs +7 -5
  9. data/ext/polars/src/conversion/anyvalue.rs +186 -0
  10. data/ext/polars/src/conversion/chunked_array.rs +140 -0
  11. data/ext/polars/src/{conversion.rs → conversion/mod.rs} +273 -342
  12. data/ext/polars/src/dataframe.rs +108 -66
  13. data/ext/polars/src/expr/array.rs +78 -0
  14. data/ext/polars/src/expr/datetime.rs +29 -58
  15. data/ext/polars/src/expr/general.rs +83 -36
  16. data/ext/polars/src/expr/list.rs +58 -6
  17. data/ext/polars/src/expr/meta.rs +48 -0
  18. data/ext/polars/src/expr/rolling.rs +1 -0
  19. data/ext/polars/src/expr/string.rs +62 -11
  20. data/ext/polars/src/expr/struct.rs +8 -4
  21. data/ext/polars/src/file.rs +158 -11
  22. data/ext/polars/src/functions/aggregation.rs +6 -0
  23. data/ext/polars/src/functions/lazy.rs +120 -50
  24. data/ext/polars/src/functions/meta.rs +45 -1
  25. data/ext/polars/src/functions/string_cache.rs +14 -0
  26. data/ext/polars/src/functions/whenthen.rs +47 -17
  27. data/ext/polars/src/{lazyframe.rs → lazyframe/mod.rs} +195 -40
  28. data/ext/polars/src/lib.rs +246 -179
  29. data/ext/polars/src/map/dataframe.rs +17 -9
  30. data/ext/polars/src/series/aggregation.rs +20 -0
  31. data/ext/polars/src/series/mod.rs +35 -4
  32. data/lib/polars/array_expr.rb +453 -0
  33. data/lib/polars/array_name_space.rb +346 -0
  34. data/lib/polars/batched_csv_reader.rb +4 -2
  35. data/lib/polars/cat_expr.rb +24 -0
  36. data/lib/polars/cat_name_space.rb +75 -0
  37. data/lib/polars/config.rb +2 -2
  38. data/lib/polars/data_frame.rb +306 -96
  39. data/lib/polars/data_types.rb +191 -28
  40. data/lib/polars/date_time_expr.rb +41 -18
  41. data/lib/polars/date_time_name_space.rb +9 -3
  42. data/lib/polars/exceptions.rb +12 -1
  43. data/lib/polars/expr.rb +898 -215
  44. data/lib/polars/functions/aggregation/horizontal.rb +246 -0
  45. data/lib/polars/functions/aggregation/vertical.rb +282 -0
  46. data/lib/polars/functions/as_datatype.rb +248 -0
  47. data/lib/polars/functions/col.rb +47 -0
  48. data/lib/polars/functions/eager.rb +182 -0
  49. data/lib/polars/functions/lazy.rb +1280 -0
  50. data/lib/polars/functions/len.rb +49 -0
  51. data/lib/polars/functions/lit.rb +35 -0
  52. data/lib/polars/functions/random.rb +16 -0
  53. data/lib/polars/functions/range/date_range.rb +103 -0
  54. data/lib/polars/functions/range/int_range.rb +51 -0
  55. data/lib/polars/functions/repeat.rb +144 -0
  56. data/lib/polars/functions/whenthen.rb +96 -0
  57. data/lib/polars/functions.rb +29 -416
  58. data/lib/polars/group_by.rb +2 -2
  59. data/lib/polars/io.rb +36 -31
  60. data/lib/polars/lazy_frame.rb +405 -88
  61. data/lib/polars/list_expr.rb +158 -8
  62. data/lib/polars/list_name_space.rb +102 -0
  63. data/lib/polars/meta_expr.rb +175 -7
  64. data/lib/polars/series.rb +282 -41
  65. data/lib/polars/string_cache.rb +75 -0
  66. data/lib/polars/string_expr.rb +413 -96
  67. data/lib/polars/string_name_space.rb +4 -4
  68. data/lib/polars/testing.rb +507 -0
  69. data/lib/polars/utils.rb +106 -8
  70. data/lib/polars/version.rb +1 -1
  71. data/lib/polars/whenthen.rb +83 -0
  72. data/lib/polars.rb +16 -4
  73. metadata +37 -8
  74. data/lib/polars/lazy_functions.rb +0 -1181
  75. data/lib/polars/when.rb +0 -16
  76. data/lib/polars/when_then.rb +0 -19
@@ -1,10 +1,10 @@
1
1
  [package]
2
2
  name = "polars"
3
- version = "0.8.0"
3
+ version = "0.10.0"
4
4
  license = "MIT"
5
5
  authors = ["Andrew Kane <andrew@ankane.org>"]
6
6
  edition = "2021"
7
- rust-version = "1.73.0"
7
+ rust-version = "1.76.0"
8
8
  publish = false
9
9
 
10
10
  [lib]
@@ -15,23 +15,26 @@ ahash = "0.8"
15
15
  chrono = "0.4"
16
16
  either = "1.8"
17
17
  magnus = "0.6"
18
- polars-core = "=0.36.2"
19
- polars-parquet = "=0.36.2"
20
- polars-utils = "=0.36.2"
18
+ polars-core = "=0.39.2"
19
+ polars-parquet = "=0.39.2"
20
+ polars-utils = "=0.39.2"
21
21
  serde_json = "1"
22
22
  smartstring = "1"
23
23
 
24
24
  [dependencies.polars]
25
- version = "=0.36.2"
25
+ version = "=0.39.2"
26
26
  features = [
27
27
  "abs",
28
28
  "approx_unique",
29
29
  "arg_where",
30
+ "array_any_all",
31
+ "array_count",
30
32
  "asof_join",
31
33
  "avro",
32
34
  "binary_encoding",
33
35
  "concat_str",
34
36
  "cov",
37
+ "cross_join",
35
38
  "cse",
36
39
  "csv",
37
40
  "cum_agg",
@@ -45,9 +48,11 @@ features = [
45
48
  "dtype-full",
46
49
  "dynamic_group_by",
47
50
  "ewma",
51
+ "ewma_by",
52
+ "extract_groups",
48
53
  "extract_jsonpath",
54
+ "find_many",
49
55
  "fmt",
50
- "horizontal_concat",
51
56
  "interpolate",
52
57
  "ipc",
53
58
  "is_first_distinct",
@@ -56,12 +61,15 @@ features = [
56
61
  "is_unique",
57
62
  "json",
58
63
  "lazy",
59
- "lazy_regex",
64
+ "list_any_all",
60
65
  "list_count",
66
+ "list_drop_nulls",
61
67
  "list_eval",
62
68
  "list_gather",
69
+ "list_sample",
63
70
  "list_to_struct",
64
71
  "log",
72
+ "merge_sorted",
65
73
  "meta",
66
74
  "mode",
67
75
  "moment",
@@ -77,8 +85,10 @@ features = [
77
85
  "random",
78
86
  "rank",
79
87
  "range",
88
+ "regex",
80
89
  "reinterpret",
81
90
  "repeat_by",
91
+ "replace",
82
92
  "rle",
83
93
  "rolling_window",
84
94
  "round_series",
@@ -1,6 +1,6 @@
1
1
  use magnus::{prelude::*, RArray, Value};
2
2
  use polars::io::mmap::MmapBytesReader;
3
- use polars::io::RowCount;
3
+ use polars::io::RowIndex;
4
4
  use polars::prelude::read_impl::OwnedBatchedCsvReader;
5
5
  use polars::prelude::*;
6
6
  use std::cell::RefCell;
@@ -46,15 +46,16 @@ impl RbBatchedCsv {
46
46
  let null_values = Option::<Wrap<NullValues>>::try_convert(arguments[18])?;
47
47
  let try_parse_dates = bool::try_convert(arguments[19])?;
48
48
  let skip_rows_after_header = usize::try_convert(arguments[20])?;
49
- let row_count = Option::<(String, IdxSize)>::try_convert(arguments[21])?;
49
+ let row_index = Option::<(String, IdxSize)>::try_convert(arguments[21])?;
50
50
  let sample_size = usize::try_convert(arguments[22])?;
51
51
  let eol_char = String::try_convert(arguments[23])?;
52
+ let truncate_ragged_lines = bool::try_convert(arguments[24])?;
52
53
  // end arguments
53
54
 
54
55
  let null_values = null_values.map(|w| w.0);
55
56
  let eol_char = eol_char.as_bytes()[0];
56
57
 
57
- let row_count = row_count.map(|(name, offset)| RowCount { name, offset });
58
+ let row_index = row_index.map(|(name, offset)| RowIndex { name, offset });
58
59
 
59
60
  let quote_char = if let Some(s) = quote_char {
60
61
  if s.is_empty() {
@@ -106,8 +107,9 @@ impl RbBatchedCsv {
106
107
  .with_quote_char(quote_char)
107
108
  .with_end_of_line_char(eol_char)
108
109
  .with_skip_rows_after_header(skip_rows_after_header)
109
- .with_row_count(row_count)
110
- .sample_size(sample_size);
110
+ .with_row_index(row_index)
111
+ .sample_size(sample_size)
112
+ .truncate_ragged_lines(truncate_ragged_lines);
111
113
 
112
114
  let reader = if low_memory {
113
115
  let reader = reader
@@ -0,0 +1,186 @@
1
+ use magnus::encoding::{EncodingCapable, Index};
2
+ use magnus::{
3
+ class, prelude::*, r_hash::ForEach, Float, Integer, IntoValue, RArray, RHash, RString, Ruby,
4
+ TryConvert, Value,
5
+ };
6
+ use polars::prelude::*;
7
+ use polars_core::utils::any_values_to_supertype_and_n_dtypes;
8
+
9
+ use super::{struct_dict, ObjectValue, Wrap};
10
+
11
+ use crate::rb_modules::utils;
12
+ use crate::{RbPolarsErr, RbResult, RbSeries};
13
+
14
+ impl IntoValue for Wrap<AnyValue<'_>> {
15
+ fn into_value_with(self, ruby: &Ruby) -> Value {
16
+ match self.0 {
17
+ AnyValue::UInt8(v) => ruby.into_value(v),
18
+ AnyValue::UInt16(v) => ruby.into_value(v),
19
+ AnyValue::UInt32(v) => ruby.into_value(v),
20
+ AnyValue::UInt64(v) => ruby.into_value(v),
21
+ AnyValue::Int8(v) => ruby.into_value(v),
22
+ AnyValue::Int16(v) => ruby.into_value(v),
23
+ AnyValue::Int32(v) => ruby.into_value(v),
24
+ AnyValue::Int64(v) => ruby.into_value(v),
25
+ AnyValue::Float32(v) => ruby.into_value(v),
26
+ AnyValue::Float64(v) => ruby.into_value(v),
27
+ AnyValue::Null => ruby.qnil().as_value(),
28
+ AnyValue::Boolean(v) => ruby.into_value(v),
29
+ AnyValue::String(v) => ruby.into_value(v),
30
+ AnyValue::StringOwned(v) => ruby.into_value(v.as_str()),
31
+ AnyValue::Categorical(idx, rev, arr) | AnyValue::Enum(idx, rev, arr) => {
32
+ let s = if arr.is_null() {
33
+ rev.get(idx)
34
+ } else {
35
+ unsafe { arr.deref_unchecked().value(idx as usize) }
36
+ };
37
+ s.into_value()
38
+ }
39
+ AnyValue::Date(v) => utils().funcall("_to_ruby_date", (v,)).unwrap(),
40
+ AnyValue::Datetime(v, time_unit, time_zone) => {
41
+ let time_unit = time_unit.to_ascii();
42
+ utils()
43
+ .funcall("_to_ruby_datetime", (v, time_unit, time_zone.clone()))
44
+ .unwrap()
45
+ }
46
+ AnyValue::Duration(v, time_unit) => {
47
+ let time_unit = time_unit.to_ascii();
48
+ utils()
49
+ .funcall("_to_ruby_duration", (v, time_unit))
50
+ .unwrap()
51
+ }
52
+ AnyValue::Time(v) => utils().funcall("_to_ruby_time", (v,)).unwrap(),
53
+ AnyValue::Array(v, _) | AnyValue::List(v) => RbSeries::new(v).to_a().into_value(),
54
+ ref av @ AnyValue::Struct(_, _, flds) => struct_dict(av._iter_struct_av(), flds),
55
+ AnyValue::StructOwned(payload) => struct_dict(payload.0.into_iter(), &payload.1),
56
+ AnyValue::Object(v) => {
57
+ let object = v.as_any().downcast_ref::<ObjectValue>().unwrap();
58
+ object.to_object()
59
+ }
60
+ AnyValue::ObjectOwned(v) => {
61
+ let object = v.0.as_any().downcast_ref::<ObjectValue>().unwrap();
62
+ object.to_object()
63
+ }
64
+ AnyValue::Binary(v) => RString::from_slice(v).into_value(),
65
+ AnyValue::BinaryOwned(v) => RString::from_slice(&v).into_value(),
66
+ AnyValue::Decimal(v, scale) => utils()
67
+ .funcall("_to_ruby_decimal", (v.to_string(), -(scale as i32)))
68
+ .unwrap(),
69
+ }
70
+ }
71
+ }
72
+
73
+ impl<'s> TryConvert for Wrap<AnyValue<'s>> {
74
+ fn try_convert(ob: Value) -> RbResult<Self> {
75
+ if ob.is_kind_of(class::true_class()) || ob.is_kind_of(class::false_class()) {
76
+ Ok(AnyValue::Boolean(bool::try_convert(ob)?).into())
77
+ } else if let Some(v) = Integer::from_value(ob) {
78
+ Ok(AnyValue::Int64(v.to_i64()?).into())
79
+ } else if let Some(v) = Float::from_value(ob) {
80
+ Ok(AnyValue::Float64(v.to_f64()).into())
81
+ } else if let Some(v) = RString::from_value(ob) {
82
+ if v.enc_get() == Index::utf8() {
83
+ Ok(AnyValue::StringOwned(v.to_string()?.into()).into())
84
+ } else {
85
+ Ok(AnyValue::BinaryOwned(unsafe { v.as_slice() }.to_vec()).into())
86
+ }
87
+ // call is_a? for ActiveSupport::TimeWithZone
88
+ } else if ob.funcall::<_, _, bool>("is_a?", (class::time(),))? {
89
+ let sec = ob.funcall::<_, _, i64>("to_i", ())?;
90
+ let nsec = ob.funcall::<_, _, i64>("nsec", ())?;
91
+ let v = sec * 1_000_000_000 + nsec;
92
+ // TODO support time zone when possible
93
+ // https://github.com/pola-rs/polars/issues/9103
94
+ Ok(AnyValue::Datetime(v, TimeUnit::Nanoseconds, &None).into())
95
+ } else if ob.is_nil() {
96
+ Ok(AnyValue::Null.into())
97
+ } else if let Some(dict) = RHash::from_value(ob) {
98
+ let len = dict.len();
99
+ let mut keys = Vec::with_capacity(len);
100
+ let mut vals = Vec::with_capacity(len);
101
+ dict.foreach(|k: Value, v: Value| {
102
+ let key = String::try_convert(k)?;
103
+ let val = Wrap::<AnyValue>::try_convert(v)?.0;
104
+ let dtype = DataType::from(&val);
105
+ keys.push(Field::new(&key, dtype));
106
+ vals.push(val);
107
+ Ok(ForEach::Continue)
108
+ })?;
109
+ Ok(Wrap(AnyValue::StructOwned(Box::new((vals, keys)))))
110
+ } else if let Some(v) = RArray::from_value(ob) {
111
+ if v.is_empty() {
112
+ Ok(Wrap(AnyValue::List(Series::new_empty("", &DataType::Null))))
113
+ } else {
114
+ let list = v;
115
+
116
+ let mut avs = Vec::with_capacity(25);
117
+ let mut iter = list.each();
118
+
119
+ for item in (&mut iter).take(25) {
120
+ avs.push(Wrap::<AnyValue>::try_convert(item?)?.0)
121
+ }
122
+
123
+ let (dtype, _n_types) =
124
+ any_values_to_supertype_and_n_dtypes(&avs).map_err(RbPolarsErr::from)?;
125
+
126
+ // push the rest
127
+ avs.reserve(list.len());
128
+ for item in iter {
129
+ avs.push(Wrap::<AnyValue>::try_convert(item?)?.0)
130
+ }
131
+
132
+ let s = Series::from_any_values_and_dtype("", &avs, &dtype, true)
133
+ .map_err(RbPolarsErr::from)?;
134
+ Ok(Wrap(AnyValue::List(s)))
135
+ }
136
+ } else if ob.is_kind_of(crate::rb_modules::datetime()) {
137
+ let sec: i64 = ob.funcall("to_i", ())?;
138
+ let nsec: i64 = ob.funcall("nsec", ())?;
139
+ Ok(Wrap(AnyValue::Datetime(
140
+ sec * 1_000_000_000 + nsec,
141
+ TimeUnit::Nanoseconds,
142
+ &None,
143
+ )))
144
+ } else if ob.is_kind_of(crate::rb_modules::date()) {
145
+ // convert to DateTime for UTC
146
+ let v = ob
147
+ .funcall::<_, _, Value>("to_datetime", ())?
148
+ .funcall::<_, _, Value>("to_time", ())?
149
+ .funcall::<_, _, i64>("to_i", ())?;
150
+ Ok(Wrap(AnyValue::Date((v / 86400) as i32)))
151
+ } else if ob.is_kind_of(crate::rb_modules::bigdecimal()) {
152
+ let (sign, digits, _, exp): (i8, String, i32, i32) = ob.funcall("split", ()).unwrap();
153
+ let (mut v, scale) = abs_decimal_from_digits(digits, exp).ok_or_else(|| {
154
+ RbPolarsErr::other("BigDecimal is too large to fit in Decimal128".into())
155
+ })?;
156
+ if sign < 0 {
157
+ // TODO better error
158
+ v = v.checked_neg().unwrap();
159
+ }
160
+ Ok(Wrap(AnyValue::Decimal(v, scale)))
161
+ } else {
162
+ Err(RbPolarsErr::other(format!(
163
+ "object type not supported {:?}",
164
+ ob
165
+ )))
166
+ }
167
+ }
168
+ }
169
+
170
+ fn abs_decimal_from_digits(digits: String, exp: i32) -> Option<(i128, usize)> {
171
+ let exp = exp - (digits.len() as i32);
172
+ match digits.parse::<i128>() {
173
+ Ok(mut v) => {
174
+ let scale = if exp > 0 {
175
+ v = 10_i128
176
+ .checked_pow(exp as u32)
177
+ .and_then(|factor| v.checked_mul(factor))?;
178
+ 0
179
+ } else {
180
+ (-exp) as usize
181
+ };
182
+ Some((v, scale))
183
+ }
184
+ Err(_) => None,
185
+ }
186
+ }
@@ -0,0 +1,140 @@
1
+ use magnus::{prelude::*, IntoValue, RArray, RString, Ruby, TryConvert, Value};
2
+ use polars::prelude::*;
3
+
4
+ use super::{get_rbseq, struct_dict, Wrap};
5
+
6
+ use crate::rb_modules::utils;
7
+ use crate::RbResult;
8
+
9
+ impl TryConvert for Wrap<StringChunked> {
10
+ fn try_convert(obj: Value) -> RbResult<Self> {
11
+ let (seq, len) = get_rbseq(obj)?;
12
+ let mut builder = StringChunkedBuilder::new("", len);
13
+
14
+ for res in seq.each() {
15
+ let item = res?;
16
+ match String::try_convert(item) {
17
+ Ok(val) => builder.append_value(&val),
18
+ Err(_) => builder.append_null(),
19
+ }
20
+ }
21
+ Ok(Wrap(builder.finish()))
22
+ }
23
+ }
24
+
25
+ impl TryConvert for Wrap<BinaryChunked> {
26
+ fn try_convert(obj: Value) -> RbResult<Self> {
27
+ let (seq, len) = get_rbseq(obj)?;
28
+ let mut builder = BinaryChunkedBuilder::new("", len);
29
+
30
+ for res in seq.each() {
31
+ let item = res?;
32
+ match RString::try_convert(item) {
33
+ Ok(val) => builder.append_value(unsafe { val.as_slice() }),
34
+ Err(_) => builder.append_null(),
35
+ }
36
+ }
37
+ Ok(Wrap(builder.finish()))
38
+ }
39
+ }
40
+
41
+ impl IntoValue for Wrap<&StringChunked> {
42
+ fn into_value_with(self, _: &Ruby) -> Value {
43
+ let iter = self.0.into_iter();
44
+ RArray::from_iter(iter).into_value()
45
+ }
46
+ }
47
+
48
+ impl IntoValue for Wrap<&BinaryChunked> {
49
+ fn into_value_with(self, _: &Ruby) -> Value {
50
+ let iter = self
51
+ .0
52
+ .into_iter()
53
+ .map(|opt_bytes| opt_bytes.map(RString::from_slice));
54
+ RArray::from_iter(iter).into_value()
55
+ }
56
+ }
57
+
58
+ impl IntoValue for Wrap<&StructChunked> {
59
+ fn into_value_with(self, _: &Ruby) -> Value {
60
+ let s = self.0.clone().into_series();
61
+ // todo! iterate its chunks and flatten.
62
+ // make series::iter() accept a chunk index.
63
+ let s = s.rechunk();
64
+ let iter = s.iter().map(|av| {
65
+ if let AnyValue::Struct(_, _, flds) = av {
66
+ struct_dict(av._iter_struct_av(), flds)
67
+ } else {
68
+ unreachable!()
69
+ }
70
+ });
71
+
72
+ RArray::from_iter(iter).into_value()
73
+ }
74
+ }
75
+
76
+ impl IntoValue for Wrap<&DurationChunked> {
77
+ fn into_value_with(self, _: &Ruby) -> Value {
78
+ let utils = utils();
79
+ let time_unit = Wrap(self.0.time_unit()).into_value();
80
+ let iter = self.0.into_iter().map(|opt_v| {
81
+ opt_v.map(|v| {
82
+ utils
83
+ .funcall::<_, _, Value>("_to_ruby_duration", (v, time_unit))
84
+ .unwrap()
85
+ })
86
+ });
87
+ RArray::from_iter(iter).into_value()
88
+ }
89
+ }
90
+
91
+ impl IntoValue for Wrap<&DatetimeChunked> {
92
+ fn into_value_with(self, _: &Ruby) -> Value {
93
+ let utils = utils();
94
+ let time_unit = Wrap(self.0.time_unit()).into_value();
95
+ let time_zone = self.0.time_zone().clone().into_value();
96
+ let iter = self.0.into_iter().map(|opt_v| {
97
+ opt_v.map(|v| {
98
+ utils
99
+ .funcall::<_, _, Value>("_to_ruby_datetime", (v, time_unit, time_zone))
100
+ .unwrap()
101
+ })
102
+ });
103
+ RArray::from_iter(iter).into_value()
104
+ }
105
+ }
106
+
107
+ impl IntoValue for Wrap<&TimeChunked> {
108
+ fn into_value_with(self, _: &Ruby) -> Value {
109
+ let utils = utils();
110
+ let iter = self.0.into_iter().map(|opt_v| {
111
+ opt_v.map(|v| utils.funcall::<_, _, Value>("_to_ruby_time", (v,)).unwrap())
112
+ });
113
+ RArray::from_iter(iter).into_value()
114
+ }
115
+ }
116
+
117
+ impl IntoValue for Wrap<&DateChunked> {
118
+ fn into_value_with(self, _: &Ruby) -> Value {
119
+ let utils = utils();
120
+ let iter = self.0.into_iter().map(|opt_v| {
121
+ opt_v.map(|v| utils.funcall::<_, _, Value>("_to_ruby_date", (v,)).unwrap())
122
+ });
123
+ RArray::from_iter(iter).into_value()
124
+ }
125
+ }
126
+
127
+ impl IntoValue for Wrap<&DecimalChunked> {
128
+ fn into_value_with(self, _: &Ruby) -> Value {
129
+ let utils = utils();
130
+ let rb_scale = (-(self.0.scale() as i32)).into_value();
131
+ let iter = self.0.into_iter().map(|opt_v| {
132
+ opt_v.map(|v| {
133
+ utils
134
+ .funcall::<_, _, Value>("_to_ruby_decimal", (v.to_string(), rb_scale))
135
+ .unwrap()
136
+ })
137
+ });
138
+ RArray::from_iter(iter).into_value()
139
+ }
140
+ }