Enum FileSourceFormat 

pub enum FileSourceFormat {
    Auto,
    JsonLines,
    JsonArray,
    Csv,
    Xml,
    Xlsx,
    Parquet,
    RawText,
    Avro,
    Orc,
}

The format choice — auto by extension, per file, or one fixed format. Shared with the file sink through faucet-common-file. Which format a file is in: resolved from its extension (auto) or fixed.

Variants

Auto

Resolve per file from its extension, looking through a compression suffix (.csv.gz is CSV): .jsonl/.ndjson, .json, .csv, .xml, .xlsx, .parquet, .avro, .orc, .txt.

JsonLines

One JSON value per line.

JsonArray

A JSON array (a lone object is one record).

Csv

Delimited text; dialect from csv.

Xml

XML; record framing from xml.

Xlsx

An Excel workbook; sheet from excel.

Parquet

Apache Parquet.

RawText

Unparsed text, one record per file.

Avro

Apache Avro Object Container File; schema and codec from avro.

Orc

Apache ORC (read-only); projection from orc.

Implementations

impl FileFormatChoice

pub fn explicit(self) -> Option<FileFormat>

The explicit format, or None for auto.

pub fn resolve( self, name: &str, strict: bool, ) -> Result<Option<FileFormat>, FaucetError>

The format of the file called name (a path or a URL’s last segment).

Ok(None) when auto finds no format and strict is off — the caller skips the file; with strict it is an error naming the file.

impl FileFormatChoice

pub fn resolve_writable(self, name: &str) -> Result<FileFormat, FaucetError>

The format a file called name is written in: the explicit format, or the one its extension names. Refuses a name with no recognised extension and ORC, which has no writer.

Trait Implementations

impl Clone for FileFormatChoice

fn clone(&self) -> FileFormatChoice

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for FileFormatChoice

impl Debug for FileFormatChoice

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

Formats the value using the given formatter.

impl Default for FileFormatChoice

fn default() -> FileFormatChoice

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FileFormatChoice

fn deserialize<__D>( __deserializer: __D, ) -> Result<FileFormatChoice, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for FileFormatChoice

impl JsonSchema for FileFormatChoice

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for FileFormatChoice

fn eq(&self, other: &FileFormatChoice) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for FileFormatChoice

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FileFormatChoice