first commit
This commit is contained in:
@@ -0,0 +1 @@
|
||||
pip
|
||||
@@ -0,0 +1,179 @@
|
||||
Metadata-Version: 2.1
|
||||
Name: starlette
|
||||
Version: 0.35.1
|
||||
Summary: The little ASGI library that shines.
|
||||
Project-URL: Homepage, https://github.com/encode/starlette
|
||||
Project-URL: Documentation, https://www.starlette.io/
|
||||
Project-URL: Changelog, https://www.starlette.io/release-notes/
|
||||
Project-URL: Funding, https://github.com/sponsors/encode
|
||||
Project-URL: Source, https://github.com/encode/starlette
|
||||
Author-email: Tom Christie <tom@tomchristie.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: License :: OSI Approved :: BSD License
|
||||
Classifier: Operating System :: OS Independent
|
||||
Classifier: Programming Language :: Python :: 3
|
||||
Classifier: Programming Language :: Python :: 3.8
|
||||
Classifier: Programming Language :: Python :: 3.9
|
||||
Classifier: Programming Language :: Python :: 3.10
|
||||
Classifier: Programming Language :: Python :: 3.11
|
||||
Classifier: Programming Language :: Python :: 3.12
|
||||
Classifier: Topic :: Internet :: WWW/HTTP
|
||||
Requires-Python: >=3.8
|
||||
Requires-Dist: anyio<5,>=3.4.0
|
||||
Requires-Dist: typing-extensions>=3.10.0; python_version < '3.10'
|
||||
Provides-Extra: full
|
||||
Requires-Dist: httpx>=0.22.0; extra == 'full'
|
||||
Requires-Dist: itsdangerous; extra == 'full'
|
||||
Requires-Dist: jinja2; extra == 'full'
|
||||
Requires-Dist: python-multipart; extra == 'full'
|
||||
Requires-Dist: pyyaml; extra == 'full'
|
||||
Description-Content-Type: text/markdown
|
||||
|
||||
<p align="center">
|
||||
<a href="https://www.starlette.io/"><img width="420px" src="https://raw.githubusercontent.com/encode/starlette/master/docs/img/starlette.png" alt='starlette'></a>
|
||||
</p>
|
||||
<p align="center">
|
||||
<em>✨ The little ASGI framework that shines. ✨</em>
|
||||
</p>
|
||||
<p align="center">
|
||||
<a href="https://github.com/encode/starlette/actions">
|
||||
<img src="https://github.com/encode/starlette/workflows/Test%20Suite/badge.svg" alt="Build Status">
|
||||
</a>
|
||||
<a href="https://pypi.org/project/starlette/">
|
||||
<img src="https://badge.fury.io/py/starlette.svg" alt="Package version">
|
||||
</a>
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
**Documentation**: [https://www.starlette.io/](https://www.starlette.io/)
|
||||
|
||||
---
|
||||
|
||||
# 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].
|
||||
|
||||
## Requirements
|
||||
|
||||
Python 3.8+
|
||||
|
||||
## Installation
|
||||
|
||||
```shell
|
||||
$ pip3 install starlette
|
||||
```
|
||||
|
||||
You'll also want to install an ASGI server, such as [uvicorn](http://www.uvicorn.org/), [daphne](https://github.com/django/daphne/), or [hypercorn](https://pgjones.gitlab.io/hypercorn/).
|
||||
|
||||
```shell
|
||||
$ pip3 install uvicorn
|
||||
```
|
||||
|
||||
## Example
|
||||
|
||||
**example.py**:
|
||||
|
||||
```python
|
||||
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 example:app
|
||||
```
|
||||
|
||||
For a more complete example, see [encode/starlette-example](https://github.com/encode/starlette-example).
|
||||
|
||||
## 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 `pip3 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/encode/starlette/blob/master/LICENSE.md">BSD licensed</a> code.<br/>Designed & crafted with care.</i></br>— ⭐️ —</p>
|
||||
|
||||
[asgi]: https://asgi.readthedocs.io/en/latest/
|
||||
[httpx]: https://www.python-httpx.org/
|
||||
[jinja2]: https://jinja.palletsprojects.com/
|
||||
[python-multipart]: https://andrew-d.github.io/python-multipart/
|
||||
[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
|
||||
@@ -0,0 +1,76 @@
|
||||
starlette-0.35.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
|
||||
starlette-0.35.1.dist-info/METADATA,sha256=W3NzXg5o039ph9ExHbsVslNc2LUmVtd-6iWbrLm-PhQ,5791
|
||||
starlette-0.35.1.dist-info/RECORD,,
|
||||
starlette-0.35.1.dist-info/WHEEL,sha256=mRYSEL3Ih6g5a_CVMIcwiF__0Ae4_gLYh01YFNwiq1k,87
|
||||
starlette-0.35.1.dist-info/licenses/LICENSE.md,sha256=3LlWd6AiQCQxh-lk-UGEfRmxeCHPmeWvrmhPqzKMGb8,1518
|
||||
starlette/__init__.py,sha256=r5hsNawfV-eVjg5zH6vTQ1QOtWivxR7nTrOD0lh9eMM,23
|
||||
starlette/__pycache__/__init__.cpython-312.pyc,,
|
||||
starlette/__pycache__/_compat.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/_compat.py,sha256=pcaBiAKr9ON7PFVg780yWlgH88AYXTGfcyV6c3awVY4,1148
|
||||
starlette/_exception_handler.py,sha256=oOrWvgjGJd1aUrQUzXBeil-N1yFHBRGyIV7RJwhrdE4,2847
|
||||
starlette/_utils.py,sha256=yi2oFJuyu4Z8fYuSgQSO_Oo4FbLZOErjTbXMvwQidC4,2563
|
||||
starlette/applications.py,sha256=_0pp5Bf6QguMhROUk9DrcFyg4RvjNpq-ArmEkOD48Y4,10923
|
||||
starlette/authentication.py,sha256=0008IUk_M77245IriQTt14JQ0na_MJKUTGLnym4_3Rs,5344
|
||||
starlette/background.py,sha256=g0ouyGnoI2CdtE2N_AJiOYUf1ChyLJcaqFqU8gIlAFo,1259
|
||||
starlette/concurrency.py,sha256=omonQjvpzt_gMbX7AmkkmOkHpyDvYOkWMjcPr6vi5g0,1866
|
||||
starlette/config.py,sha256=XOiXVP14_IyZzGVRCnGTGPnLlzU7g6WCBzvKgvRH3hU,4657
|
||||
starlette/convertors.py,sha256=Q7pKgRyKgXMMIl8xU9foy5mu-EaLzvynYFlKUSHThAo,2254
|
||||
starlette/datastructures.py,sha256=Nu08KwiSLoTcY0nxdF1gjYuc4-1kBd-Bw4PWK6djiE8,23349
|
||||
starlette/endpoints.py,sha256=4f1qb5YVYMR8-Miew6Ad3YzSofpyo34h9sBu4KQTzmk,5191
|
||||
starlette/exceptions.py,sha256=42li4DPq67FKsy3oBWSxXTp39fovJ9X8BexMeM7PaM0,1824
|
||||
starlette/formparsers.py,sha256=DTHDqGKgZb4jzigzDf-hN40ESai_Tc1TT-aesET44F8,10434
|
||||
starlette/middleware/__init__.py,sha256=vra0VmA989DwoFItWIVZk-Okgp7VuJEgOT2SQw4FI7U,1272
|
||||
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=QAXMRz4BBuMWJbCenRrHpIkdEj7Fh8dZBgvQxsDMGFk,1785
|
||||
starlette/middleware/base.py,sha256=hF1QYdnqPyntnNi9N8bY-uGC6Ak3fCR1BCDolgJRv6o,8795
|
||||
starlette/middleware/cors.py,sha256=ugLUxg0vxwTdKDKKZ7TniEhkVfQvri-qB9KdZQnbJzE,7075
|
||||
starlette/middleware/errors.py,sha256=1qLiAVzUeVBfh13jwXZnklMZw8mQUUpLl8R_lhB6bqE,7938
|
||||
starlette/middleware/exceptions.py,sha256=0C8HlE0Ut34bSKA9a5vgRsPWD61EoXwTb73jNDcUcko,2821
|
||||
starlette/middleware/gzip.py,sha256=4PwBc42TLGo50SNUn8PNMndiJmN6VHdIBI5x1Pyq4go,4507
|
||||
starlette/middleware/httpsredirect.py,sha256=SNTleaYALGoITV7xwbic4gB6VYdM8Ylea_ykciUz31g,848
|
||||
starlette/middleware/sessions.py,sha256=2xr6RGuZv1TsKTsgAije8nOXMOMULLgXj_2DRieiy3g,3589
|
||||
starlette/middleware/trustedhost.py,sha256=5oTnnGRXQC4KJTROs802G9tJzBij2zI9ze11aEdbins,2207
|
||||
starlette/middleware/wsgi.py,sha256=fcOJW1ZXMs3tu9o23WLYEG9xEEcJKdudDTgVSE6g4pc,5401
|
||||
starlette/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
||||
starlette/requests.py,sha256=9iN8-ETyWSFN8vd9f5byRSpZjQlJ33l5JspQkn4P5p0,11197
|
||||
starlette/responses.py,sha256=rG4TnNIEYU-2FHL-l0G8R-Rf94VRMO5rvsQC02oWZmY,12651
|
||||
starlette/routing.py,sha256=DW-OWfFqv2a2xsI6WUPlrN8wK1e6JGjiVPCxMRVSZ9I,35754
|
||||
starlette/schemas.py,sha256=Wt0oU6-bN4dJLs-_RAyQjHN6N-8hi9LC6dohqW88HA0,5267
|
||||
starlette/staticfiles.py,sha256=sh_PWT7qLnSlk0ahV5UvctOkkLm4ek1wnIHJkYnVuzU,8724
|
||||
starlette/status.py,sha256=lv40V7igYhk_ONySJzUzQ4T3gTgnvNLCOb846ZUONSE,6086
|
||||
starlette/templating.py,sha256=0JkeqFRmTzFWS23HvRcRYGhSL4ZM9TfG8KcbtONG7ck,8985
|
||||
starlette/testclient.py,sha256=Z09XcBQU7cgHLirt6bxPzNxBI4xoVX9VriwwJKXfcTU,29844
|
||||
starlette/types.py,sha256=X7RxJd6WXO-Z3tBGrx0_W7s9XCg9SUmTqgl_bbHpzYA,1081
|
||||
starlette/websockets.py,sha256=-rbtUttMZZ0-ecpkSGcpoeVp-DRJGk-UXihz41XTOVc,7441
|
||||
@@ -0,0 +1,4 @@
|
||||
Wheel-Version: 1.0
|
||||
Generator: hatchling 1.21.0
|
||||
Root-Is-Purelib: true
|
||||
Tag: py3-none-any
|
||||
@@ -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.
|
||||
Reference in New Issue
Block a user