litestar-org / litestar

Litestar is an ASGI framework for building APIs in Python that bundles data validation, dependency injection, ORM integration, authorization guards, middleware and a plugin API so these parts do not have to be assembled separately. Route handlers are typed, and those type hints drive OpenAPI schema generation as well as validation and parsing of data. Requests enter a Litestar application object built from route handlers, where litestar/init.py exposes names such as Litestar and get and litestar/app.py is one of the package's entry points. Handler parameters are declared centrally in litestar/params.py, litestar/_kwargs/kwargs_model.py handles the keyword arguments passed to handlers, and litestar/cli/main.py implements the litestar command that runs an application. The repository is organized into layers named API, Middleware, Application, CLI, Config, Data, Utility, Types and Docs & Tooling, with Docs & Tooling and Application holding the most files. To start reading, begin with the Quick Start example, then litestar/app.py and litestar/init.py, and use the tests directory for unit tests and the docs directory for documentation sources.