ETA for OpenAPI 3 support?

[moon0326]

Hi!

Thank you for such a good package :) I've been using it for my projects.

Is there an ETA for OpenAPI 3 support? I know that it's coming, but just wanted to know if there is an ETA.

Thanks!
Moon

[JamesMessinger]

Hi. Sorry for not having a solid ETA date. I had originally hoped to have it done by now, but then work got really hectic all of a sudden, so I haven't had any free time lately. I hope to resume work on Swagger Parser next week.

[moon0326]

@BigstickCarpet thank you for the reply :) Have a good weekend!

[lcofre]

Great @BigstickCarpet !

Thanks very much for your work. I am in the process of migrating to 3.0.0 so your project update is invaluable!

[hugoduraes]

Can you make a beta release?

[andybarron]

any updates on this? anything specific that the community could throw together a PR for?

[JamesMessinger]

Hi. Please see my comment here. I was unable to get any work done for a couple months because of work and family commitments, but I'm back on it now.

[andybarron]

All good, take your time! We all appreciate your work on this. Just let us know if we can help with anything specific :)

[gonenduk]

Can't wait for an update :)

[sandorfr]

Is there any way we can help move this forward so we could have an alpha soon?

[sandorfr]

I don’t know about others, but I grow impatient on this one. I have the feeling the only way to move this forward would be through a PR but before doing duplicated work it would be great to know if it is started somewhere?

[gonenduk]

Any updates? ETA? Some news?

[gkoberger]

Is there any updates on this, or alternative packages we should be looking at?

We're happy to help fund development of this, since we rely on the package so much. Is that something that could help speed things up? We've looked into contributing ourselves, however we didn't want to duplicate work and wasn't sure how to make changes across multiple modules.

If there's a way we can help fund this, let me know! greg at readme dot io :)

(And thanks for building this... we love the package 💙)

[SomeoneRandom42]

Yeah I am with gkoberger. We really enjoy having the docs in line with the endpoints in comments and would love to keep using this package, but the new version of Open API adds many features we desperately want to upgrade.

If there is anything we can do please let me know.

[rssteffey]

I would also be up for helping expand to 3.0 support. The spec allows for a lot more flexibility in our APIs here and we're pretty dependent on this repo

[sandorfr]

I start to feel like the only way to progress this is to start a fork with the people motivated.

[gonenduk]

@gkoberger - maybe you should offer to fund it and some motivated people could take the project and work on it.

[ztheory]

@gonenduk - Pretty sure that's exactly what he did.

+1 for this.

[gkoberger]

I reached out to @BigstickCarpet and offered to finance it, however unfortunately he wasn't able to commit to anything due to work commitments. I completely understand, but we really needed OAS3 support!

So, we created oas-normalize, which accepts both Swagger 2 and OAS 3 (YAML or JSON, via string or URL or blob or whatever), and validates them. It has a similar API to swagger-parser, and uses swagger-parser under the hood for Swagger 2. (It uses swagger2openapi for validating OAS 3). It also uses @BigstickCarpet's json-schema-ref-parser for all the resolving of $refs.

https://github.com/readmeio/oas-normalize

Here's how to use it:

const OAS = require('oas-normalize');

// Use a URL, string, pathname, JSON blob, whatever
const oas = new OAS('https://raw.githubusercontent.com/OAI/OpenAPI-Specification/master/examples/v3.0/petstore-expanded.yaml');

oas.validate((err, spec) => {
  if (err) {
    console.log(err.errors);
    return;
  }
  console.log(spec); // spec will always be JSON, and valid
});

Currently it's backend-only, but we're going to try to fix that.

Let us know if you run into issues!

[gonenduk]

Great job!
Next step would be to use it in swagger-express-middleware.
If the interface is the same then it will be easy.

[MikeRalphson]

@gkoberger happy to help if swagger2openapi needs any work done (it being my baby).

[JamesMessinger]

I just released Swagger Parser v5.0.0, which includes initial support for OpenAPI 3.0. 👏🎉🎆

A big "Thank You!" to Leo Long for doing the work and submitting PR #88. 👍 🥇 💯