sq3-rs 0.3.3

SQLite reader with no dependencies
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

use std::ops::Deref;

use sq3_derive::Name;
use sq3_parser::TypeName;

use crate::{result::SqliteResult, traits::ParseBytes};

/// # Schema cookie (4 Bytes)
///
///  The schema cookie is a 4-byte big-endian integer at offset 40 that is
/// incremented whenever the database schema changes. A prepared statement is
/// compiled against a specific version of the database schema. When the
/// database schema changes, the statement must be reprepared. When a prepared
/// statement runs, it first checks the schema cookie to ensure the value is the
/// same as when the statement was prepared and if the schema cookie has
/// changed, the statement either automatically reprepares and reruns or it
/// aborts with an [SQLITE_SCHEMA](https://www.sqlite.org/rescode.html#schema)
/// error.
#[derive(Debug, Default, Name)]
pub struct SchemaCookie(u32);
impl Deref for SchemaCookie {
    type Target = u32;

    fn deref(&self) -> &Self::Target {
        &self.0
    }
}

impl ParseBytes for SchemaCookie {
    const LENGTH_BYTES: usize = 4;

    fn parsing_handler(bytes: &[u8]) -> SqliteResult<Self> {
        let buf: [u8; Self::LENGTH_BYTES] = bytes.try_into()?;

        let database_size = u32::from_be_bytes(buf);

        Ok(Self(database_size))
    }
}