imroc/req

Features

• Fluent HTTP Request Configuration - Implements a builder pattern allowing sequential method calls to configure HTTP request parameters fluently.
• HTTP Client Libraries - Implements a chainable Go library for configuring HTTP requests and automatically decoding responses into structures.
• HTTP Clients - A chainable HTTP client library for Go that simplifies request configuration and automatic response decoding.
• HTTP Body Serialization - Automatically converts structured data to appropriate formats like JSON or XML for network transmission.
• Request-Response Middleware - Processes HTTP requests and responses through a sequence of pluggable handlers for centralized management.
• REST API Integrations - Simplifies connection to external REST services through automated data serialization and error mapping.
• API Client SDK Builders - Provides utilities for encapsulating base URLs, shared headers, and authentication into reusable client implementations.
• Concurrent File Downloaders - Increases download speeds by splitting large files into segments and fetching them concurrently.
• TLS Fingerprint Emulators - Replicates exact TLS handshake parameters and cipher suites of target browsers to evade bot detection.
• Fluent Request Builders - Uses an API pattern with method chaining to accumulate request configuration state before execution.
• Response Body Decoders - Transforms HTTP response payloads into type-safe objects using configurable decoding strategies based on status codes.
• Middleware Pipelines - Allows injection of custom logic into request, response, client, and transport pipelines via middleware.
• Content-Type Based Deserializers - Detects the Content-Type header to automatically determine the appropriate request and response parsing strategy.
• Request Body Attachers - Enables attaching raw strings, form-encoded parameters, or JSON data as the body of an HTTP request.
• HTTP Middleware Pipelines - Provides a pluggable middleware pipeline for intercepting and transforming HTTP requests and responses.
• Scraping Infrastructure Management - Bypasses bot detection using TLS fingerprint emulation and automatic proxy rotation.
• Path Parameter Definitions - Enables the definition of dynamic segments within a URL path to create reusable API request templates.
• Request Parameter Configuration - Provides tools for defining dynamic query and path parameters for outgoing network requests.
• Automatic Retry Clients - Automatically retries failed network calls using customizable backoff strategies and policies.
• Response Body Streaming - Directs response bodies into custom writers for immediate, fragment-based processing.
• Application-Level Traffic Interception - Executes custom logic within the application request pipeline for tracing and cross-cutting concerns.
• Automated File Transfer Workflows - Implements robust upload and download workflows featuring parallel streaming and direct file system writing.
• Client Default Settings - Offers centralized configuration for base URLs and user agents applied across all client requests.
• Multipart File Uploads - Sends files and form data to servers using multipart encoding.
• HTTP Proxy Configuration - Supports routing traffic through proxy servers to obscure the request origin.
• HTTP Request Debugging - Captures raw requests and responses and traces network performance metrics for troubleshooting.
• Transport Layer Interceptors - Implements transport wrapping to intercept low-level network exchanges for debugging and telemetry.
• Network Latency Measurements - Measures timing for DNS lookups, TCP connections, and TLS handshakes to identify network latency.
• Network Traffic Analyzers - Captures, traces, and dumps raw request and response details to troubleshoot communication issues.
• Proxy and Fingerprint Rotation - Automatically rotates proxy servers to bypass rate limits and avoid IP blocking.
• Download Progress Tracking - Reports the progress of file downloads through a configurable callback function.
• Request Header Configuration - Includes comprehensive tools for defining and managing custom HTTP request headers and their ordering.
• Upload Progress Tracking - Monitors the percentage of data sent during file uploads via a callback function.
• TLS Handshake Orchestrators - Dynamically manages TLS handshake parameters using custom certificates and browser fingerprints.
• Structured Error Responses - Converts error response bodies into structured objects when the server returns failure status codes.
• Cookie Management - Automates the storage and transmission of session cookies across multiple network requests.
• Error Handling Middleware - Uses middleware to uniformly process API errors and network failures across all requests.
• HTTP Status-to-Logic Mappings - Maps non-success HTTP status codes to specific error objects using unified client-level logic.
• Error Type Transformations - Converts consistent API error formats from server responses into uniform internal error types.
• Direct-to-File Response Saving - Writes response bodies directly to files to avoid loading large payloads into memory.
• Cookie Management - Automatically stores cookies from server responses and attaches them to subsequent requests.
• Retry and Backoff Logic - Implements automated retry strategies and exponential backoff to handle network instability.
• Query Parameter Manipulators - Offers utilities for adding, removing, or replacing query string values using maps or structs.

Star history