Pocok.Conversion

Conversion

Test conversion policies, collection handling, enums, temporal values, and structured failure paths.

Available 1.0.0

Samples

Conversion example

Ready

Source kind

Target alias

Source value Enter arrays as JSON. The expression view renders them as supported C#-style literals.

Culture

Overflow

Null policy

Enum policy

Numeric loss

Numeric booleans

Temporal text

Maximum depth

Maximum collection items This example accepts 1–500 items. ConversionContext.Strict retains the package default of 10,000.

Generated API call

converter.Convert<byte>(
    300,
    new ConversionContext(
        CultureInfo.InvariantCulture,
        overflow: OverflowPolicy.Saturate,
        nulls: NullPolicy.Preserve,
        enums: EnumPolicy.DefinedValuesAndFlags,
        numericLoss: NumericLossPolicy.Reject,
        numericBooleans: NumericBooleanPolicy.Reject,
        temporalText: TemporalTextPolicy.RoundTrip,
        maximumDepth: 32
    )
);

Result

Run the current input to inspect the conversion result.

Purpose

Pocok.Conversion replaces scattered Convert.ChangeType calls and serializer-based coercion with immutable policies and explicit results.

Quick start

Choose a sample, edit the input or policies, then run it. The example invokes ValueConverter.Default directly.

Typed conversion

ConversionResult<int> result = ValueConverter.Default.Convert<int>("42", ConversionContext.Strict);

Runtime target conversion

ConversionResult<object?> result = ValueConverter.Default.Convert(value, typeof(decimal), context);

More guidance

Supported targets

The example allowlist includes scalar values, signed and unsigned numbers, Guid, temporal types, local enums and flags, and selected arrays.

ConversionContext

ConversionContext captures culture, loss, overflow, null, enum, boolean, temporal, depth, and collection policies in one immutable value.

Policies

Strict rejects overflow, fractions, numeric booleans, undefined enums, and non-round-trip temporal text unless a policy explicitly allows them.

Structured failures

ConversionFailure exposes a stable code, safe message, and value path. Expected failures remain package results rather than host errors.

Collections

Selected enumerable sources convert item by item, stop at the first failure, and report an indexed path. Strings are treated as scalar text.

Enums and flags

Named values are validated. Flags combinations are accepted only when every bit is declared and the selected enum policy permits flags.

Temporal values

RoundTrip accepts invariant round-trip text. CultureAware delegates textual parsing to the selected culture.

Concurrency

ValueConverter.Default and immutable contexts can be shared safely. Showcase input, result, and cancellation state remain scoped to the current user circuit.

Boundaries

The general conversion API does not claim trimming or NativeAOT support, does not resolve arbitrary types, and has no serializer fallback.

Production notes

Choose policies at trusted boundaries, preserve failure codes, cap collections, and map untrusted target names only through an allowlist.

Source documentation

Package documentation for the public contract, policies, and boundaries.

src/Conversion/README.md