Defaults ws max_size on server to 16MB

.github/ISSUE_TEMPLATE/2-bug-report.md

@@ -0,0 +1,53 @@
+---
+name: Bug report
+about: Report a bug to help improve this project
+---
+
+### Checklist
+
+<!-- Please make sure you check all these items before submitting your bug report. -->
+
+- [ ] The bug is reproducible against the latest release and/or `master`.
+- [ ] There are no similar issues or pull requests to fix it yet.
+
+### Describe the bug
+
+<!-- A clear and concise description of what the bug is. -->
+
+### To reproduce
+
+<!-- Provide a *minimal* example with steps to reproduce the bug locally.
+
+NOTE: try to keep any external dependencies *at an absolute minimum* .
+In other words, remove anything that doesn't make the bug go away.
+
+-->
+
+### Expected behavior
+
+<!-- A clear and concise description of what you expected to happen. -->
+
+### Actual behavior
+
+<!-- A clear and concise description of what actually happens. -->
+
+### Debugging material
+
+<!-- Any tracebacks, screenshots, etc. that can help understanding the problem.
+
+NOTE:
+- Please list tracebacks in full (don't truncate them).
+- If relevant, consider turning on DEBUG or TRACE logs for additional details (see the Logging section on https://www.uvicorn.org/settings/ specifically the `log-level` flag).
+- Consider using `<details>` to make tracebacks/logs collapsible if they're very large (see https://gist.github.com/ericclemmons/b146fe5da72ca1f706b2ef72a20ac39d).
+-->
+
+### Environment
+
+- OS / Python / Uvicorn version: just run `uvicorn --version`
+- The exact command you're running uvicorn with, all flags you passed included. If you run it with gunicorn please do the same. If there is a reverse-proxy involved and you cannot reproduce without it please give the minimal config of it to reproduce.
+
+### Additional context
+
+<!-- Any additional information that can help understanding the problem.
+
+Eg. linked issues, or a description of what you were trying to achieve. -->

.github/ISSUE_TEMPLATE/3-feature-request.md

@@ -0,0 +1,33 @@
+---
+name: Feature request
+about: Suggest an idea for this project.
+---
+
+### Checklist
+
+<!-- Please make sure you check all these items before submitting your feature request. -->
+
+- [ ] There are no similar issues or pull requests for this yet.
+- [ ] I discussed this idea on the [community chat](https://gitter.im/encode/community) and feedback is positive.
+
+### Is your feature related to a problem? Please describe.
+
+<!-- A clear and concise description of what you are trying to achieve.
+
+Eg "I want to be able to [...] but I can't because [...]". -->
+
+## Describe the solution you would like.
+
+<!-- A clear and concise description of what you would want to happen.
+
+For API changes, try to provide a code snippet of what you would like the API to look like.
+-->
+
+## Describe alternatives you considered
+
+<!-- Please describe any alternative solutions or features you've considered to solve
+your problem and why they wouldn't solve it. -->
+
+## Additional context
+
+<!-- Provide any additional context, screenshots, tracebacks, etc. about the feature here. -->

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,7 @@
+# Ref: https://help.github.com/en/github/building-a-strong-community/configuring-issue-templates-for-your-repository#configuring-the-template-chooser
+blank_issues_enabled: true
+contact_links:
+- name: Question
+  url: https://gitter.im/encode/community
+  about: >
+    Ask a question

.github/workflows/publish.yml

@@ -13,10 +13,14 @@ jobs:
 
     steps:
       - uses: "actions/checkout@v2"
-      - uses: "actions/setup-python@v1"
+      - uses: "actions/setup-python@v2"
         with:
           python-version: 3.7
-      - name: "Publish"
+      - name: "Install dependencies"
+        run: "scripts/install"
+      - name: "Build package & docs"
+        run: "scripts/build"
+      - name: "Publish to PyPI & deploy docs"
         run: "scripts/publish"
         env:
           TWINE_USERNAME: __token__

.github/workflows/test-suite.yml

@@ -9,19 +9,29 @@ on:
 
 jobs:
   tests:
-    name: "Python ${{ matrix.python-version }}"
-    runs-on: "ubuntu-latest"
-
+    name: "Python ${{ matrix.python-version }} ${{ matrix.os }}"
+    runs-on: "${{ matrix.os }}"
     strategy:
       matrix:
-        python-version: ["3.6", "3.7", "3.8"]
-
+        python-version: ["3.6", "3.7", "3.8", "3.9"]
+        os: [windows-latest, ubuntu-latest]
     steps:
       - uses: "actions/checkout@v2"
-      - uses: "actions/setup-python@v1"
+      - uses: "actions/setup-python@v2"
         with:
           python-version: "${{ matrix.python-version }}"
       - name: "Install dependencies"
         run: "scripts/install"
+        shell: bash
+      - name: "Run linting checks"
+        run: "scripts/check"
+        shell: bash
+      - name: "Build package & docs"
+        run: "scripts/build"
+        shell: bash
       - name: "Run tests"
         run: "scripts/test"
+        shell: bash
+      - name: "Enforce coverage"
+        run: "scripts/coverage"
+        shell: bash

CHANGELOG.md

@@ -1,5 +1,115 @@
 # Change Log
 
+## 0.13.4 - 2021-02-20
+
+### Fixed
+
+- Fixed wsgi middleware PATH_INFO encoding (#962) 2/20/21
+- Fixed uvloop dependency  (#952) 2/10/21 then (#959) 2/20/21
+- Relax watchgod up bound (#946) 1/31/21
+- Return 'connection: close' header in response (#721) 1/25/21
+
+### Added:
+
+- Docs: Nginx + websockets (#948) 2/10/21 
+- Document the default value of 1 for workers (#940) (#943) 1/25/21
+- Enabled permessage-deflate extension in websockets (#764) 1/1/21
+
+## 0.13.3 - 2020-12-29
+
+### Fixed
+
+- Prevent swallowing of return codes from `subprocess` when running with Gunicorn by properly resetting signals. (Pull #895)
+- Tweak detection of app factories to be more robust. A warning is now logged when passing a factory without the `--factory` flag. (Pull #914)
+- Properly clean tasks when handshake is aborted when running with `--ws websockets`. (Pull #921)
+
+## 0.13.2 - 2020-12-12
+
+### Fixed
+
+- Log full exception traceback in case of invalid HTTP request. (Pull #886 and #888)
+
+## 0.13.1 - 2020-12-12
+
+### Fixed
+
+- Prevent exceptions when the ASGI application rejects a connection during the WebSocket handshake, when running on both `--ws wsproto` or `--ws websockets`. (Pull #704 and #881)
+- Ensure connection `scope` doesn't leak in logs when using JSON log formatters. (Pull #859 and #884)
+
+## 0.13.0 - 2020-12-08
+
+### Added
+
+- Add `--factory` flag to support factory-style application imports. (#875) 2020-12-07 50fc0d1c
+- Skip installation of signal handlers when not in the main thread. Allows using `Server` in multithreaded contexts without having to override `.install_signal_handlers()`. (#871) 2020-12-07 ce2ef45a
+
+## 0.12.3 - 2020-11-21
+
+### Fixed
+- Fix race condition that leads Quart to hang with uvicorn (#848) 11/18/20 de213614
+- Use latin1 when decoding X-Forwarded-* headers (#701) 11/12/20 45e6e831
+- Rework IPv6 support (#837) 11/8/20 bdab488e
+- Cancel old keepalive-trigger before setting new one. (#832) 10/26/20 d5dcf80c
+
+## 0.12.2 - 2020-10-19
+
+### Added
+- Adding ability to decrypt ssl key file (#808) 10/12/20 90dbb6e0
+- Support .yml log config files (#799) 10/6/20 b468950e
+- Added python 3.9 support (#804) 10/6/20 08fd0559
+
+### Fixed
+- Fixes watchgod with common prefixes (#817) 10/14/20 1b32f997
+- Fix reload with ipv6 host (#803) 10/14/20 5acaee5b
+- Added cli suport for headers containing colon (#813) 10/12/20 68732899
+- Sharing socket across workers on windows (#802) 10/12/20 103167a0
+- Note the need to configure trusted "ips" when using unix sockets (#796) 10/4/20 a504c569
+
+## 0.12.1 - 2020-09-30
+
+### Changed
+- Pinning h11 and python-dotenv to min versions (#789) 9/29/20 bbf19c66
+- Get docs/index.md in sync with README.md (#784) 9/29/20 70ebcfdf
+
+### Fixed
+- Improve changelog by pointing out breaking changes (#792) 9/29/20 e2b75064
+
+## 0.12.0 - 2020-09-28
+
+### Added
+- Make reload delay configurable (#774) 9/28/20 98010027
+- Upgrade maximum h11 dependency version to 0.10 (#772) 8/28/20 54d729cc
+- Allow .json or .yaml --log-config files (#665) 8/18/20 093a1f7c
+- Add ASGI dict to the lifespan scope (#754) 8/15/20 8150c3eb
+- Upgrade wsproto to 0.15.0 (#750) 8/13/20 fbce393f
+- Use optional package installs (#666) 8/10/20 5fa99a11
+
+### Changed
+- Dont set log level for root logger (#767) 8/28/20 df81b168
+- Uvicorn no longer ships extra dependencies `uvloop`, `websockets` and
+  `httptools` as default. To install these dependencies use
+  `uvicorn[standard]`.
+
+### Fixed
+- Revert "Improve shutdown robustness when using `--reload` or multiprocessing (#620)" (#756) 8/28/20 ff4af12d
+- Fix terminate error in windows (#744) 8/27/20 dd3b842d
+- Fix bug where --log-config disables uvicorn loggers (#512) 8/11/20 a9c37cc4
+
+## 0.11.8 - 2020-07-30
+
+* Fix a regression that caused Uvicorn to crash when using `--interface=wsgi`. (Pull #730)
+* Fix a regression that caused Uvicorn to crash when using unix domain sockets. (Pull #729)
+
+## 0.11.7 - 2020-28-07
+
+* SECURITY FIX: Prevent sending invalid HTTP header names and values. (Pull #725)
+* SECURITY FIX: Ensure path value is escaped before logging to the console. (Pull #724)
+* Fix `--proxy-headers` client IP and host when using a Unix socket. (Pull #636)
+
+## 0.11.6
+
+* Fix overriding the root logger.
+
 ## 0.11.5
 
 * Revert "Watch all files, not just .py" due to unexpected side effects.

README.md

@@ -33,6 +33,27 @@ Install using `pip`:
 $ pip install uvicorn
 ```
 
+This will install uvicorn with minimal (pure Python) dependencies.
+
+```shell
+$ pip install uvicorn[standard]
+```
+
+This will install uvicorn with "Cython-based" dependencies (where possible) and other "optional extras".
+
+In this context, "Cython-based" means the following:
+
+- the event loop `uvloop` will be installed and used if possible.
+- the http protocol will be handled by `httptools` if possible.
+
+Moreover, "optional extras" means that:
+
+- the websocket protocol will be handled by `websockets` (should you want to use `wsproto` you'd need to install it manually) if possible.
+- the `--reloader` flag in development mode will use `watchgod`.
+- windows users will have `colorama` installed for the colored logs.
+- `python-dotenv` will be installed should you want to use the `--env-file` option.
+- `PyYAML` will be installed to allow you to provide a `.yaml` file to `--log-config`, if desired.
+
 Create an application, in `example.py`:
 
 ```python