Deepstaging.Roslyn¶

A fluent toolkit for building Roslyn source generators, analyzers, and code fixes.

Roslyn APIs are powerful but awkward. This library wraps them in something that feels natural.

Quick Start¶

dotnet add package Deepstaging.Roslyn
dotnet add package Deepstaging.Roslyn.Scriban  # Optional: Scriban templates

What You Get¶

Queries — Find Symbols¶

var types = TypeQuery.From(compilation)
    .ThatArePublic()
    .ThatAreClasses()
    .ThatArePartial()
    .WithAttribute("GenerateAttribute")
    .GetAll();

Projections — Safe Symbol Access¶

var optional = symbol.GetAttribute("MyAttribute");

if (optional.IsNotValid(out var valid))
    return;

var typeName = valid.Name;

Emit — Generate Code¶

var code = TypeBuilder.Class("CustomerDto")
    .InNamespace("MyApp.Models")
    .AsPartial()
    .AddProperty("Id", "int", p => p.WithGetter().WithSetter())
    .Emit();

Packages¶

Package	Purpose
`Deepstaging.Roslyn`	Core toolkit: Queries, Projections, Emit builders
`Deepstaging.Roslyn.Scriban`	Scriban template integration for source generators
`Deepstaging.Roslyn.Workspace`	Code fix provider infrastructure
`Deepstaging.Roslyn.Testing`	Test utilities for generators and analyzers

Architecture¶

┌─────────────────────────────────────────────────────────────────┐
│                        Your Generator                           │
├─────────────────────────────────────────────────────────────────┤
│  Queries          │  Projections       │  Emit                  │
│  ───────          │  ───────────       │  ────                  │
│  TypeQuery        │  OptionalSymbol<T> │  TypeBuilder           │
│  MethodQuery      │  ValidSymbol<T>    │  MethodBuilder         │
│  PropertyQuery    │  OptionalAttribute │  PropertyBuilder       │
│  FieldQuery       │  ValidAttribute    │  FieldBuilder          │
│  ParameterQuery   │  XmlDocumentation  │  ConstructorBuilder    │
│  ConstructorQuery │                    │  AttributeBuilder      │
│  EventQuery       │                    │  BodyBuilder           │
└─────────────────────────────────────────────────────────────────┘

Philosophy¶

This is utility code, not a framework. It should feel like Roslyn's missing standard library.

When you call .GetAll(), you get actual Roslyn symbols you can use normally
When you call .Emit(), you get valid CompilationUnitSyntax you can use with Roslyn's APIs
Reading and writing are symmetric: TypeQuery finds types → TypeBuilder creates types

License¶

RPL-1.5 (Reciprocal Public License) — Real reciprocity, no loopholes.