vortex-array 0.69.0

Vortex in memory columnar data format
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
104
105
106
107
108

// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright the Vortex contributors

#[cfg(test)]
mod tests {
    use rstest::rstest;
    use vortex_error::VortexResult;

    use crate::Canonical;
    use crate::IntoArray;
    use crate::LEGACY_SESSION;
    use crate::VortexSessionExecute;
    use crate::arrays::MaskedArray;
    use crate::arrays::PrimitiveArray;
    use crate::dtype::Nullability;
    use crate::validity::Validity;

    #[rstest]
    #[case(
        MaskedArray::try_new(
            PrimitiveArray::from_iter([1i32, 2, 3]).into_array(),
            Validity::AllValid
        ).unwrap(),
        Nullability::Nullable
    )]
    #[case(
        MaskedArray::try_new(
            PrimitiveArray::from_iter([1i32, 2, 3]).into_array(),
            Validity::from_iter([true, false, true])
        ).unwrap(),
        Nullability::Nullable
    )]
    fn test_canonical_nullability(
        #[case] array: MaskedArray,
        #[case] expected_nullability: Nullability,
    ) -> VortexResult<()> {
        let canonical = array
            .clone()
            .into_array()
            .execute::<Canonical>(&mut LEGACY_SESSION.create_execution_ctx())?;
        assert_eq!(canonical.dtype().nullability(), expected_nullability);
        assert_eq!(canonical.dtype(), array.dtype());
        Ok(())
    }

    #[test]
    fn test_canonical_with_nulls() -> VortexResult<()> {
        let array = MaskedArray::try_new(
            PrimitiveArray::from_iter([1i32, 2, 3, 4, 5]).into_array(),
            Validity::from_iter([true, false, true, false, true]),
        )
        .unwrap();

        let canonical = array
            .into_array()
            .execute::<Canonical>(&mut LEGACY_SESSION.create_execution_ctx())?;
        let prim = canonical.into_primitive();

        // Check that null positions match validity.
        let mut ctx = LEGACY_SESSION.create_execution_ctx();
        assert_eq!(prim.valid_count(&mut ctx).unwrap(), 3);
        assert!(
            prim.is_valid(0, &mut LEGACY_SESSION.create_execution_ctx())
                .unwrap()
        );
        assert!(
            !prim
                .is_valid(1, &mut LEGACY_SESSION.create_execution_ctx())
                .unwrap()
        );
        assert!(
            prim.is_valid(2, &mut LEGACY_SESSION.create_execution_ctx())
                .unwrap()
        );
        assert!(
            !prim
                .is_valid(3, &mut LEGACY_SESSION.create_execution_ctx())
                .unwrap()
        );
        assert!(
            prim.is_valid(4, &mut LEGACY_SESSION.create_execution_ctx())
                .unwrap()
        );
        Ok(())
    }

    #[test]
    fn test_canonical_all_valid() -> VortexResult<()> {
        let array = MaskedArray::try_new(
            PrimitiveArray::from_iter([10i32, 20, 30]).into_array(),
            Validity::AllValid,
        )
        .unwrap();

        let canonical = array
            .into_array()
            .execute::<Canonical>(&mut LEGACY_SESSION.create_execution_ctx())?;
        assert_eq!(canonical.dtype().nullability(), Nullability::Nullable);
        assert_eq!(
            canonical
                .into_array()
                .valid_count(&mut LEGACY_SESSION.create_execution_ctx())
                .unwrap(),
            3
        );
        Ok(())
    }
}