notjustatoy / falcon-heavy Goto Github PK

I have built an API with Flask, Flask-Restful, and OpenAPI 3.0 (formerly Swagger). The problem I'm facing is validating incoming requests against the spec.

So far I have tried Flasgger and Connexion, which both work with the Flask framework. However, Flasgger's OAS3 support isn't complete and fails to validate any incoming data. And while Connexion's OAS3 support is broader, it still fails to validate more complex scenerios, such as conditional parameters using the newly-introduced oneOf and allOf properties of the latest OAS spec.

Hence, why I'm looking for a package that can provide more reliable results. That's where I found this repository through a few StackOverflow answers (example) and listed on the OpenAPI.Tools site.

The only problem is I don't see any sort of documentation on where to begin utilizing this tool. I would like to add decorators to my flask-restful Resource classes that directly map to each API verb (ie get, put, post, patch) and correspond to the Flask routes. Can you possibly add some documentation on how to accomplish this?

Please create a documentation for Falcon

Please add a few example projects that show this framework can be employed.
A web service that manages TODOs/notes is a common type of example.