RicoSuter/NSwag

IOperationNameGenerator based on tag name

Open

#1,823 opened on Dec 13, 2018

View on GitHubContributor guide
 (2 comments) (2 reactions) (0 assignees)C# (1,356 forks)batch import
help wantedtype: enhancement

Repository metrics

Stars
 (7,358 stars)
PR merge metrics
 (PR metrics pending)

Description

Hi, Redoc groups API endpoints based on tags and I would like to have the same structure for my clients.

Would be great to have a IOperationNameGenerator that creates client class names based on tags.

Contributor guide

Research direction
Implement a new IOperationNameGenerator that generates operation names based on the Swagger tags. Study the existing implementations (e.g., MultipleClientsFromOperationIdOperationNameGenerator) and the client generation pipeline to understand how operation names are used. Then create a new class that groups operations by tag and generates appropriate client names.
Tech stack
csharp
Domain
api
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
C#.NETGit
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
65