grape-swagger icon indicating copy to clipboard operation
grape-swagger copied to clipboard

Swagger UI 3.0

Open zhangalex opened this issue 8 years ago • 10 comments

Hi Guys,

This is really a great gem. Thank you.

Since swagger ui 3.0 already released, could you please tell me is there any plan on swagger UI v3?

THANKS AGAIN.

zhangalex avatar Apr 14 '17 11:04 zhangalex

Nobody is working on this AFAIK. We look forward to you contributing!

dblock avatar Apr 21 '17 21:04 dblock

yeap, nobody is official working on it, so please feel free to contribute

btw … you should reference the OAPI spec itself, not the swagger UI, this isn't a official implementation at the moment, see: implementations

LeFnord avatar Apr 21 '17 23:04 LeFnord

I have a local branch that works with OpenAPI 3. It's a bit rough around the edges, and I'd need some help to try to see what the next steps would be..

blakepettersson avatar Apr 01 '19 13:04 blakepettersson

sounds good 😄 … can you open a PR, so others can have a look on it and helping

LeFnord avatar Apr 01 '19 17:04 LeFnord

Does not update any more?

run27017 avatar Mar 29 '21 02:03 run27017

Hi! Dropping a note that I found a workaround to easily get SwaggerUI3 working by converting your Swagger2 spec to OpenApi3, detailed here: https://github.com/ruby-grape/grape-swagger/pull/744#issuecomment-906103541

synth avatar Aug 26 '21 05:08 synth

@blakepettersson @LeFnord Really sad to not see this get over the line, you did so much great work on it! Is there a summary or list of what's left to do to get this done in case someone else wants to pick up the rest and run with it?

We're using grape and finding we're running into so many issues with the lack of OpenAPI v3 support, from no discriminated unions, to no param examples, to no bearer auth support in the security spec, etc. Converting from v2 to v3 only gets you so far and leaves a lot to be desired.

mscrivo avatar Aug 14 '23 18:08 mscrivo

@mscrivo it's been years since I've worked on anything Ruby-related, let alone this, so I longer have no idea on what is/was missing. Good luck for anyone wanting to further build upon it!

blakepettersson avatar Aug 15 '23 13:08 blakepettersson

@mscrivo … actual, there is no such kind like a to do list for open steps

but there are a bit of work on it, see the OAPI-v3 branch feel free to start there and contribute

LeFnord avatar Aug 15 '23 14:08 LeFnord