request

Documentation

Index

• Variables
• func AddSignature(r *http.Request, keyID string, secret, payload []byte)
• func AddTracerToDefaultClient(tracerProvider trace.TracerProvider)
• func CreateClient(timeout time.Duration, onRedirect func(*http.Request, []*http.Request) error) *http.Client
• func DiscardBody(body io.ReadCloser) error
• func Do(req *http.Request) (*http.Response, error)
• func DoWithClient(client *http.Client, req *http.Request) (*http.Response, error)
• func ReadBodyRequest(r *http.Request) ([]byte, error)
• func ReadBodyResponse(r *http.Response) ([]byte, error)
• func ValidateSignature(r *http.Request, secret []byte) (bool, error)
• type Request
  • func Delete(url string) Request
  • func Get(url string) Request
  • func New() Request
  • func Patch(url string) Request
  • func Post(url string) Request
  • func Put(url string) Request
  • func (r Request) Accept(accept string) Request
  • func (r Request) AcceptJSON() Request
  • func (r Request) BasicAuth(username, password string) Request
  • func (r Request) Build(ctx context.Context, payload io.ReadCloser) (*http.Request, error)
  • func (r Request) ContentForm() Request
  • func (r Request) ContentJSON() Request
  • func (r Request) ContentType(contentType string) Request
  • func (r Request) Delete(url string) Request
  • func (r Request) Form(ctx context.Context, data url.Values) (*http.Response, error)
  • func (r Request) Get(url string) Request
  • func (r Request) Header(name, value string) Request
  • func (r Request) IsZero() bool
  • func (r Request) JSON(ctx context.Context, body any) (*http.Response, error)
  • func (r Request) Method(method string) Request
  • func (r Request) MethodURL(method, url string) Request
  • func (r Request) Multipart(ctx context.Context, feed func(mw *multipart.Writer) error) (*http.Response, error)
  • func (r Request) Patch(url string) Request
  • func (r Request) Path(path string) Request
  • func (r Request) Post(url string) Request
  • func (r Request) Put(url string) Request
  • func (r Request) Send(ctx context.Context, payload io.ReadCloser) (*http.Response, error)
  • func (r Request) StreamJSON(ctx context.Context, body any) (*http.Response, error)
  • func (r Request) String() string
  • func (r Request) URL(url string) Request
  • func (r Request) WithClient(client *http.Client) Request
  • func (r Request) WithSignatureAuthorization(keyID string, secret []byte) Request

Variables

var NoRedirection = func(*http.Request, []*http.Request) error {
	return http.ErrUseLastResponse
}

NoRedirection discard redirection

Functions

func AddSignature

func AddSignature(r *http.Request, keyID string, secret, payload []byte)

AddSignature add Authorization header based on content signature based on https://datatracker.ietf.org/doc/html/draft-cavage-http-signatures-12

func AddTracerToDefaultClient

func AddTracerToDefaultClient(tracerProvider trace.TracerProvider)

AddTracerToDefaultClient change default client

func CreateClient

func CreateClient(timeout time.Duration, onRedirect func(*http.Request, []*http.Request) error) *http.Client

CreateClient creates http client with given timeout and redirection handling

func DiscardBody

func DiscardBody(body io.ReadCloser) error

DiscardBody of a response

func Do

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

Do send request with default client

func DoWithClient

func DoWithClient(client *http.Client, req *http.Request) (*http.Response, error)

DoWithClient send request with given client

func ReadBodyRequest

func ReadBodyRequest(r *http.Request) ([]byte, error)

ReadBodyRequest return content of a body request (defined as a ReadCloser)

func ReadBodyResponse

func ReadBodyResponse(r *http.Response) ([]byte, error)

ReadBodyResponse return content of a body response (defined as a ReadCloser)

func ValidateSignature

func ValidateSignature(r *http.Request, secret []byte) (bool, error)

ValidateSignature check Authorization header based on content based on https://datatracker.ietf.org/doc/html/draft-cavage-http-signatures-12

Types

type Request

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

Request describe a complete request

func Delete

func Delete(url string) Request

Delete create DELETE to given url

func Get

func Get(url string) Request

Get create GET to given url

func New

func New() Request

New create a new Request

func Patch

func Patch(url string) Request

Patch create PATCH to given url

func Post

func Post(url string) Request

Post create POST to given url

func Put

func Put(url string) Request

Put create PUT to given url

func (Request) Accept

func (r Request) Accept(accept string) Request

Accept set Accept header

func (Request) AcceptJSON

func (r Request) AcceptJSON() Request

AcceptJSON set Accept header to application/json

func (Request) BasicAuth

func (r Request) BasicAuth(username, password string) Request

BasicAuth add Basic Auth header

func (Request) Build

func (r Request) Build(ctx context.Context, payload io.ReadCloser) (*http.Request, error)

Build create request for given context and payload

func (Request) ContentForm

func (r Request) ContentForm() Request

ContentForm set Content-Type header to application/x-www-form-urlencoded

func (Request) ContentJSON

func (r Request) ContentJSON() Request

ContentJSON set Content-Type header to application/json

func (Request) ContentType

func (r Request) ContentType(contentType string) Request

ContentType set Content-Type header

func (Request) Delete

func (r Request) Delete(url string) Request

Delete set DELETE to given url

func (Request) Form

func (r Request) Form(ctx context.Context, data url.Values) (*http.Response, error)

Form send request with given context and url.Values as payload

func (Request) Get

func (r Request) Get(url string) Request

Get set GET to given url

func (Request) Header

func (r Request) Header(name, value string) Request

Header add header to request

func (Request) IsZero

func (r Request) IsZero() bool

IsZero checks if instance is valued

func (Request) JSON

func (r Request) JSON(ctx context.Context, body any) (*http.Response, error)

JSON send request with given context and given interface as JSON payload

func (Request) Method

func (r Request) Method(method string) Request

Method set method of Request

func (Request) MethodURL

func (r Request) MethodURL(method, url string) Request

MethodURL set method and URL of Request

func (Request) Multipart

func (r Request) Multipart(ctx context.Context, feed func(mw *multipart.Writer) error) (*http.Response, error)

Multipart send request with given context and given interface as multipart content

func (Request) Patch

func (r Request) Patch(url string) Request

Patch set PATCH to given url

func (Request) Path

func (r Request) Path(path string) Request

Path appends given path to the current URL

func (Request) Post

func (r Request) Post(url string) Request

Post set POST to given url

func (Request) Put

func (r Request) Put(url string) Request

Put set PUT to given url

func (Request) Send

func (r Request) Send(ctx context.Context, payload io.ReadCloser) (*http.Response, error)

Send build request and send it with defined client

func (Request) StreamJSON

func (r Request) StreamJSON(ctx context.Context, body any) (*http.Response, error)

StreamJSON send request with given context and given interface as JSON stream

func (Request) String

func (r Request) String() string

String representation of the request

func (Request) URL

func (r Request) URL(url string) Request

URL set URL of Request

func (Request) WithClient

func (r Request) WithClient(client *http.Client) Request

WithClient defines net/http client to use, instead of default one (15sec timeout and no redirect)

func (Request) WithSignatureAuthorization

func (r Request) WithSignatureAuthorization(keyID string, secret []byte) Request

WithSignatureAuthorization add Authorization header when sending request by calculating digest and HMAC signature header