Runnable samples
The repository ships a runnable, self-contained sample project for Bodu.IO.Biff, the BIFF
record codec beneath the Excel reader, under
samples/IO.Biff/.
It is offline and deterministic: it reads a workbook it writes first, a two-sheet BIFF8
workbook of synthetic daily readings built with BiffWriter and Bodu.IO.Compound's
CompoundStorageBuilder, extracting the Workbook stream with Bodu.IO.Compound since the
codec itself has no container dependency, and it authors its own BIFF8 stream with BiffWriter
for the round-trip scenario. It is a member of bodu.slnx, built and executed by
CI. The README documents every scenario individually.
Run it from the repository root:
dotnet run --project samples/IO.Biff/Bodu.IO.Biff.Samples.BiffBasics
The sample
Bodu.IO.Biff.Samples.BiffBasics
The codec from the physical record view to authoring:
- RecordCensus - BiffReader over a workbook stream: every physical
record framed, the
BOFrecords marking each substream and establishing BiffVersion, and a tally by identifier that includes records the codec does not name. - CellsAndSharedStrings - the typed accessors: the sheet directory from
BOUNDSHEET, the shared string table read one string at a time through BiffSstReader across itsCONTINUErecords, and the first sheet's cell records decoded into values with the version seeded through BiffReaderOptions. - WriteAndReadBack - BiffWriter assembling a BIFF8 workbook stream with
fonts, formats, a shared string table, a bound sheet, and a sheet holding every cell kind, with
BytesCommittedsupplying the sheet offset, then read straight back. - MalformedInput - the error contract: truncated headers and payloads and short known records
as BiffFormatException, a BIFF4 stream as
BiffUnsupportedVersionException, an unknown record as no error at all, and
chunked reading with
isFinalBlock: false.
Where to go next
- Bodu.IO.Biff introduction - the package at a glance.
- Getting started - install and minimal samples.
- Bodu.Formats.Excel.Binary samples - the same kind of workbook read through the Excel reader.