Table of Contents

Guides

Recipe-style walk-throughs and conceptual introductions for every library in the Bodu suite, organized by the suite's seven topics. This page has one entry per package: its guide index lists every guide for that package, by namespace, and the links beside it are good first reads. Each topic also has a guides landing page that maps its packages' guides side by side.

If you are new to Bodu, start with the introduction for the project overview, or the getting-started page for install commands.

Topic guide landings: Core Foundations · Hashing & Cryptography · Globalization & Calendars · Text & Serialization · Configuration · Numerics & Financial · Binary Formats & I/O

Core Foundations

Bodu.Core

The calendar value sets, pooled buffers, async coordination and railway primitives, memoization, natural string ordering, sequence operators, and the date, numeric, span, and stream extensions.

Bodu.Collections

The specialized collection catalogue: rings and deques, evicting and sequenced dictionaries, ordered, navigable, and range-keyed lookups, interval trees, graphs, tries, the bit set, and the probabilistic sketches. Its guides share the core/ guide index with Bodu.Core.

Bodu.Collections.Concurrent

The thread-safe variants: ConcurrentCircularBuffer<T> (lock-free Vyukov MPMC), ConcurrentHashSet<T> (lock-free split-ordered), ConcurrentEvictingDictionary<TKey,TValue> (lock-striped bounded cache), and ConcurrentLruCache<TKey,TValue> (read-optimized bounded cache).

Bodu.Text (namespace in Bodu.Core)

Character-encoding helpers over System.Text.Encoding: byte-order-mark detection, span- and UTF-8-friendly transcoding, preamble handling, fallbacks, and chunked transcoding.

Hashing & Cryptography

Bodu.IO.Hashing

Non-cryptographic hashing: the FNV, CityHash, MurmurHash3, Pearson, and classic string fingerprints, the CRC engine with 112 named standards (CRC-3 through CRC-64), Fletcher and Adler, and the check-digit schemes.

Bodu.Security.Cryptography

Block, tweakable, and stream ciphers, cipher modes and padding, AEAD (the AES modes, ASCON, and the Poly1305 stream AEADs), digests and XOFs, MACs, Merkle trees, X25519, Ed25519, ML-KEM, ML-DSA, and HPKE, the KDFs (Argon2, scrypt, HKDF), one-time passwords, BCL interop, and hardware acceleration.

Globalization & Calendars

Bodu.Globalization.Calendar

The notable-date runtime and its companions: rule authoring, the strategy kinds and built-in algorithms, working days, the fluent builder, dependency injection, plugin trust, caching, the rule-pack toolchain, and the five regional data packs (Americas, Asia-Pacific, Europe, Middle East, and Africa).

Bodu.Globalization.Recurrence

RFC 5545 recurrence rules and rule sets, cron expressions with the Quartz day tokens, and anchored intervals, behind one next and previous occurrence surface; plus a scheduling host built on them.

Text & Serialization

Bodu.Text.Encoding

Base16, Base32, Base45, Base58, Base62, Base64, Base85, and Bech32, the IBinaryEncoding registry, and the percent-encoding and quoted-printable escapes.

Bodu.Text.Filtering

Include/exclude filtering: the glob grammar, AnyMatch sets and gitignore-style ordered rules, and the statistics and observer telemetry.

Bodu.Text.Formats (Delimited, DotEnv, INI)

The line formats: reading and writing CSV and TSV, .env, and INI, streaming, error handling, the writer and DOM options, and the reflection-free source generator.

Bodu serializers (Bencode, TOML, YAML)

The three System.Text.Json-shaped serializers: type mapping, both DOMs, the token readers and writers, attributes, converters, and options.

Configuration

Bodu.Text.Configuration

Parsing and profiles, glob-anchored resolution into a typed view, and diagnostics.

Bodu.Extensions.Configuration.Text

Layering Bodu configuration, TOML, and Bencode files into Microsoft.Extensions.Configuration, with options binding and reload.

Numerics & Financial

Bodu.Numerics

Fraction<T>, BigDecimal, Complex<T>, the interval algebra (Interval<T>, DiscreteInterval<T>, IntervalSet<T>), the running statistics, generic-math constraints, and the JSON companion.

Bodu.Financial

Money and currencies, monetary precision, exchange rates and lookups, the live-feed providers and their configuration, rate caching, dependency injection, and the JSON companion.

Binary Formats & I/O

Bodu.IO.Compound

The OLE2 compound-file container: reading, buffered and streaming access, property sets, authoring, and editing in place.

Bodu.IO.Biff

The BIFF5 and BIFF8 record codec: authoring a complete workbook stream, and reading a stream a block at a time.

Bodu.Formats.Excel.Binary

The read-only BIFF5 and BIFF8 .xls reader over Bodu.IO.Compound and Bodu.IO.Biff: workbooks, cell values and dates, and streaming versus materialized sheets.

Bodu.IO.Pst

The PST container layer: nodes, property and table contexts, streaming payloads, and validation levels.

Bodu.Formats.Outlook (.Msg, .Pst)

The .msg and .pst readers over the shared MAPI value model: messages, mail stores, properties and named properties, and the reader options and resource limits.

Where to go next

  • Introduction - what each library is for and how they fit together.
  • Getting started - install commands and a first sample from each library.
  • Samples - runnable, offline sample projects for every package family.
  • API reference - every type and member.