ant-node 0.10.1

Pure quantum-proof network node for the Autonomi decentralized network
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

//! Shared cache directory for upgrade artifacts.
//!
//! Multiple ant-node instances on the same machine share a single cache
//! directory so that release metadata and downloaded binaries are fetched only
//! once, reducing GitHub API calls and bandwidth.

use crate::error::{Error, Result};
use std::fs;
use std::path::PathBuf;

/// Return the shared upgrade cache directory, creating it on demand.
///
/// The path is `{data_dir}/upgrades/` where `data_dir` comes from
/// `directories::ProjectDirs` (e.g. `~/.local/share/ant/upgrades/` on
/// Linux).
///
/// # Errors
///
/// Returns an error if the platform data directory cannot be determined or
/// the directory cannot be created.
pub fn upgrade_cache_dir() -> Result<PathBuf> {
    let project_dirs = directories::ProjectDirs::from("", "", "ant").ok_or_else(|| {
        Error::Upgrade("Cannot determine platform data directory for upgrade cache".to_string())
    })?;

    let cache_dir = project_dirs.data_dir().join("upgrades");
    fs::create_dir_all(&cache_dir)?;

    Ok(cache_dir)
}

#[cfg(test)]
#[allow(clippy::unwrap_used, clippy::expect_used)]
mod tests {
    use super::*;

    /// Verify the function succeeds and returns a path ending in "upgrades".
    ///
    /// Note: this creates a real directory under the platform data dir.
    /// Modifying env vars to isolate this requires `unsafe` (due to
    /// `deny(unsafe_code)`), so we accept the minor side-effect.
    #[test]
    fn test_upgrade_cache_dir_returns_path() {
        let dir = upgrade_cache_dir().unwrap();
        assert!(dir.exists());
        assert!(dir.ends_with("upgrades"));
    }
}