@niroai/niro 0.17.0 → 1.0.0

package/docs/supported-c.md

@@ -0,0 +1,130 @@
+# Supported in C
+
+<!-- GENERATED by scripts/gen-supported-docs.js. Do not edit by hand: run the script again. -->
+<!-- source: catalog/c.json; catalog/c.structure.json -->
+<!-- measured: coverage corpus 1bb4ebb, niro-local 2b30d4fd -->
+
+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-and-consent.md](coverage-audit-and-consent.md)).
+<!-- source: niro-coverage-corpus README.md ("Synthetic test code ... All names are made up"); catalog status merged pairs one to one with measured found -->
+
+## Web frameworks and HTTP servers (the routes your code serves)
+
+0 supported, 0 partly, 10 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| Cesanta mongoose | not yet | no: mg_http_listen + handler that matches hm->uri with mg_match<br>no: mg_http_match_uri(hm, path) (mongoose 7.0 to 7.13) |
+| civetweb (C API) | not yet | no: mg_set_request_handler(ctx, path, handler, cbdata)<br>no: mg_set_websocket_handler(ctx, path, ...)<br>no: mg_set_auth_handler(ctx, path, handler, cbdata) |
+| facil.io | not yet | no: http_listen with one on_request; path compared inside |
+| GNU libmicrohttpd | not yet | no: one MHD_AccessHandlerCallback; url and method compared inside it |
+| Kore | not yet | no: routes declared in kore.conf (`route /path handler`) |
+| libevent evhttp | not yet | no: evhttp_set_cb(http, path, cb, arg) |
+| libh2o | not yet | no: h2o_config_register_path(hostconf, path, flags) + handler |
+| libsoup (GNOME) | not yet | no: soup_server_add_handler(server, path, cb, data, destroy) |
+| Lwan | not yet | no: lwan_url_map array of {.prefix, .handler} |
+| Ulfius | not yet | no: ulfius_add_endpoint_by_val(inst, verb, prefix, template, priority, cb, data) |
+
+## The language's own HTTP server
+
+0 supported, 0 partly, 1 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| POSIX sockets (no library) | not yet | no: socket/bind/listen/accept, request line read with sscanf, path compared with strcmp |
+
+## HTTP client libraries (the calls your code makes to other services)
+
+0 supported, 0 partly, 6 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| Cesanta mongoose | not yet | no: mg_http_connect(mgr, url, fn, data); request written in fn |
+| civetweb (C API) | not yet | no: mg_download(host, port, ssl, ebuf, len, request line) |
+| libcurl | not yet | no: curl_easy_setopt(h, CURLOPT_URL, literal) then curl_easy_perform<br>no: CURLOPT_URL then CURLOPT_POSTFIELDS (verb is POST)<br>no: CURLOPT_CUSTOMREQUEST names the verb<br>no: base URL from getenv, path appended with snprintf<br>no: curl_url_set(h, CURLUPART_URL, literal) + CURLOPT_CURLU<br>no: easy handle with URL added to a multi handle<br>no: URL in a #define used as the option value |
+| libevent evhttp | not yet | no: evhttp_connection_base_new(base, dns, host, port) + evhttp_make_request(conn, req, verb, path) |
+| libsoup (GNOME) | not yet | no: soup_message_new(verb, url) + soup_session_send_and_read |
+| neon | not yet | no: ne_session_create(scheme, host, port) + ne_request_create(sess, verb, path) |
+
+## The language's own HTTP client
+
+0 supported, 0 partly, 1 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| POSIX sockets (no library) | not yet | no: getaddrinfo + connect + send of a hand-written request line |
+
+## gRPC
+
+0 supported, 0 partly, 1 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| gRPC core C API | not yet | no: grpc_channel_create + grpc_channel_create_call with a method slice |
+
+## Databases and data stores
+
+0 supported, 4 partly, 4 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| hiredis | partly | yes: redisCommand(ctx, "VERB key ...", args)<br>no: redisCommandArgv(ctx, argc, argv, lens)<br>no: redisAppendCommand (pipelining) + redisGetReply |
+| libmemcached | not yet | no: memcached_set / memcached_get / memcached_delete with a key |
+| libmysqlclient / MariaDB Connector/C | partly | no: mysql_real_connect(conn, host, user, pw, db, port, ...)<br>yes: mysql_query(conn, sql)<br>yes: mysql_real_query(conn, sql_variable, len)<br>no: mysql_stmt_prepare(stmt, sql, len) + mysql_stmt_execute |
+| libpq | partly | no: PQconnectdb with a URI or key=value connection string<br>partly: PQexec(conn, sql)<br>yes: PQexecParams(conn, sql, n, types, values, ...)<br>yes: PQprepare(conn, name, sql, ...) then PQexecPrepared(conn, name, ...)<br>no: PQsendQuery / PQsendQueryParams (asynchronous) |
+| LMDB / Berkeley DB | not yet | no: embedded key-value stores (mdb_put, db->put) |
+| MongoDB C driver (libmongoc) | not yet | no: mongoc_client_get_collection(client, db, name) + insert_one / find_with_opts / update_one / delete_one<br>no: mongoc_database_get_collection(db, name) |
+| ODBC (unixODBC / Windows driver manager) | not yet | no: SQLExecDirect(stmt, sql, SQL_NTS) and SQLPrepare + SQLExecute |
+| SQLite C API | partly | yes: sqlite3_exec(db, sql, cb, arg, err)<br>no: sqlite3_prepare_v2(db, SQL_CONSTANT, -1, &stmt, NULL)<br>no: sqlite3_prepare_v3 (and sqlite3_prepare16_v2) |
+
+## Messaging and events (queues, topics, streams)
+
+1 supported, 0 partly, 11 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| CZMQ | not yet | no: zsock_new_pub("@tcp://...") / zsock_new_sub(">tcp://...", prefix) |
+| D-Bus (libdbus / sd-bus) | not yet | no: dbus_message_new_signal(path, iface, name) / sd_bus_emit_signal |
+| Eclipse Paho MQTT C | not yet | no: MQTTClient_publishMessage(client, topic, &msg, &token)<br>no: MQTTClient_publish(client, topic, len, payload, qos, retained, &token)<br>no: MQTTClient_subscribe(client, topic, qos)<br>no: MQTTAsync_sendMessage / MQTTAsync_subscribe |
+| hiredis | not yet | no: redisCommand(ctx, "PUBLISH channel %s", payload)<br>no: redisAsyncCommand(ac, cb, data, "SUBSCRIBE channel") |
+| libmosquitto | supported | yes: mosquitto_publish(mosq, mid, topic, len, payload, qos, retain)<br>yes: mosquitto_subscribe(mosq, mid, topic, qos) |
+| libpq | not yet | no: PQexec(conn, "LISTEN ch") / "NOTIFY ch" (PostgreSQL pub-sub) |
+| librdkafka (C API) | not yet | no: rd_kafka_topic_new(rk, name, conf) then rd_kafka_produce(rkt, ...)<br>no: rd_kafka_producev(rk, RD_KAFKA_V_TOPIC(name), ...)<br>no: rd_kafka_topic_partition_list_add(list, name, part) + rd_kafka_subscribe |
+| nanomsg | not yet | no: nn_socket(AF_SP, NN_PUB) + nn_bind + nn_send; nn_connect for SUB |
+| NATS C client (cnats) | not yet | no: natsConnection_PublishString(nc, subject, data)<br>no: natsConnection_Subscribe(&sub, nc, subject, cb, closure)<br>no: natsConnection_RequestString(&reply, nc, subject, data, timeout) |
+| nng | not yet | no: nng_pub0_open + nng_listen; nng_sub0_open + NNG_OPT_SUB_SUBSCRIBE + nng_dial |
+| rabbitmq-c (librabbitmq) | not yet | no: amqp_basic_publish(conn, ch, exchange, routing_key, ...)<br>no: amqp_queue_declare + amqp_basic_consume(conn, ch, queue, ...) |
+| ZeroMQ (libzmq) | not yet | no: zmq_socket(ctx, ZMQ_PUB) + zmq_bind(addr) + zmq_send<br>no: zmq_connect(addr) + zmq_setsockopt(ZMQ_SUBSCRIBE, prefix)<br>no: ZMQ_REP bound socket answering ZMQ_REQ peers |
+
+## Build tools and package managers
+
+7 supported, 0 partly, 0 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| CMake (C project) | supported | yes: root project() + add_subdirectory per library and service; target_link_libraries |
+| GNU Autotools | supported | yes: configure.ac + Makefile.am per folder: bin_PROGRAMS, lib_LTLIBRARIES, check_PROGRAMS |
+| GNU Make | supported | yes: one Makefile at the root, sources in src/, one binary |
+| GNU Make (recursive) | supported | yes: top Makefile with SUBDIRS and $(MAKE) -C, one Makefile per folder |
+| Meson | supported | yes: meson.build with subdir(); executable(), static_library(), declare_dependency(), test() |
+| PlatformIO | supported | yes: platformio.ini with src/, lib/<name>/, test/, and .pio/ output |
+| SCons | supported | yes: SConstruct + SConscript per folder; Program() and StaticLibrary() |
+
+## Project and folder layouts
+
+5 supported, 0 partly, 0 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| Bison and Flex output checked in | supported | yes: gen/parser.tab.c and gen/lexer.c next to the .y grammar |
+| CMake (include/ + src/ + apps/ + tests/) | supported | yes: public headers in include/<name>/, sources in src/, one root CMakeLists |
+| CMake build folders and vendored copies | supported | yes: build/ and cmake-build-debug/ (CLion) output; third_party/ and deps/ vendored libraries |
+| GNU Make + tests/ with its own Makefile | supported | yes: a test folder whose Makefile builds a test binary with a main |
+| no build tool (shell script) | supported | yes: flat folder of .c files compiled by build.sh |

package/docs/supported-cpp.md

@@ -0,0 +1,157 @@
+# Supported in C++
+
+<!-- GENERATED by scripts/gen-supported-docs.js. Do not edit by hand: run the script again. -->
+<!-- source: catalog/cpp.json; catalog/cpp.structure.json -->
+<!-- measured: coverage corpus 1bb4ebb, niro-local 2b30d4fd -->
+
+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-and-consent.md](coverage-audit-and-consent.md)).
+<!-- source: niro-coverage-corpus README.md ("Synthetic test code ... All names are made up"); catalog status merged pairs one to one with measured found -->
+
+## Web frameworks and HTTP servers (the routes your code serves)
+
+3 supported, 2 partly, 10 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| Boost.Beast | not yet | no: one handler comparing req.method() and req.target() |
+| civetweb C++ (CivetServer) | not yet | no: server.addHandler(path, handler) with CivetHandler::handleGet/handlePost |
+| cpp-httplib | supported | yes: svr.Get(path, lambda)<br>yes: svr.Post(path, named_function)<br>yes: regex path in a raw string literal<br>yes: path parameter written :id (cpp-httplib 0.10+) |
+| cpprestsdk (Casablanca) | not yet | no: http_listener(U("http://host:port/path")) + listener.support(methods::GET, h) |
+| Crow | supported | yes: CROW_ROUTE(app, path)(handler), GET by default<br>yes: .methods("POST"_method)<br>yes: .methods(crow::HTTPMethod::Delete)<br>yes: crow::Blueprint bp(prefix) + CROW_BP_ROUTE(bp, path)<br>yes: CROW_WEBSOCKET_ROUTE(app, path)<br>yes: CROW_CATCHALL_ROUTE(app)<br>yes: app.route_dynamic(path)(handler) |
+| Drogon | partly | yes: app().registerHandler(path, handler, {Get})<br>yes: registerHandler(path, handler, {drogon::Post, drogon::Put})<br>no: HttpController<T> with METHOD_LIST_BEGIN, ADD_METHOD_TO (absolute) and METHOD_ADD (relative to /ns/Class)<br>no: HttpSimpleController<T> with PATH_ADD(path, verbs)<br>partly: WebSocketController<T> with WS_PATH_ADD(path) |
+| Oat++ | not yet | no: ENDPOINT("VERB", "/path", name, params...) inside an ApiController |
+| Pistache | supported | yes: Routes::Get(router, path, Routes::bind(&C::m, this)) |
+| POCO Net | not yet | no: HTTPRequestHandlerFactory::createRequestHandler comparing request.getURI() |
+| Qt HTTP Server | not yet | no: QHttpServer::route(path, QHttpServerRequest::Method::X, h) |
+| RESTinio | not yet | no: router->http_get(path, h), http_post, http_put, http_delete |
+| Seastar httpd | not yet | no: routes.add(operation_type::GET, url("/x"), handler) |
+| userver | not yet | no: HttpHandlerBase subclass; path in static_config.yaml (`path: /v1/orders`) |
+| uWebSockets | partly | partly: uWS::App().get(path, h).post(...).del(...).ws<T>(path, ...) |
+| Wt | not yet | no: WServer::addResource(&resource, path) |
+
+## The language's own HTTP server
+
+0 supported, 0 partly, 2 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| Boost.Asio (raw TCP) | not yet | no: acceptor + read_until("\r\n\r\n") + hand-parsed request line |
+| POSIX sockets (no library) | not yet | no: accept + recv, request line split with istringstream, compared with == |
+
+## HTTP client libraries (the calls your code makes to other services)
+
+1 supported, 0 partly, 10 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| Boost.Beast | not yet | no: resolver.resolve(host, port) + http::request<...>{http::verb::get, target, 11} |
+| cpp-httplib | not yet | no: httplib::Client cli(base or host, port); cli.Get(path), Post, Delete |
+| cpprestsdk (Casablanca) | not yet | no: http_client(U(base)).request(methods::GET, U(path)) |
+| cpr | not yet | no: cpr::Get(cpr::Url{literal})<br>no: cpr::Post(cpr::Url{...}, cpr::Body{...}, cpr::Header{...})<br>no: cpr::Session; session.SetUrl(cpr::Url{...}); session.Get()<br>no: cpr::Url{std::string(std::getenv("X")) + "/path"} |
+| curlpp / cpp-netlib | not yet | no: curlpp::options::Url(url); boost::network::http::client::request(url) |
+| Drogon | not yet | no: HttpClient::newHttpClient(base); req->setPath(p); req->setMethod(drogon::Get); client->sendRequest(req) |
+| libcurl | not yet | no: curl_easy_setopt(h, CURLOPT_URL, literal) from C++ |
+| Oat++ | not yet | no: ApiClient with API_CALL("VERB", "/path", name) |
+| POCO Net | not yet | no: HTTPClientSession(host, port) + HTTPRequest(HTTP_GET, path) + sendRequest |
+| Qt Network | not yet | no: QNetworkAccessManager::get / post / deleteResource(QNetworkRequest(QUrl(url))) |
+| restclient-cpp | supported | yes: RestClient::get(url), post(url, type, body) |
+
+## The language's own HTTP client
+
+0 supported, 0 partly, 2 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| POSIX sockets (no library) | not yet | no: getaddrinfo + connect + send of a request line |
+| WinHTTP (Windows built-in) | not yet | no: WinHttpConnect(session, host, port) + WinHttpOpenRequest(conn, verb, path) |
+
+## gRPC
+
+0 supported, 1 partly, 1 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| Apache bRPC | not yet | no: protobuf service implemented by a class, server.AddService(&impl, ...) |
+| gRPC C++ | partly | yes: class X : public pkg::S::Service with override methods (grpc-plan.md section 3 (cpp row) and 8.1)<br>yes: override taking ServerWriter<T>* / ServerReader<T>* / ServerReaderWriter<A,B>*<br>yes: S::AsyncService member; service_.RequestM(&ctx, &req, &responder, cq, cq, tag)<br>yes: class X : public S::CallbackService with reactor overrides (incl. bidi)<br>partly: auto stub = S::NewStub(channel); stub->M(&ctx, req, &reply)<br>yes: stub->AsyncM(...) and stub->PrepareAsyncM(...) (prefix stripped)<br>yes: stub->async()->M(&ctx, &req, &reply, callback)<br>yes: std::unique_ptr<ClientReader<T>> reader(stub->M(&ctx, req))<br>yes: grpc::CreateChannel(std::getenv("X"), creds) feeding NewStub<br>yes: grpc::GenericStub::PrepareUnaryCall(&ctx, "/pkg.S/M", buf, &cq)<br>no: AsyncGenericService / CallbackGenericService (method chosen at run time) |
+
+## Databases and data stores
+
+0 supported, 1 partly, 14 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| AWS SDK for C++ (DynamoDB) | not yet | no: PutItemRequest req; req.SetTableName(name); client.PutItem(req) |
+| DataStax C/C++ driver (Cassandra, ScyllaDB) | not yet | no: cass_statement_new(cql, n) + cass_session_execute |
+| Drogon ORM | not yet | no: db->execSqlAsync(sql, ok, err, args...)<br>no: db->execSqlSync(sql, args...)<br>no: orm::Mapper<Model>(db).findAll() (table from the generated model) |
+| hiredis (from C++) | not yet | no: redisCommand(ctx.get(), "SET key %s", ...) in a .cpp file |
+| libpqxx | partly | partly: tx.exec(sql)<br>no: tx.exec_params(sql, args...)<br>no: tx.query<T...>(sql) (libpqxx 7.8+)<br>yes: tx.query_value<T>(sql)<br>yes: tx.query1<T>(sql)<br>no: c.prepare(name, sql) then tx.exec_prepared(name, args)<br>no: pqxx::connection c{uri} |
+| MongoDB C++ driver (mongocxx) | not yet | no: db.collection(name).insert_one / find_one<br>no: auto coll = db["ratings"]; coll.update_one(...)<br>no: collection(name).aggregate(pipeline) |
+| MySQL Connector/C++ (JDBC API) | not yet | no: stmt->executeQuery(sql)<br>no: con->prepareStatement(sql) + executeUpdate<br>no: stmt->execute(sql) |
+| MySQL Connector/C++ (X DevAPI) | not yet | no: sess.getSchema(db).getTable(name).select(...) / getCollection(name).add(...) |
+| ODB / sqlpp11 | not yet | no: typed ORMs (db->persist(obj), select(...).from(tab)) |
+| POCO Data | not yet | no: session << "SQL", into(x), use(y), now |
+| Qt SQL | not yet | no: QSqlQuery::exec(sql) and prepare(sql) + exec() |
+| redis-plus-plus | not yet | no: redis.set(key, v), get(key), del(key)<br>no: redis.hset(key, field, v), hget(key, field)<br>no: redis.command<T>("VERB", key, ...) |
+| SOCI | not yet | no: sql << "SELECT ...", soci::use(x), soci::into(y)<br>no: soci::statement st = (sql.prepare << "...", use(...)); st.execute(true)<br>no: soci::rowset<soci::row> rs = (sql.prepare << "SELECT ...") |
+| sqlite_orm | not yet | no: make_storage(file, make_table(name, columns...)); storage.get_all<T>() |
+| SQLiteC++ | not yet | no: SQLite::Database::exec(sql)<br>no: SQLite::Statement query(db, sql) |
+
+## Messaging and events (queues, topics, streams)
+
+0 supported, 0 partly, 9 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| AMQP-CPP (Copernica) | not yet | no: channel.publish(exchange, routing_key, body)<br>no: channel.consume(queue).onReceived(cb)<br>no: declareExchange / declareQueue / bindQueue(exchange, queue, key) |
+| AWS SDK for C++ (SQS) | not yet | no: SendMessageRequest.SetQueueUrl(url) + sqs.SendMessage; ReceiveMessageRequest |
+| cppkafka | not yet | no: producer.produce(MessageBuilder(topic).partition(p).payload(x))<br>no: BufferedProducer.add_message(make_builder(topic)...)<br>no: consumer.subscribe({topics}); consumer.poll() |
+| cppzmq | not yet | no: zmq::socket_t s(ctx, zmq::socket_type::pub); s.bind(addr); s.send(...)<br>no: s.connect(addr); s.set(zmq::sockopt::subscribe, prefix)<br>no: zmq::socket_type::rep bound; recv then send |
+| Eclipse Paho MQTT C++ | not yet | no: cli.publish(topic, payload, qos, retained)<br>no: mqtt::make_message(topic, payload) then cli.publish(msg)<br>no: cli.subscribe(topic, qos); consume_message()<br>no: mqtt::topic t(cli, name, qos); t.publish(payload)<br>no: mqtt::client (synchronous) publish(make_message(...)) |
+| librdkafka C++ API | not yet | no: producer->produce(topic_name, partition, flags, payload, len, ...)<br>no: RdKafka::Topic::create(producer, name, conf, err) then produce(topic, ...)<br>no: KafkaConsumer::create + consumer->subscribe({topics}) |
+| NATS C client (from C++) | not yet | no: natsConnection_PublishString / Subscribe called from C++ |
+| redis-plus-plus | not yet | no: redis.publish(channel, message)<br>no: auto sub = redis.subscriber(); sub.subscribe(channel); sub.consume() |
+| SimpleAmqpClient | not yet | no: ch->BasicPublish(exchange, routing_key, BasicMessage::Create(body))<br>no: ch->DeclareQueue(q); ch->BasicConsume(q); BasicConsumeMessage(tag) |
+
+## Build tools and package managers
+
+14 supported, 0 partly, 0 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| Bazel (Bzlmod) | supported | yes: MODULE.bazel + BUILD.bazel with cc_binary / cc_library / cc_test; bazel-out and bazel-bin output |
+| Bazel (WORKSPACE) | supported | yes: WORKSPACE + BUILD files (pre-Bzlmod) |
+| CMake | supported | yes: root aggregator + add_subdirectory; add_library and two add_executable; target_link_libraries |
+| CMake FetchContent | supported | yes: FetchContent_Declare + MakeAvailable; fetched sources under build/_deps |
+| CMake presets | supported | yes: CMakePresets.json with binaryDir out/build/<preset> (Visual Studio and VS Code default) |
+| Conan (conanfile.txt) | supported | yes: conanfile.txt [requires] / [generators] over a CMake tree |
+| Conan 2 (conanfile.py) | supported | yes: conanfile.py with cmake_layout over a CMake tree; generators under build/<cfg>/generators |
+| GN + Ninja | supported | yes: BUILD.gn with executable() / static_library(); .gn root; out/<dir> output |
+| Meson with wraps | supported | yes: meson.build subdir() tree; subprojects/*.wrap and downloaded sources; builddir/ |
+| MSBuild (Visual Studio .sln + .vcxproj) | supported | yes: .sln listing .vcxproj files; ConfigurationType Application / StaticLibrary; ProjectReference; x64/Release output |
+| Premake 5 | supported | yes: one premake5.lua at the root with project blocks, kind ConsoleApp / StaticLib |
+| qmake (Qt) | supported | yes: TEMPLATE = subdirs root, TEMPLATE = app and TEMPLATE = lib .pro files |
+| vcpkg manifest mode | supported | yes: vcpkg.json + vcpkg-configuration.json; packages installed in vcpkg_installed/ |
+| xmake | supported | yes: xmake.lua with target(), set_kind("binary" \| "static" \| "shared"), add_deps |
+
+## Project and folder layouts
+
+6 supported, 2 partly, 0 not yet.
+
+| Name | Status | Ways of using it that were tested |
+|---|---|---|
+| C library + C++ service (extern "C") | supported | yes: a .c library with an extern "C" guarded header called from .cpp |
+| CMake | partly | yes: aggregators two levels deep: services/orders/{core,api}, libs/pricing<br>yes: one root CMakeLists declaring a library and two executables over src/<target>/<br>yes: examples/ and benchmarks/ executables declared EXCLUDE_FROM_ALL<br>yes: add_executable(... IMPORTED) for a tool, add_library(Shop::pricing ALIAS pricing)<br>yes: add_library(x INTERFACE) header-only and add_library(y OBJECT)<br>partly: two programs whose main functions are byte-identical, no namespace |
+| CMake + GoogleTest / Catch2 | supported | yes: test folders whose add_executable is registered with gtest_discover_tests or add_test |
+| header-only library | supported | yes: a library with only include/<name>/*.hpp and an INTERFACE target |
+| include/ + src/ + apps/ (Pitchfork-style) | supported | yes: public headers include/<proj>/, implementation src/, binaries apps/<name>/ |
+| native addon inside a Node package (node-gyp / cmake-js) | supported | yes: binding.gyp and a CMakeLists under a package.json |
+| protoc output checked in | partly | partly: proto/gen/*.pb.cc, *.grpc.pb.cc next to the .proto files |
+| vendored and submodule dependencies | supported | yes: third_party/, external/ (git submodule), extern/ copies of public libraries |

package/docs/supported-csharp.md

@@ -0,0 +1,211 @@
+# Supported in C#
+
+<!-- GENERATED by scripts/gen-supported-docs.js. Do not edit by hand: run the script again. -->
+<!-- source: catalog/csharp.json; catalog/csharp.structure.json -->
+<!-- measured: coverage corpus 1bb4ebb, niro-local 2b30d4fd -->
+
+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-and-consent.md](coverage-audit-and-consent.md)).
+<!-- source: niro-coverage-corpus README.md ("Synthetic test code ... All names are made up"); catalog status merged pairs one to one with measured found -->
+
+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.
+<!-- source: catalog/csharp.json and catalog/csharp.structure.json, rows marked as traps (scripts/gen-supported-docs.js isTrap) -->
+
+## 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<br>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<br>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)<br>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<br>yes: MapGet(path, Handlers.Method) with a method group handler<br>yes: MapMethods(path, new[]{"POST","PUT"}, handler)<br>yes: var g = app.MapGroup("/api/coupons"); g.MapGet("/", ...)<br>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<br>yes: [Route("api/[controller]")] token replaced by the class name minus Controller<br>no: [AcceptVerbs("GET","HEAD", Route = "...")] naming several verbs<br>yes: [Route("~/...")] on an action, which replaces the class route<br>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<br>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()<br>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)<br>no: RestService.For<T>(baseUrl).Method() |
+| RestSharp | supported | yes: new RestRequest(template, Method.Get) + client.ExecuteAsync(request)<br>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)<br>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<br>partly: SendAsync(new HttpRequestMessage(HttpMethod.Put, url))<br>yes: static HttpClient { BaseAddress = new Uri(...) } + relative path<br>yes: interpolated $"http://host:port/path/{x}" URL<br>yes: "http://host/path/" + id concatenation<br>partly: base URL from IConfiguration["Services:X"] + path<br>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)<br>no: app.MapGrpcService<X>() registration (confirming signal)<br>yes: override Task M(Req, IServerStreamWriter<T>, ServerCallContext)<br>yes: override Task<R> M(IAsyncStreamReader<T>, ServerCallContext)<br>yes: override Task M(IAsyncStreamReader<A>, IServerStreamWriter<B>, ServerCallContext)<br>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<br>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)<br>yes: client.M(req) blocking call, channel address from IConfiguration<br>yes: server/client/bidi streaming calls (no Async twin), ResponseStream.ReadAllAsync, RequestStream.WriteAsync<br>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" })<br>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<br>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<br>no: conn.CreateCommand(); cmd.CommandText = "UPDATE ..."; ExecuteNonQuery()<br>no: CommandType.StoredProcedure with the procedure name as command text<br>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)<br>yes: [Table("name")] on the entity<br>no: modelBuilder.Entity<T>().ToTable("name")<br>no: context.Set<T>() instead of a DbSet property<br>partly: FromSqlRaw / ExecuteSqlRawAsync with SQL text<br>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<br>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<br>yes: NpgsqlDataSource.Create(cs).CreateCommand(sql) (Npgsql 7+)<br>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<br>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<br>no: CreateProcessor(topic, sub) + ProcessMessageAsync += handler + StartProcessingAsync<br>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<br>yes: consumer.Subscribe(topic) + Consume loop in a BackgroundService<br>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<br>yes: GetSendEndpoint(new Uri("queue:name")).Send(msg) + ReceiveEndpoint("name")<br>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<br>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)<br>yes: BasicPublish(exchange: "", routingKey: "q", ...) with named arguments<br>partly: EventingBasicConsumer + Received += handler + BasicConsume(queue: "q", ...)<br>yes: v7 BasicConsumeAsync + AsyncEventingBasicConsumer.ReceivedAsync<br>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<br>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<br>yes: one csproj at the repository root, folders for controllers, services and models<br>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 |