-
Notifications
You must be signed in to change notification settings - Fork 241
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[CI] Add step that runs backward compatibility tests on PRs #1592
[CI] Add step that runs backward compatibility tests on PRs #1592
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please add description to the PR:
What other tools you've checked, why you picked openapi-diff
etc...
4523f9e
to
bd4f4a2
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please note the previous review comment - add description
Also it seems like you're still writing the output of the docker run command to a file, so I unresolved #1592 (comment)
… as a result of defining more implicit env naming.
…bility-dockerized
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Very nice work!
https://jira.iguazeng.com/browse/ML-1274
A few tools have been examined:
Since we are currently using 3.0.1 of OpenApi with FastApi, there are a few differences in the capabilities that JSON schema provides that are only available in the 3.1.0 version of OpenApi.
That is further explained at tiangolo/fastapi#240 (comment).
These distinctions have an impact on the usability of
oasdiff
andnpm/openapi-diff
.Currently,
openapi-diff
is the only one capable of handling the aforementioned differences.Important Notes
oasdiff
.openapi-diff
is useful, it does not provide much useful information about the exact cause of the API breakage, necessitating additional investigation to determine the exact cause. I propose that we switch tooasdiff
once fastapi supports OpenApi 3.1.0.