httpclient

Documentation

Index

• Constants
• func DefaultTransport() http.RoundTripper
• func NewPlainClient() *http.Client
• func NewRetryClient() *http.Client
• func NewThrottledRetryClient(limitPeriod time.Duration, requestCount int) *http.Client
• func ProxyOnlyTransport() http.RoundTripper
• type HTTPClient
• type MockClient
  • func (m *MockClient) Do(req *http.Request) (*http.Response, error)
  • func (m *MockClient) Get(url string) (*http.Response, error)

Constants

const RetryCount = 3

Functions

func DefaultTransport

func DefaultTransport() http.RoundTripper

DefaultTransport returns a RoundTripper with retry and proxy support. Use when a third-party library needs a transport rather than a full http.Client.

func NewPlainClient

func NewPlainClient() *http.Client

NewPlainClient returns an HTTP client with proxy support but no retry.

func NewRetryClient

func NewRetryClient() *http.Client

func NewThrottledRetryClient

func NewThrottledRetryClient(limitPeriod time.Duration, requestCount int) *http.Client

NewThrottledRetryClient returns an HTTP client with rate limiting wrapping retry + proxy.

func ProxyOnlyTransport

func ProxyOnlyTransport() http.RoundTripper

ProxyOnlyTransport returns a RoundTripper with proxy support but no retry. Use when the caller handles its own retry (e.g. go-containerregistry) or for non-idempotent operations (e.g. OAuth token exchange) where retry is unsafe.

Types

type HTTPClient

type HTTPClient interface {
	Do(req *http.Request) (*http.Response, error)
	Get(url string) (*http.Response, error)
}

HTTPClient interface to define the contract of ALL http client to be used (http package or mocks)

type MockClient

type MockClient struct {
	DoFunc func(req *http.Request) (*http.Response, error)
}

MockClient is a stub implementation of an http.Client with a custom `Do` method

func (*MockClient) Do

func (m *MockClient) Do(req *http.Request) (*http.Response, error)

Do is the mock client's `Do` function that you can customize

func (*MockClient) Get

func (m *MockClient) Get(url string) (*http.Response, error)