Table of Contents

Samples

The repository ships runnable, self-contained sample projects under samples/, organized by domain folder named after the namespace segment they demonstrate (Core/, Collections/, Collections.Concurrent/, Financial/, Formats.Excel/, Formats.Outlook/, Globalization.Calendar/, Globalization.Recurrence/, IO.Biff/, IO.Compound/, IO.Pst/, IO.Hashing/, Numerics/, Security.Cryptography/, Text.Toml/, Text.Yaml/, Text.Bencode/, Text.Formats/, Text.Configuration/, Text.Encoding/, Text.Filtering/). This section catalogues them; each domain page walks its samples individually.

Every sample:

  • runs offline by default - no network, no accounts, no API keys. Exchange-rate samples read committed static data files; calendar samples use the embedded data packs. Where a live feed could be used, a fenced comment block shows the exact switch, and the one deliberately online sample (Bodu.Financial.Samples.LiveRates) is clearly marked and excluded from CI execution.
  • is deterministic - running a sample twice prints the same output, so samples double as executable documentation and as CI smoke tests. Every sample is a member of bodu.slnx (API drift breaks the build), and the CI samples step runs every sample application; the one library sample, a calendar plugin, runs inside the host sample that loads it.
  • is documented to a fixed README standard - one section per scenario stating the intent, what the code does, the output to expect (with the load-bearing lines explained), and the APIs demonstrated.
  • references the library projects via ProjectReference, with the equivalent dotnet add package commands listed per sample.

Run any sample from the repository root:

dotnet run --project samples/<Domain>/<SampleName>

Domains

Domain Samples Highlights
Core 3 projects The Bodu.Functional railway (Option/Result/Either/Memoizer and async companions), the utility toolbox (SequenceGenerator, PooledBufferBuilder, the enumerable operators, string/comparable/numeric extensions, the calendar value sets, the async threading primitives), and the Bodu.Text encoding utilities (BOM detection, transcoding, pooled string encoding)
Collections 4 projects The specialized collection catalogue (ring/deque/evicting/multi-value/multiset/ordered/indexed/bi/navigable/sequenced/priority), the structural collections (ranges, interval tree, graph algorithms, disjoint set, trees/tries, Aho-Corasick), and the probabilistic sketches (Bloom, count-min, HyperLogLog) with a stable comparer for reproducible error
Collections.Concurrent 1 project The thread-safe variants - ConcurrentCircularBuffer, ConcurrentHashSet, and ConcurrentEvictingDictionary (single-flight GetOrAdd, ItemEvicted) - with a parallel workload that asserts only deterministic aggregates
Financial 9 projects + 1 test project Money arithmetic and the three-tier rounding model, the offline static-rate-file pattern, read-through caching and tiered stacking, multi-provider aggregation and routing, DI hosting, a consumer-written provider proven by the shipped contract-test base, and the live-provider exception
Formats.Excel 1 project The read-only BIFF5 and BIFF8 .xls reader over a two-sheet workbook the sample generates: the session/sheet-directory surface, constant-memory forward-only streaming, the materialized worksheet, and format-classified serial-date decoding
Formats.Outlook 1 project The .msg reader over a message the sample authors itself with Bodu.IO.Compound: IsMsgFile sniffing, the subject, sender, and body conveniences, the recipient table, each attachment's metadata and bytes, and the tag-addressed MapiPropertyCollection beneath them
Globalization.Calendar 11 projects (one a plugin library) + 1 test project Holiday queries with ISO 3166-2 subdivision shadowing, working-day and fiscal arithmetic with DayOfWeekSet overrides, fluent calendar authoring with catalogue imports and the XML round trip, DI with live data reload, and custom date algorithms proven by the shared data-pack test base
Globalization.Recurrence 5 projects The RFC 5545 RRULE form with the BY* semantics implementations disagree on and WKST week numbering, the Vixie cron dialect with its day-field union rule and oversized-step handling, the calendar-free anchored interval with the duration grammar's exact boundary, RDATE/EXDATE set composition and the iCalendar property-block round trip, and an integrating host that puts all four behind one adapter with a reproducible catch-up loop
IO.Biff 1 project The BIFF record codec beneath the Excel reader: walking a workbook stream record by record with BiffReader, decoding cells and the shared string table, extracting the Workbook stream from an .xls with Bodu.IO.Compound, and authoring a BIFF8 sheet with BiffWriter that reads back through the codec
IO.Compound 1 project The OLE2 structured-storage container: builder-based authoring and byte-exact read-back, typed OLE property sets on authored and real Word files, signature detection with the v3/v4 sector knob, and walking a real .doc's storage tree
IO.Pst 1 project The PST container and the mail-store reader built on it: format detection and the open handshake over Unicode and ANSI files, the raw property-context and table-context views, chunked data streaming under strict validation with a truncated copy rejected, and the same files as an OutlookMailStore with folders, messages, recipients, attachments, bodies, and named properties
IO.Hashing 4 projects + 1 test project The 112-standard parametric CRC catalogue, checksum families with corruption detection, streaming/resumable digests, non-cryptographic bucket routing, file manifests built and checked through the stream, async, and verify extensions (including over System.IO.Hashing's own Crc32), multi-part digests without reassembly, identifier check digits across domains with error-class comparisons, and a custom scheme proven by the shared contract-test base
Numerics 5 projects Fraction<T> exact rational arithmetic, parse/format, generic math and continued fractions; the Interval/DiscreteInterval/IntervalSet algebra; the single-pass streaming statistics (RunningStatistics, MovingSum/MovingMinMax, RunningQuantile, BigDecimal); and the System.Text.Json converter registration and policy shapes
Security.Cryptography 8 projects + 1 test project Cryptographic and keyed hashes, XOFs, KDFs and one-time passwords; block ciphers, cipher modes and padding, AEAD and stream ciphers; X25519/Ed25519 and ML-KEM/ML-DSA; RFC 9180 HPKE; RFC 6962 Merkle trees; stream-to-stream and async encryption, download verification, and an encrypt-then-MAC sealed file through the extension methods (including over the BCL's own Aes); and a consumer-authored hash proven against the shared BlockHashAlgorithmTests contract base - all with fixed RFC/NIST key material for reproducible output
Text.Bencode 1 project A real BitTorrent metainfo file end to end: DOM inspection, canonical byte-exact round trips, the info-hash from the raw info slice, and typed POCO mapping with keys containing spaces
Text.Configuration 2 projects The parse/resolve/save pipeline with diagnostics and the EditorConfig-style path cascade, unset dialect handling, and the Microsoft.Extensions.Configuration bridge into IOptions<T>
Text.Encoding 2 projects + 1 test project The base-encoding catalogue and variants, formatting/parse-style knobs, checksummed Base58Check/Bech32 corruption detection, the runtime registry, and a custom Base36 codec proven by the library's contract-test base
Text.Filtering 1 project The include/exclude filtering engine: AnyMatch sets and gitignore-style ordered rules, the glob grammar with deciding-pattern diagnostics, and the statistics/observer telemetry
Text.Formats 2 projects RFC 4180 CSV/TSV with typed getters and dirty-input policies, streaming reader/writer pipelines, INI comment-preserving edit loops, and DotEnv's literal no-interpolation contract
Text.Toml 2 projects The TomlSerializer POCO surface with TOML's four native temporal kinds and naming/attribute layering, plus the mutable and read-only DOMs, the UTF-8 token layer, and resumable streaming reads
Text.Yaml 2 projects The YamlSerializer POCO surface with YAML's implicit scalar typing and naming/attribute layering, plus the mutable YamlNode and read-only YamlDocument DOMs, the UTF-8 token layer, and the stream/async facade

Testing companions

Five samples ship test projects that derive the repository's contract-test bases - DatedRateProviderContractTests<T> (from the in-repo Bodu.Financial.ExchangeRates.Testing project, which is not published to NuGet), CalendarDataTestsBase (repository-internal), BinaryEncodingContractTests<TEncoding> (from the Bodu.Text.Encoding test suite), CheckDigitContractTests<TAlgorithm> (from the Bodu.IO.Hashing test suite), and BlockHashAlgorithmTests<TTest, TAlgorithm, TVariant> (from the Bodu.Security.Cryptography test suite) - demonstrating how consumer-written providers, calendars, algorithms, encodings, check-digit schemes, and hash algorithms are validated against the same contracts the built-in implementations pass. All run in CI with the library suites.