readstor 0.6.0

A CLI for Apple Books annotations
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

//! Utilities for working with Apple Books.

use std::collections::HashSet;
use std::path::PathBuf;

use once_cell::sync::Lazy;
use plist::Value;
use sysinfo::System;

/// Returns the version Apple Books for macOS as `v[short]-[long]` e.g. `v3.2-2217`.
///
/// * Returns `v?` if the Apple Books application cannot be found.
/// * Returns `v[short]-?`, `v?-[long]` or `v?-?` depending on what version numbers can be located.
pub static APPLEBOOKS_VERSION: Lazy<String> = Lazy::new(|| {
    let path: PathBuf = [
        "/",
        "System",
        "Applications",
        "Books.app",
        "Contents",
        "Info.plist",
    ]
    .iter()
    .collect();

    let Ok(value) = Value::from_file(path) else {
        // This can happen if the user is on a non-macOS device.
        log::warn!("could not determine Apple Books version");
        return "v?".to_owned();
    };

    // -> 3.2
    let version_short = value
        .as_dictionary()
        .and_then(|d| d.get("CFBundleShortVersionString"))
        .and_then(plist::Value::as_string)
        .unwrap_or_else(|| {
            log::warn!("could not determine 'CFBundleShortVersionString'");
            "?"
        });

    // -> 2217
    let version_long = value
        .as_dictionary()
        .and_then(|d| d.get("CFBundleVersion"))
        .and_then(plist::Value::as_string)
        .unwrap_or_else(|| {
            log::warn!("could not determine 'CFBundleVersion'");
            "?"
        });

    // v3.2-2217
    format!("v{version_short}-{version_long}")
});

/// Returns a boolean based on if Apple Books is running or not.
#[must_use]
pub fn applebooks_is_running() -> bool {
    let process_names: HashSet<String> = System::new_all()
        .processes()
        .values()
        .map(|process| process.name().to_string_lossy())
        .map(String::from)
        .collect();

    // "Returns true if self has no elements in common with other. This is equivalent to checking
    // for an empty intersection."
    //
    // https://doc.rust-lang.org/std/collections/hash_set/struct.HashSet.html#method.is_disjoint
    !super::defaults::APPLEBOOKS_NAMES.is_disjoint(&process_names)
}