alopex-dataframe 0.7.2

Polars-compatible DataFrame API for Alopex DB (v0.1)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

use std::sync::Arc;

use alopex_dataframe::{DataFrame, DataFrameError, Series};
use arrow::array::{Array, ArrayRef, Int64Array, StringArray};

fn s_i64(name: &str, values: Vec<Option<i64>>) -> Series {
    let array: ArrayRef = Arc::new(Int64Array::from(values));
    Series::from_arrow(name, vec![array]).unwrap()
}

fn s_str(name: &str, values: Vec<&str>) -> Series {
    let array: ArrayRef = Arc::new(StringArray::from(values));
    Series::from_arrow(name, vec![array]).unwrap()
}

#[cfg_attr(not(feature = "lane_ci"), ignore)]
#[test]
fn sort_is_stable_and_nulls_last() {
    let df = DataFrame::new(vec![
        s_i64("a", vec![Some(2), None, Some(1), Some(1)]),
        s_i64("b", vec![Some(10), Some(40), Some(20), Some(30)]),
    ])
    .unwrap();

    let out = df.sort(vec!["a".to_string()], vec![false]).unwrap();
    let a = out.column("a").unwrap().to_arrow();
    let b = out.column("b").unwrap().to_arrow();

    let a = a[0].as_any().downcast_ref::<Int64Array>().unwrap();
    let b = b[0].as_any().downcast_ref::<Int64Array>().unwrap();

    assert_eq!(a.value(0), 1);
    assert_eq!(a.value(1), 1);
    assert_eq!(a.value(2), 2);
    assert!(a.is_null(3));

    assert_eq!(b.value(0), 20);
    assert_eq!(b.value(1), 30);
    assert_eq!(b.value(2), 10);
    assert_eq!(b.value(3), 40);
}

#[cfg_attr(not(feature = "lane_ci"), ignore)]
#[test]
fn sort_multiple_columns_with_descending() {
    let df = DataFrame::new(vec![
        s_str("category", vec!["a", "a", "b", "b"]),
        s_i64("score", vec![Some(1), Some(2), Some(1), Some(2)]),
    ])
    .unwrap();

    let out = df
        .sort(
            vec!["category".to_string(), "score".to_string()],
            vec![false, true],
        )
        .unwrap();
    let category = out.column("category").unwrap().to_arrow();
    let score = out.column("score").unwrap().to_arrow();

    let category = category[0].as_any().downcast_ref::<StringArray>().unwrap();
    let score = score[0].as_any().downcast_ref::<Int64Array>().unwrap();

    assert_eq!(category.value(0), "a");
    assert_eq!(score.value(0), 2);
    assert_eq!(category.value(1), "a");
    assert_eq!(score.value(1), 1);
    assert_eq!(category.value(2), "b");
    assert_eq!(score.value(2), 2);
    assert_eq!(category.value(3), "b");
    assert_eq!(score.value(3), 1);
}

#[cfg_attr(not(feature = "lane_ci"), ignore)]
#[test]
fn sort_errors_on_missing_column() {
    let df = DataFrame::new(vec![s_i64("a", vec![Some(1)])]).unwrap();
    let err = df
        .sort(vec!["missing".to_string()], vec![false])
        .unwrap_err();
    assert!(matches!(err, DataFrameError::ColumnNotFound { .. }));
}

#[cfg_attr(not(feature = "lane_ci"), ignore)]
#[test]
fn sort_errors_on_descending_length_mismatch() {
    let df = DataFrame::new(vec![s_i64("a", vec![Some(1)]), s_i64("b", vec![Some(2)])]).unwrap();
    let err = df
        .sort(vec!["a".to_string(), "b".to_string()], vec![true])
        .unwrap_err();
    assert!(matches!(err, DataFrameError::InvalidOperation { .. }));
}

#[cfg_attr(not(feature = "lane_ci"), ignore)]
#[test]
fn head_tail_handle_boundaries() {
    let df = DataFrame::new(vec![s_i64("a", vec![Some(1), Some(2)])]).unwrap();
    let head = df.head(0).unwrap();
    assert_eq!(head.height(), 0);

    let tail = df.tail(5).unwrap();
    assert_eq!(tail.height(), 2);
}