Responder: a familiar HTTP Service Framework for Python

Powered by Starlette. That async declaration is optional.View documentation.

This gets you a ASGI app, with a production static files server pre-installed, jinja2templating (without additional imports), and a production webserver based on uvloop,serving up requests with gzip compression automatically.

Testimonials

"Pleasantly very taken with python-responder.@kennethreitz at his absolute best." —RudrakshM.K.

"ASGI is going to enable all sorts of new high-performance web services. It's awesometo see Responder starting to take advantage of that." — Tom Christie author ofDjango REST Framework

"I love that you are exploring new patterns. Go go go!" — Danny Greenfield, author ofTwo Scoops of Django

More Examples

Seethe documentation's feature tourfor more details on features available in Responder.

Installing Responder

Install the stable release:

$ pipenv install responder
✨��✨

Or, install from the development branch:

$ pipenv install -e git+https://github.com/taoufik07/responder.git#egg=responder

Only Python 3.6+ is supported.

The Basic Idea

The primary concept here is to bring the niceties that are brought forth from both Flaskand Falcon and unify them into a single framework, along with some new ideas I have. Ialso wanted to take some of the API primitives that are instilled in the Requestslibrary and put them into a web framework. So, you'll find a lot of parallels here withRequests.

• Setting resp.content sends back bytes.
• Setting resp.text sends back unicode, while setting resp.html sends back HTML.
• Setting resp.media sends back JSON/YAML (.text/.html/.content override this).
• Case-insensitive req.headers dict (from Requests directly).
• resp.status_code, req.method, req.url, and other familiar friends.

Ideas

• Flask-style route expression, with new capabilities -- all while using Python 3.6+'snew 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 tosupporting JSON, I have decided to support YAML as well, as Kubernetes is slowlytaking over the world, and it uses YAML for all the things. Content-negotiation andall that.
• A built in testing client that uses the actual Requests you know and love.
• The ability to mount other WSGI apps easily.
• Automatic gzipped-responses.
• In addition to Falcon's on_get, on_post, etc methods, Responder features anon_request method, which gets called on every type of request, much like Requests.
• A production static file server is built-in.
• Uvicorn built-in as a production web server. I would have chosen Gunicorn, but itdoesn't run on Windows. Plus, Uvicorn serves well to protect against slowlorisattacks, making nginx unnecessary in production.
• GraphQL support, via Graphene. The goal here is to have any GraphQL query exposable atany route, magically.
• Provide an official way to run webpack.