swagger-api / swagger-api/swagger-codegen
Maven plugin: smart inputSpec config instead of multiple execution blocks
Nobody has claimed this yet.
- Dominant language
- Mustache
- Stars
- 17.8k
- Forks
- 6k
- PR merge metrics
- No merged PRs in 30d
Description
I was wondering how to generate multiple apis at the same time. The application I'm developing is huge and currently requires almost 200 rest apis. They're split in macro categories across 10 specific swagger files and 1 definition file.
my structure is something like this:
-- yaml-folder
--- User.yaml
--- Transaction.yaml
--- Notification.yaml
--- ...
--- Definitions.yaml
I read that the suggested approach is to leverage on multiple blocks on one unique pom file, but personally I find it very heavy. if other ways are available, please suggest...
Anyway, am I the only one with this requirement ? Instead of having one single fat pom.xml file, wouldn't be worth it to implement something more readable and manteinable?
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the Maven plugin configuration in pom.xml, especially the multiple execution blocks used for separate Swagger files. Compare that setup with the requested multi-API inputSpec configuration; done means a documented, maintainable configuration can generate the listed APIs without one execution block per API.
Written by the indexing model from the issue text.
Assessment
- Domain
- build-system
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100