Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
41ae6a1
chore: promote public API for v7.5.0
GabrielMarquezMatte Nov 9, 2026
d9d7821
Merge pull request #178 from GabrielMarquezMatte/chore/promote-public…
GabrielMarquezMatte Nov 9, 2026
62270bb
perf(reader): widen short ASCII cell text without a separate validati…
Nov 10, 2026
80fd2fa
perf(xls): drain number and shared-string records straight into the c…
Nov 10, 2026
0be3cb1
perf(native): train the static PGO profile on the XLS fixture too
Nov 10, 2026
9d63910
perf(native): regenerate the static PGO profile
Nov 10, 2026
2147f37
docs: refresh every benchmark table from one Medium run
Nov 10, 2026
f8c70ef
chore(deps): bump cc from 1.10.0 to 1.11.1 in /rust
dependabot[bot] Nov 11, 2026
b61d574
chore(deps): bump calamine from 0.37.0 to 0.38.0 in /rust
dependabot[bot] Nov 11, 2026
ebfa235
Bump the analyzers group with 2 updates
dependabot[bot] Nov 11, 2026
f0d4094
Bump the test group with 2 updates
dependabot[bot] Nov 11, 2026
326fb1d
Bump ConsoleAppFramework from 5.8.0 to 5.8.1
dependabot[bot] Nov 11, 2026
3760e29
Merge pull request #179 from GabrielMarquezMatte/dependabot/cargo/rus…
GabrielMarquezMatte Nov 12, 2026
8e457cd
Merge pull request #181 from GabrielMarquezMatte/dependabot/nuget/dev…
GabrielMarquezMatte Nov 12, 2026
1b39b7f
Merge pull request #180 from GabrielMarquezMatte/dependabot/cargo/rus…
GabrielMarquezMatte Nov 12, 2026
641d8ab
Merge pull request #184 from GabrielMarquezMatte/dependabot/nuget/src…
GabrielMarquezMatte Nov 12, 2026
bafb8dd
Merge pull request #182 from GabrielMarquezMatte/dependabot/nuget/tes…
GabrielMarquezMatte Nov 12, 2026
65277f9
build: publish the native library on .NET 11
Nov 16, 2026
8f833df
chore: update package versions and refactor benchmark implementations
Nov 16, 2026
c5a9257
build: add UseNativeLibPrefix property for Unix output naming
Nov 16, 2026
90ca6ca
build: adjust DLL copy location for better compatibility with cargo t…
Nov 16, 2026
d0a922c
Merge branch 'master' into develop
GabrielMarquezMatte Nov 16, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/workflows/benchmark-pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@ jobs:
- uses: actions/setup-dotnet@v6
with:
global-json-file: global.json
dotnet-version: '10.0.x'
cache: true
cache-dependency-path: '**/*.csproj'

Expand Down
1 change: 1 addition & 0 deletions .github/workflows/benchmark-pr.yml
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,7 @@ jobs:
- uses: actions/setup-dotnet@v6
with:
global-json-file: global.json
dotnet-version: '10.0.x'
cache: true
cache-dependency-path: '**/*.csproj'

Expand Down
2 changes: 2 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,7 @@ jobs:
uses: actions/setup-dotnet@v6
with:
global-json-file: global.json
dotnet-version: '10.0.x'
cache: true
cache-dependency-path: '**/*.csproj'

Expand Down Expand Up @@ -181,6 +182,7 @@ jobs:
uses: actions/setup-dotnet@v6
with:
global-json-file: global.json
dotnet-version: '10.0.x'
cache: true
cache-dependency-path: '**/*.csproj'

Expand Down
1 change: 1 addition & 0 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ jobs:
- uses: actions/setup-dotnet@v6
with:
global-json-file: global.json
dotnet-version: '10.0.x'

# The snippets themselves are compiled by ci.yml, which builds the whole solution.
- name: Check guide examples match docs/snippets
Expand Down
2 changes: 2 additions & 0 deletions .github/workflows/fuzz.yml
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,7 @@ jobs:
uses: actions/setup-dotnet@v6
with:
global-json-file: global.json
dotnet-version: '10.0.x'
cache: true
cache-dependency-path: '**/*.csproj'

Expand Down Expand Up @@ -155,6 +156,7 @@ jobs:
uses: actions/setup-dotnet@v6
with:
global-json-file: global.json
dotnet-version: '10.0.x'
cache: true
cache-dependency-path: '**/*.csproj'

Expand Down
1 change: 1 addition & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ jobs:
uses: actions/setup-dotnet@v6
with:
global-json-file: global.json
dotnet-version: '10.0.x'
cache: true
cache-dependency-path: '**/*.csproj'

Expand Down
2 changes: 1 addition & 1 deletion .vscode/settings.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"EXCELREADER_BUILD_BENCHMARKS": "ON",
"EXCELREADER_BUILD_BENCHMARKS_COMPARE": "ON",
"EXCELREADER_BUILD_TESTS": "ON",
"EXCELREADER_NATIVE_LIB": "${workspaceFolder}/src/ExcelReader.Native/bin/Release/net10.0/win-x64/native/ExcelReader.Native.dll"
"EXCELREADER_NATIVE_LIB": "${workspaceFolder}/src/ExcelReader.Native/bin/Release/net11.0/win-x64/native/ExcelReader.Native.dll"
},
"cmake.configureArgs": [
"-DEXCELREADER_BUILD_BENCHMARKS=OFF",
Expand Down
4 changes: 2 additions & 2 deletions Directory.Build.props
Original file line number Diff line number Diff line change
Expand Up @@ -23,11 +23,11 @@
it used to arrive transitively through Roslyn.Diagnostics.Analyzers, which brought a whole
Roslyn-internal ruleset along for those three rules. -->
<ItemGroup>
<PackageReference Include="Microsoft.CodeAnalysis.NetAnalyzers" Version="10.0.403">
<PackageReference Include="Microsoft.CodeAnalysis.NetAnalyzers" Version="11.0.100">
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
<PrivateAssets>all</PrivateAssets>
</PackageReference>
<PackageReference Include="Meziantou.Analyzer" Version="3.0.320">
<PackageReference Include="Meziantou.Analyzer" Version="3.0.325">
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
<PrivateAssets>all</PrivateAssets>
</PackageReference>
Expand Down
18 changes: 9 additions & 9 deletions docs/guide/reading.md
Original file line number Diff line number Diff line change
Expand Up @@ -128,7 +128,7 @@ A callback that writes to a database or sends messages must be idempotent on a C

[`ExcelParseException.Row`](xref:ExcelReader.Core.Parser.ExcelParseException.Row) on `ParseAsync` counts the rows emitted so far. On `ForEachAsync` and `AggregateAsync` it is the row a sequential read reports, whether or not the read was partitioned.

See the [parallel sheet benchmarks](../performance/benchmarks.md#parallel-sheet-reading) and the [parallel CSV benchmarks](../performance/benchmarks.md#parallel-csv) for what this buys. On a real-data XLSX the sheet stage drops from 24 ms (prefetched, sequential) to about 17 ms, and on XLSB from 17 ms to about 13 ms; the floor is inflate, which runs on one thread. CSV has no such floor: its `AggregateAsync` at dop 4 is ~2.0x faster than the typed path while allocating ~630x less, with zero garbage collections.
See the [parallel sheet benchmarks](../performance/benchmarks.md#parallel-sheet-reading) and the [parallel CSV benchmarks](../performance/benchmarks.md#parallel-csv) for what this buys. On a real-data XLSX a typed aggregate drops from 44 ms on one thread to about 16 ms at dop 4, and on XLSB from 24 ms to about 13 ms; the floor is inflate, which runs on one thread. CSV has no such floor: its `AggregateAsync` at dop 4 is ~1.9x faster than the typed path while allocating ~670x less, with zero garbage collections.

Properties need setters. A get-only property is skipped during binding and silently receives nothing.

Expand Down Expand Up @@ -356,16 +356,16 @@ Measured across both read benchmarks (see [Real data reads](../performance/bench

| Workload | Default | `PrefetchDecompression = true` | Gain |
|---|---:|---:|---:|
| XLSX, real data | 37.2 ms | 23.7 ms | 36% |
| XLSM, real data | 38.0 ms | 23.1 ms | 39% |
| XLSB, real data | 24.7 ms | 16.6 ms | 33% |
| XLSX, string-heavy | 30.0 ms | 20.0 ms | 33% |
| XLSB, string-heavy | 33.6 ms | 19.5 ms | 42% |
| XLSX, real data | 38.4 ms | 25.0 ms | 35% |
| XLSM, real data | 37.8 ms | 24.5 ms | 35% |
| XLSB, real data | 18.9 ms | 10.4 ms | 45% |
| XLSX, string-heavy | 30.5 ms | 20.5 ms | 33% |
| XLSB, string-heavy | 26.4 ms | 16.8 ms | 36% |

The gain tracks how much of a read is decompression rather than parsing, so it is smallest
on XLSB real data and string-heavy XLSX (about a third) and largest on string-heavy XLSB (42%). Allocations rise from the producer task and the
pooled decompression buffers — on the real-data corpus, roughly 7 KB to 23 KB for XLSX
and 7 KB to 15 KB for XLSB — and neither path triggers a garbage collection.
on string-heavy XLSX (about a third) and largest on XLSB real data (45%). Allocations rise from the producer task and the
pooled decompression buffers — on the real-data corpus, roughly 5 KB to 22 KB for XLSX
and 5 KB to 11 KB for XLSB — and neither path triggers a garbage collection.

Do **not** enable it for concurrent server workloads: a caller already reading many files
in parallel is CPU-saturated, and an extra background thread per read only doubles thread
Expand Down
20 changes: 10 additions & 10 deletions docs/guide/writing.md
Original file line number Diff line number Diff line change
Expand Up @@ -368,10 +368,10 @@ Writing a 50,000-row workbook (`WriteBenchmark`):

| Workload | Default | `PrefetchWrite = true` | Gain |
|---|---:|---:|---:|
| XLSX | 8.191 ms | 5.351 ms | 35% |
| XLSB | 5.462 ms | 3.282 ms | 40% |
| XLSX | 8.213 ms | 5.577 ms | 32% |
| XLSB | 5.388 ms | 3.271 ms | 39% |

Allocations are unchanged (4.02 MB either way) — the background writer hands over buffers the row
Allocations are unchanged (4.02–4.03 MB either way) — the background writer hands over buffers the row
writer already owns rather than copying them.

The same caveat as the read side applies: **do not enable it for concurrent server workloads**. A
Expand Down Expand Up @@ -433,13 +433,13 @@ Writing 1,000,000 rows of four columns (text, integer, date, number) to a `Memor

| Write | XLSX | XLSB |
|---|---:|---:|
| Serial | 165.08 ms | 113.61 ms |
| Serial, `PrefetchWrite` | 102.18 ms | 62.39 ms |
| Parallel, 1 batch in flight | 164.23 ms | 114.03 ms |
| Parallel, 2 | 84.48 ms | 58.53 ms |
| Parallel, 4 | 44.27 ms | 30.04 ms |
| Parallel, 8 | 27.54 ms | 19.48 ms |
| Parallel, 16 | 21.64 ms | 15.37 ms |
| Serial | 160.09 ms | 110.06 ms |
| Serial, `PrefetchWrite` | 99.24 ms | 61.54 ms |
| Parallel, 1 batch in flight | 174.04 ms | 107.89 ms |
| Parallel, 2 | 87.64 ms | 53.74 ms |
| Parallel, 4 | 45.61 ms | 28.72 ms |
| Parallel, 8 | 28.93 ms | 18.66 ms |
| Parallel, 16 | 22.07 ms | 15.11 ms |

The file comes out 0.18% (XLSX) or 0.04% (XLSB) larger, because each batch is compressed on its own.
As with `PrefetchWrite`, this is for single-file batch work: a server already writing many files at
Expand Down
Loading
Loading