lostisland/faraday
Faraday
Faraday is an HTTP client library for Ruby that sends requests and processes responses through a middleware pipeline with pluggable adapters. Its core identity is built around a middleware-pipeline architecture where HTTP requests and responses flow through a chain of components that can modify, log, or transform data before reaching the backend, combined with an adapter-based backend abstraction that delegates HTTP execution to interchangeable backends like Net::HTTP or Typhoeus.
The library distinguishes itself through a parallel-execution engine that dispatches multiple HTTP requests concurrently using thread-based or event-driven mechanisms, a streaming response handler that delivers response data incrementally as chunks arrive, and connection-pooling transport that reuses persistent TCP connections across multiple requests. It also includes content-type parsing middleware that automatically detects response content types and parses bodies into structured formats like JSON, XML, or YAML, and a file-upload multipart encoder for encoding file data into multipart/form-data bodies.
Faraday supports automatic response body parsing, the ability to swap HTTP adapters without rewriting application code, and the capability to upload files via HTTP. The library provides mechanisms for executing requests in parallel and reusing persistent connections to reduce latency in network-bound applications.
Features
- HTTP Client Libraries - An HTTP client library that sends requests and processes responses through a middleware pipeline with pluggable adapters.
- HTTP Client Adapters - Making HTTP requests from Ruby applications with a consistent interface that works across multiple backend adapters.
- Request-Response Middleware - Run HTTP requests and responses through a middleware pipeline to add custom behavior.
- Response Body Parsing - Parse response bodies into structured formats like JSON, XML, or YAML without manual conversion.
- Response Streaming - Receive HTTP response data piece by piece as it arrives from the server.
- Connection Pooling - An HTTP client that reuses persistent TCP connections across multiple requests to reduce latency.
- Parallel Request Executions - Sending multiple HTTP requests concurrently to reduce total wait time in network-bound applications.
- Parallel Execution Engines - Multiple HTTP requests are dispatched concurrently using thread-based or event-driven mechanisms to minimize total wait time.
- Composable Middleware Pipelines - Adding custom behavior to HTTP requests and responses through a composable middleware chain.
- HTTP Client Adapters - A common interface delegates HTTP execution to interchangeable backend adapters like Net::HTTP or Typhoeus, enabling runtime backend switching.
- Middleware Architectures - HTTP requests and responses flow through a chain of middleware components that can modify, log, or transform data before reaching the adapter.
- HTTP Middleware Pipelines - An extensible middleware stack that intercepts and transforms HTTP requests and responses for custom behavior.
- Streaming Response Handlers - Response data is delivered incrementally as chunks arrive from the server, allowing processing before the full body is received.
- Parallel Request Executors - A mechanism that runs multiple HTTP requests concurrently to minimize total wait time.
- Content-Type Parsing Middleware - Middleware automatically detects response content types and parses bodies into structured formats like JSON, XML, or YAML.
- HTTP File Uploads - Send file data inside an HTTP request body to a remote server.
- HTTP Keep-Alive Connections - Keep TCP connections alive across multiple requests to avoid repeated handshakes.
- Response Streaming - Receiving response data incrementally as it arrives from the server rather than waiting for the full payload.
- Concurrent Request Pooling - Run multiple HTTP requests concurrently to reduce total wait time.
- API Client Development Tools - Flexible HTTP client library for Ruby.
- HTTP Clients - Modular HTTP client with support for multiple adapters.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
