A developer centric, performant Python web framework
Project description
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.
See this release on GitHub: v0.2.0
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file xpresso-0.2.0.tar.gz.
File metadata
- Download URL: xpresso-0.2.0.tar.gz
- Upload date:
- Size: 38.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.12 CPython/3.10.1 Linux/5.11.0-1025-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 06daa05c97579a4b05d1d68cc4af09fc46616c136eb98d0c7b85fbf4046b7786 |
|
| MD5 | b60b44116240c0711a2947a010309cf9 |
|
| BLAKE2b-256 | f509490fc6d72ef417614a03186d80e5b0009b8aeb0868eecd8a489f8c925d85 |
Provenance
File details
Details for the file xpresso-0.2.0-py3-none-any.whl.
File metadata
- Download URL: xpresso-0.2.0-py3-none-any.whl
- Upload date:
- Size: 66.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.12 CPython/3.10.1 Linux/5.11.0-1025-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6dad5a1ca505f218789ff9f964fc6f44ff7e084412ec50e7e61a9bce83bb878d |
|
| MD5 | ff7d65e269fb0bae2dc83a3bb3a03dd0 |
|
| BLAKE2b-256 | 5a02e3c7bb65ecc12d186f3cf112e03aad154f18daf2e324fc061afc589c0e06 |
