Method finalize

atomic-core/src/change/format_v3/writer/state_machine.rs:420–438

Finalize the change file by writing the trailer. This computes the final blake3 content hash from all hashed sections written so far, writes the 32-byte trailer, and returns the [`WriteOutcome`] containing the hash and statistics. After calling this, the writer is consumed and no more writes are possible. # Required Sections The following sections must have been written before finalizing: - Fi

(mut self)

    /// - [`FormatError::UnexpectedSection`] if required sections are missing.
    /// - I/O errors from writing the trailer.
    pub fn finalize(mut self) -> FormatResult<WriteOutcome> {
        self.ensure_metadata_complete()?;

        // Compute the final hash
        let hash = self.hasher.finalize();
        let content_hash = *hash.as_bytes();

        // Write the trailer
        let trailer = Trailer { content_hash };
        trailer.write_to(self.writer)?;
        self.stats.total_bytes_written += Trailer::SIZE as u64;

        self.state = WriterState::Finalized;

        Ok(WriteOutcome {
            content_hash,
            stats: self.stats,
        })
    }

    // ── Low-Level: Pre-Compressed Section ──────────────────────────