Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions 0.1.0-preview.0.1.0

This is a prerelease version of Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions --version 0.1.0-preview.0.1.0
                    
NuGet\Install-Package Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions -Version 0.1.0-preview.0.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions" Version="0.1.0-preview.0.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions" Version="0.1.0-preview.0.1.0" />
                    
Directory.Packages.props
<PackageReference Include="Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions --version 0.1.0-preview.0.1.0
                    
#r "nuget: Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions, 0.1.0-preview.0.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions@0.1.0-preview.0.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions&version=0.1.0-preview.0.1.0&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions&version=0.1.0-preview.0.1.0&prerelease
                    
Install as a Cake Tool

Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions

Query parameter abstractions for Pure.RelationalSchema.Storage.PureQL.Projection — Pure-style counterparts of the PureQL literals that bind a query parameter.

.NET build & check Build and Deploy NuGet License: MIT

Overview

A PureQL query can read named parameters. Pure.RelationalSchema.Storage.PureQL.Projection binds them by name to PureQL literals: PureQL.CSharp.Model.Literals.ILiteral and its 16 records, from LiteralInteger(long) to LiteralUuidNullable(), one with a value and one typed null for each of the eight PureQL types.

This package holds the Pure-style counterparts of those literals. A parameter is its PureQL type and its value as the text a stored cell would hold, built from Pure.Primitives.Abstractions only. It does not depend on PureQL.CSharp.Model, so a parameter can be stored or sent as data (for example by an AOT-compatible domain layer) and turned into a literal when the query is run. The implementations live in Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.

Installation

dotnet add package Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions

Public API

Name Namespace Description
IParameterType Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions.ParameterType IString Name, the PureQL type name, and IBool Nullable, true for the typed-null variant: the counterpart of PureQL.CSharp.Model.Types.IType
IParameter Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions.Parameter IParameterType Type and IString Value, the bound value as invariant cell text: the counterpart of ILiteral

Name is one of integer, decimal, string, boolean, date, time, datetime and uuid. Nullable is true only for a typed null, such as LiteralIntegerNullable: the PureQL model has no nullable literal that holds a value.

The value text

Value is in the format the projection writes result cells and parses stored cells (CellText and StoredColumn in that repo). It is invariant, so it does not depend on the current culture:

Type Text Literal
integer -42 LiteralInteger(-42)
decimal 1.5: exact, no exponent, no trailing zeros in the fraction LiteralDecimal(1.50m)
string the string itself LiteralString("Ada")
boolean True or False LiteralBoolean(true)
date 2026-10-29 (yyyy-MM-dd) LiteralDate(new DateOnly(2026, 10, 29))
time 08:30:00, 08:30:00.25 (HH:mm:ss, fractional seconds only when present) LiteralTime(new TimeOnly(8, 30))
datetime 2026-10-29T08:30:00 (yyyy-MM-ddTHH:mm:ss in UTC, no offset, fractional seconds only when present) LiteralDatetime(...)
uuid 3f2504e0-4f89-11d3-9a0c-0305e82c3301 (lower case, D format) LiteralUuid(...)

A typed null is the empty string, the storage layer's NULL. For a string parameter, Nullable tells a typed null from the empty string.

Usage

The package ships no implementations. A minimal pair of records over Pure.Primitives:

using Pure.Primitives.Abstractions.Bool;
using Pure.Primitives.Abstractions.String;
using Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions.Parameter;
using Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions.ParameterType;

public sealed record ParameterType : IParameterType
{
    public ParameterType(IString name, IBool nullable)
    {
        Name = name;
        Nullable = nullable;
    }

    public IString Name { get; }

    public IBool Nullable { get; }
}

public sealed record Parameter : IParameter
{
    public Parameter(IParameterType type, IString value)
    {
        Type = type;
        Value = value;
    }

    public IParameterType Type { get; }

    public IString Value { get; }
}

A decimal parameter of 9.99, and a typed-null date parameter:

using Pure.Primitives.Bool;
using Pure.Primitives.String;
using String = Pure.Primitives.String.String;

IParameter price = new Parameter(
    new ParameterType(new String("decimal"), new False()),
    new String("9.99")
);

IParameter shippedBefore = new Parameter(
    new ParameterType(new String("date"), new True()),
    new EmptyString()
);

Build the text yourself, or from a formatted .NET value with new String(text). The Pure.Primitives constructors that format an IDate, ITime or IDateTime write another format (10/29/2026, for example), which is not cell text.

When the query runs, each parameter becomes the PureQL literal its type names, and the literals bind the query's parameters by name:

using System.Globalization;
using PureQL.CSharp.Model.Literals;

static ILiteral Literal(IParameter parameter)
{
    string text = parameter.Value.TextValue;
    CultureInfo invariant = CultureInfo.InvariantCulture;

    return (parameter.Type.Name.TextValue, parameter.Type.Nullable.BoolValue) switch
    {
        ("integer", false) => new LiteralInteger(long.Parse(text, invariant)),
        ("decimal", false) => new LiteralDecimal(decimal.Parse(text, invariant)),
        ("date", false) => new LiteralDate(DateOnly.Parse(text, invariant)),
        ("date", true) => new LiteralDateNullable(),
        // ... the other types
        _ => throw new ArgumentException($"{parameter.Type.Name.TextValue} is unknown."),
    };
}

IReadOnlyDictionary<string, ILiteral> literals = new Dictionary<string, ILiteral>
{
    ["price"] = Literal(price),
    ["shippedBefore"] = Literal(shippedBefore),
};

PureQLProjection projection = new PureQLProjection(datasets, query, literals);

Design Principles

  • Interfaces-only — no implementations, no tests; every file defines exactly one interface
  • Model-agnostic — depends on Pure.Primitives.Abstractions only, never on the PureQL model or the projection
  • AOT-compatible — IsAotCompatible=true
  • Documented — XML doc comments on every public member, shipped in the package

Dependencies

Target Frameworks

  • .NET 8
  • .NET 9
  • .NET 10
  • Pure.RelationalSchema.Storage.PureQL.Projection — runs PureQL queries over stored relational data and binds their parameters to PureQL literals
  • Pure.RelationalSchema.Storage.PureQL.Projection.Parameters — the implementations of these interfaces
  • PureQL.CSharp.Model — the PureQL literals and types these interfaces mirror
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions:

Package Downloads
Pure.RelationalSchema.Storage.PureQL.Projection

Package Description

Pure.RelationalSchema.Storage.PureQL.Projection.Parameters

Package Description

Pure.RelationalSchema.Storage.PureQL.Projection.Parameters.Abstractions.Serialization

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0-preview.0.3.0 130 11/11/2026
0.1.0-preview.0.2.0 376 10/29/2026
0.1.0-preview.0.1.0 84 10/29/2026