Introduction
xpresso is an ASGI web framework built on top of Starlette, Pydantic and di, with heavy inspiration from FastAPI.
Some of the standout features are:
- ASGI support for high performance (within the context of Python web frameworks)
- OpenAPI documentation generation
- Automatic parsing and validation of request bodies and parameters, with hooks for custom extractors
- Full support for OpenAPI parameter serialization
- Highly typed and tested codebase with great IDE support
- A powerful dependency injection system, backed by di
Requirements
Python 3.7+
Installation
pip install xpresso
You'll also want to install an ASGI server, such as Uvicorn.
pip install uvicorn
Example
Create a file named example.py:
from pydantic import BaseModel
from xpresso import App, Path, FromPath, FromQuery
class Item(BaseModel):
item_id: int
name: str
async def read_item(item_id: FromPath[int], name: FromQuery[str]) -> Item:
return Item(item_id=item_id, name=name)
app = App(
routes=[
Path(
"/items/{item_id}",
get=read_item,
)
]
)
Run the application:
uvicorn example:app
Navigate to http://127.0.0.1:8000/items/123?name=foobarbaz in your browser. You will get the following JSON response:
{"item_id":123,"name":"foobarbaz"}
Now navigate to http://127.0.0.1:8000/docs to poke around the interactive Swagger UI documentation:
For more examples, tutorials and reference materials, see our documentation.
61 Apr 06, 2022
13.2k Jan 05, 2023
491 Dec 08, 2022
8 Dec 07, 2021
16.7k Jan 08, 2023
72 Nov 30, 2022
1 Dec 07, 2021
32 Dec 24, 2022
1 Dec 26, 2021
2.7k Jan 04, 2023
3.7k Dec 30, 2022
1 Jul 02, 2022
1 Jan 04, 2022
3 Apr 12, 2022
32 Mar 05, 2022
1.6k Jan 09, 2023
16 Dec 15, 2022
9k Jan 01, 2023
5.8k Dec 30, 2022
525 Jan 01, 2023