apisyouwonthate / openapi.tools Goto Github PK
View Code? Open in Web Editor NEWA collection of Editors, Linters, Parsers, Code Generators, Documentation, Testing
Home Page: https://openapi.tools
License: MIT License
A collection of Editors, Linters, Parsers, Code Generators, Documentation, Testing
Home Page: https://openapi.tools
License: MIT License
@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.
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
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.
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?
ReDoc now supports OAS v3, the linked blocking issue is also closed.
Update openapi-json-schema-geenrator to show that java is supported
Will be closed by: #483
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.
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.
Would this be SDK generators AND something else, or should SDK be its own separate category? If so, what is code generators.
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 :).
Sorting entries in the yaml file by (case-insensitive) name would greatly reduce merge conflicts.
One problem - existing PRs would need to be updated.
There should be a version select to quickly filter out projects and tools that support a specific version of the OpenAPI Spec
Related PR #308
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?
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?
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.
Looks like progress has slowed with reviewing. Would you like more help? I can help, I would be happy to.
See Invalid yaml #240
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
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?
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.
1aef0451f53829061d5f7beb691cce6cc972b93b
EXXETA/openapi-cop: A proxy that validates responses and requests against an OpenAPI document.
I found it recently.
this looks promising.
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.
With Stoplight Elements you can even show your openAPI file as an awesome documentation on your webpage.
@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.
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!
From chat:
One ensures the Schema itself is valid, the other ensures data is valid against that Schema. They’re RARE.
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.
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.
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!
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?
Hi,
I cannot find tool for converting HTTP request/response into OpenApi 3, is there any tool similar to this?
We need to add descriptions to categories and add them to the site.
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.
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.
.. and you can then send requests to the API server.
https://learning.getpostman.com/docs/postman/collections/working-with-openAPI/
The Python framework FastAPI will automatically generate OpenAPI docs for the code you write, could this be added to the auto generator section?
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
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 ?
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.