mirror of
https://github.com/kennethreitz/responder.git
synced 2026-06-20 22:40:58 +00:00
36 lines
2.6 KiB
Markdown
36 lines
2.6 KiB
Markdown
# Responder: a Sorta Familar HTTP Framework for Python
|
|
|
|
|
|
|
|
I'm adept to keep the "for humans" tagline off this project, until it comes out of the prototyping phase. I'm building this to learn, and to have fun -- while, at the same time, trying to bring something new to the table.
|
|
|
|
The Python world certianly doesn't need more web frameworks. But, it does need more creativity, so I thought I'd bring some of my ideas to the table and see what I could come up with.
|
|
|
|
# The Basic Idea
|
|
|
|
The primary concept here is to bring the nicities that are brought forth from both Flask and Falcon and unify them into a single framework, along with some new ideas I have. I also wanted to take some of the API primitaves that are instilled in the Requests library and put them into a web framework. So, you'll find a lot of parallels here with Requests.
|
|
|
|
## Old Ideas
|
|
|
|
- Flask-style route expression, with new capabilities -- primarily, the ability to cast a parameter to integers as well as other types that are missing from Flask, all while using Python 3.6+'s new f-string syntax.
|
|
|
|
- I love Falcon's "every request and response is passed into to each view and mutated" methodology, especially `response.media`, and have used it here. In addition to supporting JSON, I have decided to support YAML as well, as Kubernetes is slowly taking over the world, and it uses YAML for all the things. Content-negotiation and all that.
|
|
|
|
## New Ideas
|
|
|
|
- **A built in testing client that uses the actual Requests you know and love**.
|
|
- In addition to Falcon's `on_get`, `on_post`, etc methods, Responder features an `on_request` method, which gets called on every type of request, much like Requests.
|
|
- WhiteNoise is built-in, for serving static files (this has yet to be built out, there's no templating or `static_url` yet)
|
|
- Waitress (will-be) built-in as a production web server. I would have chosen Gunicorn, but it doesn't run on Windows. Plus, Waitress serves well to protect against slowloris attacks, making nginx unneccessary in production.
|
|
- GraphQL support, via Graphene. The goal here is to eventually have an embedded version of GraphiQL exposable at any route.
|
|
|
|
## Future Ideas
|
|
|
|
- I want to be able to "mount" any WSGI app into a sub-route.
|
|
- Cooke-based sessions are currently an afterthrought, as this is an API framework, but websites are APIs too.
|
|
- Potentially support ASGI instead of WSGI. Will the tradeoffs be worth it? This is a question to ask. Procedural code works well for 90% use cases.
|
|
|
|
# The Goal
|
|
|
|
The primary goal here is to learn, not to get adoption. Though, who knows how these things will pan out.
|