OpenGenericConstraints.Analyzers 0.1.0

Suggested Alternatives

AdvancedGenericTypeConstraints.Analyzers

Additional Details

Was renamed to AdvancedGenericTypeConstraints.Analyzers

dotnet add package OpenGenericConstraints.Analyzers --version 0.1.0
                    


                    

                
NuGet\Install-Package OpenGenericConstraints.Analyzers -Version 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="OpenGenericConstraints.Analyzers" Version="0.1.0">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
</PackageReference>
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="OpenGenericConstraints.Analyzers" Version="0.1.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="OpenGenericConstraints.Analyzers">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
</PackageReference>
                    


                            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 OpenGenericConstraints.Analyzers --version 0.1.0
                    


                    

                
#r "nuget: OpenGenericConstraints.Analyzers, 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 OpenGenericConstraints.Analyzers@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=OpenGenericConstraints.Analyzers&version=0.1.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=OpenGenericConstraints.Analyzers&version=0.1.0
                    


                            Install as a Cake Tool

OpenGenericConstraints

OpenGenericConstraints enables compile-time-like validation for open generic constraints in C# by combining lightweight attributes with a Roslyn analyzer.

Why this exists

C# generic constraints cannot express rules like "the supplied type must implement IHandleMessages<T> for some T" when the constraint targets an open generic type definition.

This project closes that gap with:

  • a small abstractions package that exposes constraint attributes
  • a Roslyn analyzer package that validates the supplied type arguments at compile time

Packages

Install both packages in the consuming project:

<ItemGroup>
  <PackageReference Include="OpenGenericConstraints.Abstractions" Version="0.1.0" />
  <PackageReference Include="OpenGenericConstraints.Analyzers" Version="0.1.0" PrivateAssets="all" />
</ItemGroup>

Example

using OpenGenericConstraints;

public interface IHandleMessages<TMessage>;

public interface IFeatureRegistry
{
    void RegisterMessageHandler<
        [MustImplementOpenGeneric(typeof(IHandleMessages<>))] TMessageHandler>();
}

public sealed class MyMessage;

public sealed class MyHandler : IHandleMessages<MyMessage>;

Using RegisterMessageHandler<MyHandler>() is valid.

Using a type that does not match the configured open generic definition produces:

OGC001: Type 'MyHandler' must implement 'IHandleMessages<>'

Matching semantics

The analyzer compares open generic type definitions, not closed constructed types.

A type counts as a match when the configured open generic type definition appears on:

  • the concrete type argument itself
  • any base type in its inheritance chain
  • any implemented interface

This means matching is not limited to interfaces. Open generic classes, interfaces, and other generic type definitions are all supported as long as the open generic definition matches.

Current API

The project currently supports:

  • MustImplementOpenGenericAttribute
  • MustImplementOpenGenericAttribute(Type openGenericType, bool exactlyOne)
  • MustNotImplementOpenGenericAttribute

Example:

public interface IFeatureRegistry
{
    void RegisterSingle<
        [MustImplementOpenGeneric(typeof(IHandleMessages<>), true)]
        THandler>();

    void RegisterWithoutSagaStarter<
        [MustNotImplementOpenGeneric(typeof(IAmStartedByMessages<>))]
        THandler>();
}

Non-goals

  • no changes to the C# type system
  • no runtime validation
  • no replacement for native generic constraints

The solution is intentionally based on static analysis only.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.0 152 4/2/2026 0.1.0 is deprecated because it is no longer maintained.