Struct OpenOptions 

pub struct OpenOptions {

    pub delimiter: Option<u8>,
    pub has_header: Option<bool>,
    pub skip_lines: Option<usize>,
    pub skip_rows: Option<usize>,
    pub skip_tail_rows: Option<usize>,
    pub compression: Option<CompressionFormat>,
    pub format: Option<FileFormat>,
    pub pages_lookahead: Option<usize>,
    pub pages_lookback: Option<usize>,
    pub max_buffered_rows: Option<usize>,
    pub max_buffered_mb: Option<usize>,
    pub row_numbers: bool,
    pub row_start_index: usize,
    pub hive: bool,
    pub single_spine_schema: bool,
    pub parse_dates: bool,
    pub parse_strings: Option<ParseStringsTarget>,
    pub parse_strings_sample_rows: usize,
    pub decompress_in_memory: bool,
    pub temp_dir: Option<PathBuf>,
    pub excel_sheet: Option<String>,
    pub s3_endpoint_url_override: Option<String>,
    pub s3_access_key_id_override: Option<String>,
    pub s3_secret_access_key_override: Option<String>,
    pub s3_region_override: Option<String>,
    pub polars_streaming: bool,
    pub workaround_pivot_date_index: bool,
    pub null_values: Option<Vec<String>>,
    pub infer_schema_length: Option<usize>,
    pub ignore_errors: bool,
    pub debug: bool,
}

Fields

delimiter: Option<u8>

has_header: Option<bool>

skip_lines: Option<usize>

skip_rows: Option<usize>

skip_tail_rows: Option<usize>

Skip this many rows at the end of the file (e.g. vendor footer or trailing garbage). Applied after load for CSV.

compression: Option<CompressionFormat>

format: Option<FileFormat>

When set, bypass extension-based format detection and use this format (e.g. for URLs or temp files without extension).

pages_lookahead: Option<usize>

pages_lookback: Option<usize>

max_buffered_rows: Option<usize>

max_buffered_mb: Option<usize>

row_numbers: bool

row_start_index: usize

hive: bool

When true, use hive load path for directory/glob; single file uses normal load.

single_spine_schema: bool

When true (default), infer Hive/partitioned Parquet schema from one file for faster “Caching schema”. When false, use Polars collect_schema().

parse_dates: bool

When true, CSV reader tries to parse string columns as dates (e.g. YYYY-MM-DD, ISO datetime).

parse_strings: Option<ParseStringsTarget>

When set, trim and parse CSV string columns: None = off, Some(true) = all columns, Some(cols) = those columns only.

parse_strings_sample_rows: usize

Sample size (rows) for inferring types when parse_strings is enabled; single file or multiple/partitioned.

decompress_in_memory: bool

When true, decompress compressed CSV into memory (eager read). When false (default), decompress to a temp file and use lazy scan.

temp_dir: Option<PathBuf>

Directory for decompression temp files. None = system default (e.g. TMPDIR).

excel_sheet: Option<String>

Excel sheet: 0-based index or sheet name (CLI only).

s3_endpoint_url_override: Option<String>

S3/compatible overrides (env + CLI). Take precedence over config when building CloudOptions.

s3_access_key_id_override: Option<String>

s3_secret_access_key_override: Option<String>

s3_region_override: Option<String>

polars_streaming: bool

When true, use Polars streaming engine for LazyFrame collect when the streaming feature is enabled.

workaround_pivot_date_index: bool

When true, cast Date/Datetime pivot index columns to Int32 before pivot to avoid Polars 0.52 panic.

null_values: Option<Vec<String>>

Null value specs for CSV: global strings and/or “COL=VAL” for per-column. Empty = use Polars default.

infer_schema_length: Option<usize>

Number of rows to use when inferring CSV schema. None = Polars default (100). Larger values reduce risk of inferring wrong type (e.g. int then N/A).

ignore_errors: bool

When true, CSV reader ignores parse errors and continues with the next batch.

debug: bool

When true, show the debug overlay (session info, performance, query, etc.).

Implementations

impl OpenOptions

pub fn new() -> Self

impl OpenOptions

pub fn with_skip_lines(self, skip_lines: usize) -> Self

pub fn with_skip_rows(self, skip_rows: usize) -> Self

pub fn with_delimiter(self, delimiter: u8) -> Self

pub fn with_has_header(self, has_header: bool) -> Self

pub fn with_compression(self, compression: CompressionFormat) -> Self

pub fn with_workaround_pivot_date_index( self, workaround_pivot_date_index: bool, ) -> Self

pub fn csv_try_parse_dates(&self) -> bool

When loading CSV: use Polars try_parse_dates only if parse_strings is not set. When parse_strings is set we do our own date parsing (with strict: false), so we disable Polars’ try_parse_dates to avoid “could not find an appropriate format” errors.

impl OpenOptions

pub fn from_args_and_config(args: &Args, config: &AppConfig) -> Self

Create OpenOptions from CLI args and config, with CLI args taking precedence

Trait Implementations

impl Clone for OpenOptions

fn clone(&self) -> OpenOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for OpenOptions

fn default() -> Self

Returns the “default value” for a type.

impl From<&Args> for OpenOptions

fn from(args: &Args) -> Self

Converts to this type from the input type.