RicoSuter/NSwag

.net6 minimal API - OpenApiOperation Attribute does not work

Open

#3 802 ouverte le 21 déc. 2021

Voir sur GitHub
 (4 commentaires) (1 réaction) (0 assignés)C# (1 189 forks)batch import
help wanted

Métriques du dépôt

Stars
 (6 291 stars)
Métriques de merge PR
 (Aucune PR mergée en 30 j)

Description

Using Nswag.Annotations.OpenApiOperation does not seem to work with the new minimal API.

Example code:

var app = builder.Build();
app.MapPost("/Test", Test).WithTags("MyTag");

[OpenApiOperation("MySummary", "MyDescription")]
static string Test(string foo) {
    return foo;
}

Guide contributeur

Direction de recherche
Étudiez comment l'attribut OpenApiOperation de NSwag.Annotations est géré dans le contexte des API minimales .NET. Examinez le code source de NSwag, en particulier le processeur d'opération ou le filtre qui lit cet attribut, et comparez le avec l'approche traditionnelle basée sur les contrôleurs. Vérifiez s'il y a des commits ou des discussions récentes sur ce problème (issue #3802) indiquant une solution de contournement connue ou une correction planifiée. Le résultat attendu est une reproduction minimale ou un correctif permettant à l'attribut de fonctionner avec app.MapPost.
Stack technique
csharp
Domaine
backend
Type d'issue
Bug
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
C#.NETOpenAPI/Swagger
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
60