apisyouwonthate/openapi.tools

A collection of Editors, Linters, Parsers, Code Generators, Documentation, Testing

OpenAPI.Tools

A collection of Editors, Linters, Parsers, Code Generators, Documentation, Testing, and Schema/Data validation tools for OpenAPI v2 and v3 (but mostly v3).

Contributing

Please read CONTRIBUTING.md if you are interested in improving this site.

openapi.tools's Issues

Add Kubb

Hi,

I make a tool that converts OpenAPI to TypeScript, React-Query, Zod, Zodios and Axios. It's called Kubb and our website is the following: https://github.com/kubb-project/kubb

Can I recommend it to your list?

Add WAPIml

@philsturgeon thanks for reaching out. We appreciate your interest in listing our tool in OpenAPI.Tools. The support for OpenAPI v3.0 is in progress. We already have a metamodel for OpenAPI v3 and we will integrate it soon into the tool.

opendata-for-all/wapiml#17 (comment)

Add falcon-heavy

https://github.com/NotJustAToy/falcon-heavy we introduce new python package for server-side support of OAS3. It can be used with Django, Falcon and Flask.

Big breaking change: sort yaml entries by name

Sorting entries in the yaml file by (case-insensitive) name would greatly reduce merge conflicts.

One problem - existing PRs would need to be updated.

Add "gateway" category to list of categories

Since API gateways and related tooling are increasingly adopting / supporting OpenAPI I suggest we have a corresponding category.

Happy to create a PR to add to categories.yml if approved!

The category on Converts seems to be incorrect

As we can look at the Converts section on openapi.tools.

And we can look it has the GitHub column name on this various tool table.

And we can notice that the OpenAPI validator - Library that checks response against OpenAPI schema, based on request path and method is not the GitHub repository.

And the repository link is available on GitLab.

To resolve this issue, I think we can consider adding the GitLab column on this table and add the GitLab logo to link GitLab repository link that it's like GitHub that.

And it will not let developers misunderstand the repository link and logo on front-end page :).

Add spot

https://github.com/airtasker/spot

Adding Specmatic

I have raised a PR for this which has been pending for a while. Please let me know if you need any more details on this.

Pull request: #375

ts-gear SDK generator

Hello, recently looked at the list of available tools for generating SDKs from the OpenAPI specification. There was no library on the list https://github.com/superwf/ts-gear, would you like to add it?

add RESTler fuzzer to data validators

Hello,

I noticed that ApiFuzzer is listed under validation tools, and wanted to suggest also adding the RESTler fuzzer to the list: https://github.com/microsoft/restler-fuzzer

RESTLER's description from the README:

RESTler is the first stateful REST API fuzzing tool for automatically testing cloud services through their REST APIs and finding security and reliability bugs in these services. For a given cloud service with an OpenAPI/Swagger specification, RESTler analyzes its entire specification, and then generates and executes tests that exercise the service through its REST API.

Add Akita

Monitors your API traffic and auto-generates an OpenAPI spec; can let you know, for example, if there is a breaking change between builds on your PRs.

https://www.akitasoftware.com

Converting HTTP Request/Response body into OpenApi 3

Hi,
I cannot find tool for converting HTTP request/response into OpenApi 3, is there any tool similar to this?

Column for OpenAPI 3.1

OpenAPI 3.1 is already here, but support is a bit of a hit and miss.

https://lornajane.net/posts/2020/whats-new-in-openapi-3-1

It would be nice to add a column for OpenAPI 3.1 support.

Split “Validator” into “Data validator” and “Schema validator”

From chat:
One ensures the Schema itself is valid, the other ensures data is valid against that Schema. They’re RARE.

Reset-api

1aef0451f53829061d5f7beb691cce6cc972b93b

Add openapi-python-client

Generates python cliend code based on openapi.json.

Quite new tool, I've recently used it with openapi.json generated by FastAPI and it worked just fine. Cheers.

https://pypi.org/project/openapi-python-client/

What are Code Generators?

Would this be SDK generators AND something else, or should SDK be its own separate category? If so, what is code generators.

Category for tools such as Swashbuckle and Microsoft/OpenAPI.NET.Annotations

I am not sure if there are other tools for different languages, but for c# I know of two tools that are used often to generate openapi documentation. They do not generate the code, but instead work with annotations or comments to generate the json document for openapi.

I think it would be nice to have a category for this but I am not sure what that category would be called. Maybe Document Generators.

Add ExpressO

https://www.npmjs.com/package/expresso-api?activeTab=readme

https://github.com/AlessandroRomanelli/ExpressO

A CLI to automatically generate OAS 3.0 from Express.js backends code.

Need some help?

Looks like progress has slowed with reviewing. Would you like more help? I can help, I would be happy to.

Add at-your-service

Hey there - I opened a PR a while ago. Please let me know if there's anything else you need from myself on this.

PR: #385

Could you add Stoplight to your list?

This is the tool of my choice when starting making an API.

I always choose design first and only after that I start developing my API.

It is a breeze to use Stoplight Studio as a free Standalone Software that already supports openAPI 3.1.

https://stoplight.io/studio

With Stoplight Elements you can even show your openAPI file as an awesome documentation on your webpage.

https://stoplight.io/open-source/elements

add FastAPI as an auto generator

The Python framework FastAPI will automatically generate OpenAPI docs for the code you write, could this be added to the auto generator section?

How are PR reviews done on this repo?

How are PR reviews done on this repo?
can some clarification be added on it?
Can PRs be reviewed within a certain window of filing like 1 to 2 months?

At the time of writing this issue there is a PR open which was written in 2019. Seeking understanding and an answer to set expectations here. Thanks!

Add openapi-preprocessor

https://github.com/dolmen-go/openapi-preprocessor

Provide description for KaiZen-OpenAPI-Editor

@philsturgeon , great to see the openapi.tools site, and thank you for the links!

Opening this issue because I noticed that KZOE was missing a description. I'll open a PR for this shortly.

APIFuzzer has submitted invalid yaml whis is in tools.yml

See Invalid yaml #240

Additional Tools

Can I suggest https://apiary.io/ - with its live mock server and offers a free tier. In addition to OAS, it also supports the API Blueprint standard.

A lot of the foundations to Apiary have been made available as open-source, for example, Dredd test tool https://dredd.org/en/latest/

Considered a section for Visual Studio Code plugins ?

documentation or json schema for the data file?

I'd like to add an entry to your tooling list, which seems to be at _data/tools.yml -- is there any guide for what to put in here? Is there a json schema describing the file format, perhaps?

apicurio-studio has git repo

https://github.com/apicurio/apicurio-studio

add Azure/openapi-diff

Azure/openapi-diff: Command line tool to detect breaking changes between two openapi specifications

Postman can import OpenAPI files

.. and you can then send requests to the API server.

https://learning.getpostman.com/docs/postman/collections/working-with-openAPI/

tooling list update: openapi and json schema validators in Perl

• a JSON Schema evaluator (draft7, draft2019-09, draft2020-12) - https://github.com/karenetheridge/JSON-Schema-Modern, https://metacpan.org/pod/JSON::Schema::Modern
• an OpenAPI request/response validator (only v3.1 supported, not v3.0) - https://github.com/karenetheridge/OpenAPI-Modern, https://metacpan.org/pod/OpenAPI::Modern

SwagGen

https://github.com/yonaskolb/SwagGen

Add version filter to the top of the page

There should be a version select to quickly filter out projects and tools that support a specific version of the OpenAPI Spec

Split GUI editors from Text-based editors

Add category descriptions

We need to add descriptions to categories and add them to the site.

• Descriptions can be added in the categories.yml file
• Include 2-3 sentences for each description
• Display the description underneath the category title on the page

Update openapi-json-schema-genrator to show that java is supported

Update openapi-json-schema-geenrator to show that java is supported
Will be closed by: #483

Add api-codegen-ts to SDK generators and validators sections

I wrote a minimal config (specify spec source and codegen out only) library for generating http client controllers, response validators, and typescript models from openapi and swagger. Figured I'd add it to your list. PR incoming.

Edit: Add link to project ;)

Source is here: api-codegen-ts

Add API Contractor VS code extension

Hello👋

I would like to add the API Contractor extension for Visual Studio Code that I'm working on. The extension uses AML Language Server for validation, conversion and linting and Mulesoft API Console for visualization and trying out of OpenAPI 2.0/3.0 and RAML 0.8/1.0 API definitions.

Will it be ok if I create a PR and what category should I use?

Add apiaddicts Apitools

Related PR #308

Update documentation/redoc to include support for oas3

ReDoc now supports OAS v3, the linked blocking issue is also closed.

https://github.com/Rebilly/ReDoc#roadmap

Add stoplight in Editors

https://stoplight.io/ is a full-featured OpenAPI design, editing, mocking, viewing service, I have been using it for a while, I think it could be added under Editors category, in which it does the best.

add openapi-cop

EXXETA/openapi-cop: A proxy that validates responses and requests against an OpenAPI document.

I found it recently.
this looks promising.

No link to specifications

Great stuff, I just didn't find out what open Api is. Link to openApi specifications doesn't work. Thanks

Testing category doesn't show up

The data file has a link to a tool in the testing category, but this doesn't show up on the deployed website: http://openapi.tools.

https://github.com/apisyouwonthate/openapi.tools/blob/master/_data/tools.yml#L427

It looks like the category testing is case sensitive, and the data file uses the wrong case? Or maybe the website not continuously deployed?

Add apieat.com

Hi,

I make an openapi v3 editor @ https://apieat.com.

Can I recommand it to your list?

Badge (+ rating?)

Awesome Ruby have this little badge that folks can put on their README, which benefits them and the awesome ruby project.

https://github.com/markets/awesome-ruby

We should look into doing something similar.

Add swagger-request-validator

Hi,

It would be great to add swagger-request-validator

This project has been in development for ~5yrs and has support for Swagger 2.0 and OpenAPI 3.0.

Cheers,
James

connexion is a server generator for python, not a mock server

Connexion is documented as a mock server, rather it aids in generating a server, calling a method with the name specified in the openapi for each endpoint, only after all input validation, and optionally authentication, is automatically done for you.

openapi.tools/_data/tools.yml

Line 626 in d916eca

category: mock