Struct WriteConfig 

pub struct WriteConfig {
    pub(crate) out_path: Option<PathBuf>,
    pub(crate) format: OutFormat,
    pub(crate) overwrite: bool,
    pub(crate) compression: Option<ParquetCompression>,
    pub(crate) compression_level: Option<u32>,
}

Output configuration for writing Arrow data.

Captures the output file path, format, compression settings, and overwrite behavior. Created separately from ReadStatPath, which handles only input path validation.

Fields are private and validated by the builder methods; read them via the accessor methods. This prevents constructing a config that bypasses path, extension, and compression-level validation.

Fields

out_path: Option<PathBuf>

Optional output file path.

format: OutFormat

Output format (defaults to CSV).

overwrite: bool

Whether to overwrite an existing output file.

compression: Option<ParquetCompression>

Optional Parquet compression algorithm.

compression_level: Option<u32>

Optional Parquet compression level.

Implementations

impl WriteConfig

pub fn from_output(path: impl Into<PathBuf>) -> Result<Self, ReadStatError>

Infers the format from an output path and returns a validated config.

Errors

Returns ReadStatError if the path has an unknown extension or fails normal output-path validation.

pub const fn new(format: OutFormat) -> Self

Starts a validated configuration for format. CSV defaults to stdout; other formats require output before writer creation.

pub fn output(self, path: impl Into<PathBuf>) -> Result<Self, ReadStatError>

Sets and validates the output path.

pub const fn overwrite(self, overwrite: bool) -> Self

Controls atomic publication when the writer is successfully finished. When false, publication fails rather than replacing a destination that appeared while the output was being written.

pub fn compression( self, codec: ParquetCompression, level: Option<u32>, ) -> Result<Self, ReadStatError>

Sets and validates Parquet compression.

pub(crate) fn validate(&self) -> Result<(), ReadStatError>

pub fn out_path(&self) -> Option<&Path>

The validated output path, or None to write CSV to stdout.

pub const fn format(&self) -> OutFormat

The output format.

pub const fn is_overwrite(&self) -> bool

Whether an existing output file may be overwritten.

pub const fn compression_codec(&self) -> Option<ParquetCompression>

The configured Parquet compression codec, if any.

pub const fn compression_level(&self) -> Option<u32>

The configured Parquet compression level, if any.

fn validate_out_extension( path: &Path, format: OutFormat, ) -> Result<Option<PathBuf>, ReadStatError>

Validates the output file extension matches the format.

fn validate_out_path( path: Option<PathBuf>, ) -> Result<Option<PathBuf>, ReadStatError>

Validates the output path exists and handles overwrite logic.

fn validate_compression_level( compression: ParquetCompression, compression_level: Option<u32>, ) -> Result<Option<u32>, ReadStatError>

Validates compression level is valid for the given compression algorithm.

Trait Implementations

impl Clone for WriteConfig

fn clone(&self) -> WriteConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WriteConfig

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

Formats the value using the given formatter.