Comments (7)
Yes, I see this issue: getkin/kin-openapi#230
I am currently evaluating tooling we use to see if we are ready to migrate to 3.1 ourselves. It seems not yet. :-)
from oasdiff.
Hj @eumenhofer,
oasdiff relies on https://github.com/getkin/kin-openapi to parse OpenAPI specs.
This project itself is stuck in regards to 3.1 support as you can see here.
I think this is a good example of the dynamics that are holding back OAS 3.1 support across the entire community.
To put it in my own words, I'd say that the OpenAPI end users consider the required investment to be too costly for the expected value.
Needless to say, if you or anyone else reading this thinks that the investment is worthwhile I would be happy to discuss.
Reuven
from oasdiff.
This repo depends on https://github.com/getkin/kin-openapi which doesn't yet support OpenAPI 3.1.
Perhaps you could share an example of your specs and the expected diff?
from oasdiff.
When we can expect 3.1 support?
from oasdiff.
I know this is an ongoing issue. Side note, most projects i've seen are struggling to provide 3.1 support for their tooling, does anyone know why it's so challenging?
from oasdiff.
:( starting green field all my spec are 3.1 , leveraging tooling that support it , spectral , api management
still even if green field support of oasdiff would have been great, looking on the small diff (but annoying) things between OAS 3.1 and 3.0 , it s more likely that kin-openapi is a bit zombie, not so active :( that put your (very nice) project in danger :(
especially as OAS 3.2 (no breaking promise ) and 4.0 are coming ...
from oasdiff.
From my point of view, the only promising replacement for kin-openapi which supports OpenAPI 3.1 is a libopenapi https://github.com/pb33f/libopenapi. But during my last test I found that it lacked some features in reference resolution and its errors handling was not good enough.
I suppose it is possible to make a new version for oasdiff based on libopenapi, but firstly the libopenapi library should be fixed itself.
from oasdiff.
Related Issues (20)
- `response-property-became-required` is added for required properties that are newly added to response bodies HOT 1
- Non-friendly error message
- oasdiff flatten doesn't output paths HOT 1
- YAML/JSON field name typo: "reuired" -> "required" HOT 1
- Feature request: Support external metadata
- Verbose CLI output to help troubleshoot (especially in composed mode) HOT 5
- oasdiff error in composed mode when the same path appears in different files HOT 1
- Race condition while parsing command line arguments if telemetry is enabled HOT 1
- "Error resolving reference/map key not found" when running oasdiff across the set of files with intensive external refs HOT 1
- Supporting "--fail-on" option for changelog command
- basePath and servers.ulr support HOT 3
- Add support for AWS API Gateway extensions to OpenAPI HOT 6
- Diff tool gets confused when a new inline enum value is added and a new enum type is added at the sime time HOT 4
- Changelog does not log adding a new optional request body HOT 2
- `latest` docker container (April 8th) introduces a bug that causes false positives HOT 1
- --flatten-allof panic HOT 3
- Unmarshalling errors don't provide offset HOT 6
- Support breaking-changes and changelog for schemas with multiple types
- Support "flatten allOf" for schemas with multiple types
- Typo in description of incompatible changes HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from oasdiff.