elixir-plug/plug
Plug
Plug is a specification and set of primitives for building composable middleware pipelines in Elixir web applications. It provides a system for managing HTTP request pipelines and a routing engine that dispatches incoming requests to specific handlers based on methods and URL patterns.
The project enables the creation of interchangeable web middleware for tasks such as authentication, logging, and session management. It also includes mechanisms for upgrading standard HTTP requests to full-duplex WebSocket connections.
The capability surface covers request body parsing, static asset delivery, and security primitives including basic authentication and cross-site request forgery protection. It incorporates telemetry instrumentation for performance tracking and provides utilities for simulating request pipelines to verify connection states without a live server.
Features
- Middleware Composition Layers - Provides a structural pattern for processing web requests through chains of reusable middleware functions.
- Middleware Pipelines - Provides the core specification and primitives for building composable middleware pipelines in Elixir web applications.
- Web Framework Middleware - Establishes a standard for creating interchangeable middleware components for authentication, logging, and session management.
- Immutable Connection State Management - Implements request and response tracking using a single immutable connection struct passed through the pipeline.
- Pipeline State Manipulations - Enables building web applications by piping requests through reusable functions to manipulate connection data.
- Web Server Abstractions - Provides an abstraction layer that allows applications to run across different web server implementations without changing core logic.
- HTTP Request Handlers - Implements the core request processing pipeline, managing the lifecycle of incoming requests through middleware.
- Request Middleware - Provides mechanisms for intercepting and processing HTTP requests using shared logic for authentication and logging.
- Request Pipelines - Implements an architectural pattern for intercepting and processing network requests through sequential lifecycle hooks.
- Request Routing - Includes a high-performance routing engine that dispatches incoming requests to handlers based on URL paths and methods.
- HTTP Routing - Implements mechanisms for directing incoming HTTP traffic to handlers based on request methods and paths.
- Tree-Based Route Resolvers - Utilizes an efficient tree-based lookup structure to match incoming URL paths to specific request handlers.
- Web Pipeline Specifications - Acts as a specification and set of primitives for building composable middleware pipelines in Elixir.
- Server Interface Abstractions - Provides a server interface abstraction that decouples application logic from the underlying web server implementation.
- Websocket Connection Managers - Provides a mechanism to upgrade standard HTTP requests to persistent, full-duplex WebSocket connections.
- Connection Upgraders - Implements the mechanism to upgrade standard HTTP requests to full-duplex WebSocket connections.
- Session Management - Ships capabilities for handling the creation and retrieval of session data to maintain user state across requests.
- Execution Telemetry Pipelines - Emits standardized telemetry events during the request lifecycle to enable external performance monitoring.
- Simulated Request Testing - Provides utilities to simulate HTTP requests and verify connection states without requiring a live network server.
- Request Body Handling - Provides mechanisms to convert raw request bodies into structured data based on content type headers.
- API Frameworks - Composable module specification for Elixir web apps.
