dlpark 0.9.0-alpha.1

dlpack Rust binding for Python
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

use crate::ffi::{DLDevice, DLDeviceType};

impl DLDevice {
    /// The process-local CPU device.
    pub const CPU: Self = Self {
        device_type: DLDeviceType::CPU,
        device_id: 0,
    };

    /// Constructs a CUDA device descriptor with the given ordinal.
    pub fn cuda(device_id: i32) -> Self {
        Self {
            device_type: DLDeviceType::CUDA,
            device_id,
        }
    }
}

impl DLDeviceType {
    /// Returns whether this device type is defined by the bundled DLPack
    /// headers.
    pub const fn is_known(self) -> bool {
        const CPU: u32 = DLDeviceType::CPU.0;
        const OPENCL: u32 = DLDeviceType::OPENCL.0;
        const VULKAN: u32 = DLDeviceType::VULKAN.0;
        const TRN: u32 = DLDeviceType::TRN.0;

        matches!(self.0, CPU..=OPENCL | VULKAN..=TRN)
    }
}

impl Default for DLDevice {
    fn default() -> Self {
        Self {
            device_type: DLDeviceType(0),
            device_id: 0,
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn device_type_knownness_tracks_bundled_header() {
        for value in [1, 2, 3, 4, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18] {
            assert!(DLDeviceType(value).is_known());
        }
        for value in [0, 5, 6, 19, u32::MAX] {
            assert!(!DLDeviceType(value).is_known());
        }
    }
}