Struct PopulationWriter 

pub struct PopulationWriter<'cache> { /* private fields */ }

Exclusive write-only owner of a staged GSYM file.

Dropping the writer removes the unpublished temporary file and releases the population lock.

Implementations

impl PopulationWriter<'_>

pub fn record_failure_for( self, kind: FailureKind, lifetime: Duration, ) -> Result<CachedFailure>

Atomically records an expiring population failure and discards staged output.

Errors

Returns an error if lifetime is zero, exceeds MAX_FAILURE_TTL, cannot be represented, or the record cannot be published.

pub fn publish(self) -> Result<PublishOutcome>

Verifies and atomically publishes the staged GSYM file.

Publication consumes the writer. A racing winner is validated and returned instead of being replaced.

Errors

Returns an error if verification fails, the GSYM build identifier differs from the cache key, or durable publication fails.

Trait Implementations

impl Debug for PopulationWriter<'_>

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

Formats the value using the given formatter.

impl Write for PopulationWriter<'_>

fn write(&mut self, buffer: &[u8]) -> Result<usize>

Writes a buffer into this writer, returning how many bytes were written.

fn flush(&mut self) -> Result<()>

Flushes this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

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

Determines if this Writer has an efficient write_vectored implementation.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>

Attempts to write an entire buffer into this writer.

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>

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

Attempts to write multiple buffers into this writer.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Write.