vortex-array 0.70.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

// 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;

    fn masked_all_valid() -> MaskedArray {
        MaskedArray::try_new(
            PrimitiveArray::from_iter([1i32, 2, 3]).into_array(),
            Validity::AllValid,
        )
        .expect("valid masked array")
    }

    fn masked_with_nulls() -> MaskedArray {
        MaskedArray::try_new(
            PrimitiveArray::from_iter([1i32, 2, 3]).into_array(),
            Validity::from_iter([true, false, true]),
        )
        .expect("valid masked array")
    }

    #[rstest]
    #[case(masked_all_valid(), Nullability::Nullable)]
    #[case(masked_with_nulls(), 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]),
        )?;

        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)?, 3);
        assert!(prim.is_valid(0, &mut LEGACY_SESSION.create_execution_ctx())?);
        assert!(!prim.is_valid(1, &mut LEGACY_SESSION.create_execution_ctx())?);
        assert!(prim.is_valid(2, &mut LEGACY_SESSION.create_execution_ctx())?);
        assert!(!prim.is_valid(3, &mut LEGACY_SESSION.create_execution_ctx())?);
        assert!(prim.is_valid(4, &mut LEGACY_SESSION.create_execution_ctx())?);
        Ok(())
    }

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

        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())?,
            3
        );
        Ok(())
    }
}