# starlette-compress
[![Support my work](https://shields.monicz.dev/badge/%E2%99%A5%EF%B8%8F%20Support%20my%20work-purple)](https://monicz.dev/#support-my-work)
[![Liberapay Patrons](https://shields.monicz.dev/liberapay/patrons/Zaczero?logo=liberapay)](https://liberapay.com/Zaczero/)
[![PyPI - Python Version](https://shields.monicz.dev/pypi/pyversions/starlette-compress)](https://pypi.org/project/starlette-compress)
**starlette-compress** is a fast and simple middleware for compressing responses in [Starlette](https://www.starlette.io). It supports more compression algorithms than Starlette's built-in GZipMiddleware, and has more sensible defaults.
- Python 3.8+ support
- Compatible with `asyncio` and `trio` backends
- ZStd, Brotli, and GZip compression
- Sensible default configuration
- [The Unlicense](https://unlicense.org) — public domain dedication
- [Semantic Versioning](https://semver.org) compliance
## Installation
```sh
pip install starlette-compress
```
## Basic Usage
### Starlette
```py
from starlette.applications import Starlette
from starlette.middleware import Middleware
from starlette_compress import CompressMiddleware
middleware = [
Middleware(CompressMiddleware)
]
app = Starlette(routes=..., middleware=middleware)
```
### FastAPI
You can use starlette-compress with [FastAPI](https://fastapi.tiangolo.com) too:
```py
from fastapi import FastAPI
from starlette_compress import CompressMiddleware
app = FastAPI()
app.add_middleware(CompressMiddleware)
```
## Advanced Usage
### Changing Minimum Response Size
Control the minimum size of the response to compress. By default, responses must be at least 500 bytes to be compressed.
```py
# Starlette
middleware = [
Middleware(CompressMiddleware, minimum_size=1000)
]
# FastAPI
app.add_middleware(CompressMiddleware, minimum_size=1000)
```
### Tuning Compression Levels
Adjust the compression levels for each algorithm. Higher levels mean smaller files but slower compression. Default level is 4 for all algorithms.
```py
# Starlette
middleware = [
Middleware(CompressMiddleware, zstd_level=6, brotli_quality=6, gzip_level=6)
]
# FastAPI
app.add_middleware(CompressMiddleware, zstd_level=6, brotli_quality=6, gzip_level=6)
```
### Supporting Custom Content-Types
Manage the supported content-types. Unknown response types are not compressed. [Check here](https://github.com/Zaczero/starlette-compress/blob/main/starlette_compress/__init__.py) for the default configuration.
```py
from starlette_compress import add_compress_type, remove_compress_type
add_compress_type("application/my-custom-type")
remove_compress_type("application/json")
```
Raw data
{
"_id": null,
"home_page": "https://github.com/Zaczero/starlette-compress",
"name": "starlette-compress",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": "starlette, middleware, compression, zstd, brotli, gzip, http",
"author": "Kamil Monicz",
"author_email": "kamil@monicz.dev",
"download_url": "https://files.pythonhosted.org/packages/12/89/07ce394c23f8ca54179746410b595d22d21f3f7b209f28ed7c025b3f8837/starlette_compress-1.0.1.tar.gz",
"platform": null,
"description": "# starlette-compress\n\n[![Support my work](https://shields.monicz.dev/badge/%E2%99%A5%EF%B8%8F%20Support%20my%20work-purple)](https://monicz.dev/#support-my-work)\n[![Liberapay Patrons](https://shields.monicz.dev/liberapay/patrons/Zaczero?logo=liberapay)](https://liberapay.com/Zaczero/)\n[![PyPI - Python Version](https://shields.monicz.dev/pypi/pyversions/starlette-compress)](https://pypi.org/project/starlette-compress)\n\n**starlette-compress** is a fast and simple middleware for compressing responses in [Starlette](https://www.starlette.io). It supports more compression algorithms than Starlette's built-in GZipMiddleware, and has more sensible defaults.\n\n- Python 3.8+ support\n- Compatible with `asyncio` and `trio` backends\n- ZStd, Brotli, and GZip compression\n- Sensible default configuration\n- [The Unlicense](https://unlicense.org) \u2014 public domain dedication\n- [Semantic Versioning](https://semver.org) compliance\n\n## Installation\n\n```sh\npip install starlette-compress\n```\n\n## Basic Usage\n\n### Starlette\n\n```py\nfrom starlette.applications import Starlette\nfrom starlette.middleware import Middleware\nfrom starlette_compress import CompressMiddleware\n\nmiddleware = [\n Middleware(CompressMiddleware)\n]\n\napp = Starlette(routes=..., middleware=middleware)\n```\n\n### FastAPI\n\nYou can use starlette-compress with [FastAPI](https://fastapi.tiangolo.com) too:\n\n```py\nfrom fastapi import FastAPI\nfrom starlette_compress import CompressMiddleware\n\napp = FastAPI()\napp.add_middleware(CompressMiddleware)\n```\n\n## Advanced Usage\n\n### Changing Minimum Response Size\n\nControl the minimum size of the response to compress. By default, responses must be at least 500 bytes to be compressed.\n\n```py\n# Starlette\nmiddleware = [\n Middleware(CompressMiddleware, minimum_size=1000)\n]\n\n# FastAPI\napp.add_middleware(CompressMiddleware, minimum_size=1000)\n```\n\n### Tuning Compression Levels\n\nAdjust the compression levels for each algorithm. Higher levels mean smaller files but slower compression. Default level is 4 for all algorithms.\n\n```py\n# Starlette\nmiddleware = [\n Middleware(CompressMiddleware, zstd_level=6, brotli_quality=6, gzip_level=6)\n]\n\n# FastAPI\napp.add_middleware(CompressMiddleware, zstd_level=6, brotli_quality=6, gzip_level=6)\n```\n\n### Supporting Custom Content-Types\n\nManage the supported content-types. Unknown response types are not compressed. [Check here](https://github.com/Zaczero/starlette-compress/blob/main/starlette_compress/__init__.py) for the default configuration.\n\n```py\nfrom starlette_compress import add_compress_type, remove_compress_type\n\nadd_compress_type(\"application/my-custom-type\")\nremove_compress_type(\"application/json\")\n```\n\n",
"bugtrack_url": null,
"license": "Unlicense",
"summary": "Compression middleware for Starlette - supporting ZStd, Brotli, and GZip",
"version": "1.0.1",
"project_urls": {
"Homepage": "https://github.com/Zaczero/starlette-compress",
"Repository": "https://github.com/Zaczero/starlette-compress"
},
"split_keywords": [
"starlette",
" middleware",
" compression",
" zstd",
" brotli",
" gzip",
" http"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "82e3e269e698ece473d2c9b501971a5eae1d9460bcdc7f479d4d579281190489",
"md5": "87c53f4ed941c83e77b23e13f06a82ee",
"sha256": "4f2f9094254ba9a9064106fcd574fcb3ff7ab7fe3fbcd1c5eb622d2d7ea0a39e"
},
"downloads": -1,
"filename": "starlette_compress-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "87c53f4ed941c83e77b23e13f06a82ee",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 5919,
"upload_time": "2024-05-07T03:14:48",
"upload_time_iso_8601": "2024-05-07T03:14:48.009923Z",
"url": "https://files.pythonhosted.org/packages/82/e3/e269e698ece473d2c9b501971a5eae1d9460bcdc7f479d4d579281190489/starlette_compress-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "128907ce394c23f8ca54179746410b595d22d21f3f7b209f28ed7c025b3f8837",
"md5": "0c049dd3a25582172593f63853bb52bb",
"sha256": "2b1b1392990bdc4632aac880aa6e275ebbf0297e4ef420ad6da1721af12cb572"
},
"downloads": -1,
"filename": "starlette_compress-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "0c049dd3a25582172593f63853bb52bb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 6755,
"upload_time": "2024-05-07T03:14:49",
"upload_time_iso_8601": "2024-05-07T03:14:49.547737Z",
"url": "https://files.pythonhosted.org/packages/12/89/07ce394c23f8ca54179746410b595d22d21f3f7b209f28ed7c025b3f8837/starlette_compress-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-07 03:14:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Zaczero",
"github_project": "starlette-compress",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "starlette-compress"
}