rapis 0.0.3

Minimalistic web framework

Rapis - Minimalistic web library based on RSGI

this library was inspired by FastAPI so syntax may be identical

! WARNING: Library in early development, it is NOT READY for production

Key features:

• Easy to use: Syntax was inspired by your favourite framework
• Fast: Built on native RSGI protocol with MsgSpec support
• Async Only: Supports only work with async requests handling
• Validation: Built-in support of MsgSpec providing first-class Validation Speed
• Functional that actually MATTER: Framework contains Only what you need to build API without unnecessary dependencies

Requirements

• granian: A Rust HTTP server for Python applications
• msgspec: A fast serialization and validation library

Installation

pip install rapis

Example

# main.py
from rapis import AppRouter, Query, WebApp

router = AppRouter()


@router.get("/")
async def root() -> dict:
    return {}


@router.get("/echo")
async def parametrized_handler(
    data: Query[str] = "default",
) -> str:  # for now waiting for /echo?data=str if not given adds "default"
    return data


app = WebApp()
app.include_router(router)

Run

granian main:app

Better Example

# routes.py
from msgspec import Struct
from rapis import AppRouter, Query

router = AppRouter()


class Item(Struct):
    name: str


@router.get("/queries_with_struct")
async def fetch_item(item: Query[Item]):  # no default means required and will expect to receive all fields in query params
    return Item(name="query")  # automatically parses to {"name": "query"}


@router.post("/echo") # also put, patch
async def fetch_item(item: Item):  # will try to read and validate all fields from body
    return item

# main.py
from rapis import WebApp

from routes import router

app = WebApp()
app.include_router(router)

see more in examples

Performance

section about speed of library (WIP)

DOCS will be implemented soon

TODO

• Exception handling
• Built-in exception handlers (validation, json parsing)
• Benchmarks section
• Request/Response Work model
• Docs
• More availabilities to expand logic (custom routes and other)
• better Query params handle
• change routing from linear to something else (hash maps for static paths, ?? for dynamic paths)
• path patterns logic
• review Middleware logic (partially reviewed)
• websocket support(maybe)
• coverage
• typing support in TY
• some examples
• Problem: how to authenticate users?

CONTRIBUTING

see CONTRIBUTING.md