rack/rack
Rack
Rack este o interfață minimală care standardizează modul în care serverele web și framework-urile Ruby comunică. Oferă o interfață de aplicație web și o interfață de server web, permițând aplicațiilor Ruby să ruleze pe diferite implementări de server prin utilizarea unui hash de mediu comun și a unui tuplu de răspuns standardizat.
Proiectul implementează un pipeline de middleware HTTP modular, permițând cererilor și răspunsurilor să fie interceptate și modificate printr-o secvență de obiecte apelabile. Suportă gestionarea conexiunilor la nivel scăzut, inclusiv hijacking-ul conexiunii TCP pentru gestionarea protocoalelor personalizate, semnalizarea upgrade-ului de protocol și streaming-ul de date bidirecțional.
Suprafața de capabilități se extinde la gestionarea cererilor și răspunsurilor, inclusiv citirea fluxului de cereri binare și streaming-ul incremental al răspunsurilor. Oferă instrumente pentru gestionarea sesiunilor, rutarea căilor aplicației și livrarea fișierelor statice din sistemul de fișiere local. Pentru asigurarea calității, include utilitare pentru simularea traficului HTTP și a mediilor de server.
Proiectul include un instrument de linie de comandă pentru a lansa servere web compatibile pentru găzduirea aplicațiilor.
Features
- Web Environment Interfaces - Provides a standardized environment hash to decouple web servers from application logic.
- Web Server Interfaces - Provides a standardized interface that decouples Ruby web servers from the frameworks they host.
- Binary Request Stream Interfaces - Enables access to raw HTTP request bodies via binary-mode input streams with buffered reads.
- Response Tuple Specifications - Standardizes the server response as a simple array containing a status code, response headers, and a body.
- HTTP Request and Response Handlers - Provides comprehensive tools for processing raw request streams and managing HTTP response delivery.
- Request Interception Middleware - Implements a modular middleware pipeline to intercept and modify requests and responses.
- HTTP Middleware Pipelines - Implements a modular pipeline of callable objects to intercept and modify HTTP requests and responses.
- Ruby Web Server Interfaces - Standardizes how Ruby web servers and frameworks communicate via a common environment hash and response tuple.
- Web Application Interfaces - Provides a specification that enables Ruby applications to run across different server implementations without modification.
- Session Data Stores - Provides a standardized hash-like interface for storing and retrieving persistent user data across requests.
- Response Body Streaming - Implements incremental response body delivery using a callable object that responds to each.
- Response Body Callbacks - Handles two-way server-client communication by passing a callback as the response body.
- Connection Hijacking - Allows taking direct control of raw TCP connections to bypass standard request-response cycles.
- TCP Connection Hijacking - Allows direct control of raw TCP connections to bypass standard request-response cycles.
- Application Instance Routing - Maps specific URL paths to different application instances within a single process.
- Application Environment Mocking - Includes utilities to simulate the server environment and response tuples for application testing.
- API Request Mocking - Simulates requests and responses in a testing environment to verify application behavior.
- HTTP Traffic Simulation - Includes utilities to simulate HTTP requests and responses for testing application behavior.
- Incremental Response Streaming - Provides the ability to stream HTTP response bodies incrementally to the client.
- Multipart Form Parsing - Parses multipart/form-data requests to extract uploaded files and form fields.
- Protocol Upgrades - Enables signaling the web server to upgrade the protocol via environment headers.
- Filesystem Static File Servings - Delivers static files and directory indexes from the local filesystem to the client.
- Static File Servers - Includes a built-in implementation for serving static files and directory indexes from the filesystem.
