Struct SaltCacheSaver 

pub struct SaltCacheSaver { /* private fields */ }

Receiver that collects and persists cache entries to disk.

Created paired with a SaltCacheSender via create_writer. After all parallel work completes, call save to collect entries, merge with any existing on-disk cache, and serialize via rkyv.

This type is not Sync — it should only be used on the main thread after rayon work completes.

Drop safety

Drop is implemented as a safety net: if save is not called (e.g. due to a panic during parallel decryption), any entries already buffered in the channel are still persisted. This honors the module-level contract that partial progress is preserved on error.

Implementations

impl SaltCacheSaver

pub fn save(self)

Persist all collected entries to disk (best-effort, atomic).

1. Collects all (key, entry) pairs currently buffered in the channel via mpsc::Receiver::try_iter (non-blocking — by the time this is called, all rayon workers have finished, so every sent entry is already buffered).
2. Merges with any existing on-disk cache (existing entries are kept only if no new entry overrides them).
3. Serializes via rkyv and writes atomically to <repo>/.git/<CACHE_FILENAME>.

Safe to call exactly once; a paired Drop impl guards the panic-on-drop path. Errors are logged but not propagated because cache persistence is non-critical: losing the cache only means the next encryption uses fresh salts.

Trait Implementations

impl Drop for SaltCacheSaver

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.