[DDO-3219] Fix upsert API methods and add Swagger comment test #329
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a mismatch between what the router was configured for (PUT) and what the Swagger comments were building the client libraries to use (POST).
Tiny fix, but like #327, an easy mistake to make.
Testing
This PR adds an introspective test that mocks the router configuration to collect the API routes that the running server will end up supporting. With that list assembled, it will then iterate over the raw source code files to assert that each configured route is declared exactly once (and nothing else is declared).
This catches a wide variety of mismatches between the Swagger comments and the Gin configuration, including method mismatches like this one, route typos, or omitted Swagger documentation.
Risk
Very low