Open YAML file

Open a YAML file (YAML/yml) to load tabular data.

Supported top-level shapes:

A list of mappings - each mapping is one record (most common).

A mapping whose values are lists - column oriented (each list must have the same length).

A single mapping with scalar values - one record.

Nested mappings are flattened into dotted column names, e.g. meta.vip becomes the column "meta.vip".

Block scalars (| and >), comments, blank lines inside text and flow style values are supported.

Encoding: the file encoding (default Auto Detect; UTF-8 recommended).

Large flat files are streamed in chunks to keep memory low.

Notes: anchors/aliases, multi-document (---/...), tags and tab indentation are not supported and are reported with an error message.

---