This commit is contained in:
Iliyan Angelov
2025-12-01 06:50:10 +02:00
parent 91f51bc6fe
commit 62c1fe5951
4682 changed files with 544807 additions and 31208 deletions

View File

@@ -0,0 +1,177 @@
Metadata-Version: 2.4
Name: starlette
Version: 0.50.0
Summary: The little ASGI library that shines.
Project-URL: Homepage, https://github.com/Kludex/starlette
Project-URL: Documentation, https://starlette.dev/
Project-URL: Changelog, https://starlette.dev/release-notes/
Project-URL: Funding, https://github.com/sponsors/Kludex
Project-URL: Source, https://github.com/Kludex/starlette
Author-email: Tom Christie <tom@tomchristie.com>
Maintainer-email: Marcelo Trylesinski <marcelotryle@gmail.com>
License-Expression: BSD-3-Clause
License-File: LICENSE.md
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: AnyIO
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.10
Requires-Dist: anyio<5,>=3.6.2
Requires-Dist: typing-extensions>=4.10.0; python_version < '3.13'
Provides-Extra: full
Requires-Dist: httpx<0.29.0,>=0.27.0; extra == 'full'
Requires-Dist: itsdangerous; extra == 'full'
Requires-Dist: jinja2; extra == 'full'
Requires-Dist: python-multipart>=0.0.18; extra == 'full'
Requires-Dist: pyyaml; extra == 'full'
Description-Content-Type: text/markdown
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Kludex/starlette/main/docs/img/starlette_dark.svg" width="420px">
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Kludex/starlette/main/docs/img/starlette.svg" width="420px">
<img alt="starlette-logo" src="https://raw.githubusercontent.com/Kludex/starlette/main/docs/img/starlette_dark.svg">
</picture>
</p>
<p align="center">
<em>✨ The little ASGI framework that shines. ✨</em>
</p>
---
[![Build Status](https://github.com/Kludex/starlette/workflows/Test%20Suite/badge.svg)](https://github.com/Kludex/starlette/actions)
[![Package version](https://badge.fury.io/py/starlette.svg)](https://pypi.python.org/pypi/starlette)
[![Supported Python Version](https://img.shields.io/pypi/pyversions/starlette.svg?color=%2334D058)](https://pypi.org/project/starlette)
[![Discord](https://img.shields.io/discord/1051468649518616576?logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/RxKUF5JuHs)
---
**Documentation**: <a href="https://starlette.dev/" target="_blank">https://starlette.dev</a>
**Source Code**: <a href="https://github.com/Kludex/starlette" target="_blank">https://github.com/Kludex/starlette</a>
---
# Starlette
Starlette is a lightweight [ASGI][asgi] framework/toolkit,
which is ideal for building async web services in Python.
It is production-ready, and gives you the following:
* A lightweight, low-complexity HTTP web framework.
* WebSocket support.
* In-process background tasks.
* Startup and shutdown events.
* Test client built on `httpx`.
* CORS, GZip, Static Files, Streaming responses.
* Session and Cookie support.
* 100% test coverage.
* 100% type annotated codebase.
* Few hard dependencies.
* Compatible with `asyncio` and `trio` backends.
* Great overall performance [against independent benchmarks][techempower].
## Installation
```shell
$ pip install starlette
```
You'll also want to install an ASGI server, such as [uvicorn](https://www.uvicorn.org/), [daphne](https://github.com/django/daphne/), or [hypercorn](https://hypercorn.readthedocs.io/en/latest/).
```shell
$ pip install uvicorn
```
## Example
```python title="main.py"
from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
async def homepage(request):
return JSONResponse({'hello': 'world'})
routes = [
Route("/", endpoint=homepage)
]
app = Starlette(debug=True, routes=routes)
```
Then run the application using Uvicorn:
```shell
$ uvicorn main:app
```
## Dependencies
Starlette only requires `anyio`, and the following are optional:
* [`httpx`][httpx] - Required if you want to use the `TestClient`.
* [`jinja2`][jinja2] - Required if you want to use `Jinja2Templates`.
* [`python-multipart`][python-multipart] - Required if you want to support form parsing, with `request.form()`.
* [`itsdangerous`][itsdangerous] - Required for `SessionMiddleware` support.
* [`pyyaml`][pyyaml] - Required for `SchemaGenerator` support.
You can install all of these with `pip install starlette[full]`.
## Framework or Toolkit
Starlette is designed to be used either as a complete framework, or as
an ASGI toolkit. You can use any of its components independently.
```python
from starlette.responses import PlainTextResponse
async def app(scope, receive, send):
assert scope['type'] == 'http'
response = PlainTextResponse('Hello, world!')
await response(scope, receive, send)
```
Run the `app` application in `example.py`:
```shell
$ uvicorn example:app
INFO: Started server process [11509]
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
```
Run uvicorn with `--reload` to enable auto-reloading on code changes.
## Modularity
The modularity that Starlette is designed on promotes building re-usable
components that can be shared between any ASGI framework. This should enable
an ecosystem of shared middleware and mountable applications.
The clean API separation also means it's easier to understand each component
in isolation.
---
<p align="center"><i>Starlette is <a href="https://github.com/Kludex/starlette/blob/main/LICENSE.md">BSD licensed</a> code.<br/>Designed & crafted with care.</i></br>&mdash; ⭐️ &mdash;</p>
[asgi]: https://asgi.readthedocs.io/en/latest/
[httpx]: https://www.python-httpx.org/
[jinja2]: https://jinja.palletsprojects.com/
[python-multipart]: https://multipart.fastapiexpert.com/
[itsdangerous]: https://itsdangerous.palletsprojects.com/
[sqlalchemy]: https://www.sqlalchemy.org
[pyyaml]: https://pyyaml.org/wiki/PyYAMLDocumentation
[techempower]: https://www.techempower.com/benchmarks/#hw=ph&test=fortune&l=zijzen-sf

View File

@@ -0,0 +1,75 @@
starlette-0.50.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
starlette-0.50.0.dist-info/METADATA,sha256=7sEnzMIA7kL0DLBKgZb12rbtqbUfpD7mmVE63_fz7Ug,6318
starlette-0.50.0.dist-info/RECORD,,
starlette-0.50.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
starlette-0.50.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
starlette-0.50.0.dist-info/licenses/LICENSE.md,sha256=3LlWd6AiQCQxh-lk-UGEfRmxeCHPmeWvrmhPqzKMGb8,1518
starlette/__init__.py,sha256=ZGGb_j5nPbepbHyYElcl845wxThO9mrTqMfv_Wc33E4,23
starlette/__pycache__/__init__.cpython-312.pyc,,
starlette/__pycache__/_exception_handler.cpython-312.pyc,,
starlette/__pycache__/_utils.cpython-312.pyc,,
starlette/__pycache__/applications.cpython-312.pyc,,
starlette/__pycache__/authentication.cpython-312.pyc,,
starlette/__pycache__/background.cpython-312.pyc,,
starlette/__pycache__/concurrency.cpython-312.pyc,,
starlette/__pycache__/config.cpython-312.pyc,,
starlette/__pycache__/convertors.cpython-312.pyc,,
starlette/__pycache__/datastructures.cpython-312.pyc,,
starlette/__pycache__/endpoints.cpython-312.pyc,,
starlette/__pycache__/exceptions.cpython-312.pyc,,
starlette/__pycache__/formparsers.cpython-312.pyc,,
starlette/__pycache__/requests.cpython-312.pyc,,
starlette/__pycache__/responses.cpython-312.pyc,,
starlette/__pycache__/routing.cpython-312.pyc,,
starlette/__pycache__/schemas.cpython-312.pyc,,
starlette/__pycache__/staticfiles.cpython-312.pyc,,
starlette/__pycache__/status.cpython-312.pyc,,
starlette/__pycache__/templating.cpython-312.pyc,,
starlette/__pycache__/testclient.cpython-312.pyc,,
starlette/__pycache__/types.cpython-312.pyc,,
starlette/__pycache__/websockets.cpython-312.pyc,,
starlette/_exception_handler.py,sha256=izcMiP2VuVbIvwTUQjhMlchcaA5795-Ra1SCn5KWPTM,2205
starlette/_utils.py,sha256=i45Fbx0HlGv8c3jPzZl6BNvGLSF4kLKZawVjqx6rXr0,2806
starlette/applications.py,sha256=xK28LIP2UZ5Z4aQYIFp33klWibtkAdDOnLNwhASForM,10347
starlette/authentication.py,sha256=upvOJIPx5_HXohVapYDPknfPAq-PrXzk7gxXkIWZgWg,4750
starlette/background.py,sha256=D-XpUpFRgUBnZeA1tHgzMOgube6ICVZFlOA4ML0q1T8,1122
starlette/concurrency.py,sha256=D9o38FXqZtqt9nWIzetHPOpW94ruqLS8hNtnEIEfHv0,1630
starlette/config.py,sha256=GVwko0pGSusxuQHO35tL_Nt_ApL0fmVYL3IiHHYpLW4,4426
starlette/convertors.py,sha256=F1rse3AacN9rsfJnTeuDnjbN51r_ouHc3WLyYkjkX_o,2304
starlette/datastructures.py,sha256=3edSMwAGQxx-vBzLlIqVglvlvWuMA4ORM83uWYmcMDA,22448
starlette/endpoints.py,sha256=XODIK1P9lhmi_PH3mtCPBB4Mcw7yjjUJcTzbk7YBXhA,5099
starlette/exceptions.py,sha256=tIphlZa8EsQfKw3-xw5J3ZN1GjaR4UcxfJK69Ad2hG8,1066
starlette/formparsers.py,sha256=Ndl5dGXZtopzJUjM04M5zYhS8sT33e_5JwK2T7Md4zA,11086
starlette/middleware/__init__.py,sha256=BORnOj0n0mL1OWUUs1PLTu1SASmvT8kEEDA6cbuhuPo,1349
starlette/middleware/__pycache__/__init__.cpython-312.pyc,,
starlette/middleware/__pycache__/authentication.cpython-312.pyc,,
starlette/middleware/__pycache__/base.cpython-312.pyc,,
starlette/middleware/__pycache__/cors.cpython-312.pyc,,
starlette/middleware/__pycache__/errors.cpython-312.pyc,,
starlette/middleware/__pycache__/exceptions.cpython-312.pyc,,
starlette/middleware/__pycache__/gzip.cpython-312.pyc,,
starlette/middleware/__pycache__/httpsredirect.cpython-312.pyc,,
starlette/middleware/__pycache__/sessions.cpython-312.pyc,,
starlette/middleware/__pycache__/trustedhost.cpython-312.pyc,,
starlette/middleware/__pycache__/wsgi.cpython-312.pyc,,
starlette/middleware/authentication.py,sha256=-RSwwJ0pIkrM0v-2Ip8HXVB24xtSp7ObzR3OfTC8wSA,1800
starlette/middleware/base.py,sha256=YFqe1rG4gIeK2GpV3bcCYlGtnW_zTLwIotwvKMsGwvs,10333
starlette/middleware/cors.py,sha256=Hp1OBFB1OQbYGRa6hfTzBqkkJHOhUpjrsRryrHItHFQ,7046
starlette/middleware/errors.py,sha256=h76TfVDrdYSvpBAEWgZ91VvPZQe3vRpAl6ChoiXG-Tk,8037
starlette/middleware/exceptions.py,sha256=7OgSUiBgwHS4VMmpaWlw21uDKNDmOMzLVZrWDLDUqWo,2784
starlette/middleware/gzip.py,sha256=_thpCRctguw0tMM6J2iDlAj5vZlol9T673IHtfvfxQE,5899
starlette/middleware/httpsredirect.py,sha256=SNTleaYALGoITV7xwbic4gB6VYdM8Ylea_ykciUz31g,848
starlette/middleware/sessions.py,sha256=IgZkTkgbOhU9tQceQV0KjLAiNp-dKhngcHpu4VYaDXQ,3572
starlette/middleware/trustedhost.py,sha256=byKCUyPge54Z4MznyunD_2DsMfJc2UsfV4b2Du-WYTc,2219
starlette/middleware/wsgi.py,sha256=GQNsZLkCACNVaeY1otMUuDGIF1YZLa5oqC_-5Z3egh0,5350
starlette/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
starlette/requests.py,sha256=ZmUgUFwzRaBfvRuFRGIcEHihxN8jj33pxY2J21lMrfM,11700
starlette/responses.py,sha256=CNctyDpXpj7_75QqVP9scpREL_6o_rF52r-PMC1wSwI,21431
starlette/routing.py,sha256=9PlA8gx4DbzueNmplwPxFOBUb7u5wrfw-ZvzYfq_KBw,34201
starlette/schemas.py,sha256=fBDlI1YDKF_rkQIalqBVQ0PQ9-3gNGh7T_39OyE7rV0,5168
starlette/staticfiles.py,sha256=CDUeXRaKsqojKArSTijvsPsRPWZnmZdEy2EqfrGTdw0,8485
starlette/status.py,sha256=P5SxON3aKW3rwUpJ7cxxD3vvEULMpO-aIzzJRmLwwVs,6359
starlette/templating.py,sha256=D9MY-mUdG599Yd3QKvFs2KtChN6to3spiZ36IM4tJ0c,8293
starlette/testclient.py,sha256=0nuYh5aQixE4buQCZtCNZwVqbeHLm1enNmh83bhD4XQ,27850
starlette/types.py,sha256=87wTuwF1036QxRse3mL5qOuS9i4a9xaIZMqTjY-lvvo,1041
starlette/websockets.py,sha256=phsWgpXclYreVhg-wAyUWpgBWJTibNF5Pi-tNxbmQFY,8336

View File

@@ -0,0 +1,4 @@
Wheel-Version: 1.0
Generator: hatchling 1.27.0
Root-Is-Purelib: true
Tag: py3-none-any

View File

@@ -0,0 +1,27 @@
Copyright © 2018, [Encode OSS Ltd](https://www.encode.io/).
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.