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 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227
//! Rustic Subcommands
pub(crate) mod backup;
pub(crate) mod cat;
pub(crate) mod check;
pub(crate) mod completions;
pub(crate) mod config;
pub(crate) mod copy;
pub(crate) mod diff;
pub(crate) mod dump;
pub(crate) mod forget;
pub(crate) mod init;
pub(crate) mod key;
pub(crate) mod list;
pub(crate) mod ls;
pub(crate) mod merge;
pub(crate) mod prune;
pub(crate) mod repair;
pub(crate) mod repoinfo;
pub(crate) mod restore;
pub(crate) mod self_update;
pub(crate) mod show_config;
pub(crate) mod snapshots;
pub(crate) mod tag;
use std::path::PathBuf;
use std::sync::Arc;
use crate::{
commands::{
backup::BackupCmd, cat::CatCmd, check::CheckCmd, completions::CompletionsCmd,
config::ConfigCmd, copy::CopyCmd, diff::DiffCmd, dump::DumpCmd, forget::ForgetCmd,
init::InitCmd, key::KeyCmd, list::ListCmd, ls::LsCmd, merge::MergeCmd, prune::PruneCmd,
repair::RepairCmd, repoinfo::RepoInfoCmd, restore::RestoreCmd, self_update::SelfUpdateCmd,
show_config::ShowConfigCmd, snapshots::SnapshotCmd, tag::TagCmd,
},
config::{progress_options::ProgressOptions, RusticConfig},
{Application, RUSTIC_APP},
};
use abscissa_core::{config::Override, Command, Configurable, FrameworkError, Runnable, Shutdown};
use anyhow::{anyhow, Result};
use dialoguer::Password;
use rustic_core::{OpenStatus, Repository};
pub(super) mod constants {
pub(super) const MAX_PASSWORD_RETRIES: usize = 5;
}
/// Rustic Subcommands
/// Subcommands need to be listed in an enum.
#[derive(clap::Parser, Command, Debug, Runnable)]
enum RusticCmd {
/// Backup to the repository
Backup(BackupCmd),
/// Show raw data of repository files and blobs
Cat(CatCmd),
/// Change the repository configuration
Config(ConfigCmd),
/// Generate shell completions
Completions(CompletionsCmd),
/// Check the repository
Check(CheckCmd),
/// Copy snapshots to other repositories. Note: The target repositories must be given in the config file!
Copy(CopyCmd),
/// Compare two snapshots/paths
/// Note that the exclude options only apply for comparison with a local path
Diff(DiffCmd),
/// dump the contents of a file in a snapshot to stdout
Dump(DumpCmd),
/// Remove snapshots from the repository
Forget(ForgetCmd),
/// Initialize a new repository
Init(InitCmd),
/// Manage keys
Key(KeyCmd),
/// List repository files
List(ListCmd),
/// List file contents of a snapshot
Ls(LsCmd),
/// Merge snapshots
Merge(MergeCmd),
/// Show a detailed overview of the snapshots within the repository
Snapshots(SnapshotCmd),
/// Show the configuration which has been read from the config file(s)
ShowConfig(ShowConfigCmd),
/// Update to the latest rustic release
SelfUpdate(SelfUpdateCmd),
/// Remove unused data or repack repository pack files
Prune(PruneCmd),
/// Restore a snapshot/path
Restore(RestoreCmd),
/// Repair a snapshot/path
Repair(RepairCmd),
/// Show general information about the repository
Repoinfo(RepoInfoCmd),
/// Change tags of snapshots
Tag(TagCmd),
}
/// Entry point for the application. It needs to be a struct to allow using subcommands!
#[derive(clap::Parser, Command, Debug)]
#[command(author, about, name="rustic", version = option_env!("PROJECT_VERSION").unwrap_or(env!("CARGO_PKG_VERSION")))]
pub struct EntryPoint {
#[command(flatten)]
pub config: RusticConfig,
#[command(subcommand)]
commands: RusticCmd,
}
impl Runnable for EntryPoint {
fn run(&self) {
self.commands.run();
RUSTIC_APP.shutdown(Shutdown::Graceful)
}
}
/// This trait allows you to define how application configuration is loaded.
impl Configurable<RusticConfig> for EntryPoint {
/// Location of the configuration file
fn config_path(&self) -> Option<PathBuf> {
// Actually abscissa itself reads a config from `config_path`, but I have now returned None,
// i.e. no config is read.
None
}
/// Apply changes to the config after it's been loaded, e.g. overriding
/// values in a config file using command-line options.
fn process_config(&self, _config: RusticConfig) -> Result<RusticConfig, FrameworkError> {
// Note: The config that is "not read" is then read here in `process_config()` by the
// rustic logic and merged with the CLI options.
// That's why it says `_config`, because it's not read at all and therefore not needed.
let mut config = self.config.clone();
if config.global.use_profile.is_empty() {
config.global.use_profile.push("rustic".to_string());
}
// get global options from command line / env and config file
for profile in &config.global.use_profile.clone() {
config.merge_profile(profile)?;
}
match &self.commands {
RusticCmd::Forget(cmd) => cmd.override_config(config),
// subcommands that don't need special overrides use a catch all
_ => Ok(config),
}
}
}
/// Open the repository with the given config
///
/// # Arguments
///
/// * `config` - The config file
///
/// # Errors
///
/// * [`RepositoryErrorKind::ReadingPasswordFromReaderFailed`] - If reading the password failed
/// * [`RepositoryErrorKind::OpeningPasswordFileFailed`] - If opening the password file failed
/// * [`RepositoryErrorKind::PasswordCommandParsingFailed`] - If parsing the password command failed
/// * [`RepositoryErrorKind::ReadingPasswordFromCommandFailed`] - If reading the password from the command failed
/// * [`RepositoryErrorKind::FromSplitError`] - If splitting the password command failed
///
/// [`RepositoryErrorKind::ReadingPasswordFromReaderFailed`]: crate::error::RepositoryErrorKind::ReadingPasswordFromReaderFailed
/// [`RepositoryErrorKind::OpeningPasswordFileFailed`]: crate::error::RepositoryErrorKind::OpeningPasswordFileFailed
/// [`RepositoryErrorKind::PasswordCommandParsingFailed`]: crate::error::RepositoryErrorKind::PasswordCommandParsingFailed
/// [`RepositoryErrorKind::ReadingPasswordFromCommandFailed`]: crate::error::RepositoryErrorKind::ReadingPasswordFromCommandFailed
/// [`RepositoryErrorKind::FromSplitError`]: crate::error::RepositoryErrorKind::FromSplitError
fn open_repository(config: &Arc<RusticConfig>) -> Result<Repository<ProgressOptions, OpenStatus>> {
let po = config.global.progress_options;
let repo = Repository::new_with_progress(&config.repository, po)?;
match repo.password()? {
// if password is given, directly return the result of find_key_in_backend and don't retry
Some(pass) => {
return Ok(repo.open_with_password(&pass)?);
}
None => {
for _ in 0..constants::MAX_PASSWORD_RETRIES {
let pass = Password::new()
.with_prompt("enter repository password")
.allow_empty_password(true)
.interact()?;
match repo.clone().open_with_password(&pass) {
Ok(repo) => return Ok(repo),
// TODO: fail if error != Password incorrect
Err(_) => continue,
}
}
}
}
Err(anyhow!("incorrect password"))
}
#[cfg(test)]
mod tests {
use crate::commands::EntryPoint;
use clap::CommandFactory;
#[test]
fn verify_cli() {
EntryPoint::command().debug_assert();
}
}