Skip to content
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

Add support for OpenAPI v3 #130

Open
josephgardner opened this Issue Feb 7, 2018 · 26 comments

Comments

Projects
None yet
@josephgardner
Copy link

josephgardner commented Feb 7, 2018

I was not able to find a similar issue requesting this, so consider it requested :)

@tbarn

This comment has been minimized.

Copy link
Member

tbarn commented Mar 5, 2018

hey @josephgardner! we totally agree. we are working on OAS 3 support for the whole Stoplight platform in Q2. we are working hard to release the next version of Stoplight, which is a major platform update, and then this will be the next thing we turn our focus to.

@philsturgeon

This comment has been minimized.

Copy link

philsturgeon commented Jul 18, 2018

Hey there @tbarn, any update on this? It's Q3, and it's almost a year since OpenAPI v3 came out. :)

@tbarn

This comment has been minimized.

Copy link
Member

tbarn commented Jul 20, 2018

@philsturgeon I was mostly away from my laptop this week, so I am just getting back to this. Let's talk about what it would take to upgrade it - part of it requires an update to one of the Golang libraries we are using.

@philsturgeon

This comment has been minimized.

Copy link

philsturgeon commented Jul 23, 2018

@tbarn no worries! Which library specifically, and what does it need to have done? Point me at some stuff and if I can handle the Go I'll do it, otherwise I'll try and find some people that can. We've got a bunch of go developers here at WeWork recently, and they'd be happy to get mock servers.

@pytlesk4

This comment has been minimized.

Copy link
Member

pytlesk4 commented Jul 23, 2018

@philsturgeon prism uses go-openapi/spec to load in oas files, it looks like someone has started working on it, but I am sure he would love the help. Here is the issue go-openapi/spec#21

@philsturgeon

This comment has been minimized.

Copy link

philsturgeon commented Jul 23, 2018

Awesome news that a new v3 parser is in the works over there. I've subscribed to the issue, and once the dust has settled on that issue and an implementation has been chosen/merged/etc., I'll point some of the Go people at it to see if they can help.

@jpvajda

This comment has been minimized.

Copy link

jpvajda commented Aug 24, 2018

Any updates on supporting OAS3 anytime soon?

@tbarn

This comment has been minimized.

Copy link
Member

tbarn commented Aug 29, 2018

Hey @jpvajda, still waiting on go-openapi/spec#21. We wish we could help there, but we don't have the people available right now since we are working on wrapping up our next release right now.

@stellis

This comment has been minimized.

Copy link

stellis commented Oct 8, 2018

@spifd

This comment has been minimized.

Copy link

spifd commented Dec 18, 2018

Hi, any update for OpenAPI v3 support in stoplight.io?

@tbarn

This comment has been minimized.

Copy link
Member

tbarn commented Dec 18, 2018

There's been a lot of progress on it with other improvements. You can see the work in the develop branch. We are aiming for an early release in 2019.

@spifd

This comment has been minimized.

Copy link

spifd commented Dec 19, 2018

Good news! I'm not familiar with Prism vs the developer portal in Stoplight.io. Prism is the backend that enables mocking and Open API support, right? Does this mean that OAS3 is going to be supported for stoplight.io users in early 2019? (note: I'm currently evaluating stoplight.io as a foundation for one developer portal at my work)

@tbarn

This comment has been minimized.

Copy link
Member

tbarn commented Dec 19, 2018

Yes, mocking, test requests can go through it, contract testing, etc. We'll be rolling out OAS3 support feature by feature, versus doing it all at once. Near-term, we are focused on getting it into the code editor and having validation/linting for OAS3 files, which is pretty much done but not released. Then things like visual editing, mocking, contract testing, etc will come.

TL;DR Prism standalone will have support first, then it will get added to the larger Stoplight platform.

@daKmoR

This comment has been minimized.

Copy link

daKmoR commented Mar 7, 2019

hey, a quick update about the progress would be awesome 🤗 Don't wanna start with OAS2 if prism is going to support OAS3 any time soon 🤗

@philsturgeon

This comment has been minimized.

Copy link

philsturgeon commented Mar 8, 2019

@daKmoR Current Status: All over it like chips on gravy.

image

The team has been working incredibly hard on the fantastic new version of Prism (which is a total rewrite from v2), and we'll be poking a few brave beta testers to give it a spin shortly. We need to sort out some installation docs and other things to make sure the beta testers aren't going in completely blind.

@daKmoR

This comment has been minimized.

Copy link

daKmoR commented Mar 8, 2019

uh awesome sign me up for chips and the beta :)

I will make sure to bring my own torch just in case :p

@francbartoli

This comment has been minimized.

Copy link

francbartoli commented Mar 8, 2019

Great! Me too interested to the beta, thx

@ntiss

This comment has been minimized.

Copy link

ntiss commented Mar 10, 2019

Hi guys !
So do I. I can't wait to test this !

@brianmrock

This comment has been minimized.

Copy link

brianmrock commented Mar 10, 2019

@neuroit

This comment has been minimized.

Copy link

neuroit commented Mar 11, 2019

Bet'a me too, thank you!

@chischaschos

This comment has been minimized.

Copy link

chischaschos commented Mar 11, 2019

Me too, please ❤️

@philsturgeon

This comment has been minimized.

Copy link

philsturgeon commented Mar 12, 2019

Making good progress over here! We just updated to the latest version of Graphite (#191) which means we now support OpenAPI v2.0 in both JSON and YAML, and we support $ref. Before this was merged it was just JSON and no ref support. 😅

OpenAPI v3.0 support to Graphite is a priority in the next sprint, so then Prism will get v3 support from that. Progress! :D

@NoodlesNZ

This comment has been minimized.

Copy link

NoodlesNZ commented Mar 14, 2019

Please add me to the beta group too, thanks!

@LesterTheTester

This comment has been minimized.

Copy link

LesterTheTester commented Mar 14, 2019

I would love to be in the beta group if possible, thank you!

@gnanderson

This comment has been minimized.

Copy link

gnanderson commented Mar 21, 2019

Hi, Gopher here - any of the Go parts open sourced and needing help? Also happy to help test this in beta.

@philsturgeon

This comment has been minimized.

Copy link

philsturgeon commented Mar 21, 2019

@gnanderson thank you so much for offering, but v3 is entirely TypeScript! As a gopher myself I´ve found working in TypeScript to be pretty familiar, especially as somebody else went to all the trouble of setting it up. 😅

Check out the develop branch and the open issues if you are interested in contributing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.