Supported in C#
This page lists the C# libraries, frameworks and build tools Niro was tested against, and whether it recognised each one.
What the marks mean.
- Supported: Niro recognised every way of using it that the test code tries.
- Partly: Niro recognised some of those ways, or recognised one only in part.
- Not yet: Niro did not recognise it in the test code.
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 |