rapis 0.0.4

Minimalistic web framework

Rapis - Minimalistic web framework based on RSGI

this framework was inspired by FastAPI so syntax may be identical

⚠️ WARNING: Framework 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

• msgspec: A fast serialization and validation library

Installation

pip install rapis
# install any rsgi compatible web-server
pip install granian
# or simply
pip install rapis[standard] # includes granian in requirements

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)

more examples

Performance

see benchmarks

Docs

see wiki

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
• websocket support(maybe)
• coverage
• typing support in TY
• some examples
• Problem: how to authenticate users?
• Problem: how to send files?
• Problem: how to work with cookies?
• https://jcristharif.com/msgspec/perf-tips.html

CONTRIBUTING

see CONTRIBUTING.md