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 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176
// Copyright (C) 2019-2021 Aleo Systems Inc.
// This file is part of the aleo-std library.
// The aleo-std library is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
// The aleo-std library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
// You should have received a copy of the GNU General Public License
// along with the aleo-std library. If not, see <https://www.gnu.org/licenses/>.
use dirs::home_dir;
use std::path::PathBuf;
/// The directory name for Aleo-related resources.
const ALEO_DIRECTORY: &str = ".aleo";
///
/// Returns the directory for accessing resources from Aleo storage.
/// The expected directory path to be returned is `~/.aleo/`.
///
pub fn aleo_dir() -> PathBuf {
// Locate the home directory as the starting point.
// If called on a non-standard OS, use the repository directory.
let mut path = match home_dir() {
Some(home) => home,
None => PathBuf::from(env!("CARGO_MANIFEST_DIR")),
};
// Append the Aleo directory to the path.
path.push(ALEO_DIRECTORY);
path
}
///
/// Returns the directory for accessing the ledger files from Aleo storage.
///
/// In production mode, the expected directory path is `~/.aleo/storage/ledger-{network}`.
/// In development mode, the expected directory path is `/path/to/repo/.ledger-{network}-{id}`.
///
pub fn aleo_ledger_dir(network: u16, dev: Option<u16>) -> PathBuf {
// Retrieve the starting directory.
let mut path = match dev.is_some() {
// In development mode, the ledger is stored in the repository root directory.
true => match std::env::current_dir() {
Ok(current_dir) => current_dir,
_ => PathBuf::from(env!("CARGO_MANIFEST_DIR")),
},
// In production mode, the ledger is stored in the `~/.aleo/` directory.
false => aleo_dir(),
};
// Construct the path to the ledger in storage.
match dev {
// In development mode, the ledger files are stored in a hidden folder.
Some(id) => {
path.push(format!(".ledger-{}-{}", network, id));
path
}
// In production mode, the ledger files are stored in a visible folder.
None => {
path.push("storage");
path.push(format!("ledger-{}", network));
path
}
}
}
///
/// Returns the directory for accessing the operator files from Aleo storage.
///
/// In production mode, the expected directory path is `~/.aleo/storage/operator-{network}`.
/// In development mode, the expected directory path is `/path/to/repo/.operator-{network}-{id}`.
///
pub fn aleo_operator_dir(network: u16, dev: Option<u16>) -> PathBuf {
// Retrieve the starting directory.
let mut path = match dev.is_some() {
// In development mode, the operator is stored in the repository root directory.
true => match std::env::current_dir() {
Ok(current_dir) => current_dir,
_ => PathBuf::from(env!("CARGO_MANIFEST_DIR")),
},
// In production mode, the operator is stored in the `~/.aleo/` directory.
false => aleo_dir(),
};
// Construct the path to the operator in storage.
match dev {
// In development mode, the operator files are stored in a hidden folder.
Some(id) => {
path.push(format!(".operator-{}-{}", network, id));
path
}
// In production mode, the operator files are stored in a visible folder.
None => {
path.push("storage");
path.push(format!("operator-{}", network));
path
}
}
}
///
/// Returns the directory for accessing the prover files from Aleo storage.
///
/// In production mode, the expected directory path is `~/.aleo/storage/prover-{network}`.
/// In development mode, the expected directory path is `/path/to/repo/.prover-{network}-{id}`.
///
pub fn aleo_prover_dir(network: u16, dev: Option<u16>) -> PathBuf {
// Retrieve the starting directory.
let mut path = match dev.is_some() {
// In development mode, the prover is stored in the repository root directory.
true => match std::env::current_dir() {
Ok(current_dir) => current_dir,
_ => PathBuf::from(env!("CARGO_MANIFEST_DIR")),
},
// In production mode, the prover is stored in the `~/.aleo/` directory.
false => aleo_dir(),
};
// Construct the path to the prover in storage.
match dev {
// In development mode, the prover files are stored in a hidden folder.
Some(id) => {
path.push(format!(".prover-{}-{}", network, id));
path
}
// In production mode, the prover files are stored in a visible folder.
None => {
path.push("storage");
path.push(format!("prover-{}", network));
path
}
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_aleo_dir() {
println!("{:?} exists: {:?}", aleo_dir(), aleo_dir().exists());
}
#[test]
fn test_aleo_ledger_dir() {
println!(
"{:?} exists: {:?}",
aleo_ledger_dir(2, None),
aleo_ledger_dir(2, None).exists()
);
}
#[test]
fn test_aleo_operator_dir() {
println!(
"{:?} exists: {:?}",
aleo_operator_dir(2, None),
aleo_operator_dir(2, None).exists()
);
}
#[test]
fn test_aleo_prover_dir() {
println!(
"{:?} exists: {:?}",
aleo_prover_dir(2, None),
aleo_prover_dir(2, None).exists()
);
}
}
