30 releases (19 stable)

2.4.0 Feb 22, 2025
2.2.2 Dec 17, 2024
2.2.1 Nov 26, 2024
1.9.0 Jun 10, 2024
0.1.4 Dec 30, 2022

#936 in Database interfaces

Download history 169/week @ 2024-11-17 475/week @ 2024-11-24 293/week @ 2024-12-01 368/week @ 2024-12-08 395/week @ 2024-12-15 196/week @ 2024-12-22 170/week @ 2024-12-29 221/week @ 2025-01-05 275/week @ 2025-01-12 139/week @ 2025-01-19 113/week @ 2025-01-26 197/week @ 2025-02-02 137/week @ 2025-02-09 187/week @ 2025-02-16 228/week @ 2025-02-23 112/week @ 2025-03-02

694 downloads per month
Used in imessage-exporter

GPL-3.0-or-later

1MB
16K SLoC

imessage-database

This library provides interfaces to interact with iMessage Databases.

Installation

This library is available on crates.io.

Documentation

Documentation is available on docs.rs.

Example

use imessage_database::{
    error::table::TableError,
    tables::{
        messages::Message,
        table::{get_connection, Table},
    },
    util::dirs::default_db_path,
};

fn iter_messages() -> Result<(), TableError> {
    /// Create a read-only connection to an iMessage database
    let db = get_connection(&default_db_path()).unwrap();

    /// Create SQL statement
    let mut statement = Message::get(&db)?;

    /// Execute statement
    let messages = statement
        .query_map([], |row| Ok(Message::from_row(row)))
        .unwrap();

    /// Iterate over each row
    for message in messages {
        let mut msg = Message::extract(message)?;

        /// Deserialize message body
        msg.generate_text(&db);

        /// Emit debug info for each message
        println!("{:#?}", msg)
    }

    Ok(())
}

Dependencies

~31MB
~592K SLoC