vortex_array/extension/uuid/
metadata.rs

1// SPDX-License-Identifier: Apache-2.0
2// SPDX-FileCopyrightText: Copyright the Vortex contributors
3
4use std::fmt;
5use std::hash::Hash;
6use std::hash::Hasher;
7
8use uuid::Version;
9use vortex_error::VortexResult;
10use vortex_error::vortex_bail;
11
12/// Converts a `u8` discriminant back to a [`uuid::Version`].
13pub(crate) fn u8_to_version(b: u8) -> VortexResult<Version> {
14    match b {
15        0 => Ok(Version::Nil),
16        1 => Ok(Version::Mac),
17        2 => Ok(Version::Dce),
18        3 => Ok(Version::Md5),
19        4 => Ok(Version::Random),
20        5 => Ok(Version::Sha1),
21        6 => Ok(Version::SortMac),
22        7 => Ok(Version::SortRand),
23        8 => Ok(Version::Custom),
24        // UUID crate changed from 0xff to 0x0f for maximum uuid version in 1.23.0
25        0x0f => Ok(Version::Max),
26        0xff => Ok(Version::Max),
27        _ => vortex_bail!("unknown UUID version discriminant: {b}"),
28    }
29}
30
31/// Metadata for the UUID extension type.
32///
33/// Optionally records which UUID version the column contains (e.g. v4 random, v7
34/// sort-random). When `None`, the column may contain any mix of versions.
35#[derive(Clone, Debug, Default)]
36pub struct UuidMetadata {
37    /// The UUID version, if known.
38    pub version: Option<Version>,
39}
40
41impl fmt::Display for UuidMetadata {
42    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
43        match self.version {
44            None => write!(f, ""),
45            Some(v) => write!(f, "v{}", v as u8),
46        }
47    }
48}
49
50// `uuid::Version` derives `PartialEq` but not `Eq` or `Hash`, so we implement these
51// manually using the `#[repr(u8)]` discriminant.
52
53impl PartialEq for UuidMetadata {
54    fn eq(&self, other: &Self) -> bool {
55        self.version.map(|v| v as u8) == other.version.map(|v| v as u8)
56    }
57}
58
59impl Eq for UuidMetadata {}
60
61impl Hash for UuidMetadata {
62    fn hash<H: Hasher>(&self, state: &mut H) {
63        self.version.map(|v| v as u8).hash(state);
64    }
65}
vortex_array/extension/uuid/metadata.rs

vortex_array/extension/uuid/
metadata.rs
