libpass 0.4.0

library for interacting with pass managed data
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

//! General utilities used internally

use crate::{password_store_dir, PassError, Result};

use std::io;
use std::path::Path;
use std::path::PathBuf;

use directories::UserDirs;
use gpgme::{Context, Protocol};

/// Expand `~` in a path and canonicalize it afterwards
pub(crate) fn canonicalize_path<P: AsRef<Path>>(path: &P) -> io::Result<PathBuf> {
    let path = path.as_ref();
    let home_dir = UserDirs::new()
        .ok_or_else(|| {
            io::Error::new(
                io::ErrorKind::Other,
                "could not retrieve users home directory",
            )
        })?
        .home_dir()
        .to_path_buf();

    match path.strip_prefix("~") {
        // prefix was not found
        Err(_) => Ok(path.to_owned()),
        // prefix was stripped
        Ok(path) => home_dir.join(path).canonicalize(),
    }
}

/// Create a gpgme context that is initialized as we need it
pub(crate) fn create_gpg_context() -> Result<Context> {
    Ok(Context::from_protocol(Protocol::OpenPgp)?)
}

/// Transform an absolute path to a path that is relative to the password store root
pub(crate) fn abspath2relpath(path: &Path) -> Result<&Path> {
    path.strip_prefix(password_store_dir()?).map_err(|_| {
        PassError::InvalidStoreFormat(
            path.to_owned(),
            "Path is not inside password store".to_string(),
        )
    })
}

/// Decode a path to rust string and handle error in an idiomatic way
pub(crate) fn path2str(path: &Path) -> Result<&str> {
    path.to_str()
        .ok_or_else(|| PassError::PathDecodingError(path.to_owned()))
}