v2.0.6

Merge pull request #447 from timgates42/bugfix_typo_marshmallow
docs: fix simple typo, mashmallow -> marshmallow
2026-06-05 23:00:17 +00:00 · 2021-01-06 09:02:42 +01:00 · 2020-12-24 08:44:43 +01:00 · 2020-12-24 13:27:01 +11:00 · 2020-12-02 09:44:55 +01:00 · 2020-12-01 23:11:49 +00:00
69 changed files with 5852 additions and 1433 deletions
@@ -0,0 +1,23 @@
+name: Lint
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: 3.7
+
+      - name: Install dependencies
+        run: |
+          python -m pip install pipenv
+          pipenv install --dev --system
+
+      - name: Lint
+        run: pre-commit run --all-files --show-diff-on-failure
@@ -0,0 +1,30 @@
+name: Test
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [3.6, 3.7, 3.8]
+        os: [ubuntu-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install pipenv
+          pipenv install --dev --system
+
+      - name: Tests
+        run: |
+          python --version
+          pytest
@@ -0,0 +1,13 @@
+repos:
+  - repo: https://github.com/psf/black
+    rev: 20.8b1
+    hooks:
+      - id: black
+        types: [python]
+
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v2.2.1
+    hooks:
+      - id: prettier
+        args: [--prose-wrap=always, --print-width=88]
+        exclude: ^docs/source/_static/
@@ -1,18 +0,0 @@
-# travis use trusty by default
-dist: xenial
-
-language: python
-python:
-  - 3.6
-  - 3.7
-  - "3.8-dev"
-
-# command to install dependencies
-install:
-  - pip install pipenv --upgrade-strategy=only-if-needed
-  - pipenv install --dev
-
-# command to run the dependencies
-script:
-  - black responder tests setup.py --check
-  - pytest
@@ -1,214 +1,345 @@
 # Changelog
+
 All notable changes to this project will be documented in this file.

-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and
+this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

 ## [Unreleased]

-## [v1.3.2] - 2019-08-15
+## [v2.0.5] - 2019-12-15
+
 ### Added
+
+- Update requirements to support python 3.8
+
+## [v2.0.4] - 2019-11-19
+
+### Fixed
+
+- Fix static app resolving
+
+## [v2.0.3] - 2019-09-20
+
+### Fixed
+
+- Fix template conflicts
+
+## [v2.0.2] - 2019-09-20
+
+### Fixed
+
+- Fix template conflicts
+
+## [v2.0.1] - 2019-09-20
+
+### Fixed
+
+- Fix template import
+
+## [v2.0.0] - 2019-09-19
+
+### Changed
+
+- Refactor Router and Schema
+
+## [v1.3.2] - 2019-08-15
+
+### Added
+
 - ASGI 3 support
 - CI tests for python 3.8-dev
 - Now requests have `state` a mapping object

 ### Deprecated
+
 - ASGI 2

 ## [v1.3.1] - 2019-04-28
+
 ### Added
+
 - Route params Converters
 - Add search for documentation pages

 ### Changed
+
 - Bump dependencies

 ## [v1.3.0] - 2019-02-22
+
 ### Fixed
+
 - Versioning issue
 - Multiple cookies.
 - Whitenoise returns not found.
 - Other bugfixes.

 ### Added
+
 - Stream support via `resp.stream`.
 - Cookie directives via `resp.set_cookie`.
 - Add `resp.html` to send HTML.
 - Other improvements.

 ## [v1.1.3] - 2019-01-12
+
 ### Changed
+
 - Refactor `_route_for`

 ### Fixed
+
 - Resolve startup/shutdwown events

 ## [v1.2.0] - 2018-12-29
+
 ### Added
+
 - Documentations

 ### Changed
+
 - Use Starlette's LifeSpan middleware
 - Update denpendencies

 ### Fixed
+
 - Fix route.is_class_based
 - Fix test_500
 - Typos

 ## [v1.1.2] - 2018-11-11
+
 ### Fixed
+
 - Minor fixes for Open API
 - Typos

 ## [v1.1.1] - 2018-10-29
+
 ### Changed
+
 - Run sync views in a threadpoolexecutor.

 ## [v1.1.0] - 2018-10-27
+
 ### Added
+
 - Support for `before_request`.

 ## [v1.0.5]- 2018-10-27
+
 ### Fixed
+
 - Fix sessions.

 ## [v1.0.4] - 2018-10-27
+
 ### Fixed
+
 - Potential bufix for cookies.

 ## [v1.0.3] - 2018-10-27
+
 ### Fixed
+
 - Bugfix for redirects.

 ## [v1.0.2] - 2018-10-27
+
 ### Changed
+
 - Improvement for static file hosting.

 ## [v1.0.1] - 2018-10-26
+
 ### Changed
+
 - Improve cors configuration settings.

 ## [v1.0.0] - 2018-10-26
+
 ### Changed
+
 - Move GraphQL support into a built-in plugin.

 ## [v0.3.3] - 2018-10-25
+
 ### Added
+
 - CORS support

 ### Changed
+
 - Improved exceptions.

 ## [v0.3.2] - 2018-10-25
+
 ### Changed
+
 - Subtle improvements.

 ## [v0.3.1] - 2018-10-24
+
 ### Fixed
+
 - Packaging fix.

 ## [v0.3.0] - 2018-10-24
+
 ### Changed
+
 - Interactive Documentation endpoint.
 - Minor improvements.

 ## [v0.2.3] - 2018-10-24
+
 ### Changed
+
 - Overall improvements.

 ## [v0.2.2] - 2018-10-23
+
 ### Added
+
 - Show traceback info when background tasks raise exceptions.

 ## [v0.2.1] - 2018-10-23
+
 ### Added
+
 - api.requests.

 ## [v0.2.0] - 2018-10-22
+
 ### Added
+
 - WebSocket support.

 ## [v0.1.6] - 2018-10-20
+
 ### Added
+
 - 500 support.

 ## [v0.1.5] - 2018-10-20
+
 ### Added
+
 - File upload support

 ### Changed
+
 - Improvements to sequential media reading.

 ## [v0.1.4] - 2018-10-19
+
 ### Fixed
+
 - Stability.

 ## [v0.1.3] - 2018-10-18
+
 ### Added
+
 - Sessions support.

 ## [v0.1.2] - 2018-10-18
+
 ### Added
+
 - Cookies support.

 ## [v0.1.1] - 2018-10-17
+
 ### Changed
+
 - Default routes.

 ## [v0.1.0] - 2018-10-17
+
 ### Added
+
 - Prototype of static application support.

 ## [v0.0.10] - 2018-10-17
+
 ### Fixed
+
 - Bugfix for async class-based views.

 ## [v0.0.9] - 2018-10-17
+
 ### Fixed
+
 - Bugfix for async class-based views.

 ## [v0.0.8] - 2018-10-17
+
 ### Added
+
 - GraphiQL Support.

 ### Changed
+
 - Improvement to route selection.

 ## [v0.0.7] - 2018-10-16
+
 ### Changed
+
 - Immutable Request object.

 ## [v0.0.6] - 2018-10-16
+
 ### Added
+
 - Ability to mount WSGI apps.
 - Supply content-type when serving up the schema.

 ## [v0.0.5] - 2018-10-15
+
 ### Added
+
 - OpenAPI Schema support.
 - Safe load/dump yaml.

 ## [v0.0.4] - 2018-10-15
+
 ### Added
+
 - Asynchronous support for data uploads.

 ### Fixed
+
 - Bug fixes.

 ## [v0.0.3] - 2018-10-13
+
 ### Fixed
+
 - Bug fixes.

 ## [v0.0.2] - 2018-10-13
+
 ### Changed
+
 - Switch to ASGI/Starlette.

 ## [v0.0.1] - 2018-10-12
+
 ### Added
+
 - Conception!

-[Unreleased]: https://github.com/taoufik07/responder/compare/v1.3.2..HEAD
+[unreleased]: https://github.com/taoufik07/responder/compare/v2.0.5..HEAD
+[v2.0.5]: https://github.com/taoufik07/responder/compare/v2.0.4..v2.0.5
+[v2.0.4]: https://github.com/taoufik07/responder/compare/v2.0.3..v2.0.4
+[v2.0.3]: https://github.com/taoufik07/responder/compare/v2.0.2..v2.0.3
+[v2.0.2]: https://github.com/taoufik07/responder/compare/v2.0.1..v2.0.2
+[v2.0.1]: https://github.com/taoufik07/responder/compare/v2.0.0..v2.0.1
+[v2.0.0]: https://github.com/taoufik07/responder/compare/v1.3.2..v2.0.0
 [v1.3.2]: https://github.com/taoufik07/responder/compare/v1.3.1..v1.3.2
 [v1.3.1]: https://github.com/taoufik07/responder/compare/v1.3.0..v1.3.1
 [v1.3.0]: https://github.com/taoufik07/responder/compare/v1.2.0..v1.3.0
@@ -5,11 +5,12 @@ name = "pypi"

 [packages]
 responder = {editable = true, path = "."}
+pre-commit = "*"

 [dev-packages]
 pytest = "*"
 "flake8" = "*"
-black = "*"
+black = "==20.8b1"
 twine = "*"
 flask = "*"
 sphinx = "*"
@@ -7,47 +7,54 @@
 [![image](https://img.shields.io/pypi/pyversions/responder.svg)](https://pypi.org/project/responder/)
 [![image](https://img.shields.io/github/contributors/taoufik07/responder.svg)](https://github.com/taoufik07/responder/graphs/contributors)

-[![](https://farm2.staticflickr.com/1959/43750081370_a4e20752de_o_d.png)](https://python-responder.org/)
+[![](https://farm2.staticflickr.com/1959/43750081370_a4e20752de_o_d.png)](https://responder.readthedocs.io)

+Powered by [Starlette](https://www.starlette.io/). That `async` declaration is optional.
+[View documentation](https://responder.readthedocs.io).

-Powered by [Starlette](https://www.starlette.io/). That `async` declaration is optional. [View documentation](https://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.
-
+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.
+> "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]()
+> "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]()

 ## More Examples

-See [the documentation's feature tour](https://python-responder.org/en/latest/tour.html) for more details on features available in Responder.
-
+See
+[the documentation's feature tour](https://responder.readthedocs.io/en/latest/tour.html)
+for 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 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.
+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.content` sends back bytes.
 - Setting `resp.text` sends back unicode, while setting `resp.html` sends back HTML.
@@ -55,16 +62,24 @@ The primary concept here is to bring the niceties that are brought forth from bo
 - 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.
+- 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.
+- 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.
+- 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.
@@ -4,7 +4,7 @@ atomicwrites==1.2.1
 attrs==18.2.0
 babel==2.6.0
 black==18.9b0
-bleach==3.0.2
+bleach==3.1.4
 certifi==2018.8.24
 cffi==1.11.5
 chardet==3.0.4
@@ -45,4 +45,4 @@ tqdm==4.26.0
 twine==1.12.1
 urllib3==1.23
 webencodings==0.5.1
-werkzeug==0.14.1
+werkzeug==0.15.5
@@ -1,7 +1,7 @@
 /* Hide module name and default value for environment variable section */
-div[id$='environment-variables'] code.descclassname {
-    display: none;
+div[id$="environment-variables"] code.descclassname {
+  display: none;
 }
-div[id$='environment-variables'] em.property {
-    display: none;
+div[id$="environment-variables"] em.property {
+  display: none;
 }
@@ -10,142 +10,152 @@
 */

 var Konami = function (callback) {
-    var konami = {
-        addEvent: function (obj, type, fn, ref_obj) {
-            if (obj.addEventListener)
-                obj.addEventListener(type, fn, false);
-            else if (obj.attachEvent) {
-                // IE
-                obj["e" + type + fn] = fn;
-                obj[type + fn] = function () {
-                    obj["e" + type + fn](window.event, ref_obj);
-                }
-                obj.attachEvent("on" + type, obj[type + fn]);
-            }
-        },
-        removeEvent: function (obj, eventName, eventCallback) {
-            if (obj.removeEventListener) {
-                obj.removeEventListener(eventName, eventCallback);
-            } else if (obj.attachEvent) {
-                obj.detachEvent(eventName);
-            }
-        },
-        input: "",
-        pattern: "38384040373937396665",
-        keydownHandler: function (e, ref_obj) {
-            if (ref_obj) {
-                konami = ref_obj;
-            } // IE
-            konami.input += e ? e.keyCode : event.keyCode;
-            if (konami.input.length > konami.pattern.length) {
-                konami.input = konami.input.substr((konami.input.length - konami.pattern.length));
-            }
-            if (konami.input === konami.pattern) {
-                konami.code(konami._currentLink);
-                konami.input = '';
-                e.preventDefault();
-                return false;
-            }
-        },
-        load: function (link) {
-            this._currentLink = link;
-            this.addEvent(document, "keydown", this.keydownHandler, this);
-            this.iphone.load(link);
-        },
-        unload: function () {
-            this.removeEvent(document, 'keydown', this.keydownHandler);
-            this.iphone.unload();
-        },
-        code: function (link) {
-            window.location = link
-        },
-        iphone: {
-            start_x: 0,
-            start_y: 0,
-            stop_x: 0,
-            stop_y: 0,
-            tap: false,
-            capture: false,
-            orig_keys: "",
-            keys: ["UP", "UP", "DOWN", "DOWN", "LEFT", "RIGHT", "LEFT", "RIGHT", "TAP", "TAP"],
-            input: [],
-            code: function (link) {
-                konami.code(link);
-            },
-            touchmoveHandler: function (e) {
-                if (e.touches.length === 1 && konami.iphone.capture === true) {
-                    var touch = e.touches[0];
-                    konami.iphone.stop_x = touch.pageX;
-                    konami.iphone.stop_y = touch.pageY;
-                    konami.iphone.tap = false;
-                    konami.iphone.capture = false;
-                    konami.iphone.check_direction();
-                }
-            },
-            touchendHandler: function () {
-                konami.iphone.input.push(konami.iphone.check_direction());
-                
-                if (konami.iphone.input.length > konami.iphone.keys.length) konami.iphone.input.shift();
-                
-                if (konami.iphone.input.length === konami.iphone.keys.length) {
-                    var match = true;
-                    for (var i = 0; i < konami.iphone.keys.length; i++) {
-                        if (konami.iphone.input[i] !== konami.iphone.keys[i]) {
-                            match = false;
-                        }
-                    }
-                    if (match) {
-                        konami.iphone.code(konami._currentLink);
-                    }
-                }
-            },
-            touchstartHandler: function (e) {
-                konami.iphone.start_x = e.changedTouches[0].pageX;
-                konami.iphone.start_y = e.changedTouches[0].pageY;
-                konami.iphone.tap = true;
-                konami.iphone.capture = true;
-            },
-            load: function (link) {
-                this.orig_keys = this.keys;
-                konami.addEvent(document, "touchmove", this.touchmoveHandler);
-                konami.addEvent(document, "touchend", this.touchendHandler, false);
-                konami.addEvent(document, "touchstart", this.touchstartHandler);
-            },
-            unload: function () {
-                konami.removeEvent(document, 'touchmove', this.touchmoveHandler);
-                konami.removeEvent(document, 'touchend', this.touchendHandler);
-                konami.removeEvent(document, 'touchstart', this.touchstartHandler);
-            },
-            check_direction: function () {
-                x_magnitude = Math.abs(this.start_x - this.stop_x);
-                y_magnitude = Math.abs(this.start_y - this.stop_y);
-                x = ((this.start_x - this.stop_x) < 0) ? "RIGHT" : "LEFT";
-                y = ((this.start_y - this.stop_y) < 0) ? "DOWN" : "UP";
-                result = (x_magnitude > y_magnitude) ? x : y;
-                result = (this.tap === true) ? "TAP" : result;
-                return result;
-            }
+  var konami = {
+    addEvent: function (obj, type, fn, ref_obj) {
+      if (obj.addEventListener) obj.addEventListener(type, fn, false);
+      else if (obj.attachEvent) {
+        // IE
+        obj["e" + type + fn] = fn;
+        obj[type + fn] = function () {
+          obj["e" + type + fn](window.event, ref_obj);
+        };
+        obj.attachEvent("on" + type, obj[type + fn]);
+      }
+    },
+    removeEvent: function (obj, eventName, eventCallback) {
+      if (obj.removeEventListener) {
+        obj.removeEventListener(eventName, eventCallback);
+      } else if (obj.attachEvent) {
+        obj.detachEvent(eventName);
+      }
+    },
+    input: "",
+    pattern: "38384040373937396665",
+    keydownHandler: function (e, ref_obj) {
+      if (ref_obj) {
+        konami = ref_obj;
+      } // IE
+      konami.input += e ? e.keyCode : event.keyCode;
+      if (konami.input.length > konami.pattern.length) {
+        konami.input = konami.input.substr(konami.input.length - konami.pattern.length);
+      }
+      if (konami.input === konami.pattern) {
+        konami.code(konami._currentLink);
+        konami.input = "";
+        e.preventDefault();
+        return false;
+      }
+    },
+    load: function (link) {
+      this._currentLink = link;
+      this.addEvent(document, "keydown", this.keydownHandler, this);
+      this.iphone.load(link);
+    },
+    unload: function () {
+      this.removeEvent(document, "keydown", this.keydownHandler);
+      this.iphone.unload();
+    },
+    code: function (link) {
+      window.location = link;
+    },
+    iphone: {
+      start_x: 0,
+      start_y: 0,
+      stop_x: 0,
+      stop_y: 0,
+      tap: false,
+      capture: false,
+      orig_keys: "",
+      keys: [
+        "UP",
+        "UP",
+        "DOWN",
+        "DOWN",
+        "LEFT",
+        "RIGHT",
+        "LEFT",
+        "RIGHT",
+        "TAP",
+        "TAP",
+      ],
+      input: [],
+      code: function (link) {
+        konami.code(link);
+      },
+      touchmoveHandler: function (e) {
+        if (e.touches.length === 1 && konami.iphone.capture === true) {
+          var touch = e.touches[0];
+          konami.iphone.stop_x = touch.pageX;
+          konami.iphone.stop_y = touch.pageY;
+          konami.iphone.tap = false;
+          konami.iphone.capture = false;
+          konami.iphone.check_direction();
        }
-    }
+      },
+      touchendHandler: function () {
+        konami.iphone.input.push(konami.iphone.check_direction());

-    typeof callback === "string" && konami.load(callback);
-    if (typeof callback === "function") {
-        konami.code = callback;
-        konami.load();
-    }
+        if (konami.iphone.input.length > konami.iphone.keys.length)
+          konami.iphone.input.shift();

-    return konami;
+        if (konami.iphone.input.length === konami.iphone.keys.length) {
+          var match = true;
+          for (var i = 0; i < konami.iphone.keys.length; i++) {
+            if (konami.iphone.input[i] !== konami.iphone.keys[i]) {
+              match = false;
+            }
+          }
+          if (match) {
+            konami.iphone.code(konami._currentLink);
+          }
+        }
+      },
+      touchstartHandler: function (e) {
+        konami.iphone.start_x = e.changedTouches[0].pageX;
+        konami.iphone.start_y = e.changedTouches[0].pageY;
+        konami.iphone.tap = true;
+        konami.iphone.capture = true;
+      },
+      load: function (link) {
+        this.orig_keys = this.keys;
+        konami.addEvent(document, "touchmove", this.touchmoveHandler);
+        konami.addEvent(document, "touchend", this.touchendHandler, false);
+        konami.addEvent(document, "touchstart", this.touchstartHandler);
+      },
+      unload: function () {
+        konami.removeEvent(document, "touchmove", this.touchmoveHandler);
+        konami.removeEvent(document, "touchend", this.touchendHandler);
+        konami.removeEvent(document, "touchstart", this.touchstartHandler);
+      },
+      check_direction: function () {
+        x_magnitude = Math.abs(this.start_x - this.stop_x);
+        y_magnitude = Math.abs(this.start_y - this.stop_y);
+        x = this.start_x - this.stop_x < 0 ? "RIGHT" : "LEFT";
+        y = this.start_y - this.stop_y < 0 ? "DOWN" : "UP";
+        result = x_magnitude > y_magnitude ? x : y;
+        result = this.tap === true ? "TAP" : result;
+        return result;
+      },
+    },
+  };
+
+  typeof callback === "string" && konami.load(callback);
+  if (typeof callback === "function") {
+    konami.code = callback;
+    konami.load();
+  }
+
+  return konami;
 };

-
-if (typeof module !== 'undefined' && typeof module.exports !== 'undefined') {
-        module.exports = Konami;
+if (typeof module !== "undefined" && typeof module.exports !== "undefined") {
+  module.exports = Konami;
 } else {
-        if (typeof define === 'function' && define.amd) {
-                define([], function() {
-                        return Konami;
-                });
-        } else {
-                window.Konami = Konami;
-        }
+  if (typeof define === "function" && define.amd) {
+    define([], function () {
+      return Konami;
+    });
+  } else {
+    window.Konami = Konami;
+  }
 }
@@ -1,5 +1,11 @@
-<link rel="stylesheet" type="text/css" href="https://cloud.typography.com/7584432/7586812/css/fonts.css" />
-<script type="text/javascript">$('#searchbox').hide(0);</script>
+<link
+  rel="stylesheet"
+  type="text/css"
+  href="https://cloud.typography.com/7584432/7586812/css/fonts.css"
+/>
+<script type="text/javascript">
+  $("#searchbox").hide(0);
+</script>
 <!--Alabaster (krTheme++) Hacks -->

 <!-- CSS Adjustments (I'm very picky.) -->
@@ -39,9 +45,7 @@
  }

  .method {
-
    margin-bottom: 2em;
-
  }

  .si,
@@ -80,8 +84,6 @@
    margin-top: -1em;
  }

-
-
  /* "Quick Search" should be not be shown for now. */
  div#searchbox h3 {
    display: none;
@@ -118,10 +120,12 @@
 <script async src="https://www.googletagmanager.com/gtag/js?id=UA-127383416-1"></script>
 <script>
  window.dataLayer = window.dataLayer || [];
-  function gtag() { dataLayer.push(arguments); }
-  gtag('js', new Date());
+  function gtag() {
+    dataLayer.push(arguments);
+  }
+  gtag("js", new Date());

-  gtag('config', 'UA-127383416-1');
+  gtag("config", "UA-127383416-1");
 </script>

 <!-- There are no more hacks. -->
@@ -130,7 +134,10 @@

 <script src="{{ pathto('_static/', 1) }}/konami.js"></script>
 <script>
-  var easter_egg = new Konami('https://www.myfortunecookie.co.uk/fortunes/' + (Math.floor(Math.random() * 152) + 1));
+  var easter_egg = new Konami(
+    "https://www.myfortunecookie.co.uk/fortunes/" +
+      (Math.floor(Math.random() * 152) + 1)
+  );
 </script>

 <style>
@@ -140,67 +147,94 @@
 </style>

 <!-- GitHub Logo -->
-<a href="https://github.com/kennethreitz/responder" class="github-corner" aria-label="View source on GitHub">
-  <svg width="80" height="80" viewBox="0 0 250 250" style="fill:#151513; color:#fff; position: absolute; top: 0; border: 0; right: 0;"
-    aria-hidden="true">
+<a
+  href="https://github.com/kennethreitz/responder"
+  class="github-corner"
+  aria-label="View source on GitHub"
+>
+  <svg
+    width="80"
+    height="80"
+    viewBox="0 0 250 250"
+    style="fill: #151513; color: #fff; position: absolute; top: 0; border: 0; right: 0"
+    aria-hidden="true"
+  >
    <path d="M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z"></path>
-    <path d="M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2"
-      fill="currentColor" style="transform-origin: 130px 106px;" class="octo-arm"></path>
-    <path d="M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z"
-      fill="currentColor" class="octo-body"></path>
+    <path
+      d="M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2"
+      fill="currentColor"
+      style="transform-origin: 130px 106px"
+      class="octo-arm"
+    ></path>
+    <path
+      d="M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z"
+      fill="currentColor"
+      class="octo-body"
+    ></path>
  </svg>
 </a>
 <style>
  .github-corner:hover .octo-arm {
-    animation: octocat-wave 560ms ease-in-out
+    animation: octocat-wave 560ms ease-in-out;
  }

  @keyframes octocat-wave {
-
    0%,
    100% {
-      transform: rotate(0)
+      transform: rotate(0);
    }

    20%,
    60% {
-      transform: rotate(-25deg)
+      transform: rotate(-25deg);
    }

    40%,
    80% {
-      transform: rotate(10deg)
+      transform: rotate(10deg);
    }
  }

-  @media (max-width:500px) {
+  @media (max-width: 500px) {
    .github-corner:hover .octo-arm {
-      animation: none
+      animation: none;
    }

    .github-corner .octo-arm {
-      animation: octocat-wave 560ms ease-in-out
+      animation: octocat-wave 560ms ease-in-out;
    }
  }
 </style>

-
 <!-- That was not a hack. That was art.

 <!-- UserVoice JavaScript SDK (only needed once on a page) -->
-<script>(function () { var uv = document.createElement('script'); uv.type = 'text/javascript'; uv.async = true; uv.src = '//widget.uservoice.com/f4AQraEfwInlMzkexfRLg.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(uv, s) })()</script>
+<script>
+  (function () {
+    var uv = document.createElement("script");
+    uv.type = "text/javascript";
+    uv.async = true;
+    uv.src = "//widget.uservoice.com/f4AQraEfwInlMzkexfRLg.js";
+    var s = document.getElementsByTagName("script")[0];
+    s.parentNode.insertBefore(uv, s);
+  })();
+</script>

 <!-- A tab to launch the Classic Widget -->
 <script>
  UserVoice = window.UserVoice || [];
-  UserVoice.push(['showTab', 'classic_widget', {
-    mode: 'feedback',
-    primary_color: '#fa8c28',
-    link_color: '#0a8cc6',
-    forum_id: 913660,
-    tab_label: 'Got feedback?',
-    tab_color: '#00994f',
-    tab_position: 'bottom-left',
-    tab_inverted: true
-  }]);
+  UserVoice.push([
+    "showTab",
+    "classic_widget",
+    {
+      mode: "feedback",
+      primary_color: "#fa8c28",
+      link_color: "#0a8cc6",
+      forum_id: 913660,
+      tab_label: "Got feedback?",
+      tab_color: "#00994f",
+      tab_position: "bottom-left",
+      tab_inverted: true,
+    },
+  ]);
 </script>
@@ -1,54 +1,93 @@
 <p class="logo">
  <a href="{{ pathto(master_doc) }}">
-    <img class="logo" src="{{ pathto('_static/responder.png', 1) }}" title="https://kennethreitz.org/tattoos" />
+    <img
+      class="logo"
+      src="{{ pathto('_static/responder.png', 1) }}"
+      title="https://kennethreitz.org/tattoos"
+    />
  </a>
 </p>

 <p>
-  <iframe src="https://ghbtns.com/github-btn.html?user=kennethreitz&repo=responder&type=watch&count=true&size=large"
-    allowtransparency="true" frameborder="0" scrolling="0" width="200px" height="35px"></iframe>
+  <iframe
+    src="https://ghbtns.com/github-btn.html?user=kennethreitz&repo=responder&type=watch&count=true&size=large"
+    allowtransparency="true"
+    frameborder="0"
+    scrolling="0"
+    width="200px"
+    height="35px"
+  ></iframe>
 </p>
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
+<link
+  rel="stylesheet"
+  href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css"
+/>
 <style>
-.algolia-autocomplete{
-  width: 100%;
-  height: 1.5em
-}
-.algolia-autocomplete a{
-  border-bottom: none !important;
-}
-#doc_search{
-  width: 100%;
-  height: 100%;
-}
+  .algolia-autocomplete {
+    width: 100%;
+    height: 1.5em;
+  }
+  .algolia-autocomplete a {
+    border-bottom: none !important;
+  }
+  #doc_search {
+    width: 100%;
+    height: 100%;
+  }
 </style>
-<input id="doc_search" placeholder="Search the doc" autofocus/>
-<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js" onload="docsearch({
+<input id="doc_search" placeholder="Search the doc" autofocus />
+<script
+  type="text/javascript"
+  src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"
+  onload="docsearch({
  apiKey: 'ac965312db252e0496283c75c6f76f0b',
  indexName: 'python-responder',
  inputSelector: '#doc_search',
  debug: false // Set debug to true if you want to inspect the dropdown
-})" async></script>
+})"
+  async
+></script>

-<p>
-  <strong>Responder</strong> is a web service framework, written for human beings.
-</p>
+<p><strong>Responder</strong> is a web service framework, written for human beings.</p>

 <h3>Stay Informed</h3>
 <p>Receive updates on new releases and upcoming projects.</p>

-<p><iframe src="https://ghbtns.com/github-btn.html?user=kennethreitz&type=follow&count=true" allowtransparency="true"
-    frameborder="0" scrolling="0" width="200" height="20"></iframe></p>
-
-<p><a href="https://twitter.com/kennethreitz" class="twitter-follow-button" data-show-count="false">Follow
-    @kennethreitz</a>
-  <script>!function (d, s, id) { var js, fjs = d.getElementsByTagName(s)[0], p = /^http:/.test(d.location) ? 'http' : 'https'; if (!d.getElementById(id)) { js = d.createElement(s); js.id = id; js.src = p + '://platform.twitter.com/widgets.js'; fjs.parentNode.insertBefore(js, fjs); } }(document, 'script', 'twitter-wjs');</script>
+<p>
+  <iframe
+    src="https://ghbtns.com/github-btn.html?user=kennethreitz&type=follow&count=true"
+    allowtransparency="true"
+    frameborder="0"
+    scrolling="0"
+    width="200"
+    height="20"
+  ></iframe>
 </p>

+<p>
+  <a
+    href="https://twitter.com/kennethreitz"
+    class="twitter-follow-button"
+    data-show-count="false"
+    >Follow @kennethreitz</a
+  >
+  <script>
+    !(function (d, s, id) {
+      var js,
+        fjs = d.getElementsByTagName(s)[0],
+        p = /^http:/.test(d.location) ? "http" : "https";
+      if (!d.getElementById(id)) {
+        js = d.createElement(s);
+        js.id = id;
+        js.src = p + "://platform.twitter.com/widgets.js";
+        fjs.parentNode.insertBefore(js, fjs);
+      }
+    })(document, "script", "twitter-wjs");
+  </script>
+</p>

 <h3>Useful Links</h3>
 <ul>
-
  <li><a href="http://github.com/kennethreitz/responder">Responder @ GitHub</a></li>
  <li><a href="http://pypi.python.org/pypi/responder">Responder @ PyPI</a></li>
  <li><a href="http://github.com/kennethreitz/responder/issues">Issue Tracker</a></li>
@@ -1,54 +1,93 @@
 <p class="logo">
  <a href="{{ pathto(master_doc) }}">
-    <img class="logo" src="{{ pathto('_static/responder.png', 1) }}" title="https://kennethreitz.org/tattoos" />
+    <img
+      class="logo"
+      src="{{ pathto('_static/responder.png', 1) }}"
+      title="https://kennethreitz.org/tattoos"
+    />
  </a>
 </p>

 <p>
-  <iframe src="https://ghbtns.com/github-btn.html?user=kennethreitz&repo=responder&type=watch&count=true&size=large"
-    allowtransparency="true" frameborder="0" scrolling="0" width="200px" height="35px"></iframe>
+  <iframe
+    src="https://ghbtns.com/github-btn.html?user=kennethreitz&repo=responder&type=watch&count=true&size=large"
+    allowtransparency="true"
+    frameborder="0"
+    scrolling="0"
+    width="200px"
+    height="35px"
+  ></iframe>
 </p>
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
+<link
+  rel="stylesheet"
+  href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css"
+/>
 <style>
-.algolia-autocomplete{
-  width: 100%;
-  height: 1.5em
-}
-.algolia-autocomplete a{
-  border-bottom: none !important;
-}
-#doc_search{
-  width: 100%;
-  height: 100%;
-}
+  .algolia-autocomplete {
+    width: 100%;
+    height: 1.5em;
+  }
+  .algolia-autocomplete a {
+    border-bottom: none !important;
+  }
+  #doc_search {
+    width: 100%;
+    height: 100%;
+  }
 </style>
-<input id="doc_search" placeholder="Search the doc" autofocus/>
-<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js" onload="docsearch({
+<input id="doc_search" placeholder="Search the doc" autofocus />
+<script
+  type="text/javascript"
+  src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"
+  onload="docsearch({
  apiKey: 'ac965312db252e0496283c75c6f76f0b',
  indexName: 'python-responder',
  inputSelector: '#doc_search',
  debug: false // Set debug to true if you want to inspect the dropdown
-})" async></script>
+})"
+  async
+></script>

-<p>
-  <strong>Responder</strong> is a web service framework, written for human beings.
-</p>
+<p><strong>Responder</strong> is a web service framework, written for human beings.</p>

 <h3>Stay Informed</h3>
 <p>Receive updates on new releases and upcoming projects.</p>

-<p><iframe src="https://ghbtns.com/github-btn.html?user=kennethreitz&type=follow&count=true" allowtransparency="true"
-    frameborder="0" scrolling="0" width="200" height="20"></iframe></p>
-
-<p><a href="https://twitter.com/kennethreitz" class="twitter-follow-button" data-show-count="false">Follow
-    @kennethreitz</a>
-  <script>!function (d, s, id) { var js, fjs = d.getElementsByTagName(s)[0], p = /^http:/.test(d.location) ? 'http' : 'https'; if (!d.getElementById(id)) { js = d.createElement(s); js.id = id; js.src = p + '://platform.twitter.com/widgets.js'; fjs.parentNode.insertBefore(js, fjs); } }(document, 'script', 'twitter-wjs');</script>
+<p>
+  <iframe
+    src="https://ghbtns.com/github-btn.html?user=kennethreitz&type=follow&count=true"
+    allowtransparency="true"
+    frameborder="0"
+    scrolling="0"
+    width="200"
+    height="20"
+  ></iframe>
 </p>

+<p>
+  <a
+    href="https://twitter.com/kennethreitz"
+    class="twitter-follow-button"
+    data-show-count="false"
+    >Follow @kennethreitz</a
+  >
+  <script>
+    !(function (d, s, id) {
+      var js,
+        fjs = d.getElementsByTagName(s)[0],
+        p = /^http:/.test(d.location) ? "http" : "https";
+      if (!d.getElementById(id)) {
+        js = d.createElement(s);
+        js.id = id;
+        js.src = p + "://platform.twitter.com/widgets.js";
+        fjs.parentNode.insertBefore(js, fjs);
+      }
+    })(document, "script", "twitter-wjs");
+  </script>
+</p>

 <h3>Useful Links</h3>
 <ul>
-
  <li><a href="http://github.com/kennethreitz/responder">Responder @ GitHub</a></li>
  <li><a href="http://pypi.python.org/pypi/responder">Responder @ PyPI</a></li>
  <li><a href="http://github.com/kennethreitz/responder/issues">Issue Tracker</a></li>
@@ -73,13 +73,30 @@ If the client requests YAML instead (with a header of ``Accept: application/x-ya
 Rendering a Template
 --------------------

-If you want to render a template, simply use ``api.template``. No need for additional imports::
+Responder provides a built-in light `jinja2 <http://jinja.pocoo.org/docs/>`_ wrapper ``templates.Templates``
+
+Usage::
+
+  from responder.templates import Templates
+
+  templates = Templates()
+
+  @api.route("/hello/{name}/html")
+  def hello(req, resp, name):
+      resp.html = templates.render("hello.html", name=name)
+
+
+Also a ``render_async`` is available::
+
+    templates = Templates(enable_async=True)
+    resp.html = await templates.render_async("hello.html", who=who)
+
+You can also use the existing ``api.template(filename, *args, **kwargs)`` to render templates::

    @api.route("/hello/{who}/html")
    def hello_html(req, resp, *, who):
        resp.html = api.template('hello.html', who=who)

-The ``api`` instance is available as an object during template rendering.

 Setting Response Status Code
 ----------------------------
@@ -58,13 +58,14 @@ You can make use of Responder's Request and Response objects in your GraphQL res
 OpenAPI Schema Support
 ----------------------

-Responder comes with built-in support for OpenAPI / marshmallow::
+Responder comes with built-in support for OpenAPI / marshmallow
+
+New in Responder `1.4.0`::

    import responder
+    from responder.ext.schema import Schema as OpenAPISchema
    from marshmallow import Schema, fields

-    description = "This is a sample server for a pet store."
-    terms_of_service = "http://example.com/terms/"
    contact = {
        "name": "API Support",
        "url": "http://www.example.com/support",
@@ -74,19 +75,21 @@ Responder comes with built-in support for OpenAPI / marshmallow::
        "name": "Apache 2.0",
        "url": "https://www.apache.org/licenses/LICENSE-2.0.html",
    }
+    
+    api = responder.API()

-    api = responder.API(
+    schema = OpenAPISchema(
+        app=api,
        title="Web Service",
        version="1.0",
        openapi="3.0.2",
-        description=description,
-        terms_of_service=terms_of_service,
+        description="A simple pet store",
+        terms_of_service="http://example.com/terms/",
        contact=contact,
        license=license,
    )

-
-    @api.schema("Pet")
+    @schema.schema("Pet")
    class PetSchema(Schema):
        name = fields.Str()

@@ -108,6 +111,51 @@ Responder comes with built-in support for OpenAPI / marshmallow::
        resp.media = PetSchema().dump({"name": "little orange"})


+Old way *It's recommended to use the code above* ::
+
+    import responder
+    from marshmallow import Schema, fields
+
+    contact = {
+        "name": "API Support",
+        "url": "http://www.example.com/support",
+        "email": "support@example.com",
+    }
+    license = {
+        "name": "Apache 2.0",
+        "url": "https://www.apache.org/licenses/LICENSE-2.0.html",
+    }
+
+    api = responder.API(
+        title="Web Service",
+        version="1.0",
+        openapi="3.0.2",
+        description="A simple pet store",
+        terms_of_service="http://example.com/terms/",
+        contact=contact,
+        license=license,
+    )
+
+    @api.schema("Pet")
+    class PetSchema(Schema):
+        name = fields.Str()
+
+    @api.route("/")
+    def route(req, resp):
+        """A cute furry animal endpoint.
+        ---
+        get:
+            description: Get a random pet
+            responses:
+                200:
+                    description: A pet to be returned
+                    content:  
+                        application/json: 
+                            schema: 
+                                $ref: '#/components/schemas/Pet'                         
+        """
+        resp.media = PetSchema().dump({"name": "little orange"})
+
 ::

    >>> r = api.session().get("http://;/schema.yml")
@@ -142,7 +190,31 @@ Responder comes with built-in support for OpenAPI / marshmallow::
 Interactive Documentation
 -------------------------

-Responder can automatically supply API Documentation for you. Using the example above::
+Responder can automatically supply API Documentation for you. Using the example above
+
+The new and recommended way::
+
+    ...
+    from responder.ext.schema import Schema
+    ...
+    api = responder.API()
+
+    schema = Schema(
+        app=api,
+        title="Web Service",
+        version="1.0",
+        openapi="3.0.2",
+        ...
+        docs_route='/docs',
+        ...
+        description=description,
+        terms_of_service=terms_of_service,
+        contact=contact,
+        license=license,
+    )
+    
+
+The old way ::

    api = responder.API(
        title="Web Service",
@@ -157,8 +229,8 @@ Responder can automatically supply API Documentation for you. Using the example

 This will make ``/docs`` render interactive documentation for your API.

-Mount a WSGI App (e.g. Flask)
-----------------------------
+Mount a WSGI / ASGI Apps (e.g. Flask, Starlette,...)
+----------------------------------------------------

 Responder gives you the ability to mount another ASGI / WSGI app at a subroute::

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta:__legacy__"
@@ -1,5 +1,5 @@
 build:
-    image: latest
+  image: latest

 python:
-    version: 3.6
+  version: 3.6
@@ -1 +1 @@
-__version__ = "1.3.2"
+__version__ = "2.0.6"
@@ -1,56 +1,39 @@
 import json
 import os

-from uuid import uuid4
 from pathlib import Path
-from base64 import b64encode

-import apistar
-import itsdangerous
 import jinja2
 import uvicorn
-import yaml
-from apispec import APISpec, yaml_utils
-from apispec.ext.marshmallow import MarshmallowPlugin
+from starlette.exceptions import ExceptionMiddleware
 from starlette.middleware.wsgi import WSGIMiddleware
 from starlette.middleware.errors import ServerErrorMiddleware
 from starlette.middleware.cors import CORSMiddleware
 from starlette.middleware.gzip import GZipMiddleware
 from starlette.middleware.httpsredirect import HTTPSRedirectMiddleware
 from starlette.middleware.trustedhost import TrustedHostMiddleware
-from starlette.routing import Lifespan
+from starlette.middleware.sessions import SessionMiddleware
 from starlette.staticfiles import StaticFiles
 from starlette.testclient import TestClient
 from starlette.websockets import WebSocket
-from whitenoise import WhiteNoise

 from . import models, status_codes
 from .background import BackgroundQueue
 from .formats import get_formats
-from .routes import Route
-from .statics import (
-    DEFAULT_API_THEME,
-    DEFAULT_CORS_PARAMS,
-    DEFAULT_SECRET_KEY,
-    DEFAULT_SESSION_COOKIE,
-)
-from .templates import GRAPHIQL
+from .routes import Router
+from .statics import DEFAULT_API_THEME, DEFAULT_CORS_PARAMS, DEFAULT_SECRET_KEY
+from .ext.schema import Schema as OpenAPISchema
+from .staticfiles import StaticFiles
+from .templates import Templates


-# TODO: consider moving status codes here
 class API:
    """The primary web-service class.

-        :param static_dir: The directory to use for static files. Will be created for you if it doesn't already exist.
-        :param templates_dir: The directory to use for templates. Will be created for you if it doesn't already exist.
-        :param auto_escape: If ``True``, HTML and XML templates will automatically be escaped.
-        :param enable_hsts: If ``True``, send all responses to HTTPS URLs.
-        :param title: The title of the application (OpenAPI Info Object)
-        :param version: The version of the OpenAPI document (OpenAPI Info Object)
-        :param description: The description of the OpenAPI document (OpenAPI Info Object)
-        :param terms_of_service: A URL to the Terms of Service for the API (OpenAPI Info Object)
-        :param contact: The contact dictionary of the application (OpenAPI Contact Object)
-        :param license: The license information of the exposed API (OpenAPI License Object)
+    :param static_dir: The directory to use for static files. Will be created for you if it doesn't already exist.
+    :param templates_dir: The directory to use for templates. Will be created for you if it doesn't already exist.
+    :param auto_escape: If ``True``, HTML and XML templates will automatically be escaped.
+    :param enable_hsts: If ``True``, send all responses to HTTPS URLs.
    """

    status_codes = status_codes
@@ -81,13 +64,8 @@ class API:
        self.background = BackgroundQueue()

        self.secret_key = secret_key
-        self.title = title
-        self.version = version
-        self.description = description
-        self.terms_of_service = terms_of_service
-        self.contact = contact
-        self.license = license
-        self.openapi_version = openapi
+
+        self.router = Router()

        if static_dir is not None:
            if static_route is None:
@@ -97,23 +75,6 @@ class API:
        self.static_dir = static_dir
        self.static_route = static_route

-        self.built_in_templates_dir = Path(
-            os.path.abspath(os.path.dirname(__file__) + "/templates")
-        )
-
-        if templates_dir is not None:
-            templates_dir = Path(os.path.abspath(templates_dir))
-
-        self.templates_dir = templates_dir or self.built_in_templates_dir
-
-        self.apps = {}
-        self.routes = {}
-        self.before_requests = {"http": [], "ws": []}
-        self.docs_theme = DEFAULT_API_THEME
-        self.docs_route = docs_route
-        self.schemas = {}
-        self.session_cookie = DEFAULT_SESSION_COOKIE
-
        self.hsts_enabled = enable_hsts
        self.cors = cors
        self.cors_params = cors_params
@@ -127,39 +88,19 @@ class API:
            allowed_hosts = ["*"]
        self.allowed_hosts = allowed_hosts

-        # Make the static/templates directory if they don't exist.
-        for _dir in (self.static_dir, self.templates_dir):
-            if _dir is not None:
-                os.makedirs(_dir, exist_ok=True)
+        if self.static_dir is not None:
+            os.makedirs(self.static_dir, exist_ok=True)

        if self.static_dir is not None:
-            self.whitenoise = WhiteNoise(application=self._notfound_wsgi_app)
-            self.whitenoise.add_files(str(self.static_dir))
-
-            self.whitenoise.add_files(
-                (
-                    Path(apistar.__file__).parent
-                    / "themes"
-                    / self.docs_theme
-                    / "static"
-                ).resolve()
-            )
-
-            self.mount(self.static_route, self.whitenoise)
+            self.mount(self.static_route, self.static_app)

        self.formats = get_formats()

        # Cached requests session.
        self._session = None

-        if self.openapi_version:
-            self.add_route(openapi_route, self.schema_response)
-
-        if self.docs_route:
-            self.add_route(self.docs_route, self.docs_response)
-
        self.default_endpoint = None
-        self.app = self.asgi
+        self.app = ExceptionMiddleware(self.router, debug=debug)
        self.add_middleware(GZipMiddleware)

        if self.hsts_enabled:
@@ -167,185 +108,60 @@ class API:

        self.add_middleware(TrustedHostMiddleware, allowed_hosts=self.allowed_hosts)

-        self.lifespan_handler = Lifespan()
-
        if self.cors:
            self.add_middleware(CORSMiddleware, **self.cors_params)
        self.add_middleware(ServerErrorMiddleware, debug=debug)
+        self.add_middleware(SessionMiddleware, secret_key=self.secret_key)

-        # Jinja environment
-        self.jinja_env = jinja2.Environment(
-            loader=jinja2.FileSystemLoader(
-                [str(self.templates_dir), str(self.built_in_templates_dir)],
-                followlinks=True,
-            ),
-            autoescape=jinja2.select_autoescape(["html", "xml"] if auto_escape else []),
-        )
-        self.jinja_values_base = {"api": self}  # Give reference to self.
+        if openapi or docs_route:
+            self.openapi = OpenAPISchema(
+                app=self,
+                title=title,
+                version=version,
+                openapi=openapi,
+                docs_route=docs_route,
+                description=description,
+                terms_of_service=terms_of_service,
+                contact=contact,
+                license=license,
+                openapi_route=openapi_route,
+                static_route=static_route,
+            )
+
+        # TODO: Update docs for templates
+        self.templates = Templates(directory=templates_dir)
        self.requests = (
            self.session()
        )  #: A Requests session that is connected to the ASGI app.

-    @staticmethod
-    def _default_wsgi_app(environ, start_response):
-        pass
-
-    @staticmethod
-    def _notfound_wsgi_app(environ, start_response):
-        start_response("404 NOT FOUND", [("Content-Type", "text/plain")])
-        return [b"Not Found."]
+    @property
+    def static_app(self):
+        if not hasattr(self, "_static_app"):
+            assert self.static_dir is not None
+            self._static_app = StaticFiles(directory=self.static_dir)
+        return self._static_app

    def before_request(self, websocket=False):
        def decorator(f):
-            if websocket:
-                self.before_requests.setdefault("ws", []).append(f)
-            else:
-                self.before_requests.setdefault("http", []).append(f)
+            self.router.before_request(f, websocket=websocket)
            return f

        return decorator

-    @property
-    def before_http_requests(self):
-        return self.before_requests.get("http", [])
-
-    @property
-    def before_ws_requests(self):
-        return self.before_requests.get("ws", [])
-
-    @property
-    def _apispec(self):
-
-        info = {}
-        if self.description is not None:
-            info["description"] = self.description
-        if self.terms_of_service is not None:
-            info["termsOfService"] = self.terms_of_service
-        if self.contact is not None:
-            info["contact"] = self.contact
-        if self.license is not None:
-            info["license"] = self.license
-
-        spec = APISpec(
-            title=self.title,
-            version=self.version,
-            openapi_version=self.openapi_version,
-            plugins=[MarshmallowPlugin()],
-            info=info,
-        )
-
-        for route in self.routes:
-            if self.routes[route].description:
-                operations = yaml_utils.load_operations_from_docstring(
-                    self.routes[route].description
-                )
-                spec.path(path=route, operations=operations)
-
-        for name, schema in self.schemas.items():
-            spec.components.schema(name, schema=schema)
-
-        return spec
-
-    @property
-    def openapi(self):
-        return self._apispec.to_yaml()
-
    def add_middleware(self, middleware_cls, **middleware_config):
        self.app = middleware_cls(self.app, **middleware_config)

-    async def __call__(self, scope, receive, send):
-        if scope["type"] == "lifespan":
-            await self.lifespan_handler(scope, receive, send)
-            return
-
-        path = scope["path"]
-        root_path = scope.get("root_path", "")
-
-        # Call into a submounted app, if one exists.
-        for path_prefix, app in self.apps.items():
-            if path.startswith(path_prefix):
-                scope["path"] = path[len(path_prefix) :]
-                scope["root_path"] = root_path + path_prefix
-                try:
-                    await app(scope, receive, send)
-                    return
-                except TypeError:
-                    app = WSGIMiddleware(app)
-                    await app(scope, receive, send)
-                    return
-
-        await self.app(scope, receive, send)
-
-    async def asgi(self, scope, receive, send):
-        assert scope["type"] in ("http", "websocket")
-
-        if scope["type"] == "websocket":
-            await self._dispatch_ws(scope=scope, receive=receive, send=send)
-        else:
-            req = models.Request(scope, receive=receive, api=self)
-            resp = await self._dispatch_http(
-                req, scope=scope, send=send, receive=receive
-            )
-            await resp(scope, receive, send)
-
-    async def _dispatch_http(self, req, **options):
-        # Set formats on Request object.
-        req.formats = self.formats
-
-        # Get the route.
-        route = self.path_matches_route(req.url.path)
-        route = self.routes.get(route)
-        if route:
-            resp = models.Response(req=req, formats=self.formats)
-
-            for before_request in self.before_http_requests:
-                await self.background(before_request, req=req, resp=resp)
-
-            await self._execute_route(route=route, req=req, resp=resp, **options)
-        else:
-            resp = models.Response(req=req, formats=self.formats)
-            self.default_response(req=req, resp=resp, notfound=True)
-        self.default_response(req=req, resp=resp)
-
-        self._prepare_session(resp)
-
-        return resp
-
-    async def _dispatch_ws(self, scope, receive, send):
-        ws = WebSocket(scope=scope, receive=receive, send=send)
-
-        route = self.path_matches_route(ws.url.path)
-        route = self.routes.get(route)
-
-        if route:
-            for before_request in self.before_ws_requests:
-                await self.background(before_request, ws=ws)
-            await self.background(route.endpoint, ws)
-        else:
-            await send({"type": "websocket.close", "code": 1000})
-
-    def add_schema(self, name, schema, check_existing=True):
-        """Adds a mashmallow schema to the API specification."""
-        if check_existing:
-            assert name not in self.schemas
-
-        self.schemas[name] = schema
-
    def schema(self, name, **options):
        """Decorator for creating new routes around function and class definitions.
-
        Usage::
-
            from marshmallow import Schema, fields
-
            @api.schema("Pet")
            class PetSchema(Schema):
                name = fields.Str()
-
        """

        def decorator(f):
-            self.add_schema(name=name, schema=f, **options)
+            self.openapi.add_schema(name=name, schema=f, **options)
            return f

        return decorator
@@ -355,97 +171,18 @@ class API:

        :param path: The path portion of a URL, to test all known routes against.
        """
-        for (route, route_object) in self.routes.items():
-            if route_object.does_match(path):
+        for route in self.router.routes:
+            match, _ = route.matches(path)
+            if match:
                return route

-    @property
-    def _signer(self):
-        return itsdangerous.Signer(self.secret_key)
-
-    def _prepare_session(self, resp):
-
-        if resp.session:
-            data = self._signer.sign(
-                b64encode(json.dumps(resp.session).encode("utf-8"))
-            )
-            resp.cookies[self.session_cookie] = data.decode("utf-8")
-
-    @staticmethod
-    def no_response(req, resp, **params):
-        pass
-
-    async def _execute_route(self, *, route, req, resp, **options):
-
-        params = route.incoming_matches(req.url.path)
-
-        cont = True
-
-        if route.is_function:
-            try:
-                try:
-                    # Run the view.
-                    r = self.background(route.endpoint, req, resp, **params)
-                    # If it's async, await it.
-                    if hasattr(r, "cr_running"):
-                        await r
-                except TypeError as e:
-                    cont = True
-            except Exception:
-                await self.background(self.default_response, req, resp, error=True)
-                raise
-
-        if route.is_class_based or cont:
-            try:
-                view = route.endpoint(**params)
-            except TypeError:
-                try:
-                    view = route.endpoint()
-                except TypeError:
-                    view = route.endpoint
-                    pass
-
-            # Run on_request first.
-            try:
-                # Run the view.
-                r = getattr(view, "on_request", self.no_response)
-                r = self.background(r, req, resp, **params)
-                # If it's async, await it.
-                if hasattr(r, "send"):
-                    await r
-            except Exception:
-                await self.background(self.default_response, req, resp, error=True)
-                raise
-
-            # Then run on_method.
-            method = req.method
-            try:
-                # Run the view.
-                r = getattr(view, f"on_{method}", self.no_response)
-                r = self.background(r, req, resp, **params)
-                # If it's async, await it.
-                if hasattr(r, "send"):
-                    await r
-            except Exception:
-                await self.background(self.default_response, req, resp, error=True)
-                raise
-
-    def add_event_handler(self, event_type, handler):
-        """Adds an event handler to the API.
-
-        :param event_type: A string in ("startup", "shutdown")
-        :param handler: The function to run. Can be either a function or a coroutine.
-        """
-
-        self.lifespan_handler.add_event_handler(event_type, handler)
-
    def add_route(
        self,
        route=None,
        endpoint=None,
        *,
        default=False,
-        static=False,
+        static=True,
        check_existing=True,
        websocket=False,
        before_request=False,
@@ -456,60 +193,25 @@ class API:
        :param endpoint: The endpoint for the route -- can be a callable, or a class.
        :param default: If ``True``, all unknown requests will route to this view.
        :param static: If ``True``, and no endpoint was passed, render "static/index.html", and it will become a default route.
-        :param check_existing: If ``True``, an AssertionError will be raised, if the route is already defined.
        """
-        if before_request:
-            if websocket:
-                self.before_requests.setdefault("ws", []).append(endpoint)
-            else:
-                self.before_requests.setdefault("http", []).append(endpoint)
-            return
-
-        if route is None:
-            route = f"/{uuid4().hex}"
-
-        if check_existing:
-            assert route not in self.routes

+        # Path
        if static:
            assert self.static_dir is not None
            if not endpoint:
-                endpoint = self.static_response
+                endpoint = self._static_response
                default = True

-        if default:
-            self.default_endpoint = endpoint
-
-        self.routes[route] = Route(route, endpoint, websocket=websocket)
-        # TODO: A better data structure or sort it once the app is loaded
-        self.routes = dict(
-            sorted(self.routes.items(), key=lambda item: item[1]._weight())
+        self.router.add_route(
+            route,
+            endpoint,
+            default=default,
+            websocket=websocket,
+            before_request=before_request,
+            check_existing=check_existing,
        )

-    def default_response(
-        self, req=None, resp=None, websocket=False, notfound=False, error=False
-    ):
-        if websocket:
-            return
-
-        if resp.status_code is None:
-            resp.status_code = 200
-
-        if self.default_endpoint and notfound:
-            self.default_endpoint(req=req, resp=resp)
-        else:
-            if notfound:
-                resp.status_code = status_codes.HTTP_404
-                resp.text = "Not found."
-            if error:
-                resp.status_code = status_codes.HTTP_500
-                resp.text = "Application error."
-
-    def docs_response(self, req, resp):
-        resp.html = self.docs
-
-    def static_response(self, req, resp):
-
+    async def _static_response(self, req, resp):
        assert self.static_dir is not None

        index = (self.static_dir / "index.html").resolve()
@@ -520,28 +222,16 @@ class API:
            resp.status_code = status_codes.HTTP_404
            resp.text = "Not found."

-    def schema_response(self, req, resp):
-        resp.status_code = status_codes.HTTP_200
-        resp.headers["Content-Type"] = "application/x-yaml"
-        resp.content = self.openapi
-
    def redirect(
        self, resp, location, *, set_text=True, status_code=status_codes.HTTP_301
    ):
        """Redirects a given response to a given location.
-
        :param resp: The Response to mutate.
        :param location: The location of the redirect.
        :param set_text: If ``True``, sets the Redirect body content automatically.
        :param status_code: an `API.status_codes` attribute, or an integer, representing the HTTP status code of the redirect.
        """
-
-        # assert resp.status_code.is_300(status_code)
-
-        resp.status_code = status_code
-        if set_text:
-            resp.text = f"Redirecting to: {location}"
-        resp.headers.update({"Location": location})
+        resp.redirect(location, set_text=set_text, status_code=status_code)

    def on_event(self, event_type: str, **args):
        """Decorator for registering functions or coroutines to run at certain events
@@ -565,6 +255,15 @@ class API:

        return decorator

+    def add_event_handler(self, event_type, handler):
+        """Adds an event handler to the API.
+
+        :param event_type: A string in ("startup", "shutdown")
+        :param handler: The function to run. Can be either a function or a coroutine.
+        """
+
+        self.router.add_event_handler(event_type, handler)
+
    def route(self, route=None, **options):
        """Decorator for creating new routes around function and class definitions.

@@ -588,7 +287,7 @@ class API:
        :param route: String representation of the route to be used (shouldn't be parameterized).
        :param app: The other WSGI / ASGI app.
        """
-        self.apps.update({route: app})
+        self.router.apps.update({route: app})

    def session(self, base_url="http://;"):
        """Testing HTTP client. Returns a Requests session object, able to send HTTP requests to the Responder application.
@@ -600,11 +299,6 @@ class API:
            self._session = TestClient(self, base_url=base_url)
        return self._session

-    def _route_for(self, endpoint):
-        for route_object in self.routes.values():
-            if endpoint in (route_object.endpoint, route_object.endpoint_name):
-                return route_object
-
    def url_for(self, endpoint, **params):
        # TODO: Absolute_url
        """Given an endpoint, returns a rendered URL for its route.
@@ -612,67 +306,25 @@ class API:
        :param endpoint: The route endpoint you're searching for.
        :param params: Data to pass into the URL generator (for parameterized URLs).
        """
-        route_object = self._route_for(endpoint)
-        if route_object:
-            return route_object.url(**params)
-        raise ValueError
+        return self.router.url_for(endpoint, **params)

-    def static_url(self, asset):
-        """Given a static asset, return its URL path."""
-        assert None not in (self.static_dir, self.static_route)
-        return f"{self.static_route}/{str(asset)}"
-
-    @property
-    def docs(self):
-
-        loader = jinja2.PrefixLoader(
-            {
-                self.docs_theme: jinja2.PackageLoader(
-                    "apistar", os.path.join("themes", self.docs_theme, "templates")
-                )
-            }
-        )
-        env = jinja2.Environment(autoescape=True, loader=loader)
-        document = apistar.document.Document()
-        document.content = yaml.safe_load(self.openapi)
-
-        template = env.get_template("/".join([self.docs_theme, "index.html"]))
-
-        return template.render(
-            document=document,
-            langs=["javascript", "python"],
-            code_style=None,
-            static_url=self.static_url,
-            schema_url="/schema.yml",
-        )
-
-    def template(self, name_, **values):
+    def template(self, filename, *args, **kwargs):
        """Renders the given `jinja2 <http://jinja.pocoo.org/docs/>`_ template, with provided values supplied.
-
        Note: The current ``api`` instance is by default passed into the view. This is set in the dict ``api.jinja_values_base``.
-
-        :param name_: The filename of the jinja2 template, in ``templates_dir``.
-        :param values: Data to pass into the template.
+        :param filename: The filename of the jinja2 template, in ``templates_dir``.
+        :param *args: Data to pass into the template.
+        :param *kwargs: Date to pass into the template.
        """
-        # Prepopulate values with base
-        values = {**self.jinja_values_base, **values}
+        return self.templates.render(filename, *args, **kwargs)

-        template = self.jinja_env.get_template(name_)
-        return template.render(**values)
-
-    def template_string(self, s_, **values):
+    def template_string(self, source, *args, **kwargs):
        """Renders the given `jinja2 <http://jinja.pocoo.org/docs/>`_ template string, with provided values supplied.
-
        Note: The current ``api`` instance is by default passed into the view. This is set in the dict ``api.jinja_values_base``.
-
-        :param s_: The template to use.
-        :param values: Data to pass into the template.
+        :param source: The template to use.
+        :param *args: Data to pass into the template.
+        :param **kwargs: Data to pass into the template.
        """
-        # Prepopulate values with base
-        values = {**self.jinja_values_base, **values}
-
-        template = self.jinja_env.from_string(s_)
-        return template.render(**values)
+        return self.templates.render_string(source, *args, **kwargs)

    def serve(self, *, address=None, port=None, debug=False, **options):
        """Runs the application with uvicorn. If the ``PORT`` environment
@@ -704,3 +356,6 @@ class API:
        if "debug" not in kwargs:
            kwargs.update({"debug": self.debug})
        self.serve(**kwargs)
+
+    async def __call__(self, scope, receive, send):
+        await self.app(scope, receive, send)
@@ -3,7 +3,7 @@ from functools import partial

 from graphql_server import default_format_error, encode_execution_results, json_encode

-from ..templates import GRAPHIQL
+from .templates import GRAPHIQL


 class GraphQLView:
@@ -44,7 +44,9 @@ class GraphQLView:
        show_graphiql = req.method == "get" and req.accepts("text/html")

        if show_graphiql:
-            resp.content = self.api.template_string(GRAPHIQL, endpoint=req.url.path)
+            resp.content = self.api.templates.render_string(
+                GRAPHIQL, endpoint=req.url.path
+            )
            return

        query, variables, operation_name = await self._resolve_graphql_query(req)
@@ -63,3 +65,6 @@ class GraphQLView:

    async def on_request(self, req, resp):
        await self.graphql_response(req, resp, self.schema)
+
+    async def __call__(self, req, resp):
+        await self.on_request(req, resp)
@@ -0,0 +1,160 @@
+import os
+from pathlib import Path
+
+import apistar
+import jinja2
+import yaml
+from apispec import APISpec, yaml_utils
+from apispec.ext.marshmallow import MarshmallowPlugin
+
+from responder.statics import DEFAULT_API_THEME
+from responder.staticfiles import StaticFiles
+from responder import status_codes
+
+
+class Schema:
+    def __init__(
+        self,
+        app,
+        title,
+        version,
+        plugins=None,
+        description=None,
+        terms_of_service=None,
+        contact=None,
+        license=None,
+        openapi=None,
+        openapi_route="/schema.yml",
+        docs_route="/docs/",
+        static_route="/static",
+    ):
+        self.app = app
+        self.schemas = {}
+        self.title = title
+        self.version = version
+        self.description = description
+        self.terms_of_service = terms_of_service
+        self.contact = contact
+        self.license = license
+
+        self.openapi_version = openapi
+        self.openapi_route = openapi_route
+
+        self.docs_theme = DEFAULT_API_THEME
+        self.docs_route = docs_route
+
+        self.plugins = [MarshmallowPlugin()] if plugins is None else plugins
+
+        if self.openapi_version is not None:
+            self.app.add_route(self.openapi_route, self.schema_response)
+
+        if self.docs_route is not None:
+            self.app.add_route(self.docs_route, self.docs_response)
+
+        theme_path = (
+            Path(apistar.__file__).parent / "themes" / self.docs_theme / "static"
+        ).resolve()
+
+        self.static_route = static_route
+
+        self.app.static_app.add_directory(theme_path)
+
+    @property
+    def _apispec(self):
+
+        info = {}
+        if self.description is not None:
+            info["description"] = self.description
+        if self.terms_of_service is not None:
+            info["termsOfService"] = self.terms_of_service
+        if self.contact is not None:
+            info["contact"] = self.contact
+        if self.license is not None:
+            info["license"] = self.license
+
+        spec = APISpec(
+            title=self.title,
+            version=self.version,
+            openapi_version=self.openapi_version,
+            plugins=self.plugins,
+            info=info,
+        )
+
+        for route in self.app.router.routes:
+            if route.description:
+                operations = yaml_utils.load_operations_from_docstring(
+                    route.description
+                )
+                spec.path(path=route.route, operations=operations)
+
+        for name, schema in self.schemas.items():
+            spec.components.schema(name, schema=schema)
+
+        return spec
+
+    @property
+    def openapi(self):
+        return self._apispec.to_yaml()
+
+    def add_schema(self, name, schema, check_existing=True):
+        """Adds a marshmallow schema to the API specification."""
+        if check_existing:
+            assert name not in self.schemas
+
+        self.schemas[name] = schema
+
+    def schema(self, name, **options):
+        """Decorator for creating new routes around function and class definitions.
+
+        Usage::
+
+            from marshmallow import Schema, fields
+
+            @api.schema("Pet")
+            class PetSchema(Schema):
+                name = fields.Str()
+
+        """
+
+        def decorator(f):
+            self.add_schema(name=name, schema=f, **options)
+            return f
+
+        return decorator
+
+    @property
+    def docs(self):
+
+        loader = jinja2.PrefixLoader(
+            {
+                self.docs_theme: jinja2.PackageLoader(
+                    "apistar", os.path.join("themes", self.docs_theme, "templates")
+                )
+            }
+        )
+        env = jinja2.Environment(autoescape=True, loader=loader)
+        document = apistar.document.Document()
+        document.content = yaml.safe_load(self.openapi)
+
+        template = env.get_template("/".join([self.docs_theme, "index.html"]))
+
+        return template.render(
+            document=document,
+            langs=["javascript", "python"],
+            code_style=None,
+            static_url=self.static_url,
+            schema_url="/schema.yml",
+        )
+
+    def static_url(self, asset):
+        """Given a static asset, return its URL path."""
+        assert self.static_route is not None
+        return f"{self.static_route}/{str(asset)}"
+
+    def docs_response(self, req, resp):
+        resp.html = self.docs
+
+    def schema_response(self, req, resp):
+        resp.status_code = status_codes.HTTP_200
+        resp.headers["Content-Type"] = "application/x-yaml"
+        resp.content = self.openapi
@@ -3,16 +3,18 @@ import io
 import inspect
 import json
 import gzip
+from urllib.parse import parse_qs
 from base64 import b64decode
 from http.cookies import SimpleCookie

-
 import chardet
 import rfc3986
 import graphene
 import yaml
+
 from requests.structures import CaseInsensitiveDict
 from requests.cookies import RequestsCookieJar
+
 from starlette.datastructures import MutableHeaders
 from starlette.requests import Request as StarletteRequest, State
 from starlette.responses import (
@@ -20,9 +22,7 @@ from starlette.responses import (
    StreamingResponse as StarletteStreamingResponse,
 )

-from urllib.parse import parse_qs
-
-from .status_codes import HTTP_200
+from .status_codes import HTTP_200, HTTP_301
 from .statics import DEFAULT_ENCODING


@@ -105,9 +105,9 @@ class Request:
        "_cookies",
    ]

-    def __init__(self, scope, receive, api=None):
+    def __init__(self, scope, receive, api=None, formats=None):
        self._starlette = StarletteRequest(scope, receive)
-        self.formats = None
+        self.formats = formats
        self._encoding = None
        self.api = api
        self._content = None
@@ -122,14 +122,7 @@ class Request:
    @property
    def session(self):
        """The session data, in dict form, from the Request."""
-        if self.api.session_cookie in self.cookies:
-
-            data = self.cookies[self.api.session_cookie]
-
-            data = self.api._signer.unsign(data)
-            data = b64decode(data)
-            return json.loads(data)
-        return {}
+        return self._starlette.session

    @property
    def headers(self):
@@ -182,12 +175,12 @@ class Request:
    def state(self) -> State:
        """
        Use the state to store additional information.
-        
+
        This can be a very helpful feature, if you want to hand over
        information from a middelware or a route decorator to the
        actual route handler.

-        For example: ``request.state.time_started = time.time()`` 
+        Usage: ``request.state.time_started = time.time()``
        """
        return self._starlette.state

@@ -290,9 +283,7 @@ class Response:
        self.content = None  #: A bytes representation of the response body.
        self.mimetype = None
        self.encoding = DEFAULT_ENCODING
-        self.media = (
-            None
-        )  #: A Python object that will be content-negotiated and sent back to the client. Typically, in JSON formatting.
+        self.media = None  #: A Python object that will be content-negotiated and sent back to the client. Typically, in JSON formatting.
        self._stream = None
        self.headers = (
            {}
@@ -300,7 +291,7 @@ class Response:
        self.formats = formats
        self.cookies = SimpleCookie()  #: The cookies set in the Response
        self.session = (
-            req.session.copy()
+            req.session
        )  #: The cookie-based session data, in dict form, to add to the Response.

    # Property or func/dec
@@ -311,6 +302,12 @@ class Response:

        return func

+    def redirect(self, location, *, set_text=True, status_code=HTTP_301):
+        self.status_code = status_code
+        if set_text:
+            self.text = f"Redirecting to: {location}"
+        self.headers.update({"Location": location})
+
    @property
    async def body(self):
        if self._stream is not None:
@@ -1,43 +1,77 @@
+import asyncio
+import json
 import re
-import functools
 import inspect
-from parse import parse, with_pattern
+import traceback
+from collections import defaultdict
+
+from starlette.middleware.wsgi import WSGIMiddleware
+from starlette.websockets import WebSocket, WebSocketClose
+from starlette.concurrency import run_in_threadpool
+from starlette.exceptions import HTTPException
+
+from .models import Request, Response
+from . import status_codes
+from .formats import get_formats
+from .statics import DEFAULT_SESSION_COOKIE


-def _make_convertor(type, pattern):
-    @with_pattern(pattern)
-    def inner(value):
-        return type(value)
-
-    return inner
-
-
-_convertors = {
-    "int": _make_convertor(int, r"\d+"),
-    "str": _make_convertor(str, r"[^/]+"),
-    "float": _make_convertor(float, r"\d+(.\d+)?"),
+_CONVERTORS = {
+    "int": (int, r"\d+"),
+    "str": (str, r"[^/]+"),
+    "float": (float, r"\d+(.\d+)?"),
 }

+PARAM_RE = re.compile("{([a-zA-Z_][a-zA-Z0-9_]*)(:[a-zA-Z_][a-zA-Z0-9_]*)?}")

-class Route:
-    _param_pattern = re.compile(r"{([^{}]*)}")

-    def __init__(self, route, endpoint, *, websocket=False, before_request=False):
+def compile_path(path):
+    path_re = "^"
+    param_convertors = {}
+    idx = 0
+
+    for match in PARAM_RE.finditer(path):
+        param_name, convertor_type = match.groups(default="str")
+        convertor_type = convertor_type.lstrip(":")
+        assert (
+            convertor_type in _CONVERTORS.keys()
+        ), f"Unknown path convertor '{convertor_type}'"
+        convertor, convertor_re = _CONVERTORS[convertor_type]
+
+        path_re += path[idx : match.start()]
+        path_re += rf"(?P<{param_name}>{convertor_re})"
+
+        param_convertors[param_name] = convertor
+
+        idx = match.end()
+
+    path_re += path[idx:] + "$"
+
+    return re.compile(path_re), param_convertors
+
+
+class BaseRoute:
+    def matches(self, scope):
+        raise NotImplementedError()
+
+    async def __call__(self, scope, receive, send):
+        raise NotImplementedError()
+
+
+class Route(BaseRoute):
+    def __init__(self, route, endpoint, *, before_request=False):
+        assert route.startswith("/"), "Route path must start with '/'"
        self.route = route
        self.endpoint = endpoint
-        self.uses_websocket = websocket
        self.before_request = before_request

+        self.path_re, self.param_convertors = compile_path(route)
+
    def __repr__(self):
        return f"<Route {self.route!r}={self.endpoint!r}>"

-    def __eq__(self, other):
-        if hasattr(other, "route"):
-            # Being compared to other routes.
-            return self.route == other.route
-        else:
-            # Strings.
-            return self.does_match(other)
+    def url(self, **params):
+        return self.route.format(**params)

    @property
    def endpoint_name(self):
@@ -47,46 +81,278 @@ class Route:
    def description(self):
        return self.endpoint.__doc__

-    @property
-    def has_parameters(self):
-        return bool(self._param_pattern.search(self.route))
+    def matches(self, scope):
+        if scope["type"] != "http":
+            return False, {}

-    @functools.lru_cache(maxsize=None)
-    def does_match(self, s):
-        if s == self.route:
-            return True
+        path = scope["path"]
+        match = self.path_re.match(path)

-        named = self.incoming_matches(s)
-        return bool(len(named))
+        if match is None:
+            return False, {}

-    @functools.lru_cache(maxsize=None)
-    def incoming_matches(self, s):
-        results = parse(self.route, s, _convertors)
-        return results.named if results else {}
+        matched_params = match.groupdict()
+        for key, value in matched_params.items():
+            matched_params[key] = self.param_convertors[key](value)
+
+        return True, {"path_params": {**matched_params}}
+
+    async def __call__(self, scope, receive, send):
+        request = Request(scope, receive, formats=get_formats())
+        response = Response(req=request, formats=get_formats())
+
+        path_params = scope.get("path_params", {})
+        before_requests = scope.get("before_requests", [])
+
+        for before_request in before_requests.get("http", []):
+            if asyncio.iscoroutinefunction(before_request):
+                await before_request(request, response)
+            else:
+                await run_in_threadpool(before_request, request, response)
+
+        views = []
+
+        if inspect.isclass(self.endpoint):
+            endpoint = self.endpoint()
+            on_request = getattr(endpoint, "on_request", None)
+            if on_request:
+                views.append(on_request)
+
+            method_name = f"on_{request.method}"
+            try:
+                view = getattr(endpoint, method_name)
+                views.append(view)
+            except AttributeError:
+                if on_request is None:
+                    raise HTTPException(status_code=status_codes.HTTP_405)
+        else:
+            views.append(self.endpoint)
+
+        for view in views:
+            # "Monckey patch" for graphql: explicitly checking __call__
+            if asyncio.iscoroutinefunction(view) or asyncio.iscoroutinefunction(
+                view.__call__
+            ):
+                await view(request, response, **path_params)
+            else:
+                await run_in_threadpool(view, request, response, **path_params)
+
+        if response.status_code is None:
+            response.status_code = status_codes.HTTP_200
+
+        await response(scope, receive, send)
+
+    def __eq__(self, other):
+        # [TODO] compare to str ?
+        return self.route == other.route and self.endpoint == other.endpoint
+
+    def __hash__(self):
+        return hash(self.route) ^ hash(self.endpoint) ^ hash(self.before_request)
+
+
+class WebSocketRoute(BaseRoute):
+    def __init__(self, route, endpoint, *, before_request=False):
+        assert route.startswith("/"), "Route path must start with '/'"
+        self.route = route
+        self.endpoint = endpoint
+        self.before_request = before_request
+
+        self.path_re, self.param_convertors = compile_path(route)
+
+    def __repr__(self):
+        return f"<Route {self.route!r}={self.endpoint!r}>"

    def url(self, **params):
        return self.route.format(**params)

-    def _weight(self):
-        params = set(self._param_pattern.findall(self.route))
-        params_count = len(params)
-        w = len(self.route.rsplit("}", 1)[-1].strip("/"))
-        return params_count != 0, w == 0, -params_count
+    @property
+    def endpoint_name(self):
+        return self.endpoint.__name__

    @property
-    def is_class_based(self):
-        return inspect.isclass(self.endpoint)
+    def description(self):
+        return self.endpoint.__doc__

-    @property
-    def is_function(self):
-        code = hasattr(self.endpoint, "__code__")
-        kwdefaults = hasattr(self.endpoint, "__kwdefaults__")
-        return all((callable(self.endpoint), code, kwdefaults))
+    def matches(self, scope):
+        if scope["type"] != "websocket":
+            return False, {}
+
+        path = scope["path"]
+        match = self.path_re.match(path)
+
+        if match is None:
+            return False, {}
+
+        matched_params = match.groupdict()
+        for key, value in matched_params.items():
+            matched_params[key] = self.param_convertors[key](value)
+
+        return True, {"path_params": {**matched_params}}
+
+    async def __call__(self, scope, receive, send):
+        ws = WebSocket(scope, receive, send)
+
+        before_requests = scope.get("before_requests", [])
+        for before_request in before_requests.get("ws", []):
+            await before_request(ws)
+
+        await self.endpoint(ws)
+
+    def __eq__(self, other):
+        # [TODO] compare to str ?
+        return self.route == other.route and self.endpoint == other.endpoint

    def __hash__(self):
-        return (
-            hash(self.route)
-            ^ hash(self.endpoint)
-            ^ hash(self.uses_websocket)
-            ^ hash(self.before_request)
+        return hash(self.route) ^ hash(self.endpoint) ^ hash(self.before_request)
+
+
+class Router:
+    def __init__(self, routes=None, default_response=None, before_requests=None):
+        self.routes = [] if routes is None else list(routes)
+        # [TODO] Make its own router
+        self.apps = {}
+        self.default_endpoint = (
+            self.default_response if default_response is None else default_response
        )
+        self.before_requests = (
+            {"http": [], "ws": []} if before_requests is None else before_requests
+        )
+        self.events = defaultdict(list)
+
+    def add_route(
+        self,
+        route=None,
+        endpoint=None,
+        *,
+        default=False,
+        websocket=False,
+        before_request=False,
+        check_existing=False,
+    ):
+        """Adds a route to the router.
+        :param route: A string representation of the route
+        :param endpoint: The endpoint for the route -- can be callable, or class.
+        :param default: If ``True``, all unknown requests will route to this view.
+        """
+        if before_request:
+            if websocket:
+                self.before_requests.setdefault("ws", []).append(endpoint)
+            else:
+                self.before_requests.setdefault("http", []).append(endpoint)
+            return
+
+        if check_existing:
+            assert not self.routes or route not in (
+                item.route for item in self.routes
+            ), f"Route '{route}' already exists"
+
+        if default:
+            self.default_endpoint = endpoint
+
+        if websocket:
+            route = WebSocketRoute(route, endpoint)
+        else:
+            route = Route(route, endpoint)
+
+        self.routes.append(route)
+
+    def mount(self, route, app):
+        """Mounts ASGI / WSGI applications at a given route"""
+        self.apps.update(route, app)
+
+    def add_event_handler(self, event_type, handler):
+        assert event_type in (
+            "startup",
+            "shutdown",
+        ), f"Only 'startup' and 'shutdown' events are supported, not {event_type}."
+        self.events[event_type].append(handler)
+
+    async def trigger_event(self, event_type):
+        for handler in self.events.get(event_type, []):
+            if asyncio.iscoroutinefunction(handler):
+                await handler()
+            else:
+                handler()
+
+    def before_request(self, endpoint, websocket=False):
+        if websocket:
+            self.before_requests.setdefault("ws", []).append(endpoint)
+        else:
+            self.before_requests.setdefault("http", []).append(endpoint)
+
+    def url_for(self, endpoint, **params):
+        # TODO: Check for params
+        for route in self.routes:
+            if endpoint in (route.endpoint, route.endpoint.__name__):
+                return route.url(**params)
+        return None
+
+    async def default_response(self, scope, receive, send):
+        if scope["type"] == "websocket":
+            websocket_close = WebSocketClose()
+            await websocket_close(receive, send)
+            return
+
+        request = Request(scope, receive)
+        response = Response(request, formats=get_formats())
+
+        raise HTTPException(status_code=status_codes.HTTP_404)
+
+    def _resolve_route(self, scope):
+        for route in self.routes:
+            matches, child_scope = route.matches(scope)
+            if matches:
+                scope.update(child_scope)
+                return route
+        return None
+
+    async def lifespan(self, scope, receive, send):
+        message = await receive()
+        assert message["type"] == "lifespan.startup"
+
+        try:
+            await self.trigger_event("startup")
+        except BaseException:
+            msg = traceback.format_exc()
+            await send({"type": "lifespan.startup.failed", "message": msg})
+            raise
+
+        await send({"type": "lifespan.startup.complete"})
+        message = await receive()
+        assert message["type"] == "lifespan.shutdown"
+        await self.trigger_event("shutdown")
+        await send({"type": "lifespan.shutdown.complete"})
+
+    async def __call__(self, scope, receive, send):
+        assert scope["type"] in ("http", "websocket", "lifespan")
+
+        if scope["type"] == "lifespan":
+            await self.lifespan(scope, receive, send)
+            return
+
+        path = scope["path"]
+        root_path = scope.get("root_path", "")
+
+        # Check "primary" mounted routes first (before submounted apps)
+        route = self._resolve_route(scope)
+
+        scope["before_requests"] = self.before_requests
+
+        if route is not None:
+            await route(scope, receive, send)
+            return
+
+        # Call into a submounted app, if one exists.
+        for path_prefix, app in self.apps.items():
+            if path.startswith(path_prefix):
+                scope["path"] = path[len(path_prefix) :]
+                scope["root_path"] = root_path + path_prefix
+                try:
+                    await app(scope, receive, send)
+                    return
+                except TypeError:
+                    app = WSGIMiddleware(app)
+                    await app(scope, receive, send)
+                    return
+
+        await self.default_endpoint(scope, receive, send)
@@ -0,0 +1,18 @@
+import typing
+
+from starlette.staticfiles import StaticFiles
+
+
+class StaticFiles(StaticFiles):
+    """I've created an issue to disccuss allowing multiple directories in starletter's `StaticFiles`.
+
+    https://github.com/encode/starlette/issues/625
+
+    I've also made a PR to add this method to starlette StaticFiles
+    Once accepted we will remove this.
+
+    https://github.com/encode/starlette/pull/626
+    """
+
+    def add_directory(self, directory: str) -> None:
+        self.all_directories = [*self.all_directories, *self.get_directories(directory)]
@@ -0,0 +1,59 @@
+from contextlib import contextmanager
+
+import jinja2
+
+
+class Templates:
+    def __init__(
+        self, directory="templates", autoescape=True, context=None, enable_async=False
+    ):
+        self.directory = directory
+        self._env = jinja2.Environment(
+            loader=jinja2.FileSystemLoader([str(self.directory)]),
+            autoescape=autoescape,
+            enable_async=enable_async,
+        )
+        self.default_context = {} if context is None else {**context}
+        self._env.globals.update(self.default_context)
+
+    @property
+    def context(self):
+        return self._env.globals
+
+    @context.setter
+    def context(self, context):
+        self._env.globals = {**self.default_context, **context}
+
+    def get_template(self, name):
+        return self._env.get_template(name)
+
+    def render(self, template, *args, **kwargs):
+        """Renders the given `jinja2 <http://jinja.pocoo.org/docs/>`_ template, with provided values supplied.
+
+        :param template: The filename of the jinja2 template.
+        :param **kwargs: Data to pass into the template.
+        :param **kwargs: Data to pass into the template.
+        """
+        return self.get_template(template).render(*args, **kwargs)
+
+    @contextmanager
+    def _async(self):
+        self._env.is_async = True
+        try:
+            yield
+        finally:
+            self._env.is_async = False
+
+    async def render_async(self, template, *args, **kwargs):
+        with self._async():
+            return await self.get_template(template).render_async(*args, **kwargs)
+
+    def render_string(self, source, *args, **kwargs):
+        """Renders the given `jinja2 <http://jinja.pocoo.org/docs/>`_ template string, with provided values supplied.
+
+        :param source: The template to use.
+        :param *args, **kwargs: Data to pass into the template.
+        :param **kwargs: Data to pass into the template.
+        """
+        template = self._env.from_string(source)
+        return template.render(*args, **kwargs)
@@ -22,16 +22,14 @@ if sys.argv[-1] == "publish":
    sys.exit()

 required = [
-    "starlette==0.12.*",
-    "uvicorn>=0.7, <0.9",
+    "starlette==0.13.*",
+    "uvicorn>=0.11.7,<0.13",
    "aiofiles",
    "pyyaml",
    "requests",
-    "graphene",
+    "graphene<3.0",
    "graphql-server-core>=1.1",
    "jinja2",
-    "parse",
-    "uvloop; sys_platform != 'win32' and sys_platform != 'cygwin' and sys_platform != 'cli'",
    "rfc3986",
    "python-multipart",
    "chardet",
@@ -39,9 +37,9 @@ required = [
    "marshmallow",
    "whitenoise",
    "docopt",
-    "itsdangerous",
    "requests-toolbelt",
    "apistar",
+    "itsdangerous",
 ]


@@ -56,3 +56,12 @@ def schema():
            return f"Hello {name}"

    return graphene.Schema(query=Query)
+
+
+@pytest.fixture
+def template_path(tmpdir):
+    # create a Jinja template file on the filesystem
+    template_name = "test.html"
+    template_file = tmpdir.mkdir("static").join(template_name)
+    template_file.write("{{ var }}")
+    return template_file
@@ -7,6 +7,8 @@ import responder
 import requests
 import string
 import io
+from responder.routes import Router, Route, WebSocketRoute
+from responder.templates import Templates

 from starlette.middleware.base import BaseHTTPMiddleware
 from starlette.responses import PlainTextResponse
@@ -19,6 +21,45 @@ def test_api_basic_route(api):
        resp.text = "hello world!"


+def test_route_repr():
+    def home(req, resp):
+        """Home page"""
+        resp.text = "Hello !"
+
+    route = Route("/", home)
+
+    assert route.__repr__() == f"<Route '/'={home!r}>"
+
+    assert route.endpoint_name == home.__name__
+    assert route.description == home.__doc__
+
+
+def test_websocket_route_repr():
+    def chat_endpoint(ws):
+        """Chat"""
+        pass
+
+    route = WebSocketRoute("/", chat_endpoint)
+
+    assert route.__repr__() == f"<Route '/'={chat_endpoint!r}>"
+
+    assert route.endpoint_name == chat_endpoint.__name__
+    assert route.description == chat_endpoint.__doc__
+
+
+def test_route_eq():
+    def home(req, resp):
+        resp.text = "Hello !"
+
+    assert Route("/", home) == Route("/", home)
+
+    def chat(ws):
+        pass
+
+    assert WebSocketRoute("/", home) == WebSocketRoute("/", home)
+
+
+"""
 def test_api_basic_route_overlap(api):
    @api.route("/")
    def home(req, resp):
@@ -29,39 +70,7 @@ def test_api_basic_route_overlap(api):
        @api.route("/")
        def home2(req, resp):
            resp.text = "hello world!"
-
-
-def test_api_basic_route_overlap_alternative(api):
-    @api.route("/")
-    def home(req, resp):
-        resp.text = "hello world!"
-
-    def home2(req, resp):
-        resp.text = "hello world!"
-
-    with pytest.raises(AssertionError):
-        api.add_route("/", home2)
-
-
-def test_api_basic_route_overlap_allowed(api):
-    @api.route("/")
-    def home(req, resp):
-        resp.text = "hello world!"
-
-    def home2(req, resp):
-        resp.text = "hello world!"
-
-    api.add_route("/", home2, check_existing=False)
-
-
-def test_api_basic_route_overlap_allowed_alternative(api):
-    @api.route("/")
-    def home(req, resp):
-        resp.text = "hello world!"
-
-    @api.route("/", check_existing=False)
-    def home2(req, resp):
-        resp.text = "hello world!"
+"""


 def test_class_based_view_registration(api):
@@ -74,10 +83,10 @@ def test_class_based_view_registration(api):
 def test_class_based_view_parameters(api):
    @api.route("/{greeting}")
    class Greeting:
-        def on_request(self, req, resp, *, greeting):
-            resp.text = f"{greeting}, world!"
+        pass

-    assert api.session().get("http://;/Hello").ok
+    resp = api.session().get("http://;/Hello")
+    assert resp.status_code == api.status_codes.HTTP_405


 def test_requests_session(api):
@@ -85,14 +94,14 @@ def test_requests_session(api):
    assert api.requests


-def test_requests_session_works(api, url):
+def test_requests_session_works(api):
    TEXT = "spiral out"

    @api.route("/")
    def hello(req, resp):
        resp.text = TEXT

-    assert api.requests.get(url("/")).text == TEXT
+    assert api.requests.get("/").text == TEXT


 def test_status_code(api):
@@ -338,13 +347,45 @@ def test_yaml_downloads(api):
    assert yaml.safe_load(r.content) == dump


+def test_schema_generation_explicit():
+    import responder
+    from responder.ext.schema import Schema as OpenAPISchema
+    import marshmallow
+
+    api = responder.API()
+
+    schema = OpenAPISchema(app=api, title="Web Service", version="1.0", openapi="3.0.2")
+
+    @schema.schema("Pet")
+    class PetSchema(marshmallow.Schema):
+        name = marshmallow.fields.Str()
+
+    @api.route("/")
+    def route(req, resp):
+        """A cute furry animal endpoint.
+        ---
+        get:
+            description: Get a random pet
+            responses:
+                200:
+                    description: A pet to be returned
+                    schema:
+                        $ref: "#/components/schemas/Pet"
+        """
+        resp.media = PetSchema().dump({"name": "little orange"})
+
+    r = api.requests.get("http://;/schema.yml")
+    dump = yaml.safe_load(r.content)
+
+    assert dump
+    assert dump["openapi"] == "3.0.2"
+
+
 def test_schema_generation():
    import responder
    from marshmallow import Schema, fields

-    api = responder.API(
-        title="Web Service", openapi="3.0.2", allowed_hosts=["testserver", ";"]
-    )
+    api = responder.API(title="Web Service", openapi="3.0.2")

    @api.schema("Pet")
    class PetSchema(Schema):
@@ -371,6 +412,60 @@ def test_schema_generation():
    assert dump["openapi"] == "3.0.2"


+def test_documentation_explicit():
+    import responder
+    from responder.ext.schema import Schema as OpenAPISchema
+
+    import marshmallow
+
+    description = "This is a sample server for a pet store."
+    terms_of_service = "http://example.com/terms/"
+    contact = {
+        "name": "API Support",
+        "url": "http://www.example.com/support",
+        "email": "support@example.com",
+    }
+    license = {
+        "name": "Apache 2.0",
+        "url": "https://www.apache.org/licenses/LICENSE-2.0.html",
+    }
+
+    api = responder.API(allowed_hosts=["testserver", ";"])
+
+    schema = OpenAPISchema(
+        app=api,
+        title="Web Service",
+        version="1.0",
+        openapi="3.0.2",
+        docs_route="/docs",
+        description=description,
+        terms_of_service=terms_of_service,
+        contact=contact,
+        license=license,
+    )
+
+    @schema.schema("Pet")
+    class PetSchema(marshmallow.Schema):
+        name = marshmallow.fields.Str()
+
+    @api.route("/")
+    def route(req, resp):
+        """A cute furry animal endpoint.
+        ---
+        get:
+            description: Get a random pet
+            responses:
+                200:
+                    description: A pet to be returned
+                    schema:
+                        $ref: "#/components/schemas/Pet"
+        """
+        resp.media = PetSchema().dump({"name": "little orange"})
+
+    r = api.requests.get("/docs")
+    assert "html" in r.text
+
+
 def test_documentation():
    import responder
    from marshmallow import Schema, fields
@@ -485,7 +580,7 @@ def test_sessions(api):
    assert r.json() == {"hello": "world"}


-def test_template_rendering(api):
+def test_template_string_rendering(api):
    @api.route("/")
    def view(req, resp):
        resp.content = api.template_string("{{ var }}", var="hello")
@@ -494,6 +589,39 @@ def test_template_rendering(api):
    assert r.text == "hello"


+def test_template_rendering(template_path):
+    api = responder.API(templates_dir=template_path.dirpath())
+
+    @api.route("/")
+    def view(req, resp):
+        resp.content = api.template(template_path.basename, var="hello")
+
+    r = api.requests.get(api.url_for(view))
+    assert r.text == "hello"
+
+
+def test_template(api, template_path):
+    templates = Templates(directory=template_path.dirpath())
+
+    @api.route("/{var}/")
+    def view(req, resp, var):
+        resp.html = templates.render(template_path.basename, var=var)
+
+    r = api.requests.get("/test/")
+    assert r.text == "test"
+
+
+def test_template_async(api, template_path):
+    templates = Templates(directory=template_path.dirpath(), enable_async=True)
+
+    @api.route("/{var}/async")
+    async def view_async(req, resp, var):
+        resp.html = await templates.render_async(template_path.basename, var=var)
+
+    r = api.requests.get("/test/async")
+    assert r.text == "test"
+
+
 def test_file_uploads(api):
    @api.route("/")
    async def upload(req, resp):
@@ -582,7 +710,7 @@ def test_before_websockets(api):
        await ws.send_json(payload)
        await ws.close()

-    @api.route(before_request=True, websocket=True)
+    @api.before_request(websocket=True)
    async def before_request(ws):
        await ws.accept()
        await ws.send_json({"before": "request"})
@@ -620,7 +748,7 @@ def test_redirects(api, session):
    def one(req, resp):
        resp.text = "redirected"

-    assert session.get("/1").url == "http://;/1"
+    assert session.get("/2").url == "http://;/1"


 def test_session_thoroughly(api, session):
@@ -643,6 +771,10 @@ def test_before_response(api, session):
    def get(req, resp):
        resp.media = req.session

+    @api.route(before_request=True)
+    async def async_before_request(req, resp):
+        resp.headers["x-pizza"] = "1"
+
    @api.route(before_request=True)
    def before_request(req, resp):
        resp.headers["x-pizza"] = "1"
@@ -651,8 +783,12 @@ def test_before_response(api, session):
    assert "x-pizza" in r.headers


-def test_allowed_hosts():
-    api = responder.API(allowed_hosts=[";", "tenant.;"])
+@pytest.mark.parametrize("enable_hsts", [True, False])
+@pytest.mark.parametrize("cors", [True, False])
+def test_allowed_hosts(enable_hsts, cors):
+    api = responder.API(
+        allowed_hosts=[";", "tenant.;"], enable_hsts=enable_hsts, cors=cors
+    )

    @api.route("/")
    def get(req, resp):
@@ -716,14 +852,15 @@ def create_asset(static_dir, name=None, parent_dir=None):
    return asset


-def test_staticfiles(tmpdir):
+@pytest.mark.parametrize("static_route", [None, "/static", "/custom/static/route"])
+def test_staticfiles(tmpdir, static_route):
    static_dir = tmpdir.mkdir("static")

    asset1 = create_asset(static_dir)
    parent_dir = "css"
    asset2 = create_asset(static_dir, name="asset2", parent_dir=parent_dir)

-    api = responder.API(static_dir=str(static_dir))
+    api = responder.API(static_dir=str(static_dir), static_route=static_route)
    session = api.session()

    static_route = api.static_route
@@ -747,30 +884,6 @@ def test_staticfiles(tmpdir):
    assert r.status_code == api.status_codes.HTTP_404


-def test_staticfiles_custom_route(tmpdir):
-    static_dir = tmpdir.mkdir("static")
-    static_route = "/custom/static/route"
-
-    asset = create_asset(static_dir)
-
-    api = responder.API(static_dir=str(static_dir), static_route=static_route)
-    session = api.session()
-
-    static_route = api.static_route
-
-    # ok
-    r = session.get(f"{static_route}/{asset.basename}")
-    assert r.status_code == api.status_codes.HTTP_200
-
-    # Asset not found
-    r = session.get(f"{static_route}/not_found.css")
-    assert r.status_code == api.status_codes.HTTP_404
-
-    # Not found on dir listing
-    r = session.get(f"{static_route}")
-    assert r.status_code == api.status_codes.HTTP_404
-
-
 def test_staticfiles_none_dir(tmpdir):
    api = responder.API(static_dir=None)
    session = api.session()
@@ -794,25 +907,6 @@ def test_staticfiles_none_dir(tmpdir):
        api.add_route("/spa", static=True)


-def test_staticfiles_none_dir_route(tmpdir):
-    api = responder.API(static_dir=None, static_route=None)
-    session = api.session()
-
-    static_dir = tmpdir.mkdir("static")
-
-    asset = create_asset(static_dir)
-
-    static_route = api.static_route
-
-    # ok
-    r = session.get(f"{static_route}/{asset.basename}")
-    assert r.status_code == api.status_codes.HTTP_404
-
-    # dir listing
-    r = session.get(f"{static_route}")
-    assert r.status_code == api.status_codes.HTTP_404
-
-
 def test_response_html_property(api):
    @api.route("/")
    def view(req, resp):
@@ -904,3 +998,21 @@ def test_empty_req_text(api):
            resp.text = "{}_{}".format(req.state.test2, req.state.test1)

        assert api.requests.get(url("/")).text == "Foo_42"
+
+
+def test_path_matches_route(api):
+    @api.route("/hello")
+    def home(req, resp):
+        resp.text = "hello world!"
+
+    route = api.path_matches_route({"type": "http", "path": "/hello"})
+    assert route.endpoint_name == "home"
+
+    assert not api.path_matches_route({"type": "http", "path": "/foo"})
+
+
+def test_route_without_endpoint(api):
+    # test that a route without endpoint gets a default static response
+    api.add_route("/")
+    route = api.router.routes[0]
+    assert route.endpoint_name == "_static_response"
@@ -1,159 +0,0 @@
-import pytest
-from responder import routes
-
-
-def setup_function(function):
-    routes.Route.incoming_matches.cache_clear()
-
-
-@pytest.mark.parametrize(
-    "route, expected",
-    [
-        pytest.param("/", False, id="home path without params"),
-        pytest.param("/test_path", False, id="sub path without params"),
-        pytest.param("/{test_path}", True, id="path with params"),
-    ],
-)
-def test_parameter(route, expected):
-    r = routes.Route(route, "test_endpoint")
-    assert r.has_parameters is expected
-
-
-def test_url():
-    r = routes.Route("/{my_path}", "test_endpoint")
-    url = r.url(my_path="path")
-    assert url == "/path"
-
-
-def test_equal():
-    r = routes.Route("/{path_param}", "test_endpoint")
-    r2 = routes.Route("/{path_param}", "test_endpoint")
-    r3 = routes.Route("/test_path", "test_endpoint")
-
-    assert r == r2
-    assert r != r3
-
-
-def test_incoming_matches():
-    # Test Route with one param
-    r = routes.Route("/{greetings}", "test_endpoint")
-    assert r.incoming_matches("/hello") == {"greetings": "hello"}
-    assert r.incoming_matches("/foo") == {"greetings": "foo"}
-
-    # Test Route with two params
-    r = routes.Route("/{greetings}/{name}", "test_endpoint")
-    assert r.incoming_matches("/hi/john") == {"greetings": "hi", "name": "john"}
-    assert r.incoming_matches("/hello/jane") == {"greetings": "hello", "name": "jane"}
-
-    # Test Route with no param
-    r = routes.Route("/hello", "test_endpoint")
-    assert r.incoming_matches("/hello") == {}
-    assert r.incoming_matches("/bye") == {}
-
-
-def test_incoming_matches_cache():
-    r = routes.Route("/hello", "test_endpoint")
-    r.incoming_matches("/hello")
-    assert r.incoming_matches.cache_info().hits == 0
-    r.incoming_matches("/hello")
-    assert r.incoming_matches.cache_info().hits == 1
-
-
-def test_incoming_matches_with_concrete_path_no_match():
-    r = routes.Route("/concrete_path", "test_endpoint")
-    assert r.incoming_matches("hello") == {}
-
-
-@pytest.mark.parametrize(
-    "route, match, expected",
-    [
-        pytest.param(
-            "/{path_param}",
-            "/{path_param}",
-            True,
-            id="with both parametrized path match",
-        ),
-        pytest.param(
-            "/concrete", "/concrete", True, id="with both concrete path match"
-        ),
-        pytest.param("/concrete", "/no_match", False, id="with no match"),
-    ],
-)
-def test_does_match_with_route(route, match, expected):
-    r = routes.Route(route, "test_endpoint")
-    assert r.does_match(match) == expected
-
-
-@pytest.mark.parametrize(
-    "path_param, expected_weight",
-    [
-        pytest.param("/{greetings}", (True, True, -1), id="with one param"),
-        pytest.param(
-            "/{greetings}.{name}",
-            (True, True, -2),
-            id="with 2 params and dot in the middle",
-        ),
-        pytest.param(
-            "/{greetings}/{name}", (True, True, -2), id="with 2 params and subpath"
-        ),
-        pytest.param(
-            "/{greetings}/{name}/{hello}",
-            (True, True, -3),
-            id="with 3 params and subpath",
-        ),
-        pytest.param(
-            "/{greetings}_{name}", (True, True, -2), id="with 2 params and underscore"
-        ),
-        pytest.param("/{greetings}/test", (True, False, -1), id="with one param"),
-        pytest.param(
-            "/{greetings}.{name}/test",
-            (True, False, -2),
-            id="with 2 params and dot in the middle",
-        ),
-        pytest.param(
-            "/{greetings}/{name}/test",
-            (True, False, -2),
-            id="with 2 params and subpath",
-        ),
-        pytest.param(
-            "/{greetings}/{name}/{hello}/test",
-            (True, False, -3),
-            id="with 3 params and subpath",
-        ),
-        pytest.param(
-            "/{greetings}_{name}/test",
-            (True, False, -2),
-            id="with 2 params and underscore",
-        ),
-        pytest.param("/hello", (False, False, 0), id="without params"),
-    ],
-)
-def test_weight(path_param, expected_weight):
-    r = routes.Route(path_param, "test_endpoint")
-    assert r._weight() == expected_weight
-
-
-@pytest.mark.parametrize(
-    "route, path, expected_result",
-    [
-        pytest.param("/{greetings:str}", "/hello", {"greetings": "hello"}),
-        pytest.param(
-            "/{greetings:str}/{who}",
-            "/hello/Laidia",
-            {"greetings": "hello", "who": "Laidia"},
-        ),
-        pytest.param("/{birth_date:int}", "/1937", {"birth_date": 1937}),
-        pytest.param(
-            "/{name:str}/{age:int}", "/Fatna/80", {"name": "Fatna", "age": 80}
-        ),
-        pytest.param(
-            "/{x:float}/{y:float}", "/10.20/75", {"x": float(10.20), "y": float(75)}
-        ),
-        pytest.param("/{name:str}/{age:int}", "/Fatna/eighty", {}),
-        pytest.param("/{greetings:int}", "/hello", {}),
-        pytest.param("/{name:float}", "/Fatna", {}),
-    ],
-)
-def test_custom_specifiers(route, path, expected_result):
-    r = routes.Route(route, "test_endpoint")
-    assert r.incoming_matches(path) == expected_result
Author	SHA1	Message	Date
taoufik07	f1b2f46a10	v2.0.6	2021-01-06 09:02:42 +01:00
Taoufik	a0913e3f63	Merge pull request #447 from timgates42/bugfix_typo_marshmallow docs: fix simple typo, mashmallow -> marshmallow	2020-12-24 08:44:43 +01:00
Tim Gates	f90955a9b9	docs: fix simple typo, mashmallow -> marshmallow There is a small typo in responder/ext/schema/__init__.py. Should read `marshmallow` rather than `mashmallow`.	2020-12-24 13:27:01 +11:00
Taoufik	3736c9229d	Merge pull request #429 from taoufik07/dependabot/pip/docs/bleach-3.1.4 Bump bleach from 3.1.1 to 3.1.4 in /docs	2020-12-02 09:44:55 +01:00
dependabot[bot]	a802853367	Bump bleach from 3.1.1 to 3.1.4 in /docs Bumps [bleach](https://github.com/mozilla/bleach) from 3.1.1 to 3.1.4. - [Release notes](https://github.com/mozilla/bleach/releases) - [Changelog](https://github.com/mozilla/bleach/blob/master/CHANGES) - [Commits](https://github.com/mozilla/bleach/compare/v3.1.1...v3.1.4) Signed-off-by: dependabot[bot] <support@github.com>	2020-12-01 23:11:49 +00:00
Taoufik	96ca88fe88	Merge pull request #446 from taoufik07/github_actions Switch to github actions	2020-12-02 00:11:05 +01:00
taoufik07	a57570210a	Add prettier to pre-commit	2020-12-01 23:36:42 +01:00
taoufik07	7682e94b35	Disable tests in CI for windows	2020-12-01 23:10:24 +01:00
taoufik07	8bbebe113c	Bump black	2020-12-01 23:10:24 +01:00
taoufik07	7c921f827b	Switch to github actions	2020-12-01 23:10:24 +01:00
taoufik07	4cc055f93a	Add pre-commit	2020-12-01 23:10:21 +01:00
Taoufik	e596a8b457	Merge pull request #444 from majiang/patch-1 Call user-provided `default_response`	2020-12-01 21:42:13 +01:00
Taoufik	fd2da55880	Merge pull request #445 from majiang/patch-2 test_redirects: access '/2' and redirect to '/1'	2020-12-01 21:37:28 +01:00
majiang	975e9b5643	test_redirects: access '/2' and redirect to '/1'	2020-12-01 16:18:56 +09:00
majiang	c0036e0474	Call user-provided `default_response` I'm not 100% sure, but it seems that user-provided `default_response`, stored as `Router.default_endpoint`, should be called when no match was found.	2020-12-01 16:15:57 +09:00
Taoufik	103816e27a	Merge pull request #439 from ryuuji/master bump uvicorn 0.11.* to 0.11.7	2020-08-12 11:01:13 +02:00
Ryuuji Yoshimoto	b7c1684ab4	bump 0.11.7	2020-08-11 18:57:35 +09:00
Ryuuji Yoshimoto	16bd6ca266	bump uvicorn	2020-08-11 18:53:59 +09:00
Taoufik	20bae4712b	Merge pull request #430 from ucpr/fix-lock Fix hash in pygment from piwheel to pypi.	2020-04-17 05:40:29 +02:00
ucpr	a7aa80c690	Fix hash in pygment from piwheel to pypi.	2020-04-15 00:30:34 +09:00
Taoufik	df89d1d58b	Merge pull request #424 from taoufik07/starlette_0_13 Fixes and bump dependencies	2020-03-09 05:32:30 +01:00
taoufik07	477cddd29c	travisci add python 3.8	2020-03-09 05:26:48 +01:00
taoufik07	9b8cf3a1b1	Bump uvicorn version to 0.11	2020-03-09 05:16:34 +01:00
taoufik07	2871a3c07f	starlette 0.13 and fix lifespan	2020-03-09 05:13:12 +01:00
Taoufik	13763296dd	Merge pull request #421 from taoufik07/dependabot/pip/docs/bleach-3.1.1 Bump bleach from 3.0.2 to 3.1.1 in /docs	2020-02-25 02:24:11 +01:00
dependabot[bot]	783b22ab1c	Bump bleach from 3.0.2 to 3.1.1 in /docs Bumps [bleach](https://github.com/mozilla/bleach) from 3.0.2 to 3.1.1. - [Release notes](https://github.com/mozilla/bleach/releases) - [Changelog](https://github.com/mozilla/bleach/blob/master/CHANGES) - [Commits](https://github.com/mozilla/bleach/compare/v3.0.2...v3.1.1) Signed-off-by: dependabot[bot] <support@github.com>	2020-02-24 18:31:05 +00:00
Taoufik	109937adf4	Merge pull request #414 from taoufik07/v2.0.5 v2.0.5	2019-12-15 16:38:02 +01:00
taoufik	63ea9cc4e0	v2.0.5	2019-12-15 16:32:47 +01:00
Taoufik	ec40a0c4c3	Merge pull request #413 from taoufik07/support_python3.8 Update requirements to support python3.8	2019-12-15 16:28:17 +01:00
taoufik	0855d1a378	Update requirements to support python3.8	2019-12-15 16:22:26 +01:00
Taoufik	77fe17d350	Merge pull request #411 from StevenAvelino24/feature/use-openapi-params Use OpenAPI info params on init of API	2019-12-04 20:07:46 +01:00
Steven Avelino	0b8a031ccb	Use openapi info params on init of API	2019-12-04 14:50:30 +01:00
taoufik	0678daa880	Bump to v2.0.4	2019-11-19 17:35:16 +01:00
Taoufik	6761e3bdd8	Merge pull request #406 from daphil19/master fix issues related to using `static=true` in `api.add_route()` and `static_route` in `responder.API()`	2019-11-19 17:30:22 +01:00
David Phillips	ead213a506	responder now checks routes added via `add_route` before mounted routes routes added by `add_route` (including @api.route()) are now checked before routes that were added by api.mount() this especially helps cases for situations where the static route defined by the API class is '/' but the default route is '/' as well	2019-11-02 13:57:39 -04:00
David Phillips	75b5782eee	fix static_response endpoint to return index.html contents	2019-11-02 13:55:34 -04:00
Taoufik	a80df809e4	Merge pull request #399 from vbarbaresi/fix_render_async Async templates require enable_async in jinja2 Environment	2019-10-25 22:19:04 +01:00
taoufik	7f3177f662	v2.0.3	2019-10-22 10:41:34 +01:00
taoufik	906cd2fbbf	Fix templates conflicts	2019-10-20 12:48:02 +01:00
taoufik	9d0129da56	Fix templates conflicts	2019-10-20 12:39:32 +01:00
taoufik	aedcf12d99	v2.0.1	2019-10-20 12:20:54 +01:00
Vincent Barbaresi	86361523e2	fix async templates rendering requiring enable_async in jinja2 When trying to test the render_async() feature I realized that it wasn't working The template instance needs to be created with enable_async=True	2019-10-19 14:49:50 +02:00
Taoufik	a7110ef441	Merge pull request #395 from vbarbaresi/master add a few tests for API and remove some dead code	2019-10-19 13:06:01 +01:00
Vincent Barbaresi	d3e4968546	add a few tests for API and remove some dead code Increasing the coverage of api.py to 86% - use pytest.parametrize to test cors and hsts parameters usage - use pytest.parametrize to factorize test_staticfiles_custom_route - add tests for path_matches_route and Route() with no endpoint - test Jinja template rendering from a file - remove _notfound_wsgi_app, before_ws_requests, before_http_requests they didn't seem used anywhere and the before_* method were broken, referring to self.before_requests that doesn't exist anymore	2019-10-19 13:47:39 +02:00
Taoufik	03e34d56ab	Merge pull request #398 from taoufik07/v2 v2.0.0	2019-10-19 12:22:32 +01:00
taoufik	b470d10416	v2.0.0	2019-10-19 12:21:06 +01:00
Taoufik	b8aea89039	Merge pull request #397 from taoufik07/update_pipfile Bump versions	2019-10-19 12:13:06 +01:00
taoufik	4a1e89af1b	Bump versions	2019-10-19 12:07:31 +01:00
Taoufik	81fbc94d36	Merge pull request #396 from vbarbaresi/fix_3.8_tests upgrade pluggy to 0.13.0 to support importlib.metadata on python 3.8	2019-10-03 17:24:53 +01:00
Vincent Barbaresi	6487671559	upgrade pluggy to 0.13.0 to support stb lib importlib.metadata on python 3.8	2019-10-03 18:15:09 +02:00
Taoufik	838c7f29b5	Update docs url	2019-09-26 12:07:59 +01:00
Taoufik	df85a4c214	Merge pull request #388 from taoufik07/new-router New Router and refactor	2019-09-03 20:13:46 +02:00
taoufik	1bdbea238e	Add a api.static_app and extend starlette's StaticFiles app	2019-08-31 01:38:00 +02:00
Taoufik	97dbef92d9	Bump werkzug version to 0.15.5 in docs	2019-08-21 23:05:27 +02:00
taoufik	85c1c0036c	[WIP] Update docs	2019-08-21 22:50:58 +02:00
taoufik	0653ee2c6b	Add Templates	2019-08-21 13:46:31 +02:00
taoufik	d1db913c7d	Bump dependencies	2019-08-17 22:15:43 +02:00
taoufik	d24b921cdc	Move open api schema to ext/schema	2019-08-17 18:25:19 +02:00
taoufik	b31b742787	Implement a new Router and other changes - Router - Use starlette's Session middlewre - Add Exception Middleware - ...	2019-08-17 14:41:11 +02:00