Metadata-Version: 2.1
Name: responder
Version: 1.0.0
Summary: A sorta familiar HTTP framework.
Home-page: https://github.com/kennethreitz/responder
Author: Kenneth Reitz
Author-email: me@kennethreitz.org
License: Apache 2.0
Description: 
        # Responder: a familiar HTTP Service Framework for Python
        
        [![Build Status](https://travis-ci.org/kennethreitz/responder.svg?branch=master)](https://travis-ci.org/kennethreitz/responder)
        [![Documentation Status](https://readthedocs.org/projects/mybinder/badge/?version=latest)](https://responder.readthedocs.io/en/latest/)
        [![image](https://img.shields.io/pypi/v/responder.svg)](https://pypi.org/project/responder/)
        [![image](https://img.shields.io/pypi/l/responder.svg)](https://pypi.org/project/responder/)
        [![image](https://img.shields.io/pypi/pyversions/responder.svg)](https://pypi.org/project/responder/)
        [![image](https://img.shields.io/github/contributors/kennethreitz/responder.svg)](https://github.com/kennethreitz/responder/graphs/contributors)
        
        [![](https://github.com/kennethreitz/responder/raw/master/ext/small.jpg)](http://python-responder.org/)
        
        The Python world certainly doesn't need more web frameworks. But, it does need more creativity, so I thought I'd spread some [Hacktoberfest](https://hacktoberfest.digitalocean.com/) spirit around, bring some of my ideas to the table, and see what I could come up with.
        
        ```python
        import responder
        
        api = responder.API()
        
        @api.route("/{greeting}")
        async def greet_world(req, resp, *, greeting):
            resp.text = f"{greeting}, world!"
        
        if __name__ == '__main__':
            api.run()
        ```
        
        Powered by [Starlette](https://www.starlette.io/). That `async` declaration is optional. [View documentation](http://python-responder.org).
        
        This gets you a ASGI app, with a production static files server pre-installed, jinja2 templating (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](https://twitter.com/kennethreitz) at his absolute best." —Rudraksh M.K.
        
        > "ASGI is going to enable all sorts of new high-performance web services. It's awesome to see Responder starting to take advantage of that." — Tom Christie author of [Django REST Framework](https://www.django-rest-framework.org/)
        
        > "I love that you are exploring new patterns. Go go go!" — Danny Greenfield, author of [Two Scoops of Django]()
        
        > "Love what I have seen while it's in progress! Many features of Responder are from my wishlist for Flask, and it's even faster and even easier than Flask!" — Luna C.
        
        ## More Examples
        
        See [the documentation's feature tour](http://python-responder.org/en/latest/tour.html) for more details on features available in Responder.
        
        
        # Installing Responder
        
        Install the latest release:
        
        
            $ pipenv install responder --pre
            ✨🍰✨
        
        
        Or, install from the development branch:
        
            $ pipenv install -e git+https://github.com/kennethreitz/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 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 primitives 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.
        
        - Setting `resp.text` sends back unicode, while setting `resp.content` sends back bytes.
        - Setting `resp.media` sends back JSON/YAML (`.text`/`.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+'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.
        - **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 an `on_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 it doesn't run on Windows. Plus, Uvicorn serves well to protect against slowloris attacks, making nginx unnecessary in production.
        - GraphQL support, via Graphene. The goal here is to have any GraphQL query exposable at any route, magically.
        - Provide an official way to run webpack.
        
        
        ----------
        
        [![hacktoberfest](https://hacktoberfest.digitalocean.com/assets/hacktoberfest-2018-social-card-c8d2e1489f647f2e0a26e6f598adeb760872818905b34cd437afc7ac2857ceab.png)](https://hacktoberfest.digitalocean.com/)
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.6
Description-Content-Type: text/markdown
