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
    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