http

Dec 5, 2025

Changes in this version

+ const ErrorCodeForbidden

+ const ErrorCodeInternal

+ const ErrorCodeNotFound

+ const ErrorCodeUnauthorized

+ const ErrorCodeValidation

+ func NewJSONErrorHandler(withError WithError) http.Handler

+ func NewJSONUpdateErrorHandler(db libkv.DB, withErrorTx WithErrorTx) http.Handler

+ func NewJSONViewErrorHandler(db libkv.DB, withErrorTx WithErrorTx) http.Handler

+ func WrapWithCode(err error, code string, statusCode int) error

+ func WrapWithDetails(err error, code string, statusCode int, details map[string]string) error

+ type ErrorDetails struct

+ Code string

+ Details map[string]string

+ Message string

+ type ErrorResponse struct

+ Error ErrorDetails

+ type ErrorWithCode interface

+ Code func() string

Nov 14, 2025

Changes in this version

type RoundTripper

+ func CreateRoundTripper(options ...RoundTripperOption) RoundTripper

+ type RoundTripperOption func(*RoundTripperOptions)

+ func WithDialKeepAlive(keepAlive time.Duration) RoundTripperOption

+ func WithDialTimeout(timeout time.Duration) RoundTripperOption

+ func WithExpectContinueTimeout(timeout time.Duration) RoundTripperOption

+ func WithHTTP2(enabled bool) RoundTripperOption

+ func WithIdleConnTimeout(timeout time.Duration) RoundTripperOption

+ func WithLogging(enabled bool) RoundTripperOption

+ func WithMaxIdleConns(n int) RoundTripperOption

+ func WithProxy(proxy func(*http.Request) (*url.URL, error)) RoundTripperOption

+ func WithResponseHeaderTimeout(timeout time.Duration) RoundTripperOption

+ func WithRetry(count int, delay time.Duration) RoundTripperOption

+ func WithTLSConfig(config *tls.Config) RoundTripperOption

+ func WithTLSFiles(ctx context.Context, caCertPath, clientCertPath, clientKeyPath string) (RoundTripperOption, error)

+ func WithTLSHandshakeTimeout(timeout time.Duration) RoundTripperOption

+ func WithTimeouts(dial, tlsHandshake, responseHeader time.Duration) RoundTripperOption

+ func WithoutProxy() RoundTripperOption

+ func WithoutRetry() RoundTripperOption

+ type RoundTripperOptions struct

+ DialKeepAlive time.Duration

+ DialTimeout time.Duration

+ EnableLogging bool

+ ExpectContinueTimeout time.Duration

+ ForceAttemptHTTP2 bool

+ IdleConnTimeout time.Duration

+ MaxIdleConns int

+ Proxy func(*http.Request) (*url.URL, error)

+ ResponseHeaderTimeout time.Duration

+ RetryCount int

+ RetryDelay time.Duration

+ TLSConfig *tls.Config

+ TLSHandshakeTimeout time.Duration

Nov 14, 2025

Changes in this version

type WithError

+ func NewMemoryProfileDownloadHandler() WithError

Oct 31, 2025

Changes in this version

+ func NewDangerousHandlerWrapper(handler http.Handler) http.Handler

+ func NewDangerousHandlerWrapperWithCurrentDateTime(handler http.Handler, currentDateTime libtime.CurrentDateTime) http.Handler

Oct 30, 2025

Changes in this version

+ const ApplicationJSONContentType

+ const TextHTML

+ var ErrNotFound = stderrors.New("not found")

+ var ErrTooManyRedirects = stderrors.New("too many redirects")

+ func CreateDefaultHTTPClient() *http.Client

+ func CreateHTTPClient(timeout time.Duration) *http.Client

+ func CreateHTTPServer(addr string, router http.Handler, serverOptions ServerOptions) *http.Server

+ func CreateTLSClientConfig(ctx context.Context, caCertPath string, clientCertPath string, ...) (*tls.Config, error)

+ type ClientBuilder interface

+ Build func(ctx context.Context) (*http.Client, error)

+ BuildRoundTripper func(ctx context.Context) (http.RoundTripper, error)

+ WithClientCert func(caCertPath string, clientCertPath string, clientKeyPath string) ClientBuilder

+ WithDialFunc func(dialFunc DialFunc) ClientBuilder

+ WithInsecureSkipVerify func(insecureSkipVerify bool) ClientBuilder

+ WithProxy func() ClientBuilder

+ WithRedirects func(maxRedirect int) ClientBuilder

+ WithRetry func(retryLimit int, retryDelay time.Duration) ClientBuilder

+ WithTimeout func(timeout time.Duration) ClientBuilder

+ WithoutProxy func() ClientBuilder

+ WithoutRedirects func() ClientBuilder

+ WithoutRetry func() ClientBuilder

+ type HTTPClientBuilder = ClientBuilder

+ type JSONHandler interface

+ ServeHTTP func(ctx context.Context, req *http.Request) (interface{}, error)

+ type JSONHandlerFunc func(ctx context.Context, req *http.Request) (interface{}, error)

+ func (j JSONHandlerFunc) ServeHTTP(ctx context.Context, req *http.Request) (interface{}, error)

+ type JSONHandlerTx interface

+ ServeHTTP func(ctx context.Context, tx libkv.Tx, req *http.Request) (interface{}, error)

+ type JSONHandlerTxFunc func(ctx context.Context, tx libkv.Tx, req *http.Request) (interface{}, error)

+ func (j JSONHandlerTxFunc) ServeHTTP(ctx context.Context, tx libkv.Tx, req *http.Request) (interface{}, error)

type RoundTripper

+ func CreateDefaultRoundTripperTLS(ctx context.Context, caCertPath string, clientCertPath string, ...) (RoundTripper, error)

type WithError

+ func NewCPUProfileStartHandler() WithError

+ func NewCPUProfileStopHandler() WithError

+ func NewJSONHandler(jsonHandler JSONHandler) WithError

+ func NewJSONHandlerUpdateTx(db libkv.DB, jsonHandler JSONHandlerTx) WithError

+ func NewJSONHandlerViewTx(db libkv.DB, jsonHandler JSONHandlerTx) WithError

Oct 30, 2025

Changes in this version

+ func CreateHttpServer(addr string, router http.Handler, serverOptions ServerOptions) *http.Server

+ type ServerOptions struct

+ CertFile string

+ IdleTimeout time.Duration

+ KeyFile string

+ MaxHeaderBytes int

+ ReadHeaderTimeout time.Duration

+ ReadTimeout time.Duration

+ ShutdownTimeout time.Duration

+ TLSConfig *tls.Config

+ WriteTimeout time.Duration

+ func CreateServerOptions(optionFns ...func(serverOptions *ServerOptions)) ServerOptions

Oct 14, 2025

Changes in this version

+ func SendJSONFileResponse(ctx context.Context, resp http.ResponseWriter, data interface{}, ...) error

+ func ValidateFilename(ctx context.Context, name string) error

Oct 13, 2025

Changes in this version

+ func SendJSONResponse(ctx context.Context, resp http.ResponseWriter, data interface{}, ...) error

Jul 24, 2025

Changes in this version

+ func NewBackgroundRunRequestHandler(ctx context.Context, runFunc BackgroundRunRequestFunc) http.Handler

+ type BackgroundRunRequestFunc func(ctx context.Context, req *http.Request) error

Jun 2, 2025

Changes in this version

+ func NewMetricsRoundTripper(roundTripper http.RoundTripper, metrics RoundTripperMetrics) http.RoundTripper

+ type RoundTripperMetrics interface

+ DurationMeasureObserve func(host string, method string, duration time.Duration)

+ FailureCounterInc func(host string, method string)

+ SuccessCounterInc func(host string, method string, statusCode int)

+ TotalCounterInc func(host string, method string)

+ func NewRoundTripperMetrics() RoundTripperMetrics

May 27, 2025

Changes in this version

+ func NewGarbageCollectorHandler() http.Handler

May 23, 2025

Changes in this version

+ type Handler http.Handler

+ type HandlerFunc http.HandlerFunc

May 13, 2025

Changes in this version

type HttpClientBuilder

+ WithRetry func(retryLimit int, retryDelay time.Duration) HttpClientBuilder

+ WithoutRetry func() HttpClientBuilder

Mar 24, 2025

Changes in this version

+ type ErrorWithStatusCode interface

+ StatusCode func() int

+ func WrapWithStatusCode(err error, code int) ErrorWithStatusCode

Feb 27, 2025

Changes in this version

+ func NewRoundTripperRetryWithSkipStatus(roundTripper http.RoundTripper, retryLimit int, retryDelay time.Duration, ...) http.RoundTripper

Jan 16, 2025

Changes in this version

+ func NewUpdateErrorHandler(db libkv.DB, withErrorTx WithErrorTx) http.Handler

+ func NewViewErrorHandler(db libkv.DB, withErrorTx WithErrorTx) http.Handler

+ type JsonHandlerTx interface

+ ServeHTTP func(ctx context.Context, tx libkv.Tx, req *http.Request) (interface{}, error)

+ type JsonHandlerTxFunc func(ctx context.Context, tx libkv.Tx, req *http.Request) (interface{}, error)

+ func (j JsonHandlerTxFunc) ServeHTTP(ctx context.Context, tx libkv.Tx, req *http.Request) (interface{}, error)

type WithError

+ func NewJsonHandlerUpdateTx(db libkv.DB, jsonHandler JsonHandlerTx) WithError

+ func NewJsonHandlerViewTx(db libkv.DB, jsonHandler JsonHandlerTx) WithError

+ type WithErrorTx interface

+ ServeHTTP func(ctx context.Context, tx libkv.Tx, resp http.ResponseWriter, req *http.Request) error

+ type WithErrorTxFunc func(ctx context.Context, tx libkv.Tx, resp http.ResponseWriter, req *http.Request) error

+ func (w WithErrorTxFunc) ServeHTTP(ctx context.Context, tx libkv.Tx, resp http.ResponseWriter, req *http.Request) error

Jan 10, 2025

Changes in this version

+ const ApplicationJsonContentType

+ const ContentTypeHeaderName

+ const PreventRetryHeaderName

+ const TextHtml

+ var NotFound = stderrors.New("not found")

+ func BuildRequest(ctx context.Context, method string, urlString string, parameters url.Values, ...) (*http.Request, error)

+ func CheckResponseIsSuccessful(req *http.Request, resp *http.Response) error

+ func CreateDefaultHttpClient() *http.Client

+ func CreateHttpClient(timeout time.Duration) *http.Client

+ func CreateTlsClientConfig(ctx context.Context, caCertPath string, clientCertPath string, ...) (*tls.Config, error)

+ func FileServer(root string, prefix string) http.Handler

+ func IsIgnoredSentryError(err error) bool

+ func IsRetryError(err error) bool

+ func NewBackgroundRunHandler(ctx context.Context, runFunc run.Func) http.Handler

+ func NewErrorHandler(handlerWithError WithError) http.Handler

+ func NewPrintHandler(format string, a ...any) http.Handler

+ func NewProxy(transport http.RoundTripper, apiUrl *url.URL, ...) http.Handler

+ func NewRoundTripperBasicAuth(roundTripper RoundTripper, username string, password string) http.RoundTripper

+ func NewRoundTripperHeader(roundTripper http.RoundTripper, header http.Header) http.RoundTripper

+ func NewRoundTripperLog(tripper http.RoundTripper) http.RoundTripper

+ func NewRoundTripperRateLimit(ctx context.Context, tripper http.RoundTripper, maxRequestPerInterval int64, ...) http.RoundTripper

+ func NewRoundTripperRemovePathPrefix(roundTripper http.RoundTripper, prefix string) http.RoundTripper

+ func NewRoundTripperRetry(roundTripper http.RoundTripper, retryLimit int, retryDelay time.Duration) http.RoundTripper

+ func NewServer(addr string, router http.Handler) run.Func

+ func NewServerTLS(addr string, router http.Handler, serverCertPath string, serverKeyPath string) run.Func

+ func NewServerWithPort(port int, router http.Handler) run.Func

+ func NewSkipErrorWriter(writer io.Writer) io.Writer

+ func RegisterPprof(router *mux.Router)

+ func WriteAndGlog(w io.Writer, format string, a ...any) (n int, err error)

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

+ type DialFunc func(ctx context.Context, network, address string) (net.Conn, error)

+ type HasTemporaryError interface

+ Temporary func() bool

+ type HasTimeoutError interface

+ Timeout func() bool

+ type HttpClientBuilder interface

+ Build func(ctx context.Context) (*http.Client, error)

+ BuildRoundTripper func(ctx context.Context) (http.RoundTripper, error)

+ WithClientCert func(caCertPath string, clientCertPath string, clientKeyPath string) HttpClientBuilder

+ WithDialFunc func(dialFunc DialFunc) HttpClientBuilder

+ WithInsecureSkipVerify func(insecureSkipVerify bool) HttpClientBuilder

+ WithProxy func() HttpClientBuilder

+ WithRedirects func() HttpClientBuilder

+ WithTimeout func(timeout time.Duration) HttpClientBuilder

+ WithoutProxy func() HttpClientBuilder

+ WithoutRedirects func() HttpClientBuilder

+ func NewClientBuilder() HttpClientBuilder

+ type JsonHandler interface

+ ServeHTTP func(ctx context.Context, req *http.Request) (interface{}, error)

+ type JsonHandlerFunc func(ctx context.Context, req *http.Request) (interface{}, error)

+ func (j JsonHandlerFunc) ServeHTTP(ctx context.Context, req *http.Request) (interface{}, error)

+ type Proxy func(req *http.Request) (*url.URL, error)

+ type ProxyErrorHandler interface

+ HandleError func(resp http.ResponseWriter, req *http.Request, err error)

+ func NewSentryProxyErrorHandler(sentryClient libsentry.Client) ProxyErrorHandler

+ type ProxyErrorHandlerFunc func(resp http.ResponseWriter, req *http.Request, err error)

+ func (p ProxyErrorHandlerFunc) HandleError(resp http.ResponseWriter, req *http.Request, err error)

+ type RequestFailedError struct

+ Method string

+ StatusCode int

+ URL string

+ func (r RequestFailedError) Error() string

+ type RoundTripper interface

+ func CreateDefaultRoundTripper() RoundTripper

+ func CreateDefaultRoundTripperTls(ctx context.Context, caCertPath string, clientCertPath string, ...) (RoundTripper, error)

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

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

+ type WithError interface

+ ServeHTTP func(ctx context.Context, resp http.ResponseWriter, req *http.Request) error

+ func NewCpuProfileStartHandler() WithError

+ func NewCpuProfileStopHandler() WithError

+ func NewFileDownloader(path string) WithError

+ func NewJsonHandler(jsonHandler JsonHandler) WithError

+ func NewMemoryProfileHandler() WithError

+ func NewProfilingStart() WithError

+ func NewProfilingStop() WithError

+ type WithErrorFunc func(ctx context.Context, resp http.ResponseWriter, req *http.Request) error

+ func (w WithErrorFunc) ServeHTTP(ctx context.Context, resp http.ResponseWriter, req *http.Request) error