Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Repo info
Activity
    Stefan Junker
    @steveeJ
    what is the completeness state of the parser? I'm willing to dig all the way into the templating and configuration, but I would be thrown off if the parser wouldn't deliver all of the specs elements
    in particular I'm interested in generating Go and Rust server and client code which supports http and apiKey security schemes
    Mike Ralphson
    @MikeRalphson
    Openapi-codegen uses a domain specific language (config file driven approach) while swagger codegen and openapi-generator subclass the model generation code for each language.
    Stefan Junker
    @steveeJ
    ah, you see the config file as a DSL, makes sense
    Mike Ralphson
    @MikeRalphson
    Openapi-codegen uses a validator, but not a separate parser as such. It converts all inputs into oas3 and works directly off that as the base model.
    Completeness can only really be measured by working configs /languages, but it should quickly tend towards 100%
    Stefan Junker
    @steveeJ
    I find the config file approach appealing
    it allows for replacing the parser implementation
    if one wanted that
    Mike Ralphson
    @MikeRalphson
    Yes, it has that benefit. I can't say how much attention it's going to get as it was initially only a hackathon proof-of-concept.
    Stefan Junker
    @steveeJ
    Can you point me to the config input parameters which would be used for the security definitions?
    I have no new experience in javascript since looking at this project a couple months ago :D
    Stefan Junker
    @steveeJ
    @MikeRalphson hey, is it possible to use the command line version of swagger2openapi for the same validation method as used on the online editor? for some reason a spec passes the CLI but fails the online validator
    Stefan Junker
    @steveeJ
    I found https://github.com/wework/speccy which is very helpful at finding errors and it also providers some useful lint rules
    Mike Ralphson
    @MikeRalphson
    Speccy is based on swagger2openapi's validator and linter. You can use the testRunner harness in swagger2openapi to validate and/or lint OAS documents. I'm not sure which online editor you're referring to though.
    Stefan Junker
    @steveeJ
    the one found under wizards @ https://mermade.github.io/openapi-gui
    that one wasn't very helpful when debugging null values in contactsx, terms of services, etc., which were automatically stored by the web-ui
    we have found some UX issues with the web-ui which we'll report the next few days :-) probably not much work to fix but very helpful when done
    Mike Ralphson
    @MikeRalphson
    @/all I'm thinking of migrating all the APIs in the collection which do not originate in Swagger/OpenAPI format to OpenAPI 3.x instead of Swagger 2.0 - for example this would affect all the Google and Amazon AWS APIs. Timescale for this would be around May this year. Would this cause problems for anyone?
    Sergey Tihon
    @sergey-tihon

    @MikeRalphson what will you do with component names in V3? I heard that [ & ] are not allowed in V3 component names but was used in V2.

    For example gettyimages uses these symbols in component names $ref: '#/definitions/GettyImages.Models.Search.SearchResults[GettyImages.Models.Search.ImageSearchItem]'
    As I understand Swashbuckle serialize .NET generic parameter types this way

    Mike Ralphson
    @MikeRalphson
    If this is an OpenAPI v2 definition, as above I won't be converting it anyway. More generally, will be replacing with underscores and suffixing with a digit if necessary.
    Mike Ralphson
    @MikeRalphson
    If anyone depends on the current path fragment hack for the AWS APIs, or has thoughts generally on the accuracy of those APIs, please take a look at APIs-guru/aws2openapi#11
    James Ladd
    @jamesladd
    How can I request an API to be added to the list of API's you provide?
    *catalog
    Mike Ralphson
    @MikeRalphson
    Mike Ralphson
    @MikeRalphson
    I'll no longer be monitoring gitter for this project. Please feel free to join the Mermade slack at https://join.slack.com/t/mermade/shared_invite/zt-g78g7xir-MLE_CTCcXCdfJfG3CJe9qA