litestar-org/litestar
Litestar
Litestar is a high-performance Python ASGI web framework designed for building asynchronous APIs and web services. It functions as a type-safe toolkit that leverages Python type hints to provide automatic request validation and response serialization, while natively generating interactive API documentation based on the OpenAPI specification.
The framework is distinguished by its integrated dependency injection system, which manages shared resources and resolves complex nested service chains directly within request handlers. It further organizes API development through class-based controllers that allow developers to group related endpoints and share common path prefixes.
The capability surface includes a layered middleware pipeline for intercepting requests, route-level authorization guards for endpoint security, and a plugin system for extending core serialization behaviors. It also provides tools for data transfer object management, static file serving, and a command-line interface for application management.
Features
- ASGI-Based - Implements the Asynchronous Server Gateway Interface standard to process concurrent HTTP connections via a non-blocking event loop.
- Type-Safe API Frameworks - A web toolkit that uses Python type hints for automatic request validation and response serialization.
- ASGI Frameworks - Functions as a high-performance Python web framework implementing the ASGI standard for asynchronous interoperability.
- Strongly-Typed Validators - Leverages Python type annotations to automatically parse and validate request and response payloads.
- Data Validation Schemas - Provides schema-based validation to enforce strict data types and structures for incoming requests and outgoing responses.
- Dependency Injection Containers - Provides a configurable container to resolve and inject required services into request handlers.
- Dependency Injection - Features an integrated dependency injection system to manage shared resources and resolve complex service chains.
- Type-Hint-Based Schema Definitions - Leverages Python type hints to automatically define data structures and validation rules for request and response serialization.
- Asynchronous Server Toolkits - Provides a comprehensive toolkit for managing the asynchronous request-response lifecycle, routing, and middleware.
- Asynchronous API Routing - Provides native support for high-performance web services using asynchronous request handling and non-blocking logic.
- HTTP Routing - Maps incoming HTTP requests to specific functions or controllers using path patterns and method decorators.
- JSON Serializers - Converts internal data models and dictionaries into standardized JSON format for client responses.
- Interactive Documentation Interfaces - Automatically generates interactive web interfaces based on the OpenAPI specification for exploring and testing services.
- API Security Management - Implements API security management tools to control access, identities, and permissions for sensitive resources.
- API Security - Provides security measures and authorization guards to protect API endpoints from unauthorized access.
- Request Guards - Provides route-level request guards to validate authorization before requests reach the primary handlers.
- Automated API Documentation - Automatically generates interactive API documentation and technical specifications directly from endpoint code definitions.
- Data Transfer Object Mapping - Transforms and filters data moving between external requests and internal data models using data transfer objects.
- Dependency Injection Frameworks - Includes a dependency injection framework to decouple software components and manage object lifecycles.
- Dependency Injection Providers - Provides synchronous and asynchronous providers to pass shared resources or state to request handlers.
- Composable Middleware Pipelines - Features a composable middleware pipeline for intercepting and processing cross-cutting concerns in the request lifecycle.
- API Documentation - Automatically generates interactive web interfaces for exploring and testing available API endpoints.
- Class-Based Views - Uses class-based views to group related request handlers and share common logic across resource domains.
- Middleware Chains - Processes incoming requests and outgoing responses through a series of layered middleware wrappers for cross-cutting concerns.
- Request Parameter Parsers - Extracts and converts path and query parameters into specific data types for use within request handlers.
- RESTful API Frameworks - Offers tools for building RESTful web services, including class-based controllers to organize endpoints and resources.
- OpenAPI Specification Generators - Automatically derives OpenAPI specifications from endpoint definitions to create interactive API documentation.
- Route Organization - Groups related endpoints into controllers to organize data operations and share common path prefixes.
- Web Frameworks - Flexible and extensible ASGI framework.
