http

Documentation

Index

• Constants
• func DefaultHTTPServerSettings(in *goHttp.Server, _ context.Context) error
• func Download(ctx context.Context, client *goHttp.Client, format string, args ...interface{}) ([]byte, error)
• func InitConfiguration(cmd *cobra.Command) error
• func Insecure(in *tls.Config)
• func NewError(code int, format string, args ...any) error
• func NewSimpleJSONResponse(obj interface{}) (goHttp.Handler, error)
• func NewWriter(w goHttp.ResponseWriter, stream io.Writer) goHttp.ResponseWriter
• func RoundTripper(mods ...util.Mod[goHttp.Transport]) goHttp.RoundTripper
• func RoundTripperWithShortTransport(mods ...util.Mod[goHttp.Transport]) goHttp.RoundTripper
• func Transport(mods ...util.Mod[goHttp.Transport]) goHttp.RoundTripper
• func WithBuffer(maxSize int, in goHttp.HandlerFunc) goHttp.HandlerFunc
• func WithContentType(content string, in goHttp.HandlerFunc) goHttp.HandlerFunc
• func WithEncoding(in goHttp.HandlerFunc) goHttp.HandlerFunc
• func WithGZipEncoding(in goHttp.HandlerFunc) goHttp.HandlerFunc
• func WithIdentityEncoding(in goHttp.HandlerFunc) goHttp.HandlerFunc
• func WithNoContent(in goHttp.HandlerFunc) goHttp.HandlerFunc
• func WithRootCA(ca *x509.CertPool) util.Mod[tls.Config]
• func WithServeMux(mods ...util.Mod[goHttp.ServeMux]) util.ModEP1[goHttp.Server, context.Context]
• func WithTLSConfigFetcher(fetcher util.TLSConfigFetcher) util.ModEP1[goHttp.Server, context.Context]
• func WithTLSConfigFetcherGen(gen func() util.TLSConfigFetcher) util.ModEP1[goHttp.Server, context.Context]
• func WithTextContentType(in goHttp.HandlerFunc) goHttp.HandlerFunc
• func WithTransportTLS(mods ...util.Mod[tls.Config]) util.Mod[goHttp.Transport]
• func WrapError(code int, err error) error
• type Buffer
  • func NewBuffer(maxSize int, upstream io.Writer) Buffer
• type Client
• type Error
  • func IsError(err error) (Error, bool)
  • func (e Error) Error() string
  • func (e Error) JSON() []byte
• type HTTPClient
  • func NewHTTPClient(mods ...util.Mod[goHttp.Client]) HTTPClient
• type Headers
  • func ParseHeaders(in ...string) Headers
  • func (h Headers) Accept(headers ...string) string
• type Server
  • func NewServer(ctx context.Context, mods ...util.ModEP1[goHttp.Server, context.Context]) (Server, error)

Constants

const (
	EncodingAcceptHeader   = "Accept-Encoding"
	EncodingResponseHeader = "Content-Encoding"
)

const (
	ContentLengthHeader = "Content-Length"
)

const ContentTypeHeader = "Content-Type"

Functions

func DefaultHTTPServerSettings

func DefaultHTTPServerSettings(in *goHttp.Server, _ context.Context) error

func Download

func Download(ctx context.Context, client *goHttp.Client, format string, args ...interface{}) ([]byte, error)

func InitConfiguration

func InitConfiguration(cmd *cobra.Command) error

func Insecure

func Insecure(in *tls.Config)

func NewError

func NewError(code int, format string, args ...any) error

func NewSimpleJSONResponse

func NewSimpleJSONResponse(obj interface{}) (goHttp.Handler, error)

NewSimpleJSONResponse returns handler which server static json on GET request

func NewWriter

func NewWriter(w goHttp.ResponseWriter, stream io.Writer) goHttp.ResponseWriter

func RoundTripper

func RoundTripper(mods ...util.Mod[goHttp.Transport]) goHttp.RoundTripper

func RoundTripperWithShortTransport

func RoundTripperWithShortTransport(mods ...util.Mod[goHttp.Transport]) goHttp.RoundTripper

func Transport

func Transport(mods ...util.Mod[goHttp.Transport]) goHttp.RoundTripper

func WithBuffer

func WithBuffer(maxSize int, in goHttp.HandlerFunc) goHttp.HandlerFunc

func WithContentType

func WithContentType(content string, in goHttp.HandlerFunc) goHttp.HandlerFunc

func WithEncoding

func WithEncoding(in goHttp.HandlerFunc) goHttp.HandlerFunc

func WithGZipEncoding

func WithGZipEncoding(in goHttp.HandlerFunc) goHttp.HandlerFunc

func WithIdentityEncoding

func WithIdentityEncoding(in goHttp.HandlerFunc) goHttp.HandlerFunc

func WithNoContent

func WithNoContent(in goHttp.HandlerFunc) goHttp.HandlerFunc

func WithRootCA

func WithRootCA(ca *x509.CertPool) util.Mod[tls.Config]

func WithServeMux

func WithServeMux(mods ...util.Mod[goHttp.ServeMux]) util.ModEP1[goHttp.Server, context.Context]

func WithTLSConfigFetcher

func WithTLSConfigFetcher(fetcher util.TLSConfigFetcher) util.ModEP1[goHttp.Server, context.Context]

func WithTLSConfigFetcherGen

func WithTLSConfigFetcherGen(gen func() util.TLSConfigFetcher) util.ModEP1[goHttp.Server, context.Context]

func WithTextContentType

func WithTextContentType(in goHttp.HandlerFunc) goHttp.HandlerFunc

func WithTransportTLS

func WithTransportTLS(mods ...util.Mod[tls.Config]) util.Mod[goHttp.Transport]

func WrapError

func WrapError(code int, err error) error

Types

type Buffer

type Buffer interface {
	io.Writer

	Bytes() []byte
	Truncated() bool
}

func NewBuffer

func NewBuffer(maxSize int, upstream io.Writer) Buffer

type Client

type Client[Req, Resp any] interface {
	Do(req Req) (Resp, error)
}

type Error

type Error struct {
	Code    int
	Message string
}

func IsError

func IsError(err error) (Error, bool)

func (Error) Error

func (e Error) Error() string

func (Error) JSON

func (e Error) JSON() []byte

type HTTPClient

type HTTPClient Client[*goHttp.Request, *goHttp.Response]

func NewHTTPClient

func NewHTTPClient(mods ...util.Mod[goHttp.Client]) HTTPClient

type Headers

type Headers map[string]float64

func ParseHeaders

func ParseHeaders(in ...string) Headers

func (Headers) Accept

func (h Headers) Accept(headers ...string) string

type Server

type Server interface {
	AsyncAddr(ctx context.Context, addr string) func() error
	Async(ctx context.Context, ln net.Listener) func() error

	StartAddr(ctx context.Context, addr string) error
	Start(ctx context.Context, ln net.Listener) error
}

func NewServer

func NewServer(ctx context.Context, mods ...util.ModEP1[goHttp.Server, context.Context]) (Server, error)