Parquet files (.parquet)
A Parquet file opens as its shape, read from the footer alone, with no library and no data pages read.
- Page: a file page shows a summary line (rows, columns, row groups, size), who wrote it, a table of columns (name, physical type, logical type, repetition, compression codecs) and a table of row groups (rows and bytes each). At most 500 columns and 50 row groups are listed, with a line saying so.
- Terminal: the workspace opens the same file with the same reader and cap (
src/tui/screens/workspace_parquet.ts) as a table of columns with the same five fields; its first row is the summary sentence (3 rows · 4 columns · 1 row group · 2 KB), so the row count is there too. Row groups are counted in that sentence, not listed. - Gate: the name and the first bytes (
PAR1) must both say Parquet, and the file must be at most 5 MB; past that, or when the file is damaged, encrypted or cut short, the page keeps the source view and the terminal shows a sentence saying why. Never an error page. - Hostile input: the footer is Thrift compact, decoded by a bounded reader (depth, length and count limits); schema groups nest at most 64 deep; every name is escaped on the page.
- Left out: the rows themselves, nested schemas as a tree (columns are dotted paths), statistics, encrypted footers.
- Code:
src/web/render/parquet.ts(readFooter,summaryLine,parquet), kindparquetinkinds.ts; testtest/render-parquet.test.ts.