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.