]> git.ipfire.org Git - thirdparty/starlette.git/commitdiff
Add missing `compresslevel` parameter on docs (#2553)
authorJun-Ah 준아 <junah.dev@gmail.com>
Mon, 25 Mar 2024 17:57:47 +0000 (02:57 +0900)
committerGitHub <noreply@github.com>
Mon, 25 Mar 2024 17:57:47 +0000 (11:57 -0600)
* Add missing compresslevel parameter on docs

The compresslevel parameter was added in #1128.
But, it was not added to the document, so an explanation was added.

* Update docs/middleware.md

---------

Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>
docs/middleware.md

index 759c86d70e27c45a6ccbcca8771fd524a676291a..dfe0a70d7bb5682beb5203c5293cc316559a3fdb 100644 (file)
@@ -185,7 +185,7 @@ from starlette.middleware.gzip import GZipMiddleware
 routes = ...
 
 middleware = [
-    Middleware(GZipMiddleware, minimum_size=1000)
+    Middleware(GZipMiddleware, minimum_size=1000, compresslevel=9)
 ]
 
 app = Starlette(routes=routes, middleware=middleware)
@@ -194,6 +194,7 @@ app = Starlette(routes=routes, middleware=middleware)
 The following arguments are supported:
 
 * `minimum_size` - Do not GZip responses that are smaller than this minimum size in bytes. Defaults to `500`.
+* `compresslevel` - Used during GZip compression. It is an integer ranging from 1 to 9. Defaults to `9`. Lower value results in faster compression but larger file sizes, while higher value results in slower compression but smaller file sizes.
 
 The middleware won't GZip responses that already have a `Content-Encoding` set, to prevent them from being encoded twice.