Skip to main content

A developer centric, performant Python web framework

Project description

Xpresso

Test Coverage Package version Supported Python versions

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:

Swagger UI

For more examples, tutorials and reference materials, see our documentation.

Inspiration and relationship to other frameworks

Xpresso is mainly inspired by FastAPI. FastAPI pioneered several ideas that are core to Xpresso's approach:

  • Leverage Pydantic for JSON parsing, validation and schema generation.
  • Leverage Starlette for routing and other low level web framework functionality.
  • Provide a simple but powerful dependency injection system.
  • Use that dependency injection system to provide extraction of request bodies, forms, query parameters, etc.

Xpresso takes these ideas and refines them by:

Current state

This project is under active development. It should not be considered "stable" or ready to be used in production. It is however ready for experimentation and learning!

What is implemented and mostly stable?

  1. Extraction and OpenAPI documentation of parameters (query, headers, etc.) and request bodies (including multipart requests).
  2. Parameter serialization.
  3. Routing, including applications, routers and routes.
  4. Dependency injection and testing utilities (dependency overrides).

Most of this APIs will be generally stable going forward, although some minor aspects like argument names will probably change at some point.

What is not implemented or unstable?

  1. Low-level API for binders (stuff in xpresso.binders): this is public, but should be considered experimental and is likely to change. The high level APIs (FromPath[str] and Annotated[str, PathParam(...)]) are likely to be stable.
  2. Security dependencies and OpenAPI integration. This part used to exist, but needed some work. It is planned for the future, but we need to think about the scope of these features and the API.

See this release on GitHub: v0.46.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

xpresso-0.46.0.tar.gz (44.2 kB view details)

Uploaded Source

Built Distribution

xpresso-0.46.0-py3-none-any.whl (62.8 kB view details)

Uploaded Python 3

File details

Details for the file xpresso-0.46.0.tar.gz.

File metadata

  • Download URL: xpresso-0.46.0.tar.gz
  • Upload date:
  • Size: 44.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.11.1 Linux/5.15.0-1024-azure

File hashes

Hashes for xpresso-0.46.0.tar.gz
Algorithm Hash digest
SHA256 04eb84086f49e8e8c8876e9c4f42e427b87497369d91afca6d464ab17b2ee91f
MD5 536b59eeb84ebcf83a977a4f1b88baf1
BLAKE2b-256 9b37aa86b88be41bbf2a15264012076ab974b16390b625d8741cfcb6f1d9e306

See more details on using hashes here.

Provenance

File details

Details for the file xpresso-0.46.0-py3-none-any.whl.

File metadata

  • Download URL: xpresso-0.46.0-py3-none-any.whl
  • Upload date:
  • Size: 62.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.13 CPython/3.11.1 Linux/5.15.0-1024-azure

File hashes

Hashes for xpresso-0.46.0-py3-none-any.whl
Algorithm Hash digest
SHA256 72034522eee732a78c4ddf67ec6c10080b499eb9e7f32dba43d5464b0a71b5d1
MD5 004e4da53fbdce35077baab3afd537a3
BLAKE2b-256 2150a4fd8df8b74590c18a1381a7774cc137a7882d70203d48ef6dc211410f9f

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page