Release 21.9.3 (#2318)

* Allow non-conforming ErrorHandlers (#2259)

* Allow non-conforming ErrorHandlers

* Rename to legacy lookup

* Updated depnotice

* Bump version

* Fix formatting

* Remove unused import

* Fix error messages

* Add error format commit and merge conflicts

* Make HTTP connections start in IDLE stage, avoiding delays and error messages (#2268)

* Make all new connections start in IDLE stage, and switch to REQUEST stage only once any bytes are received from client. This makes new connections without any request obey keepalive timeout rather than request timeout like they currently do.

* Revert typo

* Remove request timeout endpoint test which is no longer working (still tested by mocking). Fix mock timeout test setup.

Co-authored-by: L. Karkkainen <tronic@users.noreply.github.com>

* Bump version

* Add error format from config replacement objects

* Cleanup mistaken print statement

* Cleanup reversions

* Bump version

Co-authored-by: L. Kärkkäinen <98187+Tronic@users.noreply.github.com>
Co-authored-by: L. Karkkainen <tronic@users.noreply.github.com>

.black.toml

@@ -0,0 +1,2 @@
+[tool.black]
+line-length = 79

.codeclimate.yml

@@ -0,0 +1,24 @@
+exclude_patterns:
+  - "sanic/__main__.py"
+  - "sanic/reloader_helpers.py"
+  - "sanic/simple.py"
+  - "sanic/utils.py"
+  - ".github/"
+  - "changelogs/"
+  - "docker/"
+  - "docs/"
+  - "examples/"
+  - "hack/"
+  - "scripts/"
+  - "tests/"
+checks:
+  argument-count:
+    enabled: false
+  file-lines:
+    config:
+      threshold: 1000
+  method-count:
+    config:
+      threshold: 40
+  complex-logic:
+    enabled: false

.coveragerc

@@ -4,12 +4,9 @@ source = sanic
 omit =
     site-packages
     sanic/__main__.py
-    sanic/server/legacy.py
-    sanic/compat.py
+    sanic/reloader_helpers.py
     sanic/simple.py
     sanic/utils.py
-    sanic/cli
-    sanic/pages
 
 [html]
 directory = coverage
@@ -21,5 +18,3 @@ exclude_lines =
     noqa
     NOQA
     pragma: no cover
-    TYPE_CHECKING
-skip_empty = True

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -1,66 +0,0 @@
-name: 🐞 Bug report
-description: Create a report to help us improve
-labels: ["bug", "triage"]
-body:
-  - type: checkboxes
-    id: existing
-    attributes:
-      label: Is there an existing issue for this?
-      description: Please search to see if an issue already exists for the bug you encountered.
-      options:
-      - label: I have searched the existing issues
-        required: true
-  - type: textarea
-    id: description
-    attributes:
-      label: Describe the bug
-      description: A clear and concise description of what the bug is, make sure to paste any exceptions and tracebacks using markdown code-block syntax to make it easier to read.
-    validations:
-      required: true
-  - type: textarea
-    id: code
-    attributes:
-      label: Code snippet
-      description: Relevant source code, make sure to remove what is not necessary.
-    validations:
-      required: false
-  - type: textarea
-    id: expected
-    attributes:
-      label: Expected Behavior
-      description: A concise description of what you expected to happen.
-    validations:
-      required: false
-  - type: dropdown
-    id: running
-    attributes:
-      label: How do you run Sanic?
-      options:
-        - Sanic CLI
-        - As a module
-        - As a script (`app.run` or `Sanic.serve`)
-        - ASGI
-    validations:
-      required: true
-  - type: input
-    id: os
-    attributes:
-      label: Operating System
-      description: What OS?
-    validations:
-      required: true
-  - type: input
-    id: version
-    attributes:
-      label: Sanic Version
-      description: Check startup logs or try `sanic --version`
-    validations:
-      required: true
-  - type: textarea
-    id: additional
-    attributes:
-      label: Additional context
-      description: Add any other context about the problem here.
-    validations:
-      required: false
-

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,25 @@
+---
+name: Bug report
+about: Create a report to help us improve
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is, make sure to paste any exceptions and tracebacks.
+
+
+**Code snippet**
+Relevant source code, make sure to remove what is not necessary.
+
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+
+**Environment (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Version [e.g. 0.8.3]
+
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/config.yml

@@ -1,8 +1,5 @@
-blank_issues_enabled: false
+blank_issues_enabled: true
 contact_links:
   - name: Questions and Help
     url: https://community.sanicframework.org/c/questions-and-help
     about: Do you need help with Sanic? Ask your questions here.
-  - name: Discussion and Support
-    url: https://discord.gg/FARQzAEMAA
-    about: For live discussion and support, checkout the Sanic Discord server.

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -1,34 +0,0 @@
-name: 🌟 Feature request
-description: Suggest an enhancement for Sanic
-labels: ["feature request"]
-body:
-  - type: checkboxes
-    id: existing
-    attributes:
-      label: Is there an existing issue for this?
-      description: Please search to see if an issue already exists for the enhancement you are proposing.
-      options:
-      - label: I have searched the existing issues
-        required: true
-  - type: textarea
-    id: description
-    attributes:
-      label: Is your feature request related to a problem? Please describe.
-      description: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-    validations:
-      required: false
-  - type: textarea
-    id: code
-    attributes:
-      label: Describe the solution you'd like
-      description: A clear and concise description of what you want to happen.
-    validations:
-      required: true
-  - type: textarea
-    id: additional
-    attributes:
-      label: Additional context
-      description: Add any other context about the problem here.
-    validations:
-      required: false
-

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,16 @@
+---
+name: Feature request
+about: Suggest an idea for Sanic
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+
+**Additional context**
+Add any other context or sample code about the feature request here.

.github/workflows/codeql-analysis.yml

@@ -2,20 +2,14 @@ name: "CodeQL"
 
 on:
   push:
-    branches:
-      - main
-      - "*LTS"
+    branches: [ main ]
   pull_request:
-    branches:
-      - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
+    branches: [ main ]
   schedule:
     - cron: '25 16 * * 0'
 
 jobs:
   analyze:
-    if: github.event.pull_request.draft == false
     name: Analyze
     runs-on: ubuntu-latest
 

.github/workflows/coverage.yml

@@ -1,15 +1,17 @@
 name: Coverage check
-on:
-  push:
-    branches:
-      - main
-      - "*LTS"
-    tags:
-      - "!*" # Do not execute on tags
-  pull_request:
-    branches:
-      - main
-      - "*LTS"
+# on:
+#   push:
+#     branches:
+#       - main
+#     tags:
+#       - "!*" # Do not execute on tags
+#     paths:
+#       - sanic/*
+#       - tests/*
+#   pull_request:
+#     paths:
+#       - "!*.MD"
+on: [push, pull_request]
 jobs:
   test:
     runs-on: ${{ matrix.os }}
@@ -21,6 +23,7 @@ jobs:
 
     steps:
       - uses: actions/checkout@v2
+
       - uses: actions/setup-python@v1
         with:
           python-version: ${{ matrix.python-version }}
@@ -29,10 +32,9 @@ jobs:
         run: |
           python -m pip install --upgrade pip
           pip install tox
-      - name: Run coverage
-        run: tox -e coverage
-        continue-on-error: true
-      - uses: codecov/codecov-action@v2
+      - uses: paambaati/codeclimate-action@v2.5.3
+        if: always()
+        env:
+          CC_TEST_REPORTER_ID: ${{ secrets.CODECLIMATE }}
         with:
-          files: ./coverage.xml
-          fail_ci_if_error: false
+          coverageCommand: tox -e coverage

.github/workflows/pr-bandit.yml

@@ -3,12 +3,9 @@ on:
   pull_request:
     branches:
       - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
 
 jobs:
   bandit:
-    if: github.event.pull_request.draft == false
     name: type-check-${{ matrix.config.python-version }}
     runs-on: ${{ matrix.os }}
     strategy:
@@ -19,8 +16,6 @@ jobs:
           - { python-version: 3.7, tox-env: security}
           - { python-version: 3.8, tox-env: security}
           - { python-version: 3.9, tox-env: security}
-          - { python-version: "3.10", tox-env: security}
-          - { python-version: "3.11", tox-env: security}
     steps:
       - name: Checkout the repository
         uses: actions/checkout@v2

.github/workflows/pr-docs.yml

@@ -3,18 +3,15 @@ on:
   pull_request:
     branches:
       - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
 
 jobs:
   docsLinter:
-    if: github.event.pull_request.draft == false
     name: Lint Documentation
     runs-on: ubuntu-latest
     strategy:
       matrix:
         config:
-          - {python-version: "3.10", tox-env: "docs"}
+          - {python-version: "3.8", tox-env: "docs"}
       fail-fast: false
 
 

.github/workflows/pr-linter.yml

@@ -3,12 +3,9 @@ on:
   pull_request:
     branches:
       - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
 
 jobs:
   linter:
-    if: github.event.pull_request.draft == false
     name: lint
     runs-on: ${{ matrix.os }}
     strategy:
@@ -16,7 +13,7 @@ jobs:
       matrix:
         os: [ubuntu-latest]
         config:
-          - { python-version: "3.10", tox-env: lint}
+          - { python-version: 3.8, tox-env: lint}
     steps:
       - name: Checkout the repository
         uses: actions/checkout@v2

.github/workflows/pr-python310.yml

@@ -1,47 +0,0 @@
-name: Python 3.10 Tests
-on:
-  pull_request:
-    branches:
-      - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
-
-jobs:
-  testPy310:
-    if: github.event.pull_request.draft == false
-    name: ut-${{ matrix.config.tox-env }}-${{ matrix.os }}
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        # os: [ubuntu-latest, macos-latest]
-        os: [ubuntu-latest]
-        config:
-          - {
-              python-version: "3.10",
-              tox-env: py310,
-              ignore-error-flake: "false",
-              command-timeout: "0",
-            }
-          - {
-              python-version: "3.10",
-              tox-env: py310-no-ext,
-              ignore-error-flake: "true",
-              command-timeout: "600000",
-            }
-    steps:
-      - name: Checkout the Repository
-        uses: actions/checkout@v2
-        id: checkout-branch
-
-      - name: Run Unit Tests
-        uses: harshanarayana/custom-actions@main
-        with:
-          python-version: ${{ matrix.config.python-version }}
-          test-infra-tool: tox
-          test-infra-version: latest
-          action: tests
-          test-additional-args: "-e=${{ matrix.config.tox-env }},-vv=''"
-          experimental-ignore-error: "${{ matrix.config.ignore-error-flake }}"
-          command-timeout: "${{ matrix.config.command-timeout }}"
-          test-failure-retry: "3"

.github/workflows/pr-python311.yml

@@ -1,47 +0,0 @@
-name: Python 3.11 Tests
-on:
-  pull_request:
-    branches:
-      - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
-
-jobs:
-  testPy311:
-    if: github.event.pull_request.draft == false
-    name: ut-${{ matrix.config.tox-env }}-${{ matrix.os }}
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        # os: [ubuntu-latest, macos-latest]
-        os: [ubuntu-latest]
-        config:
-          - {
-              python-version: "3.11",
-              tox-env: py311,
-              ignore-error-flake: "false",
-              command-timeout: "0",
-            }
-          - {
-              python-version: "3.11",
-              tox-env: py311-no-ext,
-              ignore-error-flake: "true",
-              command-timeout: "600000",
-            }
-    steps:
-      - name: Checkout the Repository
-        uses: actions/checkout@v2
-        id: checkout-branch
-
-      - name: Run Unit Tests
-        uses: harshanarayana/custom-actions@main
-        with:
-          python-version: ${{ matrix.config.python-version }}
-          test-infra-tool: tox
-          test-infra-version: latest
-          action: tests
-          test-additional-args: "-e=${{ matrix.config.tox-env }},-vv=''"
-          experimental-ignore-error: "${{ matrix.config.ignore-error-flake }}"
-          command-timeout: "${{ matrix.config.command-timeout }}"
-          test-failure-retry: "3"

.github/workflows/pr-python37.yml

@@ -3,16 +3,19 @@ on:
   pull_request:
     branches:
       - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches:
+      - main
+    paths:
+      - sanic/*
+      - tests/*
 
 jobs:
   testPy37:
-    if: github.event.pull_request.draft == false
     name: ut-${{ matrix.config.tox-env }}-${{ matrix.os }}
     runs-on: ${{ matrix.os }}
     strategy:
-      fail-fast: true
+      fail-fast: false
       matrix:
         #         os: [ubuntu-latest, macos-latest]
         os: [ubuntu-latest]

.github/workflows/pr-python38.yml

@@ -3,16 +3,19 @@ on:
   pull_request:
     branches:
       - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches:
+      - main
+    paths:
+      - sanic/*
+      - tests/*
 
 jobs:
   testPy38:
-    if: github.event.pull_request.draft == false
     name: ut-${{ matrix.config.tox-env }}-${{ matrix.os }}
     runs-on: ${{ matrix.os }}
     strategy:
-      fail-fast: true
+      fail-fast: false
       matrix:
         # os: [ubuntu-latest, macos-latest]
         os: [ubuntu-latest]

.github/workflows/pr-python39.yml

@@ -3,16 +3,19 @@ on:
   pull_request:
     branches:
       - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
+  push:
+    branches:
+      - main
+    paths:
+      - sanic/*
+      - tests/*
 
 jobs:
   testPy39:
-    if: github.event.pull_request.draft == false
     name: ut-${{ matrix.config.tox-env }}-${{ matrix.os }}
     runs-on: ${{ matrix.os }}
     strategy:
-      fail-fast: true
+      fail-fast: false
       matrix:
         # os: [ubuntu-latest, macos-latest]
         os: [ubuntu-latest]

.github/workflows/pr-type-check.yml

@@ -3,12 +3,9 @@ on:
   pull_request:
     branches:
       - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
 
 jobs:
   typeChecking:
-    if: github.event.pull_request.draft == false
     name: type-check-${{ matrix.config.python-version }}
     runs-on: ${{ matrix.os }}
     strategy:
@@ -16,11 +13,9 @@ jobs:
       matrix:
         os: [ubuntu-latest]
         config:
-          # - { python-version: 3.7, tox-env: type-checking}
+          - { python-version: 3.7, tox-env: type-checking}
           - { python-version: 3.8, tox-env: type-checking}
           - { python-version: 3.9, tox-env: type-checking}
-          - { python-version: "3.10", tox-env: type-checking}
-          - { python-version: "3.11", tox-env: type-checking}
     steps:
       - name: Checkout the repository
         uses: actions/checkout@v2

.github/workflows/pr-windows.yml

@@ -3,12 +3,9 @@ on:
   pull_request:
     branches:
       - main
-      - "*LTS"
-    types: [opened, synchronize, reopened, ready_for_review]
 
 jobs:
   testsOnWindows:
-    if: github.event.pull_request.draft == false
     name: ut-${{ matrix.config.tox-env }}
     runs-on: windows-latest
     strategy:
@@ -18,8 +15,6 @@ jobs:
           - { python-version: 3.7, tox-env: py37-no-ext }
           - { python-version: 3.8, tox-env: py38-no-ext }
           - { python-version: 3.9, tox-env: py39-no-ext }
-          - { python-version: "3.10", tox-env: py310-no-ext }
-          - { python-version: "3.11", tox-env: py310-no-ext }
           - { python-version: pypy-3.7, tox-env: pypy37-no-ext }
 
     steps:

.github/workflows/publish-images.yml

@@ -14,7 +14,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.7", "3.8", "3.9"]
 
     steps:
       - name: Checkout repository

.github/workflows/publish-package.yml

@@ -11,7 +11,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        python-version: ["3.10"]
+        python-version: ["3.8"]
 
     steps:
       - name: Checkout Repository

CHANGELOG.rst

@@ -1,12 +1,12 @@
 .. note::
 
-  CHANGELOG files are maintained in ``./docs/sanic/releases``. To view the full CHANGELOG, please visit https://sanic.readthedocs.io/en/stable/sanic/changelog.html.
-
+  From v21.9, CHANGELOG files are maintained in ``./docs/sanic/releases``
 
 Version 21.6.1
 --------------
 
-**Bugfixes**
+Bugfixes
+********
 
   * `#2178 <https://github.com/sanic-org/sanic/pull/2178>`_
     Update sanic-routing to allow for better splitting of complex URI templates
@@ -20,7 +20,8 @@ Version 21.6.1
 Version 21.6.0
 --------------
 
-**Features**
+Features
+********
 
   * `#2094 <https://github.com/sanic-org/sanic/pull/2094>`_
     Add ``response.eof()`` method for closing a stream in a handler
@@ -67,7 +68,8 @@ Version 21.6.0
   * `#2170 <https://github.com/sanic-org/sanic/pull/2170>`_
     Additional methods for attaching ``HTTPMethodView``
 
-**Bugfixes**
+Bugfixes
+********
 
   * `#2091 <https://github.com/sanic-org/sanic/pull/2091>`_
     Fix ``UserWarning`` in ASGI mode for missing ``__slots__``
@@ -83,7 +85,8 @@ Version 21.6.0
     Fix issue where Blueprint exception handlers do not consistently route to proper handler
 
 
-**Deprecations and Removals**
+Deprecations and Removals
+*************************
 
   * `#2156 <https://github.com/sanic-org/sanic/pull/2156>`_
     Remove config value ``REQUEST_BUFFER_QUEUE_SIZE``
@@ -92,12 +95,14 @@ Version 21.6.0
   * `#2172 <https://github.com/sanic-org/sanic/pull/2170>`_
     Deprecate StreamingHTTPResponse
 
-**Developer infrastructure**
+Developer infrastructure
+************************
 
   * `#2149 <https://github.com/sanic-org/sanic/pull/2149>`_
     Remove Travis CI in favor of GitHub Actions
 
-**Improved Documentation**
+Improved Documentation
+**********************
 
   * `#2164 <https://github.com/sanic-org/sanic/pull/2164>`_
     Fix typo in documentation
@@ -107,7 +112,8 @@ Version 21.6.0
 Version 21.3.2
 --------------
 
-**Bugfixes**
+Bugfixes
+********
 
   * `#2081 <https://github.com/sanic-org/sanic/pull/2081>`_
     Disable response timeout on websocket connections
@@ -118,7 +124,8 @@ Version 21.3.2
 Version 21.3.1
 --------------
 
-**Bugfixes**
+Bugfixes
+********
 
   * `#2076 <https://github.com/sanic-org/sanic/pull/2076>`_
     Static files inside subfolders are not accessible (404)
@@ -128,7 +135,8 @@ Version 21.3.0
 
 `Release Notes <https://sanicframework.org/en/guide/release-notes/v21.3.html>`_
 
-**Features**
+Features
+********
 
   *
     `#1876 <https://github.com/sanic-org/sanic/pull/1876>`_
@@ -181,7 +189,8 @@ Version 21.3.0
     `#2063 <https://github.com/sanic-org/sanic/pull/2063>`_
     App and connection level context objects
 
-**Bugfixes**
+Bugfixes and issues resolved
+****************************
 
   * Resolve `#1420 <https://github.com/sanic-org/sanic/pull/1420>`_
     ``url_for`` where ``strict_slashes`` are on for a path ending in ``/``
@@ -211,7 +220,8 @@ Version 21.3.0
     `#2001 <https://github.com/sanic-org/sanic/pull/2001>`_
     Raise ValueError when cookie max-age is not an integer
 
-**Deprecations and Removals**
+Deprecations and Removals
+*************************
 
   *
     `#2007 <https://github.com/sanic-org/sanic/pull/2007>`_
@@ -230,7 +240,8 @@ Version 21.3.0
   * ``Request.endpoint`` deprecated in favor of ``Request.name``
   * handler type name prefixes removed (static, websocket, etc)
 
-**Developer infrastructure**
+Developer infrastructure
+************************
 
   *
     `#1995 <https://github.com/sanic-org/sanic/pull/1995>`_
@@ -248,7 +259,8 @@ Version 21.3.0
     `#2049 <https://github.com/sanic-org/sanic/pull/2049>`_
     Updated setup.py to use ``find_packages``
 
-**Improved Documentation**
+Improved Documentation
+**********************
 
   *
     `#1218 <https://github.com/sanic-org/sanic/pull/1218>`_
@@ -270,7 +282,8 @@ Version 21.3.0
     `#2052 <https://github.com/sanic-org/sanic/pull/2052>`_
     Fix some examples and docs
 
-**Miscellaneous**
+Miscellaneous
+*************
 
   * ``Request.route`` property
   * Better websocket subprotocols support
@@ -316,9 +329,8 @@ Version 21.3.0
 Version 20.12.3
 ---------------
 
-`Current LTS version`
-
-**Bugfixes**
+Bugfixes
+********
 
   *
     `#2021 <https://github.com/sanic-org/sanic/pull/2021>`_
@@ -327,7 +339,8 @@ Version 20.12.3
 Version 20.12.2
 ---------------
 
-**Dependencies**
+Dependencies
+************
 
   *
     `#2026 <https://github.com/sanic-org/sanic/pull/2026>`_
@@ -340,7 +353,8 @@ Version 20.12.2
 Version 19.12.5
 ---------------
 
-**Dependencies**
+Dependencies
+************
 
   *
     `#2025 <https://github.com/sanic-org/sanic/pull/2025>`_
@@ -353,12 +367,19 @@ Version 19.12.5
 Version 20.12.0
 ---------------
 
-**Features**
+Features
+********
 
   *
     `#1993 <https://github.com/sanic-org/sanic/pull/1993>`_
     Add disable app registry
 
+Version 20.12.0
+---------------
+
+Features
+********
+
   *
     `#1945 <https://github.com/sanic-org/sanic/pull/1945>`_
     Static route more verbose if file not found
@@ -395,19 +416,22 @@ Version 20.12.0
     `#1979 <https://github.com/sanic-org/sanic/pull/1979>`_
     Add app registry and Sanic class level app retrieval
 
-**Bugfixes**
+Bugfixes
+********
 
   *
     `#1965 <https://github.com/sanic-org/sanic/pull/1965>`_
     Fix Chunked Transport-Encoding in ASGI streaming response
 
-**Deprecations and Removals**
+Deprecations and Removals
+*************************
 
   *
     `#1981 <https://github.com/sanic-org/sanic/pull/1981>`_
     Cleanup and remove deprecated code
 
-**Developer infrastructure**
+Developer infrastructure
+************************
 
   *
     `#1956 <https://github.com/sanic-org/sanic/pull/1956>`_
@@ -421,7 +445,8 @@ Version 20.12.0
     `#1986 <https://github.com/sanic-org/sanic/pull/1986>`_
     Update tox requirements
 
-**Improved Documentation**
+Improved Documentation
+**********************
 
   *
     `#1951 <https://github.com/sanic-org/sanic/pull/1951>`_
@@ -439,7 +464,8 @@ Version 20.12.0
 Version 20.9.1
 ---------------
 
-**Bugfixes**
+Bugfixes
+********
 
   *
     `#1954 <https://github.com/sanic-org/sanic/pull/1954>`_
@@ -452,7 +478,8 @@ Version 20.9.1
 Version 19.12.3
 ---------------
 
-**Bugfixes**
+Bugfixes
+********
 
   *
     `#1959 <https://github.com/sanic-org/sanic/pull/1959>`_
@@ -463,7 +490,8 @@ Version 20.9.0
 ---------------
 
 
-**Features**
+Features
+********
 
   *
     `#1887 <https://github.com/sanic-org/sanic/pull/1887>`_
@@ -490,19 +518,22 @@ Version 20.9.0
     `#1937 <https://github.com/sanic-org/sanic/pull/1937>`_
     Added auto, text, and json fallback error handlers (in v21.3, the default will change form html to auto)
 
-**Bugfixes**
+Bugfixes
+********
 
   *
     `#1897 <https://github.com/sanic-org/sanic/pull/1897>`_
     Resolves exception from unread bytes in stream
 
-**Deprecations and Removals**
+Deprecations and Removals
+*************************
 
   *
     `#1903 <https://github.com/sanic-org/sanic/pull/1903>`_
     config.from_envar, config.from_pyfile, and config.from_object are deprecated and set to be removed in v21.3
 
-**Developer infrastructure**
+Developer infrastructure
+************************
 
   *
     `#1890 <https://github.com/sanic-org/sanic/pull/1890>`_,
@@ -517,7 +548,8 @@ Version 20.9.0
     `#1924 <https://github.com/sanic-org/sanic/pull/1924>`_
     Adding --strict-markers for pytest
 
-**Improved Documentation**
+Improved Documentation
+**********************
 
   *
     `#1922 <https://github.com/sanic-org/sanic/pull/1922>`_
@@ -527,7 +559,8 @@ Version 20.9.0
 Version 20.6.3
 ---------------
 
-**Bugfixes**
+Bugfixes
+********
 
   *
     `#1884 <https://github.com/sanic-org/sanic/pull/1884>`_
@@ -537,7 +570,8 @@ Version 20.6.3
 Version 20.6.2
 ---------------
 
-**Features**
+Features
+********
 
   *
     `#1641 <https://github.com/sanic-org/sanic/pull/1641>`_
@@ -547,7 +581,8 @@ Version 20.6.2
 Version 20.6.1
 ---------------
 
-**Features**
+Features
+********
 
   *
     `#1760 <https://github.com/sanic-org/sanic/pull/1760>`_
@@ -561,7 +596,8 @@ Version 20.6.1
     `#1880 <https://github.com/sanic-org/sanic/pull/1880>`_
     Add handler names for websockets for url_for usage
 
-**Bugfixes**
+Bugfixes
+********
 
   *
     `#1776 <https://github.com/sanic-org/sanic/pull/1776>`_
@@ -583,13 +619,15 @@ Version 20.6.1
     `#1853 <https://github.com/sanic-org/sanic/pull/1853>`_
     Fix pickle error when attempting to pickle an application which contains websocket routes
 
-**Deprecations and Removals**
+Deprecations and Removals
+*************************
 
   *
     `#1739 <https://github.com/sanic-org/sanic/pull/1739>`_
     Deprecate body_bytes to merge into body
 
-**Developer infrastructure**
+Developer infrastructure
+************************
 
   *
     `#1852 <https://github.com/sanic-org/sanic/pull/1852>`_
@@ -604,7 +642,8 @@ Version 20.6.1
     Wrap run()'s "protocol" type annotation in Optional[]
 
 
-**Improved Documentation**
+Improved Documentation
+**********************
 
   *
     `#1846 <https://github.com/sanic-org/sanic/pull/1846>`_
@@ -618,13 +657,14 @@ Version 20.6.1
 Version 20.6.0
 ---------------
 
-*Released, but unintentionally omitting PR #1880, so was replaced by 20.6.1*
+*Released, but unintentionally ommitting PR #1880, so was replaced by 20.6.1*
 
 
 Version 20.3.0
 ---------------
 
-**Features**
+Features
+********
 
   *
     `#1762 <https://github.com/sanic-org/sanic/pull/1762>`_
@@ -655,7 +695,8 @@ Version 20.3.0
     `#1820 <https://github.com/sanic-org/sanic/pull/1820>`_
     Do not set content-type and content-length headers in exceptions
 
-**Bugfixes**
+Bugfixes
+********
 
   *
     `#1748 <https://github.com/sanic-org/sanic/pull/1748>`_
@@ -673,7 +714,8 @@ Version 20.3.0
     `#1808 <https://github.com/sanic-org/sanic/pull/1808>`_
      Fix Ctrl+C and tests on Windows
 
-**Deprecations and Removals**
+Deprecations and Removals
+*************************
 
   *
     `#1800 <https://github.com/sanic-org/sanic/pull/1800>`_
@@ -691,7 +733,8 @@ Version 20.3.0
     `#1818 <https://github.com/sanic-org/sanic/pull/1818>`_
     Complete deprecation of ``app.remove_route`` and ``request.raw_args``
 
-**Dependencies**
+Dependencies
+************
 
   *
     `#1794 <https://github.com/sanic-org/sanic/pull/1794>`_
@@ -701,13 +744,15 @@ Version 20.3.0
     `#1806 <https://github.com/sanic-org/sanic/pull/1806>`_
     Import ``ASGIDispatch`` from top-level ``httpx`` (from third-party deprecation)
 
-**Developer infrastructure**
+Developer infrastructure
+************************
 
   *
     `#1833 <https://github.com/sanic-org/sanic/pull/1833>`_
     Resolve broken documentation builds
 
-**Improved Documentation**
+Improved Documentation
+**********************
 
   *
     `#1755 <https://github.com/sanic-org/sanic/pull/1755>`_
@@ -749,7 +794,8 @@ Version 20.3.0
 Version 19.12.0
 ---------------
 
-**Bugfixes**
+Bugfixes
+********
 
 - Fix blueprint middleware application
 
@@ -768,7 +814,8 @@ Version 19.12.0
   due to an `AttributeError`. This fix makes the availability of `SERVER_NAME` on our `app.config` an optional behavior. (`#1707 <https://github.com/sanic-org/sanic/issues/1707>`__)
 
 
-**Improved Documentation**
+Improved Documentation
+**********************
 
 - Move docs from MD to RST
 
@@ -782,7 +829,8 @@ Version 19.12.0
 Version 19.6.3
 --------------
 
-**Features**
+Features
+********
 
 - Enable Towncrier Support
 
@@ -790,7 +838,8 @@ Version 19.6.3
   of generating and managing change logs as part of each of pull requests. (`#1631 <https://github.com/sanic-org/sanic/issues/1631>`__)
 
 
-**Improved Documentation**
+Improved Documentation
+**********************
 
 - Documentation infrastructure changes
 
@@ -803,7 +852,8 @@ Version 19.6.3
 Version 19.6.2
 --------------
 
-**Features**
+Features
+********
 
   *
     `#1562 <https://github.com/sanic-org/sanic/pull/1562>`_
@@ -819,7 +869,8 @@ Version 19.6.2
     Add Configure support from object string
 
 
-**Bugfixes**
+Bugfixes
+********
 
   *
     `#1587 <https://github.com/sanic-org/sanic/pull/1587>`_
@@ -837,7 +888,8 @@ Version 19.6.2
     `#1594 <https://github.com/sanic-org/sanic/pull/1594>`_
     Strict Slashes behavior fix
 
-**Deprecations and Removals**
+Deprecations and Removals
+*************************
 
   *
     `#1544 <https://github.com/sanic-org/sanic/pull/1544>`_
@@ -861,7 +913,8 @@ Version 19.6.2
 Version 19.3
 ------------
 
-**Features**
+Features
+********
 
   *
     `#1497 <https://github.com/sanic-org/sanic/pull/1497>`_
@@ -929,7 +982,8 @@ Version 19.3
 
     This is a breaking change.
 
-**Bugfixes**
+Bugfixes
+********
 
 
   *
@@ -965,7 +1019,8 @@ Version 19.3
     This allows the access log to be disabled for example when running via
     gunicorn.
 
-**Developer infrastructure**
+Developer infrastructure
+************************
 
   * `#1529 <https://github.com/sanic-org/sanic/pull/1529>`_ Update project PyPI credentials
   * `#1515 <https://github.com/sanic-org/sanic/pull/1515>`_ fix linter issue causing travis build failures (fix #1514)
@@ -973,7 +1028,8 @@ Version 19.3
   * `#1478 <https://github.com/sanic-org/sanic/pull/1478>`_ Upgrade setuptools version and use native docutils in doc build
   * `#1464 <https://github.com/sanic-org/sanic/pull/1464>`_ Upgrade pytest, and fix caplog unit tests
 
-**Improved Documentation**
+Improved Documentation
+**********************
 
   * `#1516 <https://github.com/sanic-org/sanic/pull/1516>`_ Fix typo at the exception documentation
   * `#1510 <https://github.com/sanic-org/sanic/pull/1510>`_ fix typo in Asyncio example
@@ -1034,19 +1090,21 @@ Version 18.12
   * Fix Range header handling for static files (#1402)
   * Fix the logger and make it work (#1397)
   * Fix type pikcle->pickle in multiprocessing test
-  * Fix pickling blueprints Change the string passed in the "name" section of the namedtuples in Blueprint to match the name of the Blueprint module attribute name. This allows blueprints to be pickled and unpickled, without errors, which is a requirement of running Sanic in multiprocessing mode in Windows. Added a test for pickling and unpickling blueprints Added a test for pickling and unpickling sanic itself Added a test for enabling multiprocessing on an app with a blueprint (only useful to catch this bug if the tests are run on Windows).
+  * Fix pickling blueprints Change the string passed in the "name" section of the namedtuples in Blueprint to match the name of the Blueprint module attribute name. This allows blueprints to be pickled and unpickled, without errors, which is a requirment of running Sanic in multiprocessing mode in Windows. Added a test for pickling and unpickling blueprints Added a test for pickling and unpickling sanic itself Added a test for enabling multiprocessing on an app with a blueprint (only useful to catch this bug if the tests are run on Windows).
   * Fix document for logging
 
 Version 0.8
 -----------
 
-**0.8.3**
+0.8.3
+*****
 
 * Changes:
 
   * Ownership changed to org 'sanic-org'
 
-**0.8.0**
+0.8.0
+*****
 
 * Changes:
 
@@ -1071,7 +1129,7 @@ Version 0.8
   * Content-length header on 204/304 responses (Arnulfo Solís)
   * Extend WebSocketProtocol arguments and add docs (Bob Olde Hampsink, yunstanford)
   * Update development status from pre-alpha to beta (Maksim Anisenkov)
-  * KeepAlive Timeout log level changed to debug (Arnulfo Solís)
+  * KeepAlive Timout log level changed to debug (Arnulfo Solís)
   * Pin pytest to 3.3.2 because of pytest-dev/pytest#3170 (Maksim Aniskenov)
   * Install Python 3.5 and 3.6 on docker container for tests (Shahin Azad)
   * Add support for blueprint groups and nesting (Elias Tarhini)
@@ -1126,16 +1184,19 @@ Version 0.1
 -----------
 
 
-**0.1.7**
+0.1.7
+*****
 
   * Reversed static url and directory arguments to meet spec
 
-**0.1.6**
+0.1.6
+*****
 
   * Static files
   * Lazy Cookie Loading
 
-**0.1.5**
+0.1.5
+*****
 
   * Cookies
   * Blueprint listeners and ordering
@@ -1143,19 +1204,23 @@ Version 0.1
   * Fix: Incomplete file reads on medium+ sized post requests
   * Breaking: after_start and before_stop now pass sanic as their first argument
 
-**0.1.4**
+0.1.4
+*****
 
   * Multiprocessing
 
-**0.1.3**
+0.1.3
+*****
 
   * Blueprint support
   * Faster Response processing
 
-**0.1.1 - 0.1.2**
+0.1.1 - 0.1.2
+*************
 
   * Struggling to update pypi via CI
 
-**0.1.0**
+0.1.0
+*****
 
   * Released to public

CONDUCT.md

@@ -55,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at adam@sanicframework.org. All
+reported by contacting the project team at sanic-maintainers@googlegroups.com. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.

CONTRIBUTING.rst

@@ -71,9 +71,9 @@ To execute only unittests, run ``tox`` with environment like so:
 
 .. code-block:: bash
 
-   tox -e py37 -v -- tests/test_config.py
+   tox -e py36 -v -- tests/test_config.py
    # or
-   tox -e py310 -v -- tests/test_config.py
+   tox -e py37 -v -- tests/test_config.py
 
 Run lint checks
 ---------------
@@ -140,7 +140,6 @@ To maintain the code consistency, Sanic uses following tools.
 #. `isort <https://github.com/timothycrosley/isort>`_
 #. `black <https://github.com/python/black>`_
 #. `flake8 <https://github.com/PyCQA/flake8>`_
-#. `slotscheck <https://github.com/ariebovenberg/slotscheck>`_
 
 isort
 *****
@@ -168,13 +167,7 @@ flake8
 #. pycodestyle
 #. Ned Batchelder's McCabe script
 
-slotscheck
-**********
-
-``slotscheck`` ensures that there are no problems with ``__slots__``
-(e.g. overlaps, or missing slots in base classes).
-
-``isort``\ , ``black``\ , ``flake8`` and ``slotscheck`` checks are performed during ``tox`` lint checks.
+``isort``\ , ``black`` and ``flake8`` checks are performed during ``tox`` lint checks.
 
 The **easiest** way to make your code conform is to run the following before committing.
 

Makefile

@@ -66,15 +66,15 @@ ifdef include_tests
 	isort -rc sanic tests
 else
 	$(info Sorting Imports)
-	isort -rc sanic tests
+	isort -rc sanic tests  --profile=black
 endif
 endif
 
 black:
-	black sanic tests
+	black --config ./.black.toml sanic tests
 
 isort:
-	isort sanic tests
+	isort sanic tests --profile=black
 
 pretty: black isort
 

README.rst

@@ -11,7 +11,7 @@ Sanic | Build fast. Run fast.
     :stub-columns: 1
 
     * - Build
-      - | |Py310Test| |Py39Test| |Py38Test| |Py37Test|
+      - | |Py39Test| |Py38Test| |Py37Test| |Codecov|
     * - Docs
       - | |UserGuide| |Documentation|
     * - Package
@@ -27,8 +27,8 @@ Sanic | Build fast. Run fast.
    :target: https://community.sanicframework.org/
 .. |Discord| image:: https://img.shields.io/discord/812221182594121728?logo=discord
    :target: https://discord.gg/FARQzAEMAA
-.. |Py310Test| image:: https://github.com/sanic-org/sanic/actions/workflows/pr-python310.yml/badge.svg?branch=main
-   :target: https://github.com/sanic-org/sanic/actions/workflows/pr-python310.yml
+.. |Codecov| image:: https://codecov.io/gh/sanic-org/sanic/branch/master/graph/badge.svg
+    :target: https://codecov.io/gh/sanic-org/sanic
 .. |Py39Test| image:: https://github.com/sanic-org/sanic/actions/workflows/pr-python39.yml/badge.svg?branch=main
    :target: https://github.com/sanic-org/sanic/actions/workflows/pr-python39.yml
 .. |Py38Test| image:: https://github.com/sanic-org/sanic/actions/workflows/pr-python38.yml/badge.svg?branch=main
@@ -66,7 +66,7 @@ Sanic | Build fast. Run fast.
 
 Sanic is a **Python 3.7+** web server and web framework that's written to go fast. It allows the usage of the ``async/await`` syntax added in Python 3.5, which makes your code non-blocking and speedy.
 
-Sanic is also ASGI compliant, so you can deploy it with an `alternative ASGI webserver <https://sanicframework.org/en/guide/deployment/running.html#asgi>`_.
+Sanic is also ASGI compliant, so you can deploy it with an `alternative ASGI webserver <https://sanic.readthedocs.io/en/latest/sanic/deploying.html#running-via-asgi>`_.
 
 `Source code on GitHub <https://github.com/sanic-org/sanic/>`_ | `Help and discussion board <https://community.sanicframework.org/>`_ | `User Guide <https://sanicframework.org>`_ | `Chat on Discord <https://discord.gg/FARQzAEMAA>`_
 
@@ -77,11 +77,7 @@ The goal of the project is to provide a simple way to get up and running a highl
 Sponsor
 -------
 
-Check out `open collective <https://opencollective.com/sanic-org>`_ to learn more about helping to fund Sanic. 
-
-Thanks to `Linode <https://www.linode.com>`_ for their contribution towards the development and community of Sanic.
-
-|Linode|
+Check out `open collective <https://opencollective.com/sanic-org>`_ to learn more about helping to fund Sanic.
 
 Installation
 ------------
@@ -102,6 +98,9 @@ Installation
   If you are running on a clean install of Fedora 28 or above, please make sure you have the ``redhat-rpm-config`` package installed in case if you want to
   use ``sanic`` with ``ujson`` dependency.
 
+.. note::
+
+  Windows support is currently "experimental" and on a best-effort basis. Multiple workers are also not currently supported on Windows (see `Issue #1517 <https://github.com/sanic-org/sanic/issues/1517>`_), but setting ``workers=1`` should launch the server successfully.
 
 Hello World Example
 -------------------
@@ -111,7 +110,7 @@ Hello World Example
     from sanic import Sanic
     from sanic.response import json
 
-    app = Sanic("my-hello-world-app")
+    app = Sanic("My Hello, world app")
 
     @app.route('/')
     async def test(request):
@@ -163,8 +162,3 @@ Contribution
 ------------
 
 We are always happy to have new contributions. We have `marked issues good for anyone looking to get started <https://github.com/sanic-org/sanic/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner>`_, and welcome `questions on the forums <https://community.sanicframework.org/>`_. Please take a look at our `Contribution guidelines <https://github.com/sanic-org/sanic/blob/master/CONTRIBUTING.rst>`_.
-
-.. |Linode| image:: https://www.linode.com/wp-content/uploads/2021/01/Linode-Logo-Black.svg
-    :alt: Linode
-    :target: https://www.linode.com
-    :width: 200px

SECURITY.md

@@ -4,42 +4,31 @@
 
 Sanic releases long term support release once a year in December. LTS releases receive bug and security updates for **24 months**. Interim releases throughout the year occur every three months, and are supported until the subsequent interim release.
 
+| Version | LTS           | Supported          |
+| ------- | ------------- | ------------------ |
+| 20.12   | until 2022-12 | :heavy_check_mark: |
+| 20.9    |               | :x:                |
+| 20.6    |               | :x:                |
+| 20.3    |               | :x:                |
+| 19.12   | until 2021-12 | :white_check_mark: |
+| 19.9    |               | :x:                |
+| 19.6    |               | :x:                |
+| 19.3    |               | :x:                |
+| 18.12   |               | :x:                |
+| 0.8.3   |               | :x:                |
+| 0.7.0   |               | :x:                |
+| 0.6.0   |               | :x:                |
+| 0.5.4   |               | :x:                |
+| 0.4.1   |               | :x:                |
+| 0.3.1   |               | :x:                |
+| 0.2.0   |               | :x:                |
+| 0.1.9   |               | :x:                |
 
-| Version | LTS           | Supported               |
-| ------- | ------------- | ----------------------- |
-| 22.12   | until 2024-12 | :white_check_mark:      |
-| 22.9    |               | :x:                     |
-| 22.6    |               | :x:                     |
-| 22.3    |               | :x:                     |
-| 21.12   | until 2023-12 | :ballot_box_with_check: |
-| 21.9    |               | :x:                     |
-| 21.6    |               | :x:                     |
-| 21.3    |               | :x:                     |
-| 20.12   |               | :x:                     |
-| 20.9    |               | :x:                     |
-| 20.6    |               | :x:                     |
-| 20.3    |               | :x:                     |
-| 19.12   |               | :x:                     |
-| 19.9    |               | :x:                     |
-| 19.6    |               | :x:                     |
-| 19.3    |               | :x:                     |
-| 18.12   |               | :x:                     |
-| 0.8.3   |               | :x:                     |
-| 0.7.0   |               | :x:                     |
-| 0.6.0   |               | :x:                     |
-| 0.5.4   |               | :x:                     |
-| 0.4.1   |               | :x:                     |
-| 0.3.1   |               | :x:                     |
-| 0.2.0   |               | :x:                     |
-| 0.1.9   |               | :x:                     |
-
-:ballot_box_with_check: = security/bug fixes 
-:white_check_mark: = full support
+:white_check_mark: = security/bug fixes
+:heavy_check_mark: = full support
 
 ## Reporting a Vulnerability
 
 If you discover a security vulnerability, we ask that you **do not** create an issue on GitHub. Instead, please [send a message to the core-devs](https://community.sanicframework.org/g/core-devs) on the community forums. Once logged in, you can send a message to the core-devs by clicking the message button.
 
-Alternatively, you can send a private message to Adam Hopkins on Discord. Find him on the [Sanic discord server](https://discord.gg/FARQzAEMAA).
-
 This will help to not publicize the issue until the team can address it and resolve it.

codecov.yml

@@ -1,28 +0,0 @@
-coverage:
-  status:
-    patch:
-      default:
-        target: auto
-        threshold: 0.75
-        informational: true
-    project:
-      default:
-        target: auto
-        threshold: 0.5
-  precision: 3
-codecov:
-  require_ci_to_pass: false
-ignore:
-  - "sanic/__main__.py"
-  - "sanic/compat.py"
-  - "sanic/simple.py"
-  - "sanic/utils.py"
-  - "sanic/cli/"
-  - "sanic/pages/"
-  - ".github/"
-  - "changelogs/"
-  - "docker/"
-  - "docs/"
-  - "examples/"
-  - "scripts/"
-  - "tests/"

docs/_static/custom.css

@@ -2,12 +2,3 @@
 .wy-nav-top {
   background: #444444;
 }
-
-#changelog section {
-  padding-left: 3rem;
-}
-
-#changelog section h2,
-#changelog section h3 {
-  margin-left: -3rem;
-}

docs/conf.py

@@ -24,11 +24,7 @@ import sanic
 
 # -- General configuration ------------------------------------------------
 
-extensions = [
-    "sphinx.ext.autodoc",
-    "m2r2",
-    "enum_tools.autoenum",
-]
+extensions = ["sphinx.ext.autodoc", "m2r2"]
 
 templates_path = ["_templates"]
 

docs/index.rst

@@ -9,7 +9,7 @@ API
 ===
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
 
    👥 User Guide <https://sanicframework.org/guide/>
    sanic/api_reference

docs/sanic/api/app.rst

@@ -15,19 +15,3 @@ sanic.config
 .. automodule:: sanic.config
     :members:
     :show-inheritance:
-
-sanic.application.constants
----------------------------
-
-.. automodule:: sanic.application.constants
-    :exclude-members: StrEnum
-    :members:
-    :show-inheritance:
-    :inherited-members:
-
-sanic.application.state
------------------------
-
-.. automodule:: sanic.application.state
-    :members:
-    :show-inheritance:

docs/sanic/api/core.rst

@@ -17,14 +17,6 @@ sanic.handlers
     :show-inheritance:
 
 
-sanic.headers
---------------
-
-.. automodule:: sanic.headers
-    :members:
-    :show-inheritance:
-
-
 sanic.request
 -------------
 
@@ -46,3 +38,10 @@ sanic.views
 .. automodule:: sanic.views
     :members:
     :show-inheritance:
+
+sanic.websocket
+---------------
+
+.. automodule:: sanic.websocket
+    :members:
+    :show-inheritance:

docs/sanic/api/server.rst

@@ -16,3 +16,10 @@ sanic.server
     :members:
     :show-inheritance:
 
+
+sanic.worker
+------------
+
+.. automodule:: sanic.worker
+    :members:
+    :show-inheritance:

docs/sanic/changelog.rst

@@ -1,10 +1,6 @@
 📜 Changelog
 ============
 
-.. mdinclude:: ./releases/22/22.12.md
-.. mdinclude:: ./releases/22/22.9.md
-.. mdinclude:: ./releases/22/22.6.md
-.. mdinclude:: ./releases/22/22.3.md
-.. mdinclude:: ./releases/21/21.12.md
-.. mdinclude:: ./releases/21/21.9.md
+.. mdinclude:: ./releases/21.9.md
+
 .. include:: ../../CHANGELOG.rst

docs/sanic/releases/21.9.md

@@ -1,14 +1,4 @@
-## Version 21.9.3
-*Rerelease of v21.9.2 with some cleanup*
-
-## Version 21.9.2
-- [#2268](https://github.com/sanic-org/sanic/pull/2268) Make HTTP connections start in IDLE stage, avoiding delays and error messages
-- [#2310](https://github.com/sanic-org/sanic/pull/2310) More consistent config setting with post-FALLBACK_ERROR_FORMAT apply
-
-## Version 21.9.1
-- [#2259](https://github.com/sanic-org/sanic/pull/2259) Allow non-conforming ErrorHandlers
-
-## Version 21.9.0
+## Version 21.9
 
 ### Features
 - [#2158](https://github.com/sanic-org/sanic/pull/2158), [#2248](https://github.com/sanic-org/sanic/pull/2248) Complete overhaul of I/O to websockets

docs/sanic/releases/21/21.12.md

@@ -1,66 +0,0 @@
-## Version 21.12.1 🔷
-
-_Current LTS version_
-
-- [#2349](https://github.com/sanic-org/sanic/pull/2349) Only display MOTD on startup
-- [#2354](https://github.com/sanic-org/sanic/pull/2354) Ignore name argument in Python 3.7
-- [#2355](https://github.com/sanic-org/sanic/pull/2355) Add config.update support for all config values
-
-## Version 21.12.0 🔹
-
-### Features
-- [#2260](https://github.com/sanic-org/sanic/pull/2260) Allow early Blueprint registrations to still apply later added objects
-- [#2262](https://github.com/sanic-org/sanic/pull/2262) Noisy exceptions - force logging of all exceptions
-- [#2264](https://github.com/sanic-org/sanic/pull/2264) Optional `uvloop` by configuration
-- [#2270](https://github.com/sanic-org/sanic/pull/2270) Vhost support using multiple TLS certificates
-- [#2277](https://github.com/sanic-org/sanic/pull/2277) Change signal routing for increased consistency
-    - *BREAKING CHANGE*: If you were manually routing signals there is a breaking change. The signal router's `get` is no longer 100% determinative. There is now an additional step to loop thru the returned signals for proper matching on the requirements. If signals are being dispatched using `app.dispatch` or `bp.dispatch`, there is no change.
-- [#2290](https://github.com/sanic-org/sanic/pull/2290) Add contextual exceptions
-- [#2291](https://github.com/sanic-org/sanic/pull/2291) Increase join concat performance 
-- [#2295](https://github.com/sanic-org/sanic/pull/2295), [#2316](https://github.com/sanic-org/sanic/pull/2316), [#2331](https://github.com/sanic-org/sanic/pull/2331) Restructure of CLI and application state with new displays and more command parity with `app.run`
-- [#2302](https://github.com/sanic-org/sanic/pull/2302) Add route context at definition time
-- [#2304](https://github.com/sanic-org/sanic/pull/2304) Named tasks and new API for managing background tasks
-- [#2307](https://github.com/sanic-org/sanic/pull/2307) On app auto-reload, provide insight of changed files
-- [#2308](https://github.com/sanic-org/sanic/pull/2308) Auto extend application with [Sanic Extensions](https://sanicframework.org/en/plugins/sanic-ext/getting-started.html) if it is installed, and provide first class support for accessing the extensions
-- [#2309](https://github.com/sanic-org/sanic/pull/2309) Builtin signals changed to `Enum`
-- [#2313](https://github.com/sanic-org/sanic/pull/2313) Support additional config implementation use case
-- [#2321](https://github.com/sanic-org/sanic/pull/2321) Refactor environment variable hydration logic
-- [#2327](https://github.com/sanic-org/sanic/pull/2327) Prevent sending multiple or mixed responses on a single request
-- [#2330](https://github.com/sanic-org/sanic/pull/2330) Custom type casting on environment variables
-- [#2332](https://github.com/sanic-org/sanic/pull/2332) Make all deprecation notices consistent
-- [#2335](https://github.com/sanic-org/sanic/pull/2335) Allow underscore to start instance names
-
-### Bugfixes
-- [#2273](https://github.com/sanic-org/sanic/pull/2273) Replace assignation by typing for `websocket_handshake`
-- [#2285](https://github.com/sanic-org/sanic/pull/2285) Fix IPv6 display in startup logs
-- [#2299](https://github.com/sanic-org/sanic/pull/2299) Dispatch `http.lifecyle.response` from exception handler
-
-### Deprecations and Removals
-- [#2306](https://github.com/sanic-org/sanic/pull/2306) Removal of deprecated items
-    - `Sanic` and `Blueprint` may no longer have arbitrary properties attached to them
-    - `Sanic` and `Blueprint` forced to have compliant names
-        - alphanumeric + `_` + `-`
-        - must start with letter or `_`
-    - `load_env` keyword argument of `Sanic`
-    - `sanic.exceptions.abort`
-    - `sanic.views.CompositionView`
-    - `sanic.response.StreamingHTTPResponse`
-        - *NOTE:* the `stream()` response method (where you pass a callable streaming function) has been deprecated and will be removed in v22.6. You should upgrade all streaming responses to the new style: https://sanicframework.org/en/guide/advanced/streaming.html#response-streaming
-- [#2320](https://github.com/sanic-org/sanic/pull/2320) Remove app instance from Config for error handler setting
-
-### Developer infrastructure
-- [#2251](https://github.com/sanic-org/sanic/pull/2251) Change dev install command
-- [#2286](https://github.com/sanic-org/sanic/pull/2286) Change codeclimate complexity threshold from 5 to 10
-- [#2287](https://github.com/sanic-org/sanic/pull/2287) Update host test function names so they are not overwritten
-- [#2292](https://github.com/sanic-org/sanic/pull/2292) Fail CI on error
-- [#2311](https://github.com/sanic-org/sanic/pull/2311), [#2324](https://github.com/sanic-org/sanic/pull/2324) Do not run tests for draft PRs
-- [#2336](https://github.com/sanic-org/sanic/pull/2336) Remove paths from coverage checks
-- [#2338](https://github.com/sanic-org/sanic/pull/2338) Cleanup ports on tests
-
-### Improved Documentation
-- [#2269](https://github.com/sanic-org/sanic/pull/2269), [#2329](https://github.com/sanic-org/sanic/pull/2329), [#2333](https://github.com/sanic-org/sanic/pull/2333) Cleanup typos and fix language
-
-### Miscellaneous
-- [#2257](https://github.com/sanic-org/sanic/pull/2257), [#2294](https://github.com/sanic-org/sanic/pull/2294), [#2341](https://github.com/sanic-org/sanic/pull/2341) Add Python 3.10 support
-- [#2279](https://github.com/sanic-org/sanic/pull/2279), [#2317](https://github.com/sanic-org/sanic/pull/2317), [#2322](https://github.com/sanic-org/sanic/pull/2322) Add/correct missing type annotations
-- [#2305](https://github.com/sanic-org/sanic/pull/2305) Fix examples to use modern implementations

docs/sanic/releases/22/22.12.md

@@ -1,55 +0,0 @@
-## Version 22.12.0 🔶
-
-_Current version_
-
-### Features
-
-- [#2569](https://github.com/sanic-org/sanic/pull/2569) Add `JSONResponse` class with some convenient methods when updating a response object
-- [#2598](https://github.com/sanic-org/sanic/pull/2598) Change `uvloop` requirement to `>=0.15.0`
-- [#2609](https://github.com/sanic-org/sanic/pull/2609) Add compatibility with `websockets` v11.0
-- [#2610](https://github.com/sanic-org/sanic/pull/2610) Kill server early on worker error
-    - Raise deadlock timeout to 30s
-- [#2617](https://github.com/sanic-org/sanic/pull/2617) Scale number of running server workers
-- [#2621](https://github.com/sanic-org/sanic/pull/2621) [#2634](https://github.com/sanic-org/sanic/pull/2634) Send `SIGKILL` on subsequent `ctrl+c` to force worker exit
-- [#2622](https://github.com/sanic-org/sanic/pull/2622) Add API to restart all workers from the multiplexer
-- [#2624](https://github.com/sanic-org/sanic/pull/2624) Default to `spawn` for all subprocesses unless specifically set:
-    ```python
-    from sanic import Sanic
-    
-    Sanic.start_method = "fork"
-    ```
-- [#2625](https://github.com/sanic-org/sanic/pull/2625) Filename normalisation of form-data/multipart file uploads
-- [#2626](https://github.com/sanic-org/sanic/pull/2626) Move to HTTP Inspector:
-    - Remote access to inspect running Sanic instances
-    - TLS support for encrypted calls to Inspector
-    - Authentication to Inspector with API key
-    - Ability to extend Inspector with custom commands
-- [#2632](https://github.com/sanic-org/sanic/pull/2632) Control order of restart operations
-- [#2633](https://github.com/sanic-org/sanic/pull/2633) Move reload interval to class variable
-- [#2636](https://github.com/sanic-org/sanic/pull/2636) Add `priority` to `register_middleware` method
-- [#2639](https://github.com/sanic-org/sanic/pull/2639) Add `unquote` to `add_route` method
-- [#2640](https://github.com/sanic-org/sanic/pull/2640) ASGI websockets to receive `text` or `bytes`
-
-
-### Bugfixes
-
-- [#2607](https://github.com/sanic-org/sanic/pull/2607) Force socket shutdown before close to allow rebinding
-- [#2590](https://github.com/sanic-org/sanic/pull/2590) Use actual `StrEnum` in Python 3.11+
-- [#2615](https://github.com/sanic-org/sanic/pull/2615) Ensure middleware executes only once per request timeout
-- [#2627](https://github.com/sanic-org/sanic/pull/2627) Crash ASGI application on lifespan failure
-- [#2635](https://github.com/sanic-org/sanic/pull/2635) Resolve error with low-level server creation on Windows
-
-
-### Deprecations and Removals
-
-- [#2608](https://github.com/sanic-org/sanic/pull/2608) [#2630](https://github.com/sanic-org/sanic/pull/2630) Signal conditions and triggers saved on `signal.extra` 
-- [#2626](https://github.com/sanic-org/sanic/pull/2626) Move to HTTP Inspector
-    - 🚨 *BREAKING CHANGE*: Moves the Inspector to a Sanic app from a simple TCP socket with a custom protocol
-    - *DEPRECATE*: The `--inspect*` commands have been deprecated in favor of `inspect ...` commands
-- [#2628](https://github.com/sanic-org/sanic/pull/2628) Replace deprecated `distutils.strtobool`
-
-
-### Developer infrastructure
-
-- [#2612](https://github.com/sanic-org/sanic/pull/2612) Add CI testing for Python 3.11
-

docs/sanic/releases/22/22.3.md

@@ -1,52 +0,0 @@
-## Version 22.3.0
-
-### Features
-- [#2347](https://github.com/sanic-org/sanic/pull/2347) API for multi-application server
-    - 🚨 *BREAKING CHANGE*: The old `sanic.worker.GunicornWorker` has been **removed**. To run Sanic with `gunicorn`, you should use it thru `uvicorn` [as described in their docs](https://www.uvicorn.org/#running-with-gunicorn).
-    - 🧁 *SIDE EFFECT*: Named background tasks are now supported, even in Python 3.7
-- [#2357](https://github.com/sanic-org/sanic/pull/2357) Parse `Authorization` header as `Request.credentials`
-- [#2361](https://github.com/sanic-org/sanic/pull/2361) Add config option to skip `Touchup` step in application startup
-- [#2372](https://github.com/sanic-org/sanic/pull/2372) Updates to CLI help messaging
-- [#2382](https://github.com/sanic-org/sanic/pull/2382) Downgrade warnings to backwater debug messages 
-- [#2396](https://github.com/sanic-org/sanic/pull/2396) Allow for `multidict` v0.6
-- [#2401](https://github.com/sanic-org/sanic/pull/2401) Upgrade CLI catching for alternative application run types
-- [#2402](https://github.com/sanic-org/sanic/pull/2402) Conditionally inject CLI arguments into factory
-- [#2413](https://github.com/sanic-org/sanic/pull/2413) Add new start and stop event listeners to reloader process
-- [#2414](https://github.com/sanic-org/sanic/pull/2414) Remove loop as required listener arg
-- [#2415](https://github.com/sanic-org/sanic/pull/2415) Better exception for bad URL parsing
-- [sanic-routing#47](https://github.com/sanic-org/sanic-routing/pull/47) Add a new extention parameter type: `<file:ext>`, `<file:ext=jpg>`, `<file:ext=jpg|png|gif|svg>`, `<file=int:ext>`, `<file=int:ext=jpg|png|gif|svg>`, `<file=float:ext=tar.gz>`
-    - 👶 *BETA FEATURE*: This feature will not work with `path` type matching, and is being released as a beta feature only.
-- [sanic-routing#57](https://github.com/sanic-org/sanic-routing/pull/57) Change `register_pattern` to accept a `str` or `Pattern`
-- [sanic-routing#58](https://github.com/sanic-org/sanic-routing/pull/58) Default matching on non-empty strings only, and new `strorempty` pattern type
-    - 🚨 *BREAKING CHANGE*: Previously a route with a dynamic string parameter (`/<foo>` or `/<foo:str>`) would match on any string, including empty strings. It will now **only** match a non-empty string. To retain the old behavior, you should use the new parameter type: `/<foo:strorempty>`.
-
-### Bugfixes
-- [#2373](https://github.com/sanic-org/sanic/pull/2373) Remove `error_logger` on websockets
-- [#2381](https://github.com/sanic-org/sanic/pull/2381) Fix newly assigned `None` in task registry
-- [sanic-routing#52](https://github.com/sanic-org/sanic-routing/pull/52) Add type casting to regex route matching
-- [sanic-routing#60](https://github.com/sanic-org/sanic-routing/pull/60) Add requirements check on regex routes (this resolves, for example, multiple static directories with differing `host` values)
-
-### Deprecations and Removals
-- [#2362](https://github.com/sanic-org/sanic/pull/2362) 22.3 Deprecations and changes
-    1. `debug=True` and `--debug` do _NOT_ automatically run `auto_reload`
-    2. Default error render is with plain text (browsers still get HTML by default because `auto` looks at headers)
-    3. `config` is required for `ErrorHandler.finalize`
-    4. `ErrorHandler.lookup` requires two positional args
-    5. Unused websocket protocol args removed
-- [#2344](https://github.com/sanic-org/sanic/pull/2344) Deprecate loading of lowercase environment variables
-
-### Developer infrastructure
-- [#2363](https://github.com/sanic-org/sanic/pull/2363) Revert code coverage back to Codecov
-- [#2405](https://github.com/sanic-org/sanic/pull/2405) Upgrade tests for `sanic-routing` changes
-- [sanic-testing#35](https://github.com/sanic-org/sanic-testing/pull/35) Allow for httpx v0.22
-
-### Improved Documentation
-- [#2350](https://github.com/sanic-org/sanic/pull/2350) Fix link in README for ASGI
-- [#2398](https://github.com/sanic-org/sanic/pull/2398) Document middleware on_request and on_response
-- [#2409](https://github.com/sanic-org/sanic/pull/2409) Add missing documentation for `Request.respond`
-
-### Miscellaneous
-- [#2376](https://github.com/sanic-org/sanic/pull/2376) Fix typing for `ListenerMixin.listener`
-- [#2383](https://github.com/sanic-org/sanic/pull/2383) Clear deprecation warning in `asyncio.wait`
-- [#2387](https://github.com/sanic-org/sanic/pull/2387) Cleanup `__slots__` implementations
-- [#2390](https://github.com/sanic-org/sanic/pull/2390) Clear deprecation warning in `asyncio.get_event_loop`

docs/sanic/releases/22/22.6.md

@@ -1,54 +0,0 @@
-## Version 22.6.2
-
-### Bugfixes
-
-- [#2522](https://github.com/sanic-org/sanic/pull/2522) Always show server location in ASGI
-
-## Version 22.6.1
-
-### Bugfixes
-
-- [#2477](https://github.com/sanic-org/sanic/pull/2477) Sanic static directory fails when folder name ends with ".."
-
-
-## Version 22.6.0
-
-### Features
-- [#2378](https://github.com/sanic-org/sanic/pull/2378) Introduce HTTP/3 and autogeneration of TLS certificates in `DEBUG` mode
-    - 👶 *EARLY RELEASE FEATURE*: Serving Sanic over HTTP/3 is an early release feature. It does not yet fully cover the HTTP/3 spec, but instead aims for feature parity with Sanic's existing HTTP/1.1 server. Websockets, WebTransport, push responses are examples of some features not yet implemented.
-    - 📦 *EXTRA REQUIREMENT*: Not all HTTP clients are capable of interfacing with HTTP/3 servers. You may need to install a [HTTP/3 capable client](https://curl.se/docs/http3.html).
-    - 📦 *EXTRA REQUIREMENT*: In order to use TLS autogeneration, you must install either [mkcert](https://github.com/FiloSottile/mkcert) or [trustme](https://github.com/python-trio/trustme).
-- [#2416](https://github.com/sanic-org/sanic/pull/2416) Add message to `task.cancel`
-- [#2420](https://github.com/sanic-org/sanic/pull/2420) Add exception aliases for more consistent naming with standard HTTP response types (`BadRequest`, `MethodNotAllowed`, `RangeNotSatisfiable`)
-- [#2432](https://github.com/sanic-org/sanic/pull/2432) Expose ASGI `scope` as a property on the `Request` object
-- [#2438](https://github.com/sanic-org/sanic/pull/2438) Easier access to websocket class for annotation: `from sanic import Websocket`
-- [#2439](https://github.com/sanic-org/sanic/pull/2439) New API for reading form values with options: `Request.get_form` 
-- [#2445](https://github.com/sanic-org/sanic/pull/2445) Add custom `loads` function
-- [#2447](https://github.com/sanic-org/sanic/pull/2447), [#2486](https://github.com/sanic-org/sanic/pull/2486) Improved API to support setting cache control headers
-- [#2453](https://github.com/sanic-org/sanic/pull/2453) Move verbosity filtering to logger
-- [#2475](https://github.com/sanic-org/sanic/pull/2475) Expose getter for current request using `Request.get_current()`
-
-### Bugfixes
-- [#2448](https://github.com/sanic-org/sanic/pull/2448) Fix to allow running with `pythonw.exe` or places where there is no `sys.stdout`
-- [#2451](https://github.com/sanic-org/sanic/pull/2451) Trigger `http.lifecycle.request` signal in ASGI mode
-- [#2455](https://github.com/sanic-org/sanic/pull/2455) Resolve typing of stacked route definitions
-- [#2463](https://github.com/sanic-org/sanic/pull/2463) Properly catch websocket CancelledError in websocket handler in Python 3.7
-
-### Deprecations and Removals
-- [#2487](https://github.com/sanic-org/sanic/pull/2487) v22.6 deprecations and changes
-    1. Optional application registry
-    1. Execution of custom handlers after some part of response was sent
-    1. Configuring fallback handlers on the `ErrorHandler`
-    1. Custom `LOGO` setting
-    1. `sanic.response.stream`
-    1. `AsyncioServer.init`
-
-### Developer infrastructure
-- [#2449](https://github.com/sanic-org/sanic/pull/2449) Clean up `black` and `isort` config
-- [#2479](https://github.com/sanic-org/sanic/pull/2479) Fix some flappy tests
-
-### Improved Documentation
-- [#2461](https://github.com/sanic-org/sanic/pull/2461) Update example to match current application naming standards
-- [#2466](https://github.com/sanic-org/sanic/pull/2466) Better type annotation for `Extend`
-- [#2485](https://github.com/sanic-org/sanic/pull/2485) Improved help messages in CLI
-

docs/sanic/releases/22/22.9.md

@@ -1,74 +0,0 @@
-## Version 22.9.1
-
-### Features
-
-- [#2585](https://github.com/sanic-org/sanic/pull/2585) Improved error message when no applications have been registered
-
-
-### Bugfixes
-
-- [#2578](https://github.com/sanic-org/sanic/pull/2578) Add certificate loader for in process certificate creation
-- [#2591](https://github.com/sanic-org/sanic/pull/2591) Do not use sentinel identity for `spawn` compatibility
-- [#2592](https://github.com/sanic-org/sanic/pull/2592) Fix properties in nested blueprint groups
-- [#2595](https://github.com/sanic-org/sanic/pull/2595) Introduce sleep interval on new worker reloader
-
-
-### Deprecations and Removals
-
-
-### Developer infrastructure
-
-- [#2588](https://github.com/sanic-org/sanic/pull/2588) Markdown templates on issue forms
-
-
-### Improved Documentation
-
-- [#2556](https://github.com/sanic-org/sanic/pull/2556) v22.9 documentation
-- [#2582](https://github.com/sanic-org/sanic/pull/2582) Cleanup documentation on Windows support
-
-
-## Version 22.9.0
-
-### Features
-
-- [#2445](https://github.com/sanic-org/sanic/pull/2445) Add custom loads function 
-- [#2490](https://github.com/sanic-org/sanic/pull/2490) Make `WebsocketImplProtocol` async iterable
-- [#2499](https://github.com/sanic-org/sanic/pull/2499) Sanic Server WorkerManager refactor
-- [#2506](https://github.com/sanic-org/sanic/pull/2506) Use `pathlib` for path resolution (for static file serving)
-- [#2508](https://github.com/sanic-org/sanic/pull/2508) Use `path.parts` instead of `match` (for static file serving)
-- [#2513](https://github.com/sanic-org/sanic/pull/2513) Better request cancel handling
-- [#2516](https://github.com/sanic-org/sanic/pull/2516) Add request properties for HTTP method info:
-    - `request.is_safe`
-    - `request.is_idempotent`
-    - `request.is_cacheable`
-    - *See* [MDN docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods) *for more information about when these apply*
-- [#2522](https://github.com/sanic-org/sanic/pull/2522) Always show server location in ASGI
-- [#2526](https://github.com/sanic-org/sanic/pull/2526) Cache control support for static files for returning 304 when appropriate
-- [#2533](https://github.com/sanic-org/sanic/pull/2533) Refactor `_static_request_handler`
-- [#2540](https://github.com/sanic-org/sanic/pull/2540) Add signals before and after handler execution
-    - `http.handler.before`
-    - `http.handler.after`
-- [#2542](https://github.com/sanic-org/sanic/pull/2542) Add *[redacted]* to CLI :)
-- [#2546](https://github.com/sanic-org/sanic/pull/2546) Add deprecation warning filter
-- [#2550](https://github.com/sanic-org/sanic/pull/2550) Middleware priority and performance enhancements
-
-### Bugfixes
-
-- [#2495](https://github.com/sanic-org/sanic/pull/2495) Prevent directory traversion with static files
-- [#2515](https://github.com/sanic-org/sanic/pull/2515) Do not apply double slash to paths in certain static dirs in Blueprints
-
-### Deprecations and Removals
-
-- [#2525](https://github.com/sanic-org/sanic/pull/2525) Warn on duplicate route names, will be prevented outright in v23.3
-- [#2537](https://github.com/sanic-org/sanic/pull/2537) Raise warning and deprecation notice on duplicate exceptions, will be prevented outright in v23.3
-
-### Developer infrastructure
-
-- [#2504](https://github.com/sanic-org/sanic/pull/2504) Cleanup test suite
-- [#2505](https://github.com/sanic-org/sanic/pull/2505) Replace Unsupported Python Version Number from the Contributing Doc
-- [#2530](https://github.com/sanic-org/sanic/pull/2530) Do not include tests folder in installed package resolver
-
-### Improved Documentation
-
-- [#2502](https://github.com/sanic-org/sanic/pull/2502) Fix a few typos
-- [#2517](https://github.com/sanic-org/sanic/pull/2517) [#2536](https://github.com/sanic-org/sanic/pull/2536) Add some type hints

examples/add_task_sanic.py

@@ -4,14 +4,12 @@ import asyncio
 
 from sanic import Sanic
 
-
-app = Sanic("Example")
+app = Sanic()
 
 
 async def notify_server_started_after_five_seconds():
     await asyncio.sleep(5)
-    print("Server successfully started!")
-
+    print('Server successfully started!')
 
 app.add_task(notify_server_started_after_five_seconds())
 

examples/amending_request_object.py

@@ -1,29 +1,30 @@
-from random import randint
-
 from sanic import Sanic
 from sanic.response import text
+from random import randint
+
+app = Sanic()
 
 
-app = Sanic("Example")
-
-
-@app.middleware("request")
+@app.middleware('request')
 def append_request(request):
-    request.ctx.num = randint(0, 100)
+    # Add new key with random value
+    request['num'] = randint(0, 100)
 
 
-@app.get("/pop")
+@app.get('/pop')
 def pop_handler(request):
-    return text(request.ctx.num)
+    # Pop key from request object
+    num = request.pop('num')
+    return text(num)
 
 
-@app.get("/key_exist")
+@app.get('/key_exist')
 def key_exist_handler(request):
     # Check the key is exist or not
-    if hasattr(request.ctx, "num"):
-        return text("num exist in request")
+    if 'num' in request:
+        return text('num exist in request')
 
-    return text("num does not exist in request")
+    return text('num does not exist in reqeust')
 
 
 app.run(host="0.0.0.0", port=8000, debug=True)

examples/authorized_sanic.py

@@ -1,12 +1,10 @@
 # -*- coding: utf-8 -*-
 
-from functools import wraps
-
 from sanic import Sanic
+from functools import wraps
 from sanic.response import json
 
-
-app = Sanic("Example")
+app = Sanic()
 
 
 def check_request_for_authorization_status(request):
@@ -29,16 +27,14 @@ def authorized(f):
             return response
         else:
             # the user is not authorized.
-            return json({"status": "not_authorized"}, 403)
-
+            return json({'status': 'not_authorized'}, 403)
     return decorated_function
 
 
 @app.route("/")
 @authorized
 async def test(request):
-    return json({"status": "authorized"})
-
+    return json({'status': 'authorized'})
 
 if __name__ == "__main__":
     app.run(host="0.0.0.0", port=8000)

examples/blueprint_middlware_execution_order.py

@@ -1,53 +1,43 @@
-from sanic import Blueprint, Sanic
+from sanic import Sanic, Blueprint
 from sanic.response import text
-
-
-"""
-Demonstrates that blueprint request middleware are executed in the order they
+'''
+Demonstrates that blueprint request middleware are executed in the order they 
 are added. And blueprint response middleware are executed in _reverse_ order.
 On a valid request, it should print "1 2 3 6 5 4" to terminal
-"""
+'''
 
-app = Sanic("Example")
+app = Sanic(__name__)
 
-bp = Blueprint("bp_example")
+bp = Blueprint("bp_"+__name__)
 
-
-@bp.on_request
+@bp.middleware('request')
 def request_middleware_1(request):
-    print("1")
+    print('1')
 
-
-@bp.on_request
+@bp.middleware('request')
 def request_middleware_2(request):
-    print("2")
+    print('2')
 
-
-@bp.on_request
+@bp.middleware('request')
 def request_middleware_3(request):
-    print("3")
+    print('3')
 
-
-@bp.on_response
+@bp.middleware('response')
 def resp_middleware_4(request, response):
-    print("4")
+    print('4')
 
-
-@bp.on_response
+@bp.middleware('response')
 def resp_middleware_5(request, response):
-    print("5")
+    print('5')
 
-
-@bp.on_response
+@bp.middleware('response')
 def resp_middleware_6(request, response):
-    print("6")
+    print('6')
 
-
-@bp.route("/")
+@bp.route('/')
 def pop_handler(request):
-    return text("hello world")
+    return text('hello world')
 
-
-app.blueprint(bp, url_prefix="/bp")
+app.blueprint(bp, url_prefix='/bp')
 
 app.run(host="0.0.0.0", port=8000, debug=True, auto_reload=False)

examples/blueprints.py

@@ -1,11 +1,10 @@
 from sanic import Blueprint, Sanic
 from sanic.response import file, json
 
-
-app = Sanic("Example")
-blueprint = Blueprint("bp_example", url_prefix="/my_blueprint")
-blueprint2 = Blueprint("bp_example2", url_prefix="/my_blueprint2")
-blueprint3 = Blueprint("bp_example3", url_prefix="/my_blueprint3")
+app = Sanic(__name__)
+blueprint = Blueprint("name", url_prefix="/my_blueprint")
+blueprint2 = Blueprint("name2", url_prefix="/my_blueprint2")
+blueprint3 = Blueprint("name3", url_prefix="/my_blueprint3")
 
 
 @blueprint.route("/foo")

examples/delayed_response.py

@@ -2,21 +2,17 @@ from asyncio import sleep
 
 from sanic import Sanic, response
 
-
-app = Sanic("DelayedResponseApp", strict_slashes=True)
-app.config.AUTO_EXTEND = False
-
+app = Sanic(__name__, strict_slashes=True)
 
 @app.get("/")
 async def handler(request):
     return response.redirect("/sleep/3")
 
-
-@app.get("/sleep/<t:float>")
+@app.get("/sleep/<t:number>")
 async def handler2(request, t=0.3):
     await sleep(t)
     return response.text(f"Slept {t:.1f} seconds.\n")
 
 
-if __name__ == "__main__":
+if __name__ == '__main__':
     app.run(host="0.0.0.0", port=8000)

examples/exception_monitoring.py

@@ -7,10 +7,8 @@ and pass in an instance of it when we create our Sanic instance. Inside this
 class' default handler, we can do anything including sending exceptions to
 an external service.
 """
-from sanic.exceptions import SanicException
 from sanic.handlers import ErrorHandler
-
-
+from sanic.exceptions import SanicException
 """
 Imports and code relevant for our CustomHandler class
 (Ordinarily this would be in a separate file)
@@ -18,6 +16,7 @@ Imports and code relevant for our CustomHandler class
 
 
 class CustomHandler(ErrorHandler):
+
     def default(self, request, exception):
         # Here, we have access to the exception object
         # and can do anything with it (log, send to external service, etc)
@@ -39,17 +38,17 @@ server's error_handler to an instance of our CustomHandler
 
 from sanic import Sanic
 
+app = Sanic(__name__)
 
 handler = CustomHandler()
-app = Sanic("Example", error_handler=handler)
+app.error_handler = handler
 
 
 @app.route("/")
 async def test(request):
     # Here, something occurs which causes an unexpected exception
     # This exception will flow to our custom handler.
-    raise SanicException("You Broke It!")
+    raise SanicException('You Broke It!')
 
-
-if __name__ == "__main__":
+if __name__ == '__main__':
     app.run(host="0.0.0.0", port=8000, debug=True)

examples/http_redirect.py

@@ -1,6 +1,4 @@
 from sanic import Sanic, response, text
-from sanic.handlers import ErrorHandler
-from sanic.server.async_server import AsyncioServer
 
 
 HTTP_PORT = 9999
@@ -34,40 +32,20 @@ def proxy(request, path):
     return response.redirect(url)
 
 
-@https.main_process_start
+@https.listener("main_process_start")
 async def start(app, _):
-    http_server = await http.create_server(
+    global http
+    app.http_server = await http.create_server(
         port=HTTP_PORT, return_asyncio_server=True
     )
-    app.add_task(runner(http, http_server))
-    app.ctx.http_server = http_server
-    app.ctx.http = http
+    app.http_server.after_start()
 
 
-@https.main_process_stop
+@https.listener("main_process_stop")
 async def stop(app, _):
-    await app.ctx.http_server.before_stop()
-    await app.ctx.http_server.close()
-    for connection in app.ctx.http_server.connections:
-        connection.close_if_idle()
-    await app.ctx.http_server.after_stop()
-    app.ctx.http = False
-
-
-async def runner(app: Sanic, app_server: AsyncioServer):
-    app.is_running = True
-    try:
-        app.signalize()
-        app.finalize()
-        ErrorHandler.finalize(app.error_handler)
-        app_server.init = True
-
-        await app_server.before_start()
-        await app_server.after_start()
-        await app_server.serve_forever()
-    finally:
-        app.is_running = False
-        app.is_stopping = True
+    app.http_server.before_stop()
+    await app.http_server.close()
+    app.http_server.after_stop()
 
 
 https.run(port=HTTPS_PORT, debug=True)

examples/limit_concurrency.py

@@ -1,30 +1,26 @@
-import asyncio
-
-import httpx
-
 from sanic import Sanic
 from sanic.response import json
 
+import asyncio
+import aiohttp
 
-app = Sanic("Example")
+app = Sanic(__name__)
 
 sem = None
 
 
-@app.before_server_start
-def init(sanic, _):
+@app.listener('before_server_start')
+def init(sanic, loop):
     global sem
     concurrency_per_worker = 4
-    sem = asyncio.Semaphore(concurrency_per_worker)
-
+    sem = asyncio.Semaphore(concurrency_per_worker, loop=loop)
 
 async def bounded_fetch(session, url):
     """
     Use session object to perform 'get' request on url
     """
-    async with sem:
-        response = await session.get(url)
-        return response.json()
+    async with sem, session.get(url) as response:
+        return await response.json()
 
 
 @app.route("/")
@@ -32,9 +28,9 @@ async def test(request):
     """
     Download and serve example JSON
     """
-    url = "https://api.github.com/repos/sanic-org/sanic"
+    url = "https://api.github.com/repos/channelcat/sanic"
 
-    async with httpx.AsyncClient() as session:
+    async with aiohttp.ClientSession() as session:
         response = await bounded_fetch(session, url)
         return json(response)
 

examples/log_request_id.py

@@ -1,6 +1,6 @@
 import logging
 
-from contextvars import ContextVar
+import aiotask_context as context
 
 from sanic import Sanic, response
 
@@ -11,8 +11,8 @@ log = logging.getLogger(__name__)
 class RequestIdFilter(logging.Filter):
     def filter(self, record):
         try:
-            record.request_id = app.ctx.request_id.get(None) or "n/a"
-        except AttributeError:
+            record.request_id = context.get("X-Request-ID")
+        except ValueError:
             record.request_id = "n/a"
         return True
 
@@ -44,12 +44,13 @@ LOG_SETTINGS = {
 }
 
 
-app = Sanic("Example", log_config=LOG_SETTINGS)
+app = Sanic(__name__, log_config=LOG_SETTINGS)
 
 
 @app.on_request
 async def set_request_id(request):
-    request.app.ctx.request_id.set(request.id)
+    request_id = request.id
+    context.set("X-Request-ID", request_id)
     log.info(f"Setting {request.id=}")
 
 
@@ -60,14 +61,14 @@ async def set_request_header(request, response):
 
 @app.route("/")
 async def test(request):
-    log.debug("X-Request-ID: %s", request.id)
+    log.debug("X-Request-ID: %s", context.get("X-Request-ID"))
     log.info("Hello from test!")
     return response.json({"test": True})
 
 
 @app.before_server_start
 def setup(app, loop):
-    app.ctx.request_id = ContextVar("request_id")
+    loop.set_task_factory(context.task_factory)
 
 
 if __name__ == "__main__":

examples/logdna_example.py

@@ -1,6 +1,5 @@
 import logging
 import socket
-
 from os import getenv
 from platform import node
 from uuid import getnode as get_mac
@@ -8,11 +7,10 @@ from uuid import getnode as get_mac
 from logdna import LogDNAHandler
 
 from sanic import Sanic
-from sanic.request import Request
 from sanic.response import json
+from sanic.request import Request
 
-
-log = logging.getLogger("logdna")
+log = logging.getLogger('logdna')
 log.setLevel(logging.INFO)
 
 
@@ -32,18 +30,16 @@ logdna_options = {
     "index_meta": True,
     "hostname": node(),
     "ip": get_my_ip_address(),
-    "mac": get_mac_address(),
+    "mac": get_mac_address()
 }
 
-logdna_handler = LogDNAHandler(
-    getenv("LOGDNA_API_KEY"), options=logdna_options
-)
+logdna_handler = LogDNAHandler(getenv("LOGDNA_API_KEY"), options=logdna_options)
 
 logdna = logging.getLogger(__name__)
 logdna.setLevel(logging.INFO)
 logdna.addHandler(logdna_handler)
 
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
 @app.middleware
@@ -53,8 +49,13 @@ def log_request(request: Request):
 
 @app.route("/")
 def default(request):
-    return json({"response": "I was here"})
+    return json({
+        "response": "I was here"
+    })
 
 
 if __name__ == "__main__":
-    app.run(host="0.0.0.0", port=getenv("PORT", 8080))
+    app.run(
+        host="0.0.0.0",
+        port=getenv("PORT", 8080)
+    )

examples/modify_header_example.py

@@ -2,29 +2,27 @@
 Modify header or status in response
 """
 
-from sanic import Sanic, response
+from sanic import Sanic
+from sanic import response
+
+app = Sanic(__name__)
 
 
-app = Sanic("Example")
-
-
-@app.route("/")
+@app.route('/')
 def handle_request(request):
     return response.json(
-        {"message": "Hello world!"},
-        headers={"X-Served-By": "sanic"},
-        status=200,
+        {'message': 'Hello world!'},
+        headers={'X-Served-By': 'sanic'},
+        status=200
     )
 
 
-@app.route("/unauthorized")
+@app.route('/unauthorized')
 def handle_request(request):
     return response.json(
-        {"message": "You are not authorized"},
-        headers={"X-Served-By": "sanic"},
-        status=404,
+        {'message': 'You are not authorized'},
+        headers={'X-Served-By': 'sanic'},
+        status=404
     )
 
-
-if __name__ == "__main__":
-    app.run(host="0.0.0.0", port=8000, debug=True)
+app.run(host="0.0.0.0", port=8000, debug=True)

examples/pytest_xdist.py

@@ -32,7 +32,7 @@ def test_port(worker_id):
 
 @pytest.fixture(scope="session")
 def app():
-    app = Sanic("Example")
+    app = Sanic()
 
     @app.route("/")
     async def index(request):

examples/raygun_example.py

@@ -8,6 +8,7 @@ from sanic.handlers import ErrorHandler
 
 
 class RaygunExceptionReporter(ErrorHandler):
+
     def __init__(self, raygun_api_key=None):
         super().__init__()
         if raygun_api_key is None:
@@ -21,13 +22,16 @@ class RaygunExceptionReporter(ErrorHandler):
 
 
 raygun_error_reporter = RaygunExceptionReporter()
-app = Sanic("Example", error_handler=raygun_error_reporter)
+app = Sanic(__name__, error_handler=raygun_error_reporter)
 
 
 @app.route("/raise")
 async def test(request):
-    raise SanicException("You Broke It!")
+    raise SanicException('You Broke It!')
 
 
-if __name__ == "__main__":
-    app.run(host="0.0.0.0", port=getenv("PORT", 8080))
+if __name__ == '__main__':
+    app.run(
+        host="0.0.0.0",
+        port=getenv("PORT", 8080)
+    )

examples/redirect_example.py

@@ -1,18 +1,18 @@
-from sanic import Sanic, response
+from sanic import Sanic
+from sanic import response
 
+app = Sanic(__name__)
 
-app = Sanic("Example")
-
-
-@app.route("/")
+    
+@app.route('/')
 def handle_request(request):
-    return response.redirect("/redirect")
+    return response.redirect('/redirect')
 
 
-@app.route("/redirect")
+@app.route('/redirect')
 async def test(request):
     return response.json({"Redirected": True})
 
 
-if __name__ == "__main__":
-    app.run(host="0.0.0.0", port=8000)
+if __name__ == '__main__':
+    app.run(host="0.0.0.0", port=8000)

examples/request_stream/server.py

@@ -1,63 +1,65 @@
 from sanic import Sanic
-from sanic.blueprints import Blueprint
-from sanic.response import stream, text
+from sanic.views import CompositionView
 from sanic.views import HTTPMethodView
 from sanic.views import stream as stream_decorator
+from sanic.blueprints import Blueprint
+from sanic.response import stream, text
 
-
-bp = Blueprint("bp_example")
-app = Sanic("Example")
+bp = Blueprint('blueprint_request_stream')
+app = Sanic('request_stream')
 
 
 class SimpleView(HTTPMethodView):
+
     @stream_decorator
     async def post(self, request):
-        result = ""
+        result = ''
         while True:
             body = await request.stream.get()
             if body is None:
                 break
-            result += body.decode("utf-8")
+            result += body.decode('utf-8')
         return text(result)
 
 
-@app.post("/stream", stream=True)
+@app.post('/stream', stream=True)
 async def handler(request):
     async def streaming(response):
         while True:
             body = await request.stream.get()
             if body is None:
                 break
-            body = body.decode("utf-8").replace("1", "A")
+            body = body.decode('utf-8').replace('1', 'A')
             await response.write(body)
-
     return stream(streaming)
 
 
-@bp.put("/bp_stream", stream=True)
+@bp.put('/bp_stream', stream=True)
 async def bp_handler(request):
-    result = ""
+    result = ''
     while True:
         body = await request.stream.get()
         if body is None:
             break
-        result += body.decode("utf-8").replace("1", "A")
+        result += body.decode('utf-8').replace('1', 'A')
     return text(result)
 
 
 async def post_handler(request):
-    result = ""
+    result = ''
     while True:
         body = await request.stream.get()
         if body is None:
             break
-        result += body.decode("utf-8")
+        result += body.decode('utf-8')
     return text(result)
 
-
 app.blueprint(bp)
-app.add_route(SimpleView.as_view(), "/method_view")
+app.add_route(SimpleView.as_view(), '/method_view')
+view = CompositionView()
+view.add(['POST'], post_handler, stream=True)
+app.add_route(view, '/composition_view')
 
 
-if __name__ == "__main__":
-    app.run(host="0.0.0.0", port=8000)
+if __name__ == '__main__':
+    app.run(host='0.0.0.0', port=8000)

examples/request_timeout.py

@@ -1,23 +1,21 @@
 import asyncio
-
-from sanic import Sanic, response
+from sanic import Sanic
+from sanic import response
 from sanic.config import Config
 from sanic.exceptions import RequestTimeout
 
-
 Config.REQUEST_TIMEOUT = 1
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
-@app.route("/")
+@app.route('/')
 async def test(request):
     await asyncio.sleep(3)
-    return response.text("Hello, world!")
+    return response.text('Hello, world!')
 
 
 @app.exception(RequestTimeout)
 def timeout(request, exception):
-    return response.text("RequestTimeout from error_handler.", 408)
+    return response.text('RequestTimeout from error_handler.', 408)
 
-
-app.run(host="0.0.0.0", port=8000)
+app.run(host='0.0.0.0', port=8000)

examples/rollbar_example.py

@@ -1,22 +1,21 @@
-from os import getenv
-
 import rollbar
 
+from sanic.handlers import ErrorHandler
 from sanic import Sanic
 from sanic.exceptions import SanicException
-from sanic.handlers import ErrorHandler
-
+from os import getenv
 
 rollbar.init(getenv("ROLLBAR_API_KEY"))
 
 
 class RollbarExceptionHandler(ErrorHandler):
+
     def default(self, request, exception):
         rollbar.report_message(str(exception))
         return super().default(request, exception)
 
 
-app = Sanic("Example", error_handler=RollbarExceptionHandler())
+app = Sanic(__name__, error_handler=RollbarExceptionHandler())
 
 
 @app.route("/raise")
@@ -25,4 +24,7 @@ def create_error(request):
 
 
 if __name__ == "__main__":
-    app.run(host="0.0.0.0", port=getenv("PORT", 8080))
+    app.run(
+        host="0.0.0.0",
+        port=getenv("PORT", 8080)
+    )

examples/run_asgi.py

@@ -11,7 +11,7 @@ from pathlib import Path
 from sanic import Sanic, response
 
 
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
 @app.route("/text")
@@ -59,31 +59,31 @@ async def handler_stream(request):
     return response.stream(body)
 
 
-@app.before_server_start
+@app.listener("before_server_start")
 async def listener_before_server_start(*args, **kwargs):
     print("before_server_start")
 
 
-@app.after_server_start
+@app.listener("after_server_start")
 async def listener_after_server_start(*args, **kwargs):
     print("after_server_start")
 
 
-@app.before_server_stop
+@app.listener("before_server_stop")
 async def listener_before_server_stop(*args, **kwargs):
     print("before_server_stop")
 
 
-@app.after_server_stop
+@app.listener("after_server_stop")
 async def listener_after_server_stop(*args, **kwargs):
     print("after_server_stop")
 
 
-@app.on_request
+@app.middleware("request")
 async def print_on_request(request):
     print("print_on_request")
 
 
-@app.on_response
+@app.middleware("response")
 async def print_on_response(request, response):
     print("print_on_response")

examples/run_async.py

@@ -1,30 +1,22 @@
+from sanic import Sanic
+from sanic import response
+from signal import signal, SIGINT
 import asyncio
-
 import uvloop
 
-from sanic import Sanic, response
-
-
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
 @app.route("/")
 async def test(request):
     return response.json({"answer": "42"})
 
-
-async def main():
-    server = await app.create_server(
-        port=8000, host="0.0.0.0", return_asyncio_server=True
-    )
-
-    if server is None:
-        return
-
-    await server.startup()
-    await server.serve_forever()
-
-
-if __name__ == "__main__":
-    asyncio.set_event_loop(uvloop.new_event_loop())
-    asyncio.run(main())
+asyncio.set_event_loop(uvloop.new_event_loop())
+server = app.create_server(host="0.0.0.0", port=8000, return_asyncio_server=True)
+loop = asyncio.get_event_loop()
+task = asyncio.ensure_future(server)
+signal(SIGINT, lambda s, f: loop.stop())
+try:
+    loop.run_forever()
+except:
+    loop.stop()

examples/run_async_advanced.py

@@ -8,27 +8,12 @@ from sanic import Sanic, response
 from sanic.server import AsyncioServer
 
 
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
-@app.before_server_start
-async def before_server_start(app, loop):
-    print("Async Server starting")
-
-
-@app.after_server_start
-async def after_server_start(app, loop):
-    print("Async Server started")
-
-
-@app.before_server_stop
-async def before_server_stop(app, loop):
-    print("Async Server stopping")
-
-
-@app.after_server_stop
-async def after_server_stop(app, loop):
-    print("Async Server stopped")
+@app.listener("after_server_start")
+async def after_start_test(app, loop):
+    print("Async Server Started!")
 
 
 @app.route("/")
@@ -43,20 +28,20 @@ serv_coro = app.create_server(
 loop = asyncio.get_event_loop()
 serv_task = asyncio.ensure_future(serv_coro, loop=loop)
 signal(SIGINT, lambda s, f: loop.stop())
-server: AsyncioServer = loop.run_until_complete(serv_task)
-loop.run_until_complete(server.startup())
+server: AsyncioServer = loop.run_until_complete(serv_task)  # type: ignore
+server.startup()
 
 # When using app.run(), this actually triggers before the serv_coro.
 # But, in this example, we are using the convenience method, even if it is
 # out of order.
-loop.run_until_complete(server.before_start())
-loop.run_until_complete(server.after_start())
+server.before_start()
+server.after_start()
 try:
     loop.run_forever()
 except KeyboardInterrupt:
     loop.stop()
 finally:
-    loop.run_until_complete(server.before_stop())
+    server.before_stop()
 
     # Wait for server to close
     close_task = server.close()
@@ -65,4 +50,4 @@ finally:
     # Complete all tasks on the loop
     for connection in server.connections:
         connection.close_if_idle()
-    loop.run_until_complete(server.after_stop())
+    server.after_stop()

examples/sentry_example.py

@@ -6,19 +6,20 @@ from sentry_sdk.integrations.sanic import SanicIntegration
 from sanic import Sanic
 from sanic.response import json
 
-
 sentry_init(
     dsn=getenv("SENTRY_DSN"),
     integrations=[SanicIntegration()],
 )
 
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
 # noinspection PyUnusedLocal
 @app.route("/working")
 async def working_path(request):
-    return json({"response": "Working API Response"})
+    return json({
+        "response": "Working API Response"
+    })
 
 
 # noinspection PyUnusedLocal
@@ -27,5 +28,8 @@ async def raise_error(request):
     raise Exception("Testing Sentry Integration")
 
 
-if __name__ == "__main__":
-    app.run(host="0.0.0.0", port=getenv("PORT", 8080))
+if __name__ == '__main__':
+    app.run(
+        host="0.0.0.0",
+        port=getenv("PORT", 8080)
+    )

examples/simple_async_view.py

@@ -1,41 +1,42 @@
 from sanic import Sanic
-from sanic.response import text
 from sanic.views import HTTPMethodView
+from sanic.response import text
 
-
-app = Sanic("some_name")
+app = Sanic('some_name')
 
 
 class SimpleView(HTTPMethodView):
+
     def get(self, request):
-        return text("I am get method")
+        return text('I am get method')
 
     def post(self, request):
-        return text("I am post method")
+        return text('I am post method')
 
     def put(self, request):
-        return text("I am put method")
+        return text('I am put method')
 
     def patch(self, request):
-        return text("I am patch method")
+        return text('I am patch method')
 
     def delete(self, request):
-        return text("I am delete method")
+        return text('I am delete method')
 
 
 class SimpleAsyncView(HTTPMethodView):
+
     async def get(self, request):
-        return text("I am async get method")
+        return text('I am async get method')
 
     async def post(self, request):
-        return text("I am async post method")
+        return text('I am async post method')
 
     async def put(self, request):
-        return text("I am async put method")
+        return text('I am async put method')
 
 
-app.add_route(SimpleView.as_view(), "/")
-app.add_route(SimpleAsyncView.as_view(), "/async")
+app.add_route(SimpleView.as_view(), '/')
+app.add_route(SimpleAsyncView.as_view(), '/async')
 
-if __name__ == "__main__":
+if __name__ == '__main__':
     app.run(host="0.0.0.0", port=8000, debug=True)

examples/simple_server.py

@@ -1,7 +1,7 @@
-from sanic import Sanic, response
+from sanic import Sanic
+from sanic import response
 
-
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
 @app.route("/")
@@ -9,5 +9,5 @@ async def test(request):
     return response.json({"test": True})
 
 
-if __name__ == "__main__":
+if __name__ == '__main__':
     app.run(host="0.0.0.0", port=8000)

examples/static_assets.py

@@ -1,6 +1,6 @@
 from sanic import Sanic
 
 
-app = Sanic("Example")
+app = Sanic(__name__)
 
 app.static("/", "./static")

examples/teapot.py

@@ -1,14 +1,13 @@
 from sanic import Sanic
 from sanic import response as res
 
-
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
 @app.route("/")
 async def test(req):
-    return res.text("I'm a teapot", status=418)
+    return res.text("I\'m a teapot", status=418)
 
 
-if __name__ == "__main__":
+if __name__ == '__main__':
     app.run(host="0.0.0.0", port=8000)

examples/try_everything.py

@@ -1,11 +1,11 @@
 import os
 
-from sanic import Sanic, response
-from sanic.exceptions import ServerError
+from sanic import Sanic
 from sanic.log import logger as log
+from sanic import response
+from sanic.exceptions import ServerError
 
-
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
 @app.route("/")
@@ -13,7 +13,7 @@ async def test_async(request):
     return response.json({"test": True})
 
 
-@app.route("/sync", methods=["GET", "POST"])
+@app.route("/sync", methods=['GET', 'POST'])
 def test_sync(request):
     return response.json({"test": True})
 
@@ -31,7 +31,6 @@ def exception(request):
 @app.route("/await")
 async def test_await(request):
     import asyncio
-
     await asyncio.sleep(5)
     return response.text("I'm feeling sleepy")
 
@@ -43,10 +42,8 @@ async def test_file(request):
 
 @app.route("/file_stream")
 async def test_file_stream(request):
-    return await response.file_stream(
-        os.path.abspath("setup.py"), chunk_size=1024
-    )
-
+    return await response.file_stream(os.path.abspath("setup.py"),
+                                      chunk_size=1024)
 
 # ----------------------------------------------- #
 # Exceptions
@@ -55,17 +52,14 @@ async def test_file_stream(request):
 
 @app.exception(ServerError)
 async def test(request, exception):
-    return response.json(
-        {"exception": str(exception), "status": exception.status_code},
-        status=exception.status_code,
-    )
+    return response.json({"exception": "{}".format(exception), "status": exception.status_code},
+                         status=exception.status_code)
 
 
 # ----------------------------------------------- #
 # Read from request
 # ----------------------------------------------- #
 
-
 @app.route("/json")
 def post_json(request):
     return response.json({"received": True, "message": request.json})
@@ -73,51 +67,38 @@ def post_json(request):
 
 @app.route("/form")
 def post_form_json(request):
-    return response.json(
-        {
-            "received": True,
-            "form_data": request.form,
-            "test": request.form.get("test"),
-        }
-    )
+    return response.json({"received": True, "form_data": request.form, "test": request.form.get('test')})
 
 
 @app.route("/query_string")
 def query_string(request):
-    return response.json(
-        {
-            "parsed": True,
-            "args": request.args,
-            "url": request.url,
-            "query_string": request.query_string,
-        }
-    )
+    return response.json({"parsed": True, "args": request.args, "url": request.url,
+                          "query_string": request.query_string})
 
 
 # ----------------------------------------------- #
 # Run Server
 # ----------------------------------------------- #
 
-
-@app.before_server_start
+@app.listener('before_server_start')
 def before_start(app, loop):
     log.info("SERVER STARTING")
 
 
-@app.after_server_start
+@app.listener('after_server_start')
 def after_start(app, loop):
     log.info("OH OH OH OH OHHHHHHHH")
 
 
-@app.before_server_stop
+@app.listener('before_server_stop')
 def before_stop(app, loop):
     log.info("SERVER STOPPING")
 
 
-@app.after_server_stop
+@app.listener('after_server_stop')
 def after_stop(app, loop):
     log.info("TRIED EVERYTHING")
 
 
-if __name__ == "__main__":
+if __name__ == '__main__':
     app.run(host="0.0.0.0", port=8000, debug=True)

examples/unix_socket.py

@@ -1,13 +1,23 @@
-from sanic import Sanic, response
+from sanic import Sanic
+from sanic import response
+import socket
+import os
 
-
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
 @app.route("/test")
 async def test(request):
     return response.text("OK")
 
-
-if __name__ == "__main__":
-    app.run(unix="./uds_socket")
+if __name__ == '__main__':
+    server_address = './uds_socket'
+    # Make sure the socket does not already exist
+    try:
+            os.unlink(server_address)
+    except OSError:
+            if os.path.exists(server_address):
+                        raise
+    sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+    sock.bind(server_address)
+    app.run(sock=sock)

examples/url_for_example.py

@@ -1,21 +1,20 @@
-from sanic import Sanic, response
+from sanic import Sanic
+from sanic import response
+
+app = Sanic(__name__)
 
 
-app = Sanic("Example")
-
-
-@app.route("/")
+@app.route('/')
 async def index(request):
     # generate a URL for the endpoint `post_handler`
-    url = app.url_for("post_handler", post_id=5)
+    url = app.url_for('post_handler', post_id=5)
     # the URL is `/posts/5`, redirect to it
     return response.redirect(url)
 
 
-@app.route("/posts/<post_id>")
+@app.route('/posts/<post_id>')
 async def post_handler(request, post_id):
-    return response.text("Post - {}".format(post_id))
-
-
-if __name__ == "__main__":
+    return response.text('Post - {}'.format(post_id))
+    
+if __name__ == '__main__':
     app.run(host="0.0.0.0", port=8000, debug=True)

examples/versioned_blueprint_group.py

@@ -8,9 +8,7 @@ app = Sanic(name="blue-print-group-version-example")
 bp1 = Blueprint(name="ultron", url_prefix="/ultron")
 bp2 = Blueprint(name="vision", url_prefix="/vision", strict_slashes=None)
 
-bpg = Blueprint.group(
-    bp1, bp2, url_prefix="/sentient/robot", version=1, strict_slashes=True
-)
+bpg = Blueprint.group([bp1, bp2], url_prefix="/sentient/robot", version=1, strict_slashes=True)
 
 
 @bp1.get("/name")
@@ -33,5 +31,5 @@ async def bp2_revised_name(request):
 
 app.blueprint(bpg)
 
-if __name__ == "__main__":
+if __name__ == '__main__':
     app.run(host="0.0.0.0", port=8000)

examples/vhosts.py

@@ -8,7 +8,7 @@ from sanic.blueprints import Blueprint
 # curl -H "Host: bp.example.com" localhost:8000/question
 # curl -H "Host: bp.example.com" localhost:8000/answer
 
-app = Sanic("Example")
+app = Sanic(__name__)
 bp = Blueprint("bp", host="bp.example.com")
 
 

examples/websocket.py

@@ -1,27 +1,25 @@
 from sanic import Sanic
 from sanic.response import redirect
 
-
-app = Sanic("Example")
+app = Sanic(__name__)
 
 
-app.static("index.html", "websocket.html")
+app.static('index.html', "websocket.html")
 
-
-@app.route("/")
+@app.route('/')
 def index(request):
     return redirect("index.html")
 
-
-@app.websocket("/feed")
+@app.websocket('/feed')
 async def feed(request, ws):
     while True:
-        data = "hello!"
-        print("Sending: " + data)
+        data = 'hello!'
+        print('Sending: ' + data)
         await ws.send(data)
         data = await ws.recv()
-        print("Received: " + data)
+        print('Received: ' + data)
 
 
-if __name__ == "__main__":
+if __name__ == '__main__':
     app.run(host="0.0.0.0", port=8000, debug=True)
+

hack/Dockerfile

@@ -0,0 +1,6 @@
+FROM catthehacker/ubuntu:act-latest
+SHELL [ "/bin/bash", "-c" ]
+ENTRYPOINT []
+RUN apt-get update
+RUN apt-get install gcc -y
+RUN apt-get install -y --no-install-recommends g++

pyproject.toml

@@ -1,29 +1,3 @@
 [build-system]
-requires = ["setuptools<60.0", "wheel"]
+requires = ["setuptools", "wheel"]
 build-backend = "setuptools.build_meta"
-
-[tool.black]
-line-length = 79
-
-[tool.isort]
-atomic = true
-default_section = "THIRDPARTY"
-include_trailing_comma = true
-known_first_party = "sanic"
-known_third_party = "pytest"
-line_length = 79
-lines_after_imports = 2
-lines_between_types = 1
-multi_line_output = 3
-profile = "black"
-
-[[tool.mypy.overrides]]
-module = [
-    "httptools.*",
-    "trustme.*",
-    "sanic_routing.*",
-    "aioquic.*",
-    "html5tagger.*",
-    "tracerite.*",
-]
-ignore_missing_imports = true

readthedocs.yml

@@ -6,4 +6,4 @@ python:
         path: .
         extra_requirements:
             - docs
-   system_packages: true
+   system_packages: true

sanic/__init__.py

@@ -3,16 +3,7 @@ from sanic.app import Sanic
 from sanic.blueprints import Blueprint
 from sanic.constants import HTTPMethod
 from sanic.request import Request
-from sanic.response import (
-    HTTPResponse,
-    empty,
-    file,
-    html,
-    json,
-    redirect,
-    text,
-)
-from sanic.server.websockets.impl import WebsocketImplProtocol as Websocket
+from sanic.response import HTTPResponse, html, json, text
 
 
 __all__ = (
@@ -22,11 +13,7 @@ __all__ = (
     "HTTPMethod",
     "HTTPResponse",
     "Request",
-    "Websocket",
-    "empty",
-    "file",
     "html",
     "json",
-    "redirect",
     "text",
 )

sanic/__main__.py

@@ -1,15 +1,196 @@
-from sanic.cli.app import SanicCLI
-from sanic.compat import OS_IS_WINDOWS, enable_windows_color_support
+import os
+import sys
+
+from argparse import ArgumentParser, RawTextHelpFormatter
+from importlib import import_module
+from pathlib import Path
+from typing import Any, Dict, Optional
+
+from sanic_routing import __version__ as __routing_version__  # type: ignore
+
+from sanic import __version__
+from sanic.app import Sanic
+from sanic.config import BASE_LOGO
+from sanic.log import error_logger
+from sanic.simple import create_simple_server
 
 
-if OS_IS_WINDOWS:
-    enable_windows_color_support()
+class SanicArgumentParser(ArgumentParser):
+    def add_bool_arguments(self, *args, **kwargs):
+        group = self.add_mutually_exclusive_group()
+        group.add_argument(*args, action="store_true", **kwargs)
+        kwargs["help"] = f"no {kwargs['help']}\n "
+        group.add_argument(
+            "--no-" + args[0][2:], *args[1:], action="store_false", **kwargs
+        )
 
 
-def main(args=None):
-    cli = SanicCLI()
-    cli.attach()
-    cli.run(args)
+def main():
+    parser = SanicArgumentParser(
+        prog="sanic",
+        description=BASE_LOGO,
+        formatter_class=lambda prog: RawTextHelpFormatter(
+            prog, max_help_position=33
+        ),
+    )
+    parser.add_argument(
+        "-v",
+        "--version",
+        action="version",
+        version=f"Sanic {__version__}; Routing {__routing_version__}",
+    )
+    parser.add_argument(
+        "--factory",
+        action="store_true",
+        help=(
+            "Treat app as an application factory, "
+            "i.e. a () -> <Sanic app> callable"
+        ),
+    )
+    parser.add_argument(
+        "-s",
+        "--simple",
+        dest="simple",
+        action="store_true",
+        help="Run Sanic as a Simple Server (module arg should be a path)\n ",
+    )
+    parser.add_argument(
+        "-H",
+        "--host",
+        dest="host",
+        type=str,
+        default="127.0.0.1",
+        help="Host address [default 127.0.0.1]",
+    )
+    parser.add_argument(
+        "-p",
+        "--port",
+        dest="port",
+        type=int,
+        default=8000,
+        help="Port to serve on [default 8000]",
+    )
+    parser.add_argument(
+        "-u",
+        "--unix",
+        dest="unix",
+        type=str,
+        default="",
+        help="location of unix socket\n ",
+    )
+    parser.add_argument(
+        "--cert", dest="cert", type=str, help="Location of certificate for SSL"
+    )
+    parser.add_argument(
+        "--key", dest="key", type=str, help="location of keyfile for SSL\n "
+    )
+    parser.add_bool_arguments(
+        "--access-logs", dest="access_log", help="display access logs"
+    )
+    parser.add_argument(
+        "-w",
+        "--workers",
+        dest="workers",
+        type=int,
+        default=1,
+        help="number of worker processes [default 1]\n ",
+    )
+    parser.add_argument("-d", "--debug", dest="debug", action="store_true")
+    parser.add_argument(
+        "-r",
+        "--reload",
+        "--auto-reload",
+        dest="auto_reload",
+        action="store_true",
+        help="Watch source directory for file changes and reload on changes",
+    )
+    parser.add_argument(
+        "-R",
+        "--reload-dir",
+        dest="path",
+        action="append",
+        help="Extra directories to watch and reload on changes\n ",
+    )
+    parser.add_argument(
+        "module",
+        help=(
+            "Path to your Sanic app. Example: path.to.server:app\n"
+            "If running a Simple Server, path to directory to serve. "
+            "Example: ./\n"
+        ),
+    )
+    args = parser.parse_args()
+
+    try:
+        module_path = os.path.abspath(os.getcwd())
+        if module_path not in sys.path:
+            sys.path.append(module_path)
+
+        if args.simple:
+            path = Path(args.module)
+            app = create_simple_server(path)
+        else:
+            delimiter = ":" if ":" in args.module else "."
+            module_name, app_name = args.module.rsplit(delimiter, 1)
+
+            if app_name.endswith("()"):
+                args.factory = True
+                app_name = app_name[:-2]
+
+            module = import_module(module_name)
+            app = getattr(module, app_name, None)
+            if args.factory:
+                app = app()
+
+            app_type_name = type(app).__name__
+
+            if not isinstance(app, Sanic):
+                raise ValueError(
+                    f"Module is not a Sanic app, it is a {app_type_name}.  "
+                    f"Perhaps you meant {args.module}.app?"
+                )
+        if args.cert is not None or args.key is not None:
+            ssl: Optional[Dict[str, Any]] = {
+                "cert": args.cert,
+                "key": args.key,
+            }
+        else:
+            ssl = None
+
+        kwargs = {
+            "host": args.host,
+            "port": args.port,
+            "unix": args.unix,
+            "workers": args.workers,
+            "debug": args.debug,
+            "access_log": args.access_log,
+            "ssl": ssl,
+        }
+        if args.auto_reload:
+            kwargs["auto_reload"] = True
+
+        if args.path:
+            if args.auto_reload or args.debug:
+                kwargs["reload_dir"] = args.path
+            else:
+                error_logger.warning(
+                    "Ignoring '--reload-dir' since auto reloading was not "
+                    "enabled. If you would like to watch directories for "
+                    "changes, consider using --debug or --auto-reload."
+                )
+
+        app.run(**kwargs)
+    except ImportError as e:
+        if module_name.startswith(e.name):
+            error_logger.error(
+                f"No module named {e.name} found.\n"
+                "  Example File: project/sanic_server.py -> app\n"
+                "  Example Module: project.sanic_server.app"
+            )
+        else:
+            raise e
+    except ValueError:
+        error_logger.exception("Failed to run app")
 
 
 if __name__ == "__main__":

sanic/__version__.py

@@ -1,10 +1 @@
-__version__ = "23.3.0"
-__compatibility__ = "22.12"
-
-from inspect import currentframe, stack
-
-for frame_info in stack():
-    if frame_info.frame is not currentframe():
-        value = frame_info.frame.f_globals.get("__SANIC_COMPATIBILITY__")
-        if value:
-            __compatibility__ = value
+__version__ = "21.9.3"

sanic/application/constants.py

@@ -1,32 +0,0 @@
-from enum import Enum, IntEnum, auto
-
-
-class StrEnum(str, Enum):  # no cov
-    def _generate_next_value_(name: str, *args) -> str:  # type: ignore
-        return name.lower()
-
-    def __eq__(self, value: object) -> bool:
-        value = str(value).upper()
-        return super().__eq__(value)
-
-    def __hash__(self) -> int:
-        return hash(self.value)
-
-    def __str__(self) -> str:
-        return self.value
-
-
-class Server(StrEnum):
-    SANIC = auto()
-    ASGI = auto()
-
-
-class Mode(StrEnum):
-    PRODUCTION = auto()
-    DEBUG = auto()
-
-
-class ServerStage(IntEnum):
-    STOPPED = auto()
-    PARTIAL = auto()
-    SERVING = auto()

sanic/application/ext.py

@@ -1,34 +0,0 @@
-from __future__ import annotations
-
-from contextlib import suppress
-from importlib import import_module
-from typing import TYPE_CHECKING
-
-
-if TYPE_CHECKING:
-    from sanic import Sanic
-
-
-def setup_ext(app: Sanic, *, fail: bool = False, **kwargs):
-    if not app.config.AUTO_EXTEND:
-        return
-
-    sanic_ext = None
-    with suppress(ModuleNotFoundError):
-        sanic_ext = import_module("sanic_ext")
-
-    if not sanic_ext:  # no cov
-        if fail:
-            raise RuntimeError(
-                "Sanic Extensions is not installed. You can add it to your "
-                "environment using:\n$ pip install sanic[ext]\nor\n$ pip "
-                "install sanic-ext"
-            )
-
-        return
-
-    if not getattr(app, "_ext", None):
-        Ext = getattr(sanic_ext, "Extend")
-        app._ext = Ext(app, **kwargs)
-
-        return app.ext

sanic/application/logo.py

@@ -1,61 +0,0 @@
-import re
-import sys
-
-from os import environ
-
-from sanic.compat import is_atty
-
-
-BASE_LOGO = """
-
-                 Sanic
-         Build Fast. Run Fast.
-
-"""
-COFFEE_LOGO = """\033[48;2;255;13;104m                     \033[0m
-\033[38;2;255;255;255;48;2;255;13;104m     ▄████████▄      \033[0m
-\033[38;2;255;255;255;48;2;255;13;104m    ██       ██▀▀▄   \033[0m
-\033[38;2;255;255;255;48;2;255;13;104m    ███████████  █   \033[0m
-\033[38;2;255;255;255;48;2;255;13;104m    ███████████▄▄▀   \033[0m
-\033[38;2;255;255;255;48;2;255;13;104m     ▀███████▀       \033[0m
-\033[48;2;255;13;104m                     \033[0m
-Dark roast. No sugar."""
-
-COLOR_LOGO = """\033[48;2;255;13;104m                     \033[0m
-\033[38;2;255;255;255;48;2;255;13;104m    ▄███ █████ ██    \033[0m
-\033[38;2;255;255;255;48;2;255;13;104m   ██                \033[0m
-\033[38;2;255;255;255;48;2;255;13;104m    ▀███████ ███▄    \033[0m
-\033[38;2;255;255;255;48;2;255;13;104m                ██   \033[0m
-\033[38;2;255;255;255;48;2;255;13;104m   ████ ████████▀    \033[0m
-\033[48;2;255;13;104m                     \033[0m
-Build Fast. Run Fast."""
-
-FULL_COLOR_LOGO = """
-
-\033[38;2;255;13;104m  ▄███ █████ ██ \033[0m     ▄█▄      ██       █   █   ▄██████████
-\033[38;2;255;13;104m ██             \033[0m    █   █     █ ██     █   █  ██
-\033[38;2;255;13;104m  ▀███████ ███▄ \033[0m   ▀     █    █   ██   ▄   █  ██
-\033[38;2;255;13;104m              ██\033[0m  █████████   █     ██ █   █  ▄▄
-\033[38;2;255;13;104m ████ ████████▀ \033[0m █         █  █       ██   █   ▀██ ███████
-
-"""  # noqa
-
-SVG_LOGO_SIMPLE = """<svg id=logo-simple viewBox="0 0 964 279"><desc>Sanic</desc><path d="M107 222c9-2 10-20 1-22s-20-2-30-2-17 7-16 14 6 10 15 10h30zm115-1c16-2 30-11 35-23s6-24 2-33-6-14-15-20-24-11-38-10c-7 3-10 13-5 19s17-1 24 4 15 14 13 24-5 15-14 18-50 0-74 0h-17c-6 4-10 15-4 20s16 2 23 3zM251 83q9-1 9-7 0-15-10-16h-13c-10 6-10 20 0 22zM147 60c-4 0-10 3-11 11s5 13 10 12 42 0 67 0c5-3 7-10 6-15s-4-8-9-8zm-33 1c-8 0-16 0-24 3s-20 10-25 20-6 24-4 36 15 22 26 27 78 8 94 3c4-4 4-12 0-18s-69 8-93-10c-8-7-9-23 0-30s12-10 20-10 12 2 16-3 1-15-5-18z" fill="#ff0d68"/><path d="M676 74c0-14-18-9-20 0s0 30 0 39 20 9 20 2zm-297-10c-12 2-15 12-23 23l-41 58H340l22-30c8-12 23-13 30-4s20 24 24 38-10 10-17 10l-68 2q-17 1-48 30c-7 6-10 20 0 24s15-8 20-13 20 -20 58-21h50 c20 2 33 9 52 30 8 10 24-4 16-13L384 65q-3-2-5-1zm131 0c-10 1-12 12-11 20v96c1 10-3 23 5 32s20-5 17-15c0-23-3-46 2-67 5-12 22-14 32-5l103 87c7 5 19 1 18-9v-64c-3-10-20-9-21 2s-20 22-30 13l-97-80c-5-4-10-10-18-10zM701 76v128c2 10 15 12 20 4s0-102 0-124s-20-18-20-7z M850 63c-35 0-69-2-86 15s-20 60-13 66 13 8 16 0 1-10 1-27 12-26 20-32 66-5 85-5 31 4 31-10-18-7-54-7M764 159c-6-2-15-2-16 12s19 37 33 43 23 8 25-4-4-11-11-14q-9-3-22-18c-4-7-3-16-10-19zM828 196c-4 0-8 1-10 5s-4 12 0 15 8 2 12 2h60c5 0 10-2 12-6 3-7-1-16-8-16z" fill="#1f1f1f"/></svg>"""  # noqa
-
-ansi_pattern = re.compile(r"\x1B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])")
-
-
-def get_logo(full=False, coffee=False):
-    logo = (
-        (FULL_COLOR_LOGO if full else (COFFEE_LOGO if coffee else COLOR_LOGO))
-        if is_atty()
-        else BASE_LOGO
-    )
-
-    if (
-        sys.platform == "darwin"
-        and environ.get("TERM_PROGRAM") == "Apple_Terminal"
-    ):
-        logo = ansi_pattern.sub("", logo)
-
-    return logo

sanic/application/motd.py

@@ -1,145 +0,0 @@
-from abc import ABC, abstractmethod
-from shutil import get_terminal_size
-from textwrap import indent, wrap
-from typing import Dict, Optional
-
-from sanic import __version__
-from sanic.compat import is_atty
-from sanic.log import logger
-
-
-class MOTD(ABC):
-    def __init__(
-        self,
-        logo: Optional[str],
-        serve_location: str,
-        data: Dict[str, str],
-        extra: Dict[str, str],
-    ) -> None:
-        self.logo = logo
-        self.serve_location = serve_location
-        self.data = data
-        self.extra = extra
-        self.key_width = 0
-        self.value_width = 0
-
-    @abstractmethod
-    def display(self):
-        ...  # noqa
-
-    @classmethod
-    def output(
-        cls,
-        logo: Optional[str],
-        serve_location: str,
-        data: Dict[str, str],
-        extra: Dict[str, str],
-    ) -> None:
-        motd_class = MOTDTTY if is_atty() else MOTDBasic
-        motd_class(logo, serve_location, data, extra).display()
-
-
-class MOTDBasic(MOTD):
-    def display(self):
-        if self.logo:
-            logger.debug(self.logo)
-        lines = [f"Sanic v{__version__}"]
-        if self.serve_location:
-            lines.append(f"Goin' Fast @ {self.serve_location}")
-        lines += [
-            *(f"{key}: {value}" for key, value in self.data.items()),
-            *(f"{key}: {value}" for key, value in self.extra.items()),
-        ]
-        for line in lines:
-            logger.info(line)
-
-
-class MOTDTTY(MOTD):
-    def __init__(self, *args, **kwargs) -> None:
-        super().__init__(*args, **kwargs)
-        self.set_variables()
-
-    def set_variables(self):  # no  cov
-        fallback = (108, 24)
-        terminal_width = max(
-            get_terminal_size(fallback=fallback).columns, fallback[0]
-        )
-        self.max_value_width = terminal_width - fallback[0] + 36
-
-        self.key_width = 4
-        self.value_width = self.max_value_width
-        if self.data:
-            self.key_width = max(map(len, self.data.keys()))
-            self.value_width = min(
-                max(map(len, self.data.values())), self.max_value_width
-            )
-        self.logo_lines = self.logo.split("\n") if self.logo else []
-        self.logo_line_length = 24
-        self.centering_length = (
-            self.key_width + self.value_width + 2 + self.logo_line_length
-        )
-        self.display_length = self.key_width + self.value_width + 2
-
-    def display(self, version=True, action="Goin' Fast", out=None):
-        if not out:
-            out = logger.info
-        header = "Sanic"
-        if version:
-            header += f" v{__version__}"
-        header = header.center(self.centering_length)
-        running = (
-            f"{action} @ {self.serve_location}" if self.serve_location else ""
-        ).center(self.centering_length)
-        length = len(header) + 2 - self.logo_line_length
-        first_filler = "─" * (self.logo_line_length - 1)
-        second_filler = "─" * length
-        display_filler = "─" * (self.display_length + 2)
-        lines = [
-            f"\n┌{first_filler}─{second_filler}┐",
-            f"│ {header} │",
-            f"│ {running} │",
-            f"├{first_filler}┬{second_filler}┤",
-        ]
-
-        self._render_data(lines, self.data, 0)
-        if self.extra:
-            logo_part = self._get_logo_part(len(lines) - 4)
-            lines.append(f"| {logo_part} ├{display_filler}┤")
-            self._render_data(lines, self.extra, len(lines) - 4)
-
-        self._render_fill(lines)
-
-        lines.append(f"└{first_filler}┴{second_filler}┘\n")
-        out(indent("\n".join(lines), "  "))
-
-    def _render_data(self, lines, data, start):
-        offset = 0
-        for idx, (key, value) in enumerate(data.items(), start=start):
-            key = key.rjust(self.key_width)
-
-            wrapped = wrap(value, self.max_value_width, break_on_hyphens=False)
-            for wrap_index, part in enumerate(wrapped):
-                part = part.ljust(self.value_width)
-                logo_part = self._get_logo_part(idx + offset + wrap_index)
-                display = (
-                    f"{key}: {part}"
-                    if wrap_index == 0
-                    else (" " * len(key) + f"  {part}")
-                )
-                lines.append(f"│ {logo_part} │ {display} │")
-                if wrap_index:
-                    offset += 1
-
-    def _render_fill(self, lines):
-        filler = " " * self.display_length
-        idx = len(lines) - 5
-        for i in range(1, len(self.logo_lines) - idx):
-            logo_part = self.logo_lines[idx + i]
-            lines.append(f"│ {logo_part} │ {filler} │")
-
-    def _get_logo_part(self, idx):
-        try:
-            logo_part = self.logo_lines[idx]
-        except IndexError:
-            logo_part = " " * (self.logo_line_length - 3)
-        return logo_part

sanic/application/spinner.py

@@ -1,86 +0,0 @@
-import os
-import sys
-import time
-
-from contextlib import contextmanager
-from queue import Queue
-from threading import Thread
-
-
-if os.name == "nt":  # noqa
-    import ctypes  # noqa
-
-    class _CursorInfo(ctypes.Structure):
-        _fields_ = [("size", ctypes.c_int), ("visible", ctypes.c_byte)]
-
-
-class Spinner:  # noqa
-    def __init__(self, message: str) -> None:
-        self.message = message
-        self.queue: Queue[int] = Queue()
-        self.spinner = self.cursor()
-        self.thread = Thread(target=self.run)
-
-    def start(self):
-        self.queue.put(1)
-        self.thread.start()
-        self.hide()
-
-    def run(self):
-        while self.queue.get():
-            output = f"\r{self.message} [{next(self.spinner)}]"
-            sys.stdout.write(output)
-            sys.stdout.flush()
-            time.sleep(0.1)
-            self.queue.put(1)
-
-    def stop(self):
-        self.queue.put(0)
-        self.thread.join()
-        self.show()
-
-    @staticmethod
-    def cursor():
-        while True:
-            for cursor in "|/-\\":
-                yield cursor
-
-    @staticmethod
-    def hide():
-        if os.name == "nt":
-            ci = _CursorInfo()
-            handle = ctypes.windll.kernel32.GetStdHandle(-11)
-            ctypes.windll.kernel32.GetConsoleCursorInfo(
-                handle, ctypes.byref(ci)
-            )
-            ci.visible = False
-            ctypes.windll.kernel32.SetConsoleCursorInfo(
-                handle, ctypes.byref(ci)
-            )
-        elif os.name == "posix":
-            sys.stdout.write("\033[?25l")
-            sys.stdout.flush()
-
-    @staticmethod
-    def show():
-        if os.name == "nt":
-            ci = _CursorInfo()
-            handle = ctypes.windll.kernel32.GetStdHandle(-11)
-            ctypes.windll.kernel32.GetConsoleCursorInfo(
-                handle, ctypes.byref(ci)
-            )
-            ci.visible = True
-            ctypes.windll.kernel32.SetConsoleCursorInfo(
-                handle, ctypes.byref(ci)
-            )
-        elif os.name == "posix":
-            sys.stdout.write("\033[?25h")
-            sys.stdout.flush()
-
-
-@contextmanager
-def loading(message: str = "Loading"):  # noqa
-    spinner = Spinner(message)
-    spinner.start()
-    yield
-    spinner.stop()

sanic/application/state.py

@@ -1,91 +0,0 @@
-from __future__ import annotations
-
-import logging
-
-from dataclasses import dataclass, field
-from pathlib import Path
-from socket import socket
-from ssl import SSLContext
-from typing import TYPE_CHECKING, Any, Dict, List, Optional, Set, Union
-
-from sanic.application.constants import Mode, Server, ServerStage
-from sanic.log import VerbosityFilter, logger
-from sanic.server.async_server import AsyncioServer
-
-
-if TYPE_CHECKING:
-    from sanic import Sanic
-
-
-@dataclass
-class ApplicationServerInfo:
-    settings: Dict[str, Any]
-    stage: ServerStage = field(default=ServerStage.STOPPED)
-    server: Optional[AsyncioServer] = field(default=None)
-
-
-@dataclass
-class ApplicationState:
-    app: Sanic
-    asgi: bool = field(default=False)
-    coffee: bool = field(default=False)
-    fast: bool = field(default=False)
-    host: str = field(default="")
-    port: int = field(default=0)
-    ssl: Optional[SSLContext] = field(default=None)
-    sock: Optional[socket] = field(default=None)
-    unix: Optional[str] = field(default=None)
-    mode: Mode = field(default=Mode.PRODUCTION)
-    reload_dirs: Set[Path] = field(default_factory=set)
-    auto_reload: bool = field(default=False)
-    server: Server = field(default=Server.SANIC)
-    is_running: bool = field(default=False)
-    is_started: bool = field(default=False)
-    is_stopping: bool = field(default=False)
-    verbosity: int = field(default=0)
-    workers: int = field(default=0)
-    primary: bool = field(default=True)
-    server_info: List[ApplicationServerInfo] = field(default_factory=list)
-
-    # This property relates to the ApplicationState instance and should
-    # not be changed except in the __post_init__ method
-    _init: bool = field(default=False)
-
-    def __post_init__(self) -> None:
-        self._init = True
-
-    def __setattr__(self, name: str, value: Any) -> None:
-        if self._init and name == "_init":
-            raise RuntimeError(
-                "Cannot change the value of _init after instantiation"
-            )
-        super().__setattr__(name, value)
-        if self._init and hasattr(self, f"set_{name}"):
-            getattr(self, f"set_{name}")(value)
-
-    def set_mode(self, value: Union[str, Mode]):
-        if hasattr(self.app, "error_handler"):
-            self.app.error_handler.debug = self.app.debug
-        if getattr(self.app, "configure_logging", False) and self.app.debug:
-            logger.setLevel(logging.DEBUG)
-
-    def set_verbosity(self, value: int):
-        VerbosityFilter.verbosity = value
-
-    @property
-    def is_debug(self):
-        return self.mode is Mode.DEBUG
-
-    @property
-    def stage(self) -> ServerStage:
-        if not self.server_info:
-            return ServerStage.STOPPED
-
-        if all(info.stage is ServerStage.SERVING for info in self.server_info):
-            return ServerStage.SERVING
-        elif any(
-            info.stage is ServerStage.SERVING for info in self.server_info
-        ):
-            return ServerStage.PARTIAL
-
-        return ServerStage.STOPPED

sanic/asgi.py

@@ -1,51 +1,41 @@
-from __future__ import annotations
-
 import warnings
 
-from typing import TYPE_CHECKING, Optional
+from typing import Optional
 from urllib.parse import quote
 
+import sanic.app  # noqa
+
 from sanic.compat import Header
 from sanic.exceptions import ServerError
-from sanic.helpers import Default
-from sanic.http import Stage
-from sanic.log import error_logger, logger
 from sanic.models.asgi import ASGIReceive, ASGIScope, ASGISend, MockTransport
 from sanic.request import Request
-from sanic.response import BaseHTTPResponse
 from sanic.server import ConnInfo
 from sanic.server.websockets.connection import WebSocketConnection
 
 
-if TYPE_CHECKING:
-    from sanic import Sanic
-
-
 class Lifespan:
-    def __init__(self, asgi_app: ASGIApp) -> None:
+    def __init__(self, asgi_app: "ASGIApp") -> None:
         self.asgi_app = asgi_app
 
         if (
             "server.init.before"
             in self.asgi_app.sanic_app.signal_router.name_index
         ):
-            logger.debug(
+            warnings.warn(
                 'You have set a listener for "before_server_start" '
                 "in ASGI mode. "
                 "It will be executed as early as possible, but not before "
-                "the ASGI server is started.",
-                extra={"verbosity": 1},
+                "the ASGI server is started."
             )
         if (
             "server.shutdown.after"
             in self.asgi_app.sanic_app.signal_router.name_index
         ):
-            logger.debug(
+            warnings.warn(
                 'You have set a listener for "after_server_stop" '
                 "in ASGI mode. "
                 "It will be executed as late as possible, but not after "
-                "the ASGI server is stopped.",
-                extra={"verbosity": 1},
+                "the ASGI server is stopped."
             )
 
     async def startup(self) -> None:
@@ -61,13 +51,6 @@ class Lifespan:
         await self.asgi_app.sanic_app._server_event("init", "before")
         await self.asgi_app.sanic_app._server_event("init", "after")
 
-        if not isinstance(self.asgi_app.sanic_app.config.USE_UVLOOP, Default):
-            warnings.warn(
-                "You have set the USE_UVLOOP configuration option, but Sanic "
-                "cannot control the event loop when running in ASGI mode."
-                "This option will be ignored."
-            )
-
     async def shutdown(self) -> None:
         """
         Gather the listeners to fire on server stop.
@@ -85,37 +68,21 @@ class Lifespan:
     ) -> None:
         message = await receive()
         if message["type"] == "lifespan.startup":
-            try:
-                await self.startup()
-            except Exception as e:
-                error_logger.exception(e)
-                await send(
-                    {"type": "lifespan.startup.failed", "message": str(e)}
-                )
-            else:
-                await send({"type": "lifespan.startup.complete"})
+            await self.startup()
+            await send({"type": "lifespan.startup.complete"})
 
         message = await receive()
         if message["type"] == "lifespan.shutdown":
-            try:
-                await self.shutdown()
-            except Exception as e:
-                error_logger.exception(e)
-                await send(
-                    {"type": "lifespan.shutdown.failed", "message": str(e)}
-                )
-            else:
-                await send({"type": "lifespan.shutdown.complete"})
+            await self.shutdown()
+            await send({"type": "lifespan.shutdown.complete"})
 
 
 class ASGIApp:
-    sanic_app: Sanic
+    sanic_app: "sanic.app.Sanic"
     request: Request
     transport: MockTransport
     lifespan: Lifespan
     ws: Optional[WebSocketConnection]
-    stage: Stage
-    response: Optional[BaseHTTPResponse]
 
     def __init__(self) -> None:
         self.ws = None
@@ -128,8 +95,6 @@ class ASGIApp:
         instance.sanic_app = sanic_app
         instance.transport = MockTransport(scope, receive, send)
         instance.transport.loop = sanic_app.loop
-        instance.stage = Stage.IDLE
-        instance.response = None
         setattr(instance.transport, "add_task", sanic_app.loop.create_task)
 
         headers = Header(
@@ -178,21 +143,12 @@ class ASGIApp:
             instance.request_body = True
             instance.request.conn_info = ConnInfo(instance.transport)
 
-            await sanic_app.dispatch(
-                "http.lifecycle.request",
-                inline=True,
-                context={"request": instance.request},
-                fail_not_found=False,
-            )
-
         return instance
 
     async def read(self) -> Optional[bytes]:
         """
         Read and stream the body in chunks from an incoming ASGI message.
         """
-        if self.stage is Stage.IDLE:
-            self.stage = Stage.REQUEST
         message = await self.transport.receive()
         body = message.get("body", b"")
         if not message.get("more_body", False):
@@ -207,17 +163,11 @@ class ASGIApp:
             if data:
                 yield data
 
-    def respond(self, response: BaseHTTPResponse):
-        if self.stage is not Stage.HANDLER:
-            self.stage = Stage.FAILED
-            raise RuntimeError("Response already started")
-        if self.response is not None:
-            self.response.stream = None
+    def respond(self, response):
         response.stream, self.response = self, response
         return response
 
     async def send(self, data, end_stream):
-        self.stage = Stage.IDLE if end_stream else Stage.RESPONSE
         if self.response:
             response, self.response = self.response, None
             await self.transport.send(
@@ -245,10 +195,6 @@ class ASGIApp:
         Handle the incoming request.
         """
         try:
-            self.stage = Stage.HANDLER
             await self.sanic_app.handle_request(self.request)
         except Exception as e:
-            try:
-                await self.sanic_app.handle_exception(self.request, e)
-            except Exception as exc:
-                await self.sanic_app.handle_exception(self.request, exc, False)
+            await self.sanic_app.handle_exception(self.request, e)

sanic/base.py

@@ -1,34 +1,29 @@
 import re
 
-from typing import Any, Optional
+from typing import Any, Tuple
+from warnings import warn
 
-from sanic.base.meta import SanicMeta
 from sanic.exceptions import SanicException
 from sanic.mixins.exceptions import ExceptionMixin
 from sanic.mixins.listeners import ListenerMixin
 from sanic.mixins.middleware import MiddlewareMixin
 from sanic.mixins.routes import RouteMixin
 from sanic.mixins.signals import SignalMixin
-from sanic.mixins.static import StaticMixin
 
 
-VALID_NAME = re.compile(r"^[a-zA-Z_][a-zA-Z0-9_\-]*$")
+VALID_NAME = re.compile(r"^[a-zA-Z][a-zA-Z0-9_\-]*$")
 
 
 class BaseSanic(
     RouteMixin,
-    StaticMixin,
     MiddlewareMixin,
     ListenerMixin,
     ExceptionMixin,
     SignalMixin,
-    metaclass=SanicMeta,
 ):
-    __slots__ = ("name",)
+    __fake_slots__: Tuple[str, ...]
 
-    def __init__(
-        self, name: Optional[str] = None, *args: Any, **kwargs: Any
-    ) -> None:
+    def __init__(self, name: str = None, *args, **kwargs) -> None:
         class_name = self.__class__.__name__
 
         if name is None:
@@ -38,10 +33,11 @@ class BaseSanic(
             )
 
         if not VALID_NAME.match(name):
-            raise SanicException(
-                f"{class_name} instance named '{name}' uses an invalid "
-                "format. Names must begin with a character and may only "
-                "contain alphanumeric characters, _, or -."
+            warn(
+                f"{class_name} instance named '{name}' uses a format that is"
+                f"deprecated. Starting in version 21.12, {class_name} objects "
+                "must be named only using alphanumeric characters, _, or -.",
+                DeprecationWarning,
             )
 
         self.name = name
@@ -56,12 +52,15 @@ class BaseSanic(
         return f'{self.__class__.__name__}(name="{self.name}")'
 
     def __setattr__(self, name: str, value: Any) -> None:
-        try:
-            super().__setattr__(name, value)
-        except AttributeError as e:
-            raise AttributeError(
+        # This is a temporary compat layer so we can raise a warning until
+        # setting attributes on the app instance can be removed and deprecated
+        # with a proper implementation of __slots__
+        if name not in self.__fake_slots__:
+            warn(
                 f"Setting variables on {self.__class__.__name__} instances is "
-                "not allowed. You should change your "
-                f"{self.__class__.__name__} instance to use "
+                "deprecated and will be removed in version 21.12. You should "
+                f"change your {self.__class__.__name__} instance to use "
                 f"instance.ctx.{name} instead.",
-            ) from e
+                DeprecationWarning,
+            )
+        super().__setattr__(name, value)

sanic/base/meta.py

@@ -1,6 +0,0 @@
-class SanicMeta(type):
-    @classmethod
-    def __prepare__(metaclass, name, bases, **kwds):
-        cls = super().__prepare__(metaclass, name, bases, **kwds)
-        cls["__slots__"] = ()
-        return cls

sanic/blueprint_group.py

@@ -208,7 +208,7 @@ class BlueprintGroup(MutableSequence):
         :param args: List of Python exceptions to be caught by the handler
         :param kwargs: Additional optional arguments to be passed to the
             exception handler
-        :return: a decorated method to handle global exceptions for any
+        :return a decorated method to handle global exceptions for any
             blueprint registered under this group.
         """
 

sanic/blueprints.py

@@ -4,27 +4,13 @@ import asyncio
 
 from collections import defaultdict
 from copy import deepcopy
-from functools import wraps
-from inspect import isfunction
-from itertools import chain
 from types import SimpleNamespace
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Dict,
-    Iterable,
-    List,
-    Optional,
-    Sequence,
-    Set,
-    Tuple,
-    Union,
-)
+from typing import TYPE_CHECKING, Dict, Iterable, List, Optional, Set, Union
 
-from sanic_routing.exceptions import NotFound
-from sanic_routing.route import Route
+from sanic_routing.exceptions import NotFound  # type: ignore
+from sanic_routing.route import Route  # type: ignore
 
-from sanic.base.root import BaseSanic
+from sanic.base import BaseSanic
 from sanic.blueprint_group import BlueprintGroup
 from sanic.exceptions import SanicException
 from sanic.helpers import Default, _default
@@ -37,33 +23,7 @@ from sanic.models.handler_types import (
 
 
 if TYPE_CHECKING:
-    from sanic import Sanic
-
-
-def lazy(func, as_decorator=True):
-    @wraps(func)
-    def decorator(bp, *args, **kwargs):
-        nonlocal as_decorator
-        kwargs["apply"] = False
-        pass_handler = None
-
-        if args and isfunction(args[0]):
-            as_decorator = False
-
-        def wrapper(handler):
-            future = func(bp, *args, **kwargs)
-            if as_decorator:
-                future = future(handler)
-
-            if bp.registered:
-                for app in bp.apps:
-                    bp.register(app, {})
-
-            return future
-
-        return wrapper if as_decorator else wrapper(pass_handler)
-
-    return decorator
+    from sanic import Sanic  # noqa
 
 
 class Blueprint(BaseSanic):
@@ -79,13 +39,13 @@ class Blueprint(BaseSanic):
 
     :param name: unique name of the blueprint
     :param url_prefix: URL to be prefixed before all route URLs
-    :param host: IP Address or FQDN for the sanic server to use.
+    :param host: IP Address of FQDN for the sanic server to use.
     :param version: Blueprint Version
     :param strict_slashes: Enforce the API urls are requested with a
         trailing */*
     """
 
-    __slots__ = (
+    __fake_slots__ = (
         "_apps",
         "_future_routes",
         "_future_statics",
@@ -98,6 +58,7 @@ class Blueprint(BaseSanic):
         "host",
         "listeners",
         "middlewares",
+        "name",
         "routes",
         "statics",
         "strict_slashes",
@@ -111,7 +72,7 @@ class Blueprint(BaseSanic):
         self,
         name: str = None,
         url_prefix: Optional[str] = None,
-        host: Optional[Union[List[str], str]] = None,
+        host: Optional[str] = None,
         version: Optional[Union[int, str, float]] = None,
         strict_slashes: Optional[bool] = None,
         version_prefix: str = "/v",
@@ -154,21 +115,34 @@ class Blueprint(BaseSanic):
             )
         return self._apps
 
-    @property
-    def registered(self) -> bool:
-        return bool(self._apps)
+    def route(self, *args, **kwargs):
+        kwargs["apply"] = False
+        return super().route(*args, **kwargs)
 
-    exception = lazy(BaseSanic.exception)
-    listener = lazy(BaseSanic.listener)
-    middleware = lazy(BaseSanic.middleware)
-    route = lazy(BaseSanic.route)
-    signal = lazy(BaseSanic.signal)
-    static = lazy(BaseSanic.static, as_decorator=False)
+    def static(self, *args, **kwargs):
+        kwargs["apply"] = False
+        return super().static(*args, **kwargs)
+
+    def middleware(self, *args, **kwargs):
+        kwargs["apply"] = False
+        return super().middleware(*args, **kwargs)
+
+    def listener(self, *args, **kwargs):
+        kwargs["apply"] = False
+        return super().listener(*args, **kwargs)
+
+    def exception(self, *args, **kwargs):
+        kwargs["apply"] = False
+        return super().exception(*args, **kwargs)
+
+    def signal(self, event: str, *args, **kwargs):
+        kwargs["apply"] = False
+        return super().signal(event, *args, **kwargs)
 
     def reset(self):
         self._apps: Set[Sanic] = set()
         self.exceptions: List[RouteHandler] = []
-        self.listeners: Dict[str, List[ListenerType[Any]]] = {}
+        self.listeners: Dict[str, List[ListenerType]] = {}
         self.middlewares: List[MiddlewareType] = []
         self.routes: List[Route] = []
         self.statics: List[RouteHandler] = []
@@ -247,7 +221,7 @@ class Blueprint(BaseSanic):
         version: Optional[Union[int, str, float]] = None,
         strict_slashes: Optional[bool] = None,
         version_prefix: str = "/v",
-    ) -> BlueprintGroup:
+    ):
         """
         Create a list of blueprints, optionally grouping them under a
         general URL prefix.
@@ -300,12 +274,14 @@ class Blueprint(BaseSanic):
         middleware = []
         exception_handlers = []
         listeners = defaultdict(list)
-        registered = set()
 
         # Routes
         for future in self._future_routes:
+            # attach the blueprint name to the handler so that it can be
+            # prefixed properly in the router
+            future.handler.__blueprintname__ = self.name
             # Prepend the blueprint URI prefix if available
-            uri = self._setup_uri(future.uri, url_prefix)
+            uri = url_prefix + future.uri if url_prefix else future.uri
 
             version_prefix = self.version_prefix
             for prefix in (
@@ -324,15 +300,12 @@ class Blueprint(BaseSanic):
             )
 
             name = app._generate_name(future.name)
-            host = future.host or self.host
-            if isinstance(host, list):
-                host = tuple(host)
 
             apply_route = FutureRoute(
                 future.handler,
-                uri,
+                uri[1:] if uri.startswith("//") else uri,
                 future.methods,
-                host,
+                future.host or self.host,
                 strict_slashes,
                 future.stream,
                 version,
@@ -344,13 +317,8 @@ class Blueprint(BaseSanic):
                 future.static,
                 version_prefix,
                 error_format,
-                future.route_context,
             )
 
-            if (self, apply_route) in app._future_registry:
-                continue
-
-            registered.add(apply_route)
             route = app._apply_route(apply_route)
             operation = (
                 routes.extend if isinstance(route, list) else routes.append
@@ -360,13 +328,8 @@ class Blueprint(BaseSanic):
         # Static Files
         for future in self._future_statics:
             # Prepend the blueprint URI prefix if available
-            uri = self._setup_uri(future.uri, url_prefix)
+            uri = url_prefix + future.uri if url_prefix else future.uri
             apply_route = FutureStatic(uri, *future[1:])
-
-            if (self, apply_route) in app._future_registry:
-                continue
-
-            registered.add(apply_route)
             route = app._apply_static(apply_route)
             routes.append(route)
 
@@ -375,56 +338,34 @@ class Blueprint(BaseSanic):
         if route_names:
             # Middleware
             for future in self._future_middleware:
-                if (self, future) in app._future_registry:
-                    continue
                 middleware.append(app._apply_middleware(future, route_names))
 
             # Exceptions
             for future in self._future_exceptions:
-                if (self, future) in app._future_registry:
-                    continue
                 exception_handlers.append(
                     app._apply_exception_handler(future, route_names)
                 )
 
         # Event listeners
-        for future in self._future_listeners:
-            if (self, future) in app._future_registry:
-                continue
-            listeners[future.event].append(app._apply_listener(future))
+        for listener in self._future_listeners:
+            listeners[listener.event].append(app._apply_listener(listener))
 
         # Signals
-        for future in self._future_signals:
-            if (self, future) in app._future_registry:
-                continue
-            future.condition.update({"__blueprint__": self.name})
-            # Force exclusive to be False
-            app._apply_signal(tuple((*future[:-1], False)))
+        for signal in self._future_signals:
+            signal.condition.update({"blueprint": self.name})
+            app._apply_signal(signal)
 
-        self.routes += [route for route in routes if isinstance(route, Route)]
-        self.websocket_routes += [
-            route for route in self.routes if route.extra.websocket
+        self.routes = [route for route in routes if isinstance(route, Route)]
+        self.websocket_routes = [
+            route for route in self.routes if route.ctx.websocket
         ]
-        self.middlewares += middleware
-        self.exceptions += exception_handlers
-        self.listeners.update(dict(listeners))
-
-        if self.registered:
-            self.register_futures(
-                self.apps,
-                self,
-                chain(
-                    registered,
-                    self._future_middleware,
-                    self._future_exceptions,
-                    self._future_listeners,
-                    self._future_signals,
-                ),
-            )
+        self.middlewares = middleware
+        self.exceptions = exception_handlers
+        self.listeners = dict(listeners)
 
     async def dispatch(self, *args, **kwargs):
         condition = kwargs.pop("condition", {})
-        condition.update({"__blueprint__": self.name})
+        condition.update({"blueprint": self.name})
         kwargs["condition"] = condition
         await asyncio.gather(
             *[app.dispatch(*args, **kwargs) for app in self.apps]
@@ -439,7 +380,7 @@ class Blueprint(BaseSanic):
             events.add(signal.ctx.event)
 
         return asyncio.wait(
-            [asyncio.create_task(event.wait()) for event in events],
+            [event.wait() for event in events],
             return_when=asyncio.FIRST_COMPLETED,
             timeout=timeout,
         )
@@ -452,22 +393,3 @@ class Blueprint(BaseSanic):
                 value = v
                 break
         return value
-
-    @staticmethod
-    def _setup_uri(base: str, prefix: Optional[str]):
-        uri = base
-        if prefix:
-            uri = prefix
-            if base.startswith("/") and prefix.endswith("/"):
-                uri += base[1:]
-            else:
-                uri += base
-
-        return uri[1:] if uri.startswith("//") else uri
-
-    @staticmethod
-    def register_futures(
-        apps: Set[Sanic], bp: Blueprint, futures: Sequence[Tuple[Any, ...]]
-    ):
-        for app in apps:
-            app._future_registry.update(set((bp, item) for item in futures))

sanic/breaking/__init__.py

@@ -1,18 +0,0 @@
-from sanic.__version__ import __compatibility__
-
-if __compatibility__ == "22.12":
-    from .v22_12.request import (
-        File,
-        Request,
-        RequestParameters,
-        parse_multipart_form,
-    )
-elif __compatibility__ == "23.3":
-    from .v23_3.request import (
-        File,
-        Request,
-        RequestParameters,
-        parse_multipart_form,
-    )
-else:
-    raise RuntimeError(f"Unknown compatibility value: {__compatibility__}")

sanic/breaking/v23_3/request.py

@@ -1,9 +0,0 @@
-from ..v22_12.request import File
-from ..v22_12.request import Request as LegacyRequest
-from ..v22_12.request import RequestParameters, parse_multipart_form
-
-
-class Request(LegacyRequest):
-    @property
-    def something_new(self):
-        return 123