httpc

package module

Go to main page

Versions in this module

v0

v0.8.3

Feb 18, 2026

v0.8.2

Jul 27, 2025

v0.8.1

Jul 16, 2025

Changes in this version

type Option

+ func WithHTTPProxy(proxyURL string) Option

+ func WithSocks5Proxy(proxyURL string) Option

type RequestBuilder

+ func (rb *RequestBuilder) SetRawBody(body []byte) *RequestBuilder

v0.8.0

Jul 6, 2025

Changes in this version

+ var ErrNoResponse = errors.New("httpc: no response")

v0.7.2

Jul 3, 2025

v0.7.1

Jun 19, 2025

Changes in this version

type Option

+ func WithDNSResolver(servers []string, timeout time.Duration) Option

v0.7.0

Jun 10, 2025

Changes in this version

+ var EOF = io.EOF

+ var ErrDecodeResponse = errors.New("httpc: failed to decode response body")

+ var ErrInvalidURL = errors.New("httpc: invalid URL")

+ var ErrMaxRetriesExceeded = errors.New("httpc: max retries exceeded")

+ var ErrRequestTimeout = errors.New("httpc: request timeout")

+ var ErrShortWrite = errors.New("short write")

+ type BufferPool interface

+ Get func() *bytes.Buffer

+ Put func(*bytes.Buffer)

+ type Client struct

+ func New(opts ...Option) *Client

+ func (c *Client) DELETE(urlStr string) *RequestBuilder

+ func (c *Client) Delete(ctx context.Context, url string) (*http.Response, error)

+ func (c *Client) Do(req *http.Request) (*http.Response, error)

+ func (c *Client) GET(urlStr string) *RequestBuilder

+ func (c *Client) Get(url string) (*http.Response, error)

+ func (c *Client) GetContext(ctx context.Context, url string) (*http.Response, error)

+ func (c *Client) HEAD(urlStr string) *RequestBuilder

+ func (c *Client) NewRequest(method, urlStr string, body io.Reader) (*http.Request, error)

+ func (c *Client) NewRequestBuilder(method, urlStr string) *RequestBuilder

+ func (c *Client) OPTIONS(urlStr string) *RequestBuilder

+ func (c *Client) PATCH(urlStr string) *RequestBuilder

+ func (c *Client) POST(urlStr string) *RequestBuilder

+ func (c *Client) PUT(urlStr string) *RequestBuilder

+ func (c *Client) Post(ctx context.Context, url string, body io.Reader) (*http.Response, error)

+ func (c *Client) PostGOB(ctx context.Context, url string, body interface{}) (*http.Response, error)

+ func (c *Client) PostJSON(ctx context.Context, url string, body interface{}) (*http.Response, error)

+ func (c *Client) PostXML(ctx context.Context, url string, body interface{}) (*http.Response, error)

+ func (c *Client) Put(ctx context.Context, url string, body io.Reader) (*http.Response, error)

+ func (c *Client) PutGOB(ctx context.Context, url string, body interface{}) (*http.Response, error)

+ func (c *Client) PutJSON(ctx context.Context, url string, body interface{}) (*http.Response, error)

+ func (c *Client) PutXML(ctx context.Context, url string, body interface{}) (*http.Response, error)

+ func (c *Client) SetDumpLogFunc(dumpLog DumpLogFunc)

+ func (c *Client) SetRetryOptions(opts RetryOptions)

+ func (c *Client) SetTimeout(timeout time.Duration)

+ type DumpLogFunc func(ctx context.Context, log string)

+ type HTTPError struct

+ Body []byte

+ Header http.Header

+ Status string

+ StatusCode int

+ func (e *HTTPError) Error() string

+ type MiddlewareFunc func(next http.RoundTripper) http.RoundTripper

+ type Option func(*Client)

+ func WithBufferPool(pool BufferPool) Option

+ func WithBufferSize(bufferSize int) Option

+ func WithDialTimeout(dialTimeout time.Duration) Option

+ func WithDumpLog() Option

+ func WithDumpLogFunc(dumpLog DumpLogFunc) Option

+ func WithExpectContinueTimeout(expectContinueTimeout time.Duration) Option

+ func WithIdleConnTimeout(idleConnTimeout time.Duration) Option

+ func WithKeepAliveTimeout(keepAliveTimeout time.Duration) Option

+ func WithMaxBufferPoolSize(maxBufferPool int) Option

+ func WithMaxIdleConns(maxIdleConns int) Option

+ func WithMiddleware(middleware ...MiddlewareFunc) Option

+ func WithProtocols(config ProtocolsConfig) Option

+ func WithRetryOptions(opts RetryOptions) Option

+ func WithTLSHandshakeTimeout(tlsHandshakeTimeout time.Duration) Option

+ func WithTimeout(timeout time.Duration) Option

+ func WithTransport(t *http.Transport) Option

+ func WithUserAgent(ua string) Option

+ type ProtocolsConfig struct

+ ForceH2C bool

+ Http1 bool

+ Http2 bool

+ Http2_Cleartext bool

+ type RequestBuilder struct

+ func (rb *RequestBuilder) AddHeader(key, value string) *RequestBuilder

+ func (rb *RequestBuilder) AddQueryParam(key, value string) *RequestBuilder

+ func (rb *RequestBuilder) Build() (*http.Request, error)

+ func (rb *RequestBuilder) Bytes() ([]byte, error)

+ func (rb *RequestBuilder) DecodeGOB(v interface{}) error

+ func (rb *RequestBuilder) DecodeJSON(v interface{}) error

+ func (rb *RequestBuilder) DecodeXML(v interface{}) error

+ func (rb *RequestBuilder) Execute() (*http.Response, error)

+ func (rb *RequestBuilder) NoDefaultHeaders() *RequestBuilder

+ func (rb *RequestBuilder) SetBody(body io.Reader) *RequestBuilder

+ func (rb *RequestBuilder) SetGOBBody(body interface{}) (*RequestBuilder, error)

+ func (rb *RequestBuilder) SetHeader(key, value string) *RequestBuilder

+ func (rb *RequestBuilder) SetHeaders(headers map[string]string) *RequestBuilder

+ func (rb *RequestBuilder) SetJSONBody(body interface{}) (*RequestBuilder, error)

+ func (rb *RequestBuilder) SetQueryParam(key, value string) *RequestBuilder

+ func (rb *RequestBuilder) SetQueryParams(params map[string]string) *RequestBuilder

+ func (rb *RequestBuilder) SetXMLBody(body interface{}) (*RequestBuilder, error)

+ func (rb *RequestBuilder) Text() (string, error)

+ func (rb *RequestBuilder) WithContext(ctx context.Context) *RequestBuilder

+ type RetryOptions struct

+ BaseDelay time.Duration

+ Jitter bool

+ MaxAttempts int

+ MaxDelay time.Duration

+ RetryStatuses []int

+ type RoundTripperFunc func(req *http.Request) (*http.Response, error)

+ func (f RoundTripperFunc) RoundTrip(req *http.Request) (*http.Response, error)

v0.6.0

Jun 9, 2025

v0.5.1

May 13, 2025

v0.5.0

May 5, 2025

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL