shardline 1.0.0

Self-hosted Shardline CAS server and operator CLI for Git/Xet storage workflows.
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

use std::{io::Error as IoError, path::Path};

use shardline_server::{
    BackupManifestReport, ServerConfigError, ServerError,
    write_backup_manifest as write_server_backup_manifest,
};
use thiserror::Error;

use crate::{config::load_server_config, local_output::write_output_bytes};

/// Backup command runtime failure.
#[derive(Debug, Error)]
pub enum BackupRuntimeError {
    /// Configuration loading failed.
    #[error(transparent)]
    Config(#[from] ServerConfigError),
    /// Backup manifest writing failed due to an operational server-side error.
    #[error(transparent)]
    Server(#[from] ServerError),
    /// Output file creation failed.
    #[error("backup manifest output file operation failed")]
    Io(#[from] IoError),
}

/// Writes a backup manifest for the active deployment.
///
/// # Errors
///
/// Returns [`BackupRuntimeError`] when configuration loading, output creation, metadata
/// enumeration, or object inventory fails.
pub async fn run_backup_manifest(
    root: Option<&Path>,
    output: &Path,
) -> Result<BackupManifestReport, BackupRuntimeError> {
    let config = load_server_config(root)?;
    let mut manifest = Vec::new();
    let report = write_server_backup_manifest(config, &mut manifest).await?;
    write_output_bytes(output, &manifest, false)?;
    Ok(report)
}