httpclient

package

Go to main page

Versions in this module

v0

v0.7.4

May 2, 2026

Changes in this version

type Client

+ func (c *Client) NewInterfaceResolver(ctx context.Context) (InterfaceResolver, error)

+ func (c *Client) NewTransport(ctx context.Context) (http.RoundTripper, error)

type Option

+ func WithDefaultInterfaceResolver() Option

+ func WithDefaultTransportFactory() Option

+ func WithInterfaceResolver(r InterfaceResolver) Option

+ func WithInterfaceResolverFactory(fn func(context.Context) (InterfaceResolver, error)) Option

+ func WithTraceLevel(v TraceLevel) Option

+ func WithTransportFactory(fn func(context.Context) (http.RoundTripper, error)) Option

+ func WithUserAgent(s string) Option

v0.7.3

Apr 22, 2026

Changes in this version

+ const DefaultInterfaceResolver

+ type AuthenticatorMiddleware func(context.Context, Authenticator) Authenticator

type Client

+ func (c *Client) AddAuthenticatorMiddleware(fn AuthenticatorMiddleware)

+ func (c *Client) AddDownloaderMiddleware(fn DownloaderMiddleware)

+ func (c *Client) Pipeline() cli.Action

+ type DownloaderMiddleware func(context.Context, Downloader) Downloader

+ func NewIntegrityDownloaderMiddleware(i Integrity) DownloaderMiddleware

type Location

+ func NewURLLocation(u *url.URL) Location

type Option

+ func WithAction(a cli.Action) Option

+ func WithDefaultAction() Option

+ func WithDownloaderMiddleware(d DownloaderMiddleware) Option

v0.7.2

Apr 1, 2026

Changes in this version

type Authenticator

+ func NewBearerTokenAuthenticator(token string, headeropt ...string) Authenticator

type Client

+ func (c *Client) Apply(opts ...Option)

v0.7.1

Mar 23, 2026

v0.7.0

Mar 15, 2026

Changes in this version

type Location

+ func NewLocation(url string, varfn func(context.Context) any) Location

+ func NewURITemplateLocation(template string, varfn func(context.Context) any) Location

type Option

+ func WithTLSConfig(t *tls.Config) Option

+ func WithTLSConfigFactory(fn func(context.Context) (*tls.Config, error)) Option

v0.6.0

Feb 5, 2026

Changes in this version

type Client

+ func (c *Client) AddAuthMiddleware(fn func(Authenticator) Authenticator)

+ func (c *Client) AddDownloadMiddleware(fn func(Downloader) Downloader)

+ func (c *Client) DoLocation(ctx context.Context, l Location) (*Response, error)

type LocationResolver

+ BaseURL func() *url.URL

+ SetBaseURL func(base *url.URL) error

+ Vars func() map[string]any

type Option

+ func WithBody(b io.ReadCloser) Option

+ func WithBodyString(s string) Option

+ func WithDownloadMiddleware(d func(Downloader) Downloader) Option

v0.5.5

Dec 23, 2025

v0.5.4

Nov 17, 2025

Changes in this version

type Middleware

+ func WithMethod(method any) Middleware

v0.5.3

Nov 2, 2025

Changes in this version

+ const TraceConnections

+ const TraceDNS

+ const TraceDebug

+ const TraceHTTP1XX

+ const TraceOff

+ const TraceOn

+ const TraceRedirects

+ const TraceRequestBody

+ const TraceRequestHeaders

+ const TraceResponseHeaders

+ const TraceResponseStatus

+ const TraceTLS

+ const TraceVerbose

+ var Authenticators = &provider.Registry

+ func ContextValue(c *Client) cli.Action

+ func ExpandHeader(h http.Header) expr.Expander

+ func ExpandResponse(r *Response) expr.Expander

+ func FetchAndPrint() cli.Action

+ func FlagsAndArgs() cli.Action

+ func ListAuthenticators() cli.Action

+ func ListCiphers() cli.Action

+ func ListCurves() cli.Action

+ func ListInterfaces() cli.Action

+ func NewIntegrityDownloadMiddleware(i Integrity) func(Downloader) Downloader

+ func PromptForCredentials() cli.Action

+ func SetAuth(v ...*provider.Value) cli.Action

+ func SetBaseURL(name ...*URLValue) cli.Action

+ func SetBasicAuth() cli.Action

+ func SetBindAddress(v ...string) cli.Action

+ func SetBody(s ...string) cli.Action

+ func SetBodyContent(s ...*ContentType) cli.Action

+ func SetCACertFile(path ...string) cli.Action

+ func SetCACertPath(path ...string) cli.Action

+ func SetCiphers(v ...*CipherSuites) cli.Action

+ func SetClientCertFile(path ...string) cli.Action

+ func SetCurves(v ...*CurveIDs) cli.Action

+ func SetDNSInterface(s ...string) cli.Action

+ func SetDialKeepAlive(v ...time.Duration) cli.Action

+ func SetDialTimeout(s ...time.Duration) cli.Action

+ func SetDisableDialKeepAlive() cli.Action

+ func SetDownload() cli.Action

+ func SetFailFast(i ...bool) cli.Action

+ func SetFillValue(s ...*cli.NameValue) cli.Action

+ func SetFollowRedirects(s ...bool) cli.Action

+ func SetHeader(s ...*HeaderValue) cli.Action

+ func SetIncludeResponseHeaders(s ...bool) cli.Action

+ func SetInsecureSkipVerify(v ...bool) cli.Action

+ func SetIntegrity(i ...Integrity) cli.Action

+ func SetInterface(v ...string) cli.Action

+ func SetJSON() cli.Action

+ func SetJSONContent() cli.Action

+ func SetKeyFile(path ...string) cli.Action

+ func SetMethod(s ...string) cli.Action

+ func SetNextProtos(s ...[]string) cli.Action

+ func SetNoOutput(b ...bool) cli.Action

+ func SetOutputFile(f ...string) cli.Action

+ func SetPreferGo() cli.Action

+ func SetQueryString(s ...*cli.NameValue) cli.Action

+ func SetRequestID(s ...string) cli.Action

+ func SetServerName(s ...string) cli.Action

+ func SetStrictErrorsDNS() cli.Action

+ func SetStripComponents(i ...int) cli.Action

+ func SetTLSv1() cli.Action

+ func SetTLSv1_0() cli.Action

+ func SetTLSv1_1() cli.Action

+ func SetTLSv1_2() cli.Action

+ func SetTLSv1_3() cli.Action

+ func SetTime(s ...*cli.File) cli.Action

+ func SetTraceLevel(s ...*TraceLevel) cli.Action

+ func SetURITemplateVar(v ...*uritemplates.Var) cli.Action

+ func SetURITemplateVars(v ...uritemplates.Vars) cli.Action

+ func SetURLValue(i ...*URLValue) cli.Action

+ func SetUser(s ...*UserInfo) cli.Action

+ func SetUserAgent(s ...string) cli.Action

+ func SetVerbose() cli.Action

+ func SetWriteErr(w ...Expr) cli.Action

+ func SetWriteOut(w ...Expr) cli.Action

+ func SourceAnnotation() (string, string)

+ type AuthMode int

+ const BasicAuth

+ const NoAuth

+ func (*AuthMode) Synopsis() string

+ func (m *AuthMode) Set(arg string) error

+ func (m *AuthMode) UnmarshalText(b []byte) error

+ func (m AuthMode) Authenticate(r *http.Request, ui *UserInfo) error

+ func (m AuthMode) MarshalText() ([]byte, error)

+ func (m AuthMode) RequiresUserInfo() bool

+ func (m AuthMode) String() string

+ type Authenticator interface

+ Authenticate func(r *http.Request, u *UserInfo) error

+ RequiresUserInfo func() bool

+ func NewAuthenticator(name string, opts map[string]string) (Authenticator, error)

+ func WithPromptForCredentials(auth Authenticator) Authenticator

+ type CipherSuites []uint16

+ func (c *CipherSuites) Set(arg string) error

+ func (c *CipherSuites) String() string

+ func (c *CipherSuites) Synopsis() string

+ type Client struct

+ BodyContent Content

+ CheckRedirect func(*http.Request, []*http.Request) error

+ FailFast bool

+ IncludeResponseHeaders bool

+ InterfaceResolver InterfaceResolver

+ LocationResolver LocationResolver

+ Request *http.Request

+ Transport http.RoundTripper

+ UserInfo *UserInfo

+ func FromContext(c context.Context) *Client

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

+ func (c *Client) AddMiddleware(m Middleware)

+ func (c *Client) AddTransportMiddleware(m TransportMiddleware)

+ func (c *Client) Authenticator() Authenticator

+ func (c *Client) DNSDialer() *net.Dialer

+ func (c *Client) Dialer() *net.Dialer

+ func (c *Client) Do(ctx context.Context) ([]*Response, error)

+ func (c *Client) Execute(ctx context.Context) error

+ func (c *Client) SetAuth(auth Authenticator) error

+ func (c *Client) SetBaseURL(u *URLValue) error

+ func (c *Client) SetBindAddress(value string) error

+ func (c *Client) SetBody(body string) error

+ func (c *Client) SetBodyContent(bodyContent Content) error

+ func (c *Client) SetCACertFile(path string) error

+ func (c *Client) SetCACertPath(path string) error

+ func (c *Client) SetCiphers(ids *CipherSuites) error

+ func (c *Client) SetClientCertFile(path string) error

+ func (c *Client) SetCurves(ids *CurveIDs) error

+ func (c *Client) SetDNSInterface(value string) error

+ func (c *Client) SetDialKeepAlive(v time.Duration) error

+ func (c *Client) SetDialTimeout(v time.Duration) error

+ func (c *Client) SetDisableDialKeepAlive(v bool) error

+ func (c *Client) SetDownloadFile(v Downloader) error

+ func (c *Client) SetFailFast(v bool) error

+ func (c *Client) SetFillValue(v *cli.NameValue) error

+ func (c *Client) SetFollowRedirects(value bool) error

+ func (c *Client) SetHeader(n *HeaderValue) error

+ func (c *Client) SetIncludeResponseHeaders(v bool) error

+ func (c *Client) SetInsecureSkipVerify(v bool) error

+ func (c *Client) SetIntegrity(i Integrity) error

+ func (c *Client) SetInterface(value string) error

+ func (c *Client) SetKeyFile(path string) error

+ func (c *Client) SetMethod(s string) error

+ func (c *Client) SetNextProtos(s []string) error

+ func (c *Client) SetNoOutput(b bool) error

+ func (c *Client) SetOutputFile(f string) error

+ func (c *Client) SetPreferGoDialer(v bool) error

+ func (c *Client) SetQueryString(n *cli.NameValue) error

+ func (c *Client) SetRequestID(s string) error

+ func (c *Client) SetServerName(s string) error

+ func (c *Client) SetStrictErrorsDNS(v bool) error

+ func (c *Client) SetStripComponents(count int) error

+ func (c *Client) SetTraceLevel(v TraceLevel) error

+ func (c *Client) SetURITemplateVar(v *uritemplates.Var) error

+ func (c *Client) SetURITemplateVars(v uritemplates.Vars) error

+ func (c *Client) SetURL(u *url.URL) error

+ func (c *Client) SetURLValue(u *URLValue) error

+ func (c *Client) SetUser(user *UserInfo) error

+ func (c *Client) SetUserAgent(value string) error

+ func (c *Client) SetWriteErr(w Expr) error

+ func (c *Client) SetWriteOut(w Expr) error

+ func (c *Client) TLSConfig() *tls.Config

+ func (c *Client) UseAuthMiddleware(fn func(Authenticator) Authenticator)

+ func (c *Client) UseDownloadMiddleware(fn func(Downloader) Downloader)

+ type Content interface

+ ContentType func() string

+ Query func() (url.Values, error)

+ Read func() io.Reader

+ Set func(name, value string) error

+ SetFile func(name, file io.Reader) error

+ func NewContent(ct ContentType) Content

+ type ContentType int

+ const ContentTypeFormData

+ const ContentTypeJSON

+ const ContentTypeMultipartFormData

+ const ContentTypeRaw

+ const ContentTypeURLEncodedFormData

+ func (ContentType) Synopsis() string

+ func (c *ContentType) Set(arg string) error

+ func (c *ContentType) UnmarshalText(b []byte) error

+ func (c ContentType) MarshalText() ([]byte, error)

+ func (c ContentType) String() string

+ type CurveIDs []tls.CurveID

+ func (c *CurveIDs) Set(arg string) error

+ func (c *CurveIDs) String() string

+ func (c *CurveIDs) Synopsis() string

+ type DownloadMode int

+ const PreserveRequestFile

+ const PreserveRequestPath

+ func (d DownloadMode) FileName(r *Response) string

+ func (d DownloadMode) OpenDownload(ctx context.Context, resp *Response) (io.WriteCloser, error)

+ func (d DownloadMode) WithStripComponents(count int) Downloader

+ type Downloader interface

+ OpenDownload func(context.Context, *Response) (io.WriteCloser, error)

+ func NewDownloaderTo(w io.Writer) Downloader

+ func NewFileDownloader(f string, fileSystem fs.FS) Downloader

+ func NewIntegrityDownloader(i Integrity, d Downloader) Downloader

+ type Expr string

+ func (e *Expr) UnmarshalText(b []byte) error

+ func (e Expr) Compile() *expr.Pattern

+ type FormDataContent struct

+ func (c *FormDataContent) ContentType() string

+ func (c *FormDataContent) Query() (url.Values, error)

+ func (c *FormDataContent) Read() io.Reader

+ func (c *FormDataContent) Set(name, value string) error

+ func (c *FormDataContent) SetFile(name, file io.Reader) error

+ type HeaderValue struct

+ Name string

+ Value string

+ func (v *HeaderValue) Copy() *HeaderValue

+ func (v *HeaderValue) NewCounter() cli.ArgCounter

+ func (v *HeaderValue) Reset()

+ func (v *HeaderValue) Set(arg string) error

+ func (v *HeaderValue) String() string

+ type Integrity struct

+ Digest []byte

+ Hash crypto.Hash

+ func ParseIntegrity(s string) (Integrity, error)

+ func (i *Integrity) UnmarshalText(b []byte) error

+ type InterfaceResolver interface

+ Resolve func(string) (*net.TCPAddr, error)

+ type JSONContent struct

+ func (c *JSONContent) ContentType() string

+ func (c *JSONContent) Query() (url.Values, error)

+ func (c *JSONContent) Read() io.Reader

+ func (c *JSONContent) Set(name, value string) error

+ func (c *JSONContent) SetFile(name, file io.Reader) error

+ type Location interface

+ URL func(ctx context.Context) (context.Context, *url.URL, error)

+ func URLLocation(u *url.URL) Location

+ type LocationResolver interface

+ Add func(location string) error

+ AddVar func(v *uritemplates.Var) error

+ Resolve func(context.Context) ([]Location, error)

+ SetBase func(base *url.URL) error

+ func NewDefaultLocationResolver() LocationResolver

+ type Middleware interface

+ Handle func(req *http.Request, next func(*http.Request) error) error

+ func ComposeMiddleware(mw ...Middleware) Middleware

+ func NewRequestIDMiddleware(v ...any) Middleware

+ func WithHeader(name string, value any) Middleware

+ func WithHeaders(headers http.Header) Middleware

+ type MiddlewareFunc func(req *http.Request) error

+ func (f MiddlewareFunc) Handle(req *http.Request, next func(*http.Request) error) error

+ type MultipartFormDataContent struct

+ func (c *MultipartFormDataContent) ContentType() string

+ func (c *MultipartFormDataContent) Query() (url.Values, error)

+ func (c *MultipartFormDataContent) Read() io.Reader

+ func (c *MultipartFormDataContent) Set(name, value string) error

+ func (c *MultipartFormDataContent) SetFile(name, file io.Reader) error

+ type NameValue struct

+ Name string

+ Value string

+ type Option func(*Client)

+ func WithDefaultUserAgent(s string) Option

+ func WithLocationResolver(r LocationResolver) Option

+ func WithMiddleware(m Middleware) Option

+ func WithRequestID(v ...any) Option

+ func WithTransport(t http.RoundTripper) Option

+ func WithTransportMiddleware(m TransportMiddleware) Option

+ func (o Option) Execute(c context.Context) error

+ type RawContent struct

+ func NewRawContent(data []byte) *RawContent

+ func NewStringContent(data string) *RawContent

+ func (c *RawContent) ContentType() string

+ func (c *RawContent) Query() (url.Values, error)

+ func (c *RawContent) Read() io.Reader

+ func (c *RawContent) Set(_, _ string) error

+ func (c *RawContent) SetFile(_, _ io.Reader) error

+ func (c *RawContent) Write(d []byte) (int, error)

+ func (c *RawContent) WriteString(d string) (int, error)

+ type Response struct

+ func Do(c *cli.Context) ([]*Response, error)

+ func (r *Response) CopyHeadersTo(w io.Writer) error

+ func (r *Response) CopyTo(w io.Writer) error

+ func (r *Response) Success() bool

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

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

+ type TraceLevel int

+ func (l *TraceLevel) Set(arg string) error

+ func (l TraceLevel) String() string

+ type TraceLogger interface

+ ConnectDone func(network, addr string, err error)

+ ConnectStart func(network, addr string)

+ DNSDone func(httptrace.DNSDoneInfo)

+ DNSStart func(httptrace.DNSStartInfo)

+ GetConn func(hostPort string)

+ Got1xxResponse func(code int, header textproto.MIMEHeader) error

+ GotConn func(httptrace.GotConnInfo)

+ Redirected func(req *http.Request, via []*http.Request, err error)

+ ResponseDone func(resp *http.Response, err error)

+ StartRequest func(req *http.Request)

+ TLSHandshakeDone func(tls.ConnectionState, error)

+ TLSHandshakeStart func()

+ Wait100Continue func()

+ WroteHeaderField func(key string, value []string)

+ WroteRequest func(httptrace.WroteRequestInfo)

+ type TransportMiddleware func(context.Context, http.RoundTripper) http.RoundTripper

+ type URLEncodedFormDataContent struct

+ func (c *URLEncodedFormDataContent) ContentType() string

+ func (c *URLEncodedFormDataContent) Query() (url.Values, error)

+ func (c *URLEncodedFormDataContent) Read() io.Reader

+ func (c *URLEncodedFormDataContent) Set(name, value string) error

+ func (c *URLEncodedFormDataContent) SetFile(name, file io.Reader) error

+ type URLValue struct

+ func NewURLValue(loc string) *URLValue

+ func (u *URLValue) Copy() *URLValue

+ func (u *URLValue) Reset()

+ func (u *URLValue) Set(arg string) error

+ func (u *URLValue) String() string

+ func (u *URLValue) URITemplate() (*uritemplates.URITemplate, error)

+ func (u *URLValue) URL() (*url.URL, error)

+ type UserInfo struct

+ HasPassword bool

+ Password string

+ User string

+ func (*UserInfo) Synopsis() string

+ func (u *UserInfo) Set(arg string) error

+ func (u *UserInfo) String() string

+ type VirtualPath struct

+ Options map[string]string

+ PhysicalPath string

+ RequestPath string

+ func ParseVirtualPath(v string) (VirtualPath, error)

+ func (v *VirtualPath) Copy() *VirtualPath

+ func (v *VirtualPath) NewCounter() cli.ArgCounter

+ func (v *VirtualPath) Reset()

+ func (v *VirtualPath) Set(arg string) error

+ func (v VirtualPath) String() string

v0.5.2

Apr 5, 2025

v0.5.1

Mar 2, 2025

v0.5.0

Jun 8, 2023

v0.4.0

May 17, 2023

v0.3.2

Mar 15, 2023

v0.3.1

Mar 14, 2023

v0.3.0

Mar 13, 2023

v0.2.0

Sep 5, 2022

v0.1.0

Jul 9, 2022

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