Table of Contents

Bodu.Core - Getting started

Install

dotnet add package Bodu.Core

Targets net8.0 and net10.0. No external runtime dependencies. Bodu.Core covers the buffers, extensions, threading, and functional surfaces; the specialized collection catalogue ships in the companion Bodu.Collections package (namespaces unchanged; it depends on Bodu.Core), and the thread-safe collections in Bodu.Collections.Concurrent:

dotnet add package Bodu.Collections             # collection catalogue
dotnet add package Bodu.Collections.Concurrent  # thread-safe variants

Minimal samples

Every sample below needs only Bodu.Core. For collection samples (CircularBuffer<T>, EvictingDictionary<TKey, TValue>, Deque<T>, and the rest of the catalogue), see the Bodu.Collections getting-started page.

Calendar value sets (DayOfWeekSet, MonthSet, HourSet, ...)

using Bodu;

DayOfWeekSet weekdays = DayOfWeekSet.Parse("_MTWTF_");
DayOfWeekSet weekend  = DayOfWeekSet.Parse("S_____S");
DayOfWeekSet allDays  = weekdays | weekend;

bool monday = weekdays.Contains(DayOfWeek.Monday); // true

MonthSet quarterEnds = MonthSet.Parse("3,6,9,12");
HourSet  openHours   = HourSet.Parse("9-17");
bool open = openHours.Contains(new DateTime(2025, 3, 31, 10, 0, 0).Hour); // true

Each set is an immutable readonly struct, so With / Without and the |, &, ^, ~ operators each return a new value. Presets DayOfWeekSet.Empty, DayOfWeekSet.Weekdays, and DayOfWeekSet.Weekend cover the common cases; the numeric sets read and write a list of values and ranges ("9-17") by default, and also a list without ranges (L), binary (B), and for months a mask of initials (J). DayOfWeekSet and the five numeric sets all implement ICalendarValueSet<TSelf, TValue>, so one generic method can take any of them. See the DayOfWeekSet and calendar value sets guides.

Railway outcomes (Option<T> / Result<T>)

Model "might be absent" and "might fail" as values, and chain the happy path through combinators:

using Bodu.Functional;

Option<string> setting = LookupSetting("timeout");

int timeoutMs = setting
    .Map(int.Parse)
    .Filter(ms => ms > 0)
    .Match(onSome: ms => ms, onNone: () => 30_000);   // default when absent or invalid

Result<Order> order = ParseOrder(json)
    .Bind(Validate)                                // runs only on the success track
    .Map(Normalize);

if (!order.IsSuccess)
    logger.LogWarning("Rejected: {Message}", order.Error.Message);

default(Option<T>) is None and default(Result<T>) is a failure with an empty error - an unassigned field is well-formed, never a phantom success.

Pooled buffer (PooledBufferBuilder<T>)

An ArrayPool<T>-backed IBufferWriter<T> for assembling a span without per-append allocation:

using Bodu.Buffers;

using var builder = new PooledBufferBuilder<byte>(initialCapacity: 256);
builder.Append((byte)'{');
builder.AppendRange("\"ok\":true"u8);
builder.Append((byte)'}');

byte[] json = builder.ToArrayAndDispose();   // snapshot, then return the rental

Async coordination (AsyncLock)

The awaitable peer of lock - waiting yields the thread instead of blocking it:

using Bodu.Threading;

private readonly AsyncLock _gate = new();

public async Task WriteAsync(Entry entry, CancellationToken cancellationToken)
{
    using (await _gate.LockAsync(cancellationToken))
    {
        await AppendToJournalAsync(entry, cancellationToken);
    }
}   // releaser disposes → lock released, next waiter resumes

AsyncSemaphore, AsyncReaderWriterLock, the async reset/countdown events, AsyncLazy<T>, and AsyncDebouncer follow the same awaitable, cancellation-aware shape; RateGate is a synchronous gate whose TryInvoke admits at most one call per interval.

Date arithmetic (DateTimeExtensions)

using Bodu.Extensions;

DateTime today = DateTime.Today;

DateTime startOfWeek  = today.FirstDateOfWeek();                 // culture's first day of the current week
DateTime nextFriday   = today.NextDateOfWeek(DayOfWeek.Friday);  // strictly after today
DateTime endOfQuarter = today.LastDateOfQuarter();              // calendar Q-end
int isoWeek           = today.IsoWeekOfYear;                    // ISO 8601 week number (C# 14 extension property)

IsoWeekOfYear is read without parentheses; consuming the C# 14 extension properties needs <LangVersion>14</LangVersion> (or latest on the .NET 10 SDK) - see the date and time extensions guide. FirstDateOfWeek has overloads taking a CultureInfo or a WorkingDaysOfWeek preset; LastDateOfQuarter accepts a CalendarQuarterDefinition (e.g. AprilToMarch, April6ToApril5 for the UK tax year) so the same call covers fiscal calendars. The DateOnly equivalents, Age included, live on DateOnlyExtensions.

Centralized argument validation (ThrowHelper)

using Bodu;

public static double Average(IReadOnlyList<int> values)
{
    ThrowHelper.ThrowIfNull(values);
    ThrowHelper.ThrowIfZero(values.Count);
    return values.Average();
}

ThrowHelper.ThrowIf… uses [CallerArgumentExpression] so the parameter name is captured automatically.

Where to go next