Interface Archive

atomic-repository/src/archive.rs:655–679

Trait for archive implementations. This trait abstracts over different archive formats, allowing the same archive logic to work with tarballs, zip files, or directories.

/// This trait abstracts over different archive formats, allowing
/// the same archive logic to work with tarballs, zip files, or directories.
pub trait Archive {
    /// The file writer type for this archive.
    type Writer: Write;

    /// Error type for this archive.
    type Error: std::error::Error + 'static;

    /// Create a new file in the archive.
    fn create_file(
        &mut self,
        path: &str,
        size: u64,
        mode: u32,
        mtime: u64,
    ) -> Result<Self::Writer, Self::Error>;

    /// Create a directory in the archive.
    fn create_directory(&mut self, path: &str, mode: u32, mtime: u64) -> Result<(), Self::Error>;

    /// Close a file writer.
    fn close_file(&mut self, writer: Self::Writer) -> Result<(), Self::Error>;

    /// Finish writing the archive.
    fn finish(self) -> Result<(), Self::Error>;
}

// Directory Archive