Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abersheeran/baize
Powerful and exquisite WSGI/ASGI framework/toolkit.
https://github.com/abersheeran/baize
asgi python3 wsgi
Last synced: 3 days ago
JSON representation
Powerful and exquisite WSGI/ASGI framework/toolkit.
- Host: GitHub
- URL: https://github.com/abersheeran/baize
- Owner: abersheeran
- License: apache-2.0
- Created: 2021-02-21T04:51:11.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-12-12T03:48:44.000Z (11 months ago)
- Last Synced: 2024-05-21T00:07:14.482Z (6 months ago)
- Topics: asgi, python3, wsgi
- Language: Python
- Homepage: https://baize.aber.sh
- Size: 609 KB
- Stars: 76
- Watchers: 7
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BáiZé
[](https://codecov.io/gh/abersheeran/baize)
[](https://pypi.org/project/baize/)
Powerful and exquisite WSGI/ASGI framework/toolkit.
The minimize implementation of methods required in the Web framework. No redundant implementation means that you can freely customize functions without considering the conflict with baize's own implementation.
Under the ASGI/WSGI protocol, the interface of the request object and the response object is almost the same, only need to add or delete `await` in the appropriate place. In addition, it should be noted that ASGI supports WebSocket but WSGI does not.
- Type annotations as strict as possible (almost no Any)
- Support range file response, server-sent event response
- Support WebSocket (only ASGI)
- WSGI, ASGI routing to combine any application like [Django(wsgi)](https://docs.djangoproject.com/en/3.0/howto/deployment/wsgi/)/[Kuí(wsgi)](https://kui.aber.sh/wsgi/)/[Pyramid](https://trypyramid.com/)/[Bottle](https://bottlepy.org/)/[Flask](https://flask.palletsprojects.com/) or [Django(asgi)](https://docs.djangoproject.com/en/3.0/howto/deployment/asgi/)/[Kuí(asgi)](https://kui.aber.sh/asgi/)/[Starlette](https://www.starlette.io/)/[FastAPI](https://fastapi.tiangolo.com/)/[Sanic](https://sanic.readthedocs.io/en/stable/)/[Quart](https://pgjones.gitlab.io/quart/)
## Install
```
pip install -U baize
```
## Document and other website
[BáiZé Document](https://baize.aber.sh/)
If you have questions or idea, you can send it to [Discussions](https://github.com/abersheeran/baize/discussions).
## Quick Start
A short example for WSGI application, if you don't know what is WSGI, please read [PEP3333](https://www.python.org/dev/peps/pep-3333/).
```python
import time
from typing import Callable
from baize.wsgi import (
decorator,
request_response,
Router,
Request,
Response,
PlainTextResponse,
)
@decorator
def timer(request: Request, next_call: Callable[[Request], Response]) -> Response:
start_time = time.time()
response = next_call(request)
end_time = time.time()
response.headers["x-time"] = str(round((end_time - start_time) * 1000))
return response
@request_response
@timer
def sayhi(request: Request) -> Response:
return PlainTextResponse("hi, " + request.path_params["name"])
@request_response
@timer
def echo(request: Request) -> Response:
return PlainTextResponse(request.body)
application = Router(
("/", PlainTextResponse("homepage")),
("/echo", echo),
("/sayhi/{name}", sayhi),
)
if __name__ == "__main__":
import uvicorn
uvicorn.run(application, interface="wsgi", port=8000)
```
A short example for ASGI application, if you don't know what is ASGI, please read [ASGI Documention](https://asgi.readthedocs.io/en/latest/).
```python
import time
from typing import Awaitable, Callable
from baize.asgi import (
decorator,
request_response,
Router,
Request,
Response,
PlainTextResponse,
)
@decorator
async def timer(
request: Request, next_call: Callable[[Request], Awaitable[Response]]
) -> Response:
start_time = time.time()
response = await next_call(request)
end_time = time.time()
response.headers["x-time"] = str(round((end_time - start_time) * 1000))
return response
@request_response
@timer
async def sayhi(request: Request) -> Response:
return PlainTextResponse("hi, " + request.path_params["name"])
@request_response
@timer
async def echo(request: Request) -> Response:
return PlainTextResponse(await request.body)
application = Router(
("/", PlainTextResponse("homepage")),
("/echo", echo),
("/sayhi/{name}", sayhi),
)
if __name__ == "__main__":
import uvicorn
uvicorn.run(application, interface="asgi3", port=8000)
```
## License
Apache-2.0.