KnstAsyncApi 1.0.3-pre

Reference and Thanks

AsyncApi
tehmantra/saunter
domaindrivendev/Swashbuckle.AspNetCore
dotnet-architecture/eShopOnContainers
RicoSuter/Namotion.Reflection
JeringTech/Javascript.NodeJS

KnstAsyncApi & KnstAsyncApiUI

Requirements

• Node.js v12.16+
• npm v6.13.7+

Add "Target Tag" into your .csproj file

<Target Name="NpmInstall" AfterTargets="Build;Publish;" Condition="!Exists('bin\$(Configuration)\$(TargetFramework)\node_modules')">
    <Exec WorkingDirectory="bin\$(Configuration)\$(TargetFramework)\" Command="npm install" ContinueOnError="true">
        <Output TaskParameter="ExitCode" PropertyName="ErrorCode" />
    </Exec>
    <Error Condition="'$(ErrorCode)' != '0'" Text="Node.js/npm is required to build this project. To continue, please install Node.js from https://nodejs.org/ or Visual Studio Installer, and then restart your command prompt or IDE." />
</Target>

Register in Startup.cs ConfigureServices

services.AddAsyncApi(options =>
{
    options.AsyncApi = new AsyncApiDocument
    {
        Info = new Info("Async API", "1.0.0")
        {
            Description = "Description"
        }
    };
});
services.AddAsyncApiUI();

Use middleware

app.UseAsyncApi();
app.UseAsyncApiUI();

Add AsyncApi document mark

[AsyncApi]
[Channel]
[Message]
[Publish]
[Subscribe]

/// <summary>
/// HelloWorld Channel(Topic) Summary
/// </summary>
[AsyncApi]
[Channel("pubsub/HelloWorld")]
[Message(typeof(HelloWorld))]
public class HelloWorldChannel : IChannel<HelloWorld>
{
    /// <summary>
    /// HelloWorld Pub Summary
    /// </summary>
    [Publish]
    public Task PublishAsync(HelloWorld @event) => Task.CompletedTask;

    /// <summary>
    /// HelloWorld Sub Summary
    /// </summary>
    [Subscribe]
    public Task SubscribeAsync() => Task.CompletedTask;

    public Task UnSubscribeAsync() => Task.CompletedTask;
}

Visit your document

https://{domain-host}/asyncapi/asyncapi.json
https://localhost:5001/asyncapi/asyncapi.json
https://{domain-host}/asyncapi/index.html
https://localhost:5001/asyncapi/index.html

You can run my toys to get example.