geopackage-core 0.5.0

No-IO core for the OGC GeoPackage format: GeoPackage Binary (GPB) codec, table DDL, RTree trigger definitions, and validation rules
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

//! GeoPackage file identity: SQLite `application_id` and `user_version` pragmas.

/// `application_id` for GeoPackage 1.2+: "GPKG".
pub const APPLICATION_ID_GPKG: u32 = 0x4750_4B47;
/// Legacy `application_id` for GeoPackage 1.0: "GP10".
pub const APPLICATION_ID_GP10: u32 = 0x4750_3130;
/// Legacy `application_id` for GeoPackage 1.1: "GP11".
pub const APPLICATION_ID_GP11: u32 = 0x4750_3131;

/// GeoPackage specification version, as declared by a file's pragmas.
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord)]
#[non_exhaustive]
pub enum GpkgVersion {
    /// GeoPackage 1.0 (`application_id` "GP10").
    V1_0,
    /// GeoPackage 1.1 (`application_id` "GP11").
    V1_1,
    /// GeoPackage 1.2.x (`user_version` 102xx).
    V1_2,
    /// GeoPackage 1.3.x (`user_version` 103xx).
    V1_3,
    /// GeoPackage 1.4.x (`user_version` 104xx).
    V1_4,
}

impl GpkgVersion {
    /// Classify a file from its `application_id` and `user_version` pragmas.
    ///
    /// Returns `None` if the pragmas do not identify a GeoPackage.
    /// `user_version` values above the newest known 104xx range map to
    /// `V1_4` (per spec, clients should attempt to read newer minor versions).
    pub fn from_pragmas(application_id: u32, user_version: u32) -> Option<Self> {
        match application_id {
            APPLICATION_ID_GP10 => Some(Self::V1_0),
            APPLICATION_ID_GP11 => Some(Self::V1_1),
            APPLICATION_ID_GPKG => match user_version / 100 {
                102 => Some(Self::V1_2),
                103 => Some(Self::V1_3),
                v if v >= 104 => Some(Self::V1_4),
                _ => None,
            },
            _ => None,
        }
    }

    /// The `user_version` this crate writes for the given version
    /// (`None` for 1.0/1.1, which predate `user_version` use).
    pub fn user_version(self) -> Option<u32> {
        match self {
            Self::V1_0 | Self::V1_1 => None,
            Self::V1_2 => Some(10200),
            Self::V1_3 => Some(10300),
            Self::V1_4 => Some(10400),
        }
    }
}

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

    #[test]
    fn classification() {
        assert_eq!(
            GpkgVersion::from_pragmas(APPLICATION_ID_GPKG, 10400),
            Some(GpkgVersion::V1_4)
        );
        assert_eq!(
            GpkgVersion::from_pragmas(APPLICATION_ID_GPKG, 10201),
            Some(GpkgVersion::V1_2)
        );
        // future minor versions read as newest-known
        assert_eq!(
            GpkgVersion::from_pragmas(APPLICATION_ID_GPKG, 10500),
            Some(GpkgVersion::V1_4)
        );
        assert_eq!(
            GpkgVersion::from_pragmas(APPLICATION_ID_GP10, 0),
            Some(GpkgVersion::V1_0)
        );
        assert_eq!(GpkgVersion::from_pragmas(0x1234_5678, 10400), None);
        assert_eq!(GpkgVersion::from_pragmas(APPLICATION_ID_GPKG, 0), None);
    }
}