This page lists the C# libraries, frameworks and build tools Niro was tested against, and whether it recognised each one.

What the marks mean.

The test code is made up for the purpose: one small service per library, with the names invented. So "supported" means Niro recognised it there. It is good evidence, but it is not a promise about every codebase. If Niro misses something in your code, the coverage audit reports the gap on its own (see Coverage audit).

The test catalog also holds 3 look-alike cases for C#: code that Niro must NOT take for a route, a call or a store. They test that Niro ignores the look-alike, so they are left out of this page and its counts.

Web frameworks and HTTP servers (the routes your code serves)

10 supported, 3 partly, 2 not yet.

Name Status Ways of using it that were tested
AWS SAM template.yaml supported yes: AWS::Serverless::Function (Runtime dotnet8, Handler Assembly::Namespace.Class::Method) with Events Type HttpApi Path and Method
Azure Functions (.NET isolated worker) supported yes: host.json extensions.http.routePrefix set to a value other than api (here a two-segment prefix), with a verb-less [HttpTrigger] that serves every verb
Carter supported yes: ICarterModule.AddRoutes(app) with app.MapGet/MapPost
yes: CarterModule base("/api/ratings") constructor prefix
CoreWCF not yet no: [ServiceContract]/[OperationContract] served at AddServiceEndpoint<,>(binding, "/X.svc")
Dapr.AspNetCore supported yes: [HttpPost("x")] controller action reached by Dapr invocation or pub/sub
FastEndpoints not yet no: Get("/x") / Post("/x") inside Configure(), plus UseFastEndpoints RoutePrefix
no: [HttpGet("/x")] on the endpoint class
HotChocolate.AspNetCore supported yes: app.MapGraphQL("/graphql") with Query/Mutation types
Microsoft.AspNet.WebApi (System.Web.Http) partly yes: [RoutePrefix] + [Route("{id:int}")] + [HttpGet] on ApiController (.NET Framework)
no: config.Routes.MapHttpRoute("DefaultApi", "api/{controller}/{id}")
Microsoft.Azure.Functions.Worker supported yes: [Function] + [HttpTrigger(level, "get", Route = "x/{id}")] parameter; host.json routePrefix
Microsoft.Azure.WebJobs supported yes: [FunctionName] + [HttpTrigger] in the in-process model
Nancy supported yes: NancyModule base path + Get("/x", handler) in the constructor
Ocelot partly partly: ocelot.json Routes: UpstreamPathTemplate -> DownstreamHostAndPorts + DownstreamPathTemplate
Serverless Framework serverless.yml supported yes: functions.<name>.handler Assembly::Namespace.Class::Method with events httpApi
ServiceStack supported yes: [Route("/x/{Id}", "GET")] on the request DTO, served by Service.Get(Dto)
Yarp.ReverseProxy partly partly: appsettings ReverseProxy Routes/Clusters (Match.Path -> Destinations.Address)

The language's own HTTP server

2 supported, 3 partly, 2 not yet.

Name Status Ways of using it that were tested
Microsoft.AspNetCore.Builder supported yes: app.MapGet/MapPost/MapPut/MapDelete/MapPatch(path, lambda) in top-level Program.cs
yes: MapGet(path, Handlers.Method) with a method group handler
yes: MapMethods(path, new[]{"POST","PUT"}, handler)
yes: var g = app.MapGroup("/api/coupons"); g.MapGet("/", ...)
yes: routes registered in an IEndpointRouteBuilder extension method in another file
Microsoft.AspNetCore.Http not yet no: app.Run(async ctx => { if (ctx.Request.Path == "/x") ... }) terminal middleware
Microsoft.AspNetCore.Mvc partly yes: [Route] on the controller class + [HttpGet("{id}")] etc. on actions
yes: [Route("api/[controller]")] token replaced by the class name minus Controller
no: [AcceptVerbs("GET","HEAD", Route = "...")] naming several verbs
yes: [Route("~/...")] on an action, which replaces the class route
partly: MapControllerRoute("default", "{controller=Home}/{action=Index}/{id?}") with attribute-less controllers
Microsoft.AspNetCore.Mvc.RazorPages partly partly: @page "/basket/{id}" in .cshtml with OnGet/OnPost handlers
Microsoft.AspNetCore.Routing supported yes: app.UseEndpoints(endpoints => endpoints.MapGet(...)) (pre-.NET 6 Startup style)
Microsoft.AspNetCore.SignalR partly no: app.MapHub<THub>("/hubs/x") route
yes: public methods of a Hub subclass, called by clients with InvokeAsync("Name")
System.Net.HttpListener not yet no: HttpListener.Prefixes.Add(url) + GetContextAsync loop + path switch

HTTP client libraries (the calls your code makes to other services)

3 supported, 0 partly, 6 not yet.

Name Status Ways of using it that were tested
Dapr.Client not yet no: DaprClient.InvokeMethodAsync(HttpMethod.Get, "app-id", "path") and CreateInvokeHttpClient("app-id")
docker-compose (deployment) not yet no: a compose service name used as the host (http://<service>:8080) for a C# service
Flurl.Http not yet no: "url".AppendPathSegments(...).GetJsonAsync<T>() and "url".PostJsonAsync()
no: new FlurlClient(base).Request(path).GetJsonAsync<T>()
GraphQL.Client supported yes: new GraphQLHttpClient(url, serializer).SendQueryAsync(...)
Microsoft.AspNetCore.SignalR.Client supported yes: new HubConnectionBuilder().WithUrl(hubUrl).Build(); InvokeAsync("Method"); On<T>("Event")
Refit not yet no: interface with [Get("/x/{id}")] methods + AddRefitClient<T>().ConfigureHttpClient(BaseAddress)
no: RestService.For<T>(baseUrl).Method()
RestSharp supported yes: new RestRequest(template, Method.Get) + client.ExecuteAsync(request)
yes: client.GetJsonAsync<T>(path), PostJsonAsync, ExecutePostAsync
ServiceStack.Client not yet no: JsonServiceClient.Get(new Dto{...}) (route from the DTO) and Get<T>("/relative")
System.ServiceModel.Http not yet no: new ChannelFactory<T>(binding, new EndpointAddress(url)).CreateChannel().Op()

The language's own HTTP client

2 supported, 2 partly, 2 not yet.

Name Status Ways of using it that were tested
Microsoft.Extensions.Http (IHttpClientFactory) partly partly: AddHttpClient("name", c => c.BaseAddress = ...) + factory.CreateClient("name").GetAsync(path)
yes: AddHttpClient<TClient>(c => c.BaseAddress = ...) and HttpClient injected into TClient
Microsoft.Extensions.Http.Resilience / Polly supported yes: AddHttpClient<T>(...).AddStandardResilienceHandler() wrapping a typed client
System.Net.Http.HttpClient partly partly: GetAsync/PostAsync/GetStreamAsync with an absolute literal URL
partly: SendAsync(new HttpRequestMessage(HttpMethod.Put, url))
yes: static HttpClient { BaseAddress = new Uri(...) } + relative path
yes: interpolated $"http://host:port/path/{x}" URL
yes: "http://host/path/" + id concatenation
partly: base URL from IConfiguration["Services:X"] + path
partly: new Uri(new Uri(base), relative) as the request URI
System.Net.Http.Json supported yes: GetFromJsonAsync / PostAsJsonAsync / PutAsJsonAsync / DeleteFromJsonAsync extensions
System.Net.WebClient not yet no: new WebClient().DownloadString(url) / UploadString(url, "POST", body)
System.Net.WebRequest / HttpWebRequest not yet no: WebRequest.Create(url).GetResponse(); HttpWebRequest with Method = "POST"

gRPC

5 supported, 2 partly, 1 not yet.

Name Status Ways of using it that were tested
Grpc.AspNetCore partly yes: class X : {S}.{S}Base with public override Task<R> M(Req, ServerCallContext) (unary)
no: app.MapGrpcService<X>() registration (confirming signal)
yes: override Task M(Req, IServerStreamWriter<T>, ServerCallContext)
yes: override Task<R> M(IAsyncStreamReader<T>, ServerCallContext)
yes: override Task M(IAsyncStreamReader<A>, IServerStreamWriter<B>, ServerCallContext)
no: AddGrpc(o => o.Interceptors.Add<T>()) (must not hide the service)
Grpc.Core supported yes: new Server { Services = { X.BindService(new Impl()) }, Ports = {...} } with Impl : X.XBase
yes: new Channel("host:port", ChannelCredentials.Insecure) + new X.XClient(channel)
Grpc.Core.Api supported yes: new Method<Req,Res>(MethodType.Unary, "pkg.Svc", "M", m, m) + CallInvoker.BlockingUnaryCall
Grpc.Net.Client supported yes: GrpcChannel.ForAddress(url); new {S}.{S}Client(channel); await client.MAsync(req)
yes: client.M(req) blocking call, channel address from IConfiguration
yes: server/client/bidi streaming calls (no Async twin), ResponseStream.ReadAllAsync, RequestStream.WriteAsync
yes: channel.Intercept(interceptor) then new {S}.{S}Client(invoker)
Grpc.Net.ClientFactory supported yes: services.AddGrpcClient<{S}.{S}Client>(o => o.Address = new Uri(...)) then the client injected by type
Microsoft.AspNetCore.Grpc.JsonTranscoding partly partly: option (google.api.http) = { get: "/v1/orders/{order_id}" } in the proto + AddJsonTranscoding()
protobuf-net.Grpc not yet no: channel.CreateGrpcService<IContract>().MAsync(req)
protobuf-net.Grpc.AspNetCore supported yes: [Service("pkg.Svc")] / [ServiceContract(Name)] interface + [Operation] methods, MapGrpcService<Impl>(), AddCodeFirstGrpc()

Databases and data stores

10 supported, 5 partly, 11 not yet.

Name Status Ways of using it that were tested
AWSSDK.DynamoDBv2 partly yes: PutItemAsync/QueryAsync(new XRequest { TableName = "t" })
no: DynamoDBContext.SaveAsync(obj) with [DynamoDBTable("t")]
AWSSDK.S3 supported yes: PutObjectAsync(new PutObjectRequest { BucketName = "b" })
Azure.Storage.Blobs supported yes: GetBlobContainerClient("name").UploadBlobAsync
CassandraCSharpDriver supported yes: ISession.Execute(cql) / ExecuteAsync(new SimpleStatement(cql))
Dapper not yet no: conn.QueryFirstOrDefaultAsync<T>(sql) / Query<T>(const sql) / QueryMultiple
no: conn.ExecuteAsync("INSERT ...")
Dapper.Contrib not yet no: conn.Get<T>(id) / Insert<T> with [Table("name")]
Dapr.Client not yet no: DaprClient.SaveStateAsync("store", key, value)
Elastic.Clients.Elasticsearch not yet no: ElasticsearchClient.IndexAsync(doc, "index") / SearchAsync<T>(s => s.Index("x"))
EntityFramework (EF6) not yet no: System.Data.Entity DbContext + DbSet + ToTable + Database.ExecuteSqlCommand
linq2db not yet no: [Table("t")] + GetTable<T>()
Marten not yet no: IDocumentSession.Store(doc) / Query<T>() over PostgreSQL
Microsoft.Azure.Cosmos partly partly: client.GetContainer(db, "name") in a field + UpsertItemAsync / GetItemQueryIterator
Microsoft.Data.SqlClient partly yes: new SqlCommand("SELECT ... FROM t", conn) + ExecuteReaderAsync/ExecuteScalar
no: conn.CreateCommand(); cmd.CommandText = "UPDATE ..."; ExecuteNonQuery()
no: CommandType.StoredProcedure with the procedure name as command text
no: SqlBulkCopy { DestinationTableName = "t" }.WriteToServerAsync
Microsoft.Data.Sqlite not yet no: conn.CreateCommand() + CommandText
Microsoft.EntityFrameworkCore partly yes: DbSet<T> property + LINQ (Where/FirstOrDefaultAsync/ToListAsync)
yes: [Table("name")] on the entity
no: modelBuilder.Entity<T>().ToTable("name")
no: context.Set<T>() instead of a DbSet property
partly: FromSqlRaw / ExecuteSqlRawAsync with SQL text
yes: ExecuteUpdateAsync / ExecuteDeleteAsync bulk operations (EF Core 7+)
Microsoft.Extensions.Caching.Distributed supported yes: IDistributedCache.SetAsync/GetAsync (Redis backed)
MongoDB.Driver partly partly: GetCollection<T>("name") stored in a field, then Find/InsertOneAsync/UpdateOneAsync on the field
partly: db.GetCollection<T>("name").CountDocumentsAsync(...) inline
MySql.Data supported yes: Oracle MySql.Data MySqlCommand (namespace MySql.Data.MySqlClient)
MySqlConnector supported yes: MySqlCommand(sql, conn) + ExecuteScalarAsync
NEST not yet no: ElasticClient with DefaultIndex, IndexDocument, Search(s => s.Index("x"))
NHibernate not yet no: session.Query<T>(), Save, CreateSQLQuery; FluentNHibernate ClassMap Table("t")
Npgsql supported yes: NpgsqlCommand(sql, conn) + ExecuteScalarAsync
yes: NpgsqlDataSource.Create(cs).CreateCommand(sql) (Npgsql 7+)
yes: BeginBinaryImportAsync("COPY t ... FROM STDIN")
Oracle.ManagedDataAccess supported yes: OracleCommand(sql, conn)
StackExchange.Redis supported yes: IDatabase.StringSetAsync/StringGetAsync/HashIncrementAsync/ListLeftPushAsync
System.Data.Common (ADO.NET) not yet no: DbProviderFactories.GetFactory + DbConnection.CreateCommand + DbCommand
System.Data.SqlClient supported yes: the older package, same SqlCommand API

Messaging and events (queues, topics, streams)

10 supported, 8 partly, 12 not yet.

Name Status Ways of using it that were tested
.NET events and delegates not yet no: event EventHandler<T> OnX; OnX?.Invoke(...) inside one process
AWSSDK.EventBridge partly partly: PutEventsAsync(new PutEventsRequest { Entries = { new() { EventBusName, DetailType } } })
AWSSDK.SimpleNotificationService supported yes: PublishAsync(new PublishRequest { TopicArn }) and PublishAsync(topicArn, msg)
AWSSDK.SQS supported yes: SendMessageAsync(queueUrl, body) with the URL in a const
yes: ReceiveMessageAsync(new ReceiveMessageRequest { QueueUrl = ... })
Azure.Messaging.EventGrid not yet no: EventGridPublisherClient(endpoint, cred).SendEventAsync(new EventGridEvent(subject, type, ...))
Azure.Messaging.EventHubs not yet no: new EventHubProducerClient(cs, "hub").SendAsync(events)
Azure.Messaging.EventHubs.Processor not yet no: new EventProcessorClient(store, group, cs, "hub") + ProcessEventAsync += handler
Azure.Messaging.ServiceBus partly yes: client.CreateSender("queue").SendMessageAsync / ScheduleMessageAsync
no: CreateProcessor(topic, sub) + ProcessMessageAsync += handler + StartProcessingAsync
yes: CreateReceiver("queue").ReceiveMessageAsync()
Azure.Storage.Queues not yet no: new QueueClient(cs, "name").SendMessageAsync / ReceiveMessagesAsync
Confluent.Kafka supported yes: producer.ProduceAsync(topic, msg) and Produce(topic, msg, handler), topic as literal or const
yes: consumer.Subscribe(topic) + Consume loop in a BackgroundService
yes: consumer.Subscribe(new[] { "a", "b" })
Dapr.Client / Dapr.AspNetCore partly partly: DaprClient.PublishEventAsync(pubsub, topic, data); [Topic(pubsub, topic)] or .WithTopic
DotNetCore.CAP supported yes: ICapPublisher.PublishAsync(name, data) and [CapSubscribe(name)]
EasyNetQ not yet no: bus.PubSub.PublishAsync / SubscribeAsync<T>(id, handler); SendReceive.SendAsync/ReceiveAsync(queue)
Google.Cloud.PubSub.V1 supported yes: PublisherClient.CreateAsync(TopicName).PublishAsync; SubscriberClient.CreateAsync(SubscriptionName).StartAsync
Hangfire.Core not yet no: BackgroundJob.Enqueue/Schedule, RecurringJob.AddOrUpdate
MassTransit partly yes: IPublishEndpoint.Publish(new T()) and IConsumer<T>.Consume
yes: GetSendEndpoint(new Uri("queue:name")).Send(msg) + ReceiveEndpoint("name")
partly: IRequestClient<T>.GetResponse<TRes>(msg) and RespondAsync
MediatR supported yes: IMediator.Send/Publish and IRequestHandler/INotificationHandler (in-process)
Microsoft.AspNetCore.SignalR not yet no: Clients.All/Caller/Group(x).SendAsync("Event", ...) and IHubContext<T>
Microsoft.Azure.Functions.Worker not yet no: [ServiceBusOutput("q")] on the function (return value is the message)
Microsoft.Azure.Functions.Worker / WebJobs not yet no: [ServiceBusTrigger("q")], [QueueTrigger], [KafkaTrigger], [EventHubTrigger], [TimerTrigger] on a PARAMETER
MQTTnet supported yes: client.PublishAsync(builder.WithTopic(t)) and SubscribeAsync(filter) + ApplicationMessageReceivedAsync +=
NATS.Client supported yes: conn.Publish(subject, bytes) and conn.SubscribeAsync(subject, handler)
NATS.Net partly partly: NatsConnection.PublishAsync(subject, data); await foreach SubscribeAsync<T>(subject)
NServiceBus partly yes: IHandleMessages<T>.Handle + context.Publish
partly: IMessageSession.Send(msg) with RouteToEndpoint
Quartz partly partly: IScheduler.ScheduleJob(job, trigger) and IJob.Execute
RabbitMQ.Client partly yes: channel.BasicPublish("exchange", "routing.key", props, body)
yes: BasicPublish(exchange: "", routingKey: "q", ...) with named arguments
partly: EventingBasicConsumer + Received += handler + BasicConsume(queue: "q", ...)
yes: v7 BasicConsumeAsync + AsyncEventingBasicConsumer.ReceivedAsync
no: class X : DefaultBasicConsumer overriding HandleBasicDeliver
Rebus supported yes: IBus.Send(msg) and IHandleMessages<T>
StackExchange.Redis supported yes: ISubscriber.Publish/PublishAsync(RedisChannel.Literal("x"), msg) and Subscribe(channel, handler)
System.Threading.Channels not yet no: Channel.CreateBounded/Unbounded<T>(), Writer.WriteAsync, Reader.ReadAllAsync (in-process)
WolverineFx not yet no: IMessageBus.PublishAsync/SendAsync and convention handlers (class *Handler, method Handle)

Build tools and package managers

9 supported, 2 partly, 0 not yet.

Name Status Ways of using it that were tested
Microsoft.Build.Traversal (dirs.proj) supported yes: dirs.proj at the root building src/**/*.csproj, no .sln
MSBuild + .fsproj (F#) partly partly: a C# Web API calling an F# library in the same solution
MSBuild + .sln (SDK-style csproj) supported yes: .sln, src/ and tests/: Web SDK API and Worker SDK service with no <OutputType>, a class library, an xUnit project
MSBuild + .slnx and .slnf supported yes: XML solution file (.slnx) and a solution filter, no .sln
MSBuild + .vbproj (VB.NET) partly partly: a C# console app calling a VB.NET library
MSBuild Directory.Build.props / .targets supported yes: OutputType=Exe inherited from apps/Directory.Build.props; the csproj files are one line
MSBuild legacy (non-SDK) csproj, .NET Framework supported yes: ToolsVersion csproj with <Compile Include>, packages.config, restored packages/ folder; ASP.NET MVC 5 app with OutputType Library + Web.config + Global.asax
MSBuild shared project (.shproj + .projitems) supported yes: files compiled into each importing app; the shared folder has no assembly
NuGet central package management supported yes: Directory.Packages.props with PackageVersion; PackageReference without Version; global.json; nuget.config
NUKE, Cake, dotnet tool, Roslyn source generator supported yes: build/_build.csproj (NUKE, Exe), build.cake, tools/Orders.Cli (PackAsTool), src/Orders.Generators (IsRoslynComponent, referenced as Analyzer), one Web API
project.json (.NET Core 1.0 preview tooling) supported yes: project.json per project, global.json "projects", no csproj

Project and folder layouts

7 supported, 0 partly, 0 not yet.

Name Status Ways of using it that were tested
Azure Functions project supported yes: isolated worker app (OutputType Exe, AzureFunctionsVersion, host.json) and in-process app (Microsoft.NET.Sdk.Functions, no OutputType)
Blazor WebAssembly hosted template supported yes: Client (BlazorWebAssembly SDK), Server (Web SDK, references Client), Shared
C# top-level statements (Program.cs) supported yes: Program.cs with no class or Main, the default template since .NET 6
MSBuild output folders supported yes: bin/, obj/ (generated *.g.cs), .vs/, TestResults/, artifacts/, packages/ present, no .gitignore
yes: the same with the standard Visual Studio .gitignore ([Bb]in/, [Oo]bj/, **/[Pp]ackages/*)
MSBuild SDK-style supported yes: a console app (OutputType Exe, top-level statements), a Worker SDK service with no OutputType, a library; projects at the repo root, no solution
yes: one csproj at the repository root, folders for controllers, services and models
yes: services/<name>/<name>.csproj and libs/<name>, no solution, no deploy descriptor
MSBuild SDK-style, WPF supported yes: WPF app (OutputType WinExe, UseWPF, net8.0-windows) with XAML code-behind, and a library
MSBuild test projects (xUnit v2, xUnit v3, NUnit, MSTest) supported yes: unit and integration tests; the xUnit v3 project is OutputType Exe; one MSTest project not named *.Tests

Deployment files

3 supported, 0 partly, 0 not yet.

Name Status Ways of using it that were tested
.NET Aspire AppHost supported yes: AppHost (Aspire.AppHost.Sdk, IsAspireHost) declaring AddProject<Projects.X>("name"), ServiceDefaults library, two services, service discovery URL http://catalog-api
ASP.NET Core address settings supported yes: launchSettings.json applicationUrl, appsettings.json Kestrel:Endpoints:Http:Url, compose ASPNETCORE_URLS
Dockerfile + docker-compose (Visual Studio container tools) supported yes: Dockerfile inside each project folder, built with context "."; compose services with context: . and dockerfile: src/X/Dockerfile