Struct ArchiveCreator 

pub struct ArchiveCreator { /* private fields */ }

Builder for creating archives with fluent API.

Provides a convenient, type-safe interface for configuring and creating archives with various compression formats and security options.

Examples

use exarch_core::creation::ArchiveCreator;

let report = ArchiveCreator::new()
    .output("backup.tar.gz")
    .add_source("src/")
    .add_source("Cargo.toml")
    .compression_level(9)
    .create()?;

println!("Created archive with {} files", report.files_added);

Implementations

impl ArchiveCreator

pub fn new() -> Self

Creates a new ArchiveCreator with default settings.

Examples

use exarch_core::creation::ArchiveCreator;

let creator = ArchiveCreator::new();

pub fn output<P: AsRef<Path>>(self, path: P) -> Self

Sets the output archive path.

The archive format is auto-detected from the file extension unless explicitly set via format().

Examples

use exarch_core::creation::ArchiveCreator;

let creator = ArchiveCreator::new().output("backup.tar.gz");

pub fn add_source<P: AsRef<Path>>(self, path: P) -> Self

Adds a source file or directory.

Examples

use exarch_core::creation::ArchiveCreator;

let creator = ArchiveCreator::new()
    .add_source("src/")
    .add_source("Cargo.toml");

pub fn sources<P: AsRef<Path>>(self, paths: &[P]) -> Self

Adds multiple source files or directories.

Examples

use exarch_core::creation::ArchiveCreator;

let creator = ArchiveCreator::new().sources(&["src/", "Cargo.toml", "README.md"]);

pub fn config(self, config: CreationConfig) -> Self

Sets the full configuration.

Examples

use exarch_core::creation::ArchiveCreator;
use exarch_core::creation::CreationConfig;

let config = CreationConfig::default().with_follow_symlinks(true);

let creator = ArchiveCreator::new().config(config);

pub fn compression_level(self, level: u8) -> Self

Sets the compression level (1-9).

Higher values provide better compression but slower speed.

Examples

use exarch_core::creation::ArchiveCreator;

let creator = ArchiveCreator::new().compression_level(9); // Maximum compression

pub fn follow_symlinks(self, follow: bool) -> Self

Sets whether to follow symlinks.

Default: false (symlinks stored as symlinks).

Examples

use exarch_core::creation::ArchiveCreator;

let creator = ArchiveCreator::new().follow_symlinks(true);

pub fn include_hidden(self, include: bool) -> Self

Sets whether to include hidden files.

Default: false (skip hidden files).

Examples

use exarch_core::creation::ArchiveCreator;

let creator = ArchiveCreator::new().include_hidden(true);

pub fn exclude<S: Into<String>>(self, pattern: S) -> Self

Adds an exclude pattern.

Files matching this pattern will be skipped.

Examples

use exarch_core::creation::ArchiveCreator;

let creator = ArchiveCreator::new().exclude("*.log").exclude("target/");

pub fn strip_prefix<P: AsRef<Path>>(self, prefix: P) -> Self

Sets the strip prefix for archive paths.

If set, this prefix will be removed from all entry paths in the archive.

Examples

use exarch_core::creation::ArchiveCreator;

let creator = ArchiveCreator::new().strip_prefix("/base/path");

pub fn format(self, format: ArchiveType) -> Self

Sets explicit archive format.

If not set, format is auto-detected from output file extension.

Examples

use exarch_core::creation::ArchiveCreator;
use exarch_core::formats::detect::ArchiveType;

let creator = ArchiveCreator::new().format(ArchiveType::TarGz);

pub fn create(self) -> Result<CreationReport>

Creates the archive.

Errors

Returns an error if:

• Output path not set
• No sources provided
• Source files don’t exist
• I/O errors during creation
• Invalid configuration (e.g., invalid compression level)

Examples

use exarch_core::creation::ArchiveCreator;

let report = ArchiveCreator::new()
    .output("backup.tar.gz")
    .add_source("src/")
    .create()?;

Trait Implementations

impl Debug for ArchiveCreator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ArchiveCreator

fn default() -> ArchiveCreator

Returns the “default value” for a type.