httpx

type Client struct {
	// contains filtered or unexported fields
}

type ClientTLS struct {
	// Certificate is presented whenever the server asks for one, whether or not the server
	// names its issuer, so an untrusted certificate reaches the server. Nil presents none.
	Certificate *tls.Certificate
	// ServerName is the SNI value sent. Empty sends the URL host, which Go omits for an IP.
	ServerName string
	// OmitServerName sends no SNI whatever the URL host is. It ignores ServerName and needs
	// InsecureSkipVerify, since a certificate cannot be verified against no name.
	OmitServerName bool
	// Sessions is shared by requests that may resume one another's TLS session. Nil
	// disables resumption.
	Sessions tls.ClientSessionCache
	// InsecureSkipVerify disables server certificate and hostname verification, for a local
	// listener that serves a self-signed certificate.
	InsecureSkipVerify bool
}

type Funnel struct {
	// contains filtered or unexported fields
}

type Options struct {
	// Timeout bounds one request.
	Timeout time.Duration
	// FollowRedirects enables normal HTTP redirect handling.
	FollowRedirects bool
	// MaxRetries bounds transient-error retries.
	MaxRetries int
	// RetryDelay is the pause between transient retries.
	RetryDelay time.Duration
	// RetryOn recognises transient responses.
	RetryOn []TransientMatcher
	// TLSClientConfig configures certificate verification for trusted test services.
	// A nil value uses the system verification roots and hostname from the URL, unless
	// InsecureSkipVerify is explicitly enabled.
	TLSClientConfig *tls.Config
	// InsecureSkipVerify disables TLS certificate and hostname verification. Use only for
	// local test targets that intentionally use self-signed certificates.
	InsecureSkipVerify bool
}

type Request struct {
	Method  string
	URL     string
	Headers map[string]string
	Body    []byte
	// ContentType is a convenience; an explicit Content-Type header wins.
	ContentType string

	// Host overrides the HTTP Host header. Empty uses the URL host.
	Host string

	// TLS, when set, runs the request on its own connection with this client TLS.
	TLS *ClientTLS
}

type Response struct {
	StatusCode int
	Body       []byte
	Headers    http.Header

	// Request describes the call that produced the response.
	Method string
	URL    string

	// Elapsed is the duration of the request and body read.
	Elapsed time.Duration

	// TLS is the negotiated handshake of a request that carried ClientTLS, else nil.
	TLS *TLSState
}

type StreamVisitor func(line string, sinceHeaders time.Duration) bool

type TLSState struct {
	// Version is the negotiated TLS version.
	Version uint16
	// ServerName is the SNI value the client sent.
	ServerName string
	// DidResume reports that the handshake resumed a cached session.
	DidResume bool
	// ClientCertificateRequested reports that the server sent a CertificateRequest.
	ClientCertificateRequested bool
	// PeerCertificates is the chain the server presented, leaf first.
	PeerCertificates []*x509.Certificate
}

type TransientMatcher func(*Response) bool