httpclient

Jun 13, 2025

Changes in this version

type Client

+ TLSClientConfig *tls.Config

type NewClientOption

+ func WithTLSClientConfig(tlsConfig *tls.Config) NewClientOption

Jun 12, 2025

Changes in this version

type Client

+ Config *Config

+ Transport *ResilientTransport

type Config

+ RetryStrategy RetryStrategyConfig

+ ServerErrorThreshold int

+ type NewClientOption func(*Client)

+ func WithConfig(config *Config) NewClientOption

type ResilientTransport

+ CircuitBreaker *CircuitBreaker

+ Config *Config

+ RetryStrategy *RetryStrategy

+ Transport http.RoundTripper

+ type RetryStrategyConfig struct

+ Enabled bool

+ InitialInterval time.Duration

+ MaxAttempts uint

+ MaxInterval time.Duration

+ Multiplier float64

+ RandomFactor float64

Jun 10, 2025

Changes in this version

+ var ErrAllRetryAttemptsFailed = errors.New("all retry attempts failed")

+ var ErrRequestContextError = errors.New("request context error")

+ var ErrTransportError = errors.New("transport error")

type CircuitState

+ func (i CircuitState) String() string

Feb 25, 2025

Changes in this version

+ const DefaultFailureThreshold

+ const DefaultHalfOpenSuccess

+ const DefaultInitialInterval

+ const DefaultMaxAttempts

+ const DefaultMaxInterval

+ const DefaultMultiplier

+ const DefaultRandomFactor

+ const DefaultResetTimeout

+ const DefaultServerErrorThreshold

+ var ErrCircuitOpen = errors.New("circuit breaker is open")

+ var ErrMaxRetries = errors.New("max retries exceeded")

+ var ErrRequestBodyNotRetriable = errors.New("request body cannot be retried, implement GetBody to enable retries")

+ type CircuitBreaker struct

+ Config CircuitBreakerConfig

+ func NewCircuitBreaker(config CircuitBreakerConfig) *CircuitBreaker

+ func (cb *CircuitBreaker) IsAllowed() bool

+ func (cb *CircuitBreaker) OnFailure()

+ func (cb *CircuitBreaker) OnSuccess()

+ func (cb *CircuitBreaker) State() CircuitState

+ type CircuitBreakerConfig struct

+ Enabled bool

+ FailureThreshold uint

+ HalfOpenSuccessNeeded uint

+ ResetTimeout time.Duration

+ ServerErrorThreshold int

+ type CircuitState int

+ const StateClosed

+ const StateHalfOpen

+ const StateOpen

+ type Client struct

+ func DefaultClient() *Client

+ func NewClient(cb *CircuitBreaker, rs *RetryStrategy) *Client

+ func (c *Client) CircuitBreaker() *CircuitBreaker

+ func (c *Client) RetryStrategy() *RetryStrategy

+ type Config struct

+ CircuitBreaker CircuitBreakerConfig

+ Retry RetryConfig

+ type ResilientTransport struct

+ func NewResilientTransport(transport http.RoundTripper, cb *CircuitBreaker, rs *RetryStrategy) *ResilientTransport

+ func (t *ResilientTransport) CancelRequest(req *http.Request)

+ func (t *ResilientTransport) RoundTrip(req *http.Request) (*http.Response, error)

+ type RetryConfig struct

+ Enabled bool

+ InitialInterval time.Duration

+ MaxAttempts uint

+ MaxInterval time.Duration

+ Multiplier float64

+ RandomFactor float64

+ type RetryStrategy struct

+ Config RetryConfig

+ func DefaultRetryStrategy() *RetryStrategy

+ func NewRetryStrategy(config RetryConfig) *RetryStrategy

+ func (r *RetryStrategy) NextBackoff(attempt uint) time.Duration