sreq

Jan 25, 2020

Changes in this version

type Backoff

+ func NewExponentialBackoff(minWaitTime, maxWaitTime time.Duration, jitter bool) Backoff

+ WaitTime func(attemptNum int, resp *Response) time.Duration

type Client

+ func NewWithHTTPClient(rawClient *http.Client) *Client

+ func NewWithSession() *Client

+ func (c *Client) SetRateLimiter(limiter *rate.Limiter, urlPatterns ...*regexp.Regexp) *Client

type Request

+ func (req *Request) ExportCURLCommand() (string, error)

type Response

+ func (resp *Response) Dump(withBody bool) ([]byte, error)

type Retry

+ Triggers []func(resp *Response) bool

Jan 22, 2020

Changes in this version

+ func GenCURLCommand(req *http.Request) (string, error)

type BeforeRequestHook

+ func SetDefaultOrigin(origin string) BeforeRequestHook

+ func SetReverseProxy(target string, publicPaths ...string) BeforeRequestHook

type Client

+ func (c *Client) SetHTTPClient(rawClient *http.Client) *Client

type ClientOption

+ func SetHTTPClient(rawClient *http.Client) ClientOption

+ type FormFile interface

+ Filename func() string

+ MIME func() string

type Request

+ func (req *Request) Dump(withBody bool) ([]byte, error)

+ func (req *Request) Export() (string, error)

+ func (req *Request) SetOrigin(origin string) *Request

type RequestOption

+ func WithOrigin(origin string) RequestOption

type Response

+ func (resp *Response) Prefetch() *Response

Jan 20, 2020

Changes in this version

type Request

+ func (req *Request) Decode() *http.Request

Jan 19, 2020

Changes in this version

type Client

+ func NewWithOptions(opts ...ClientOption) (*Client, error)

type Request

+ Query Params

Jan 15, 2020

Changes in this version

type Values

+ func (v Values) URLEncode(escaped bool) string

Jan 14, 2020

Changes in this version

+ type Error struct

+ Err error

+ Op string

+ func (e *Error) Error() string

+ func (e *Error) Unwrap() error

type Request

+ func (req *Request) Sync()

type Retry

+ func (r *Retry) Merge(r2 *Retry) *Retry

Jan 11, 2020

Changes in this version

+ func DefaultTrigger(resp *Response) bool

type BeforeRequestHook

+ func SetDefaultBasicAuth(username string, password string) BeforeRequestHook

+ func SetDefaultBearerToken(token string) BeforeRequestHook

+ func SetDefaultContentType(contentType string) BeforeRequestHook

+ func SetDefaultCookies(cookies Cookies) BeforeRequestHook

+ func SetDefaultForm(form Form) BeforeRequestHook

+ func SetDefaultHeaders(headers Headers) BeforeRequestHook

+ func SetDefaultHost(host string) BeforeRequestHook

+ func SetDefaultQuery(params Params) BeforeRequestHook

+ func SetDefaultReferer(referer string) BeforeRequestHook

+ func SetDefaultRetry(retry *Retry) BeforeRequestHook

+ func SetDefaultUserAgent(userAgent string) BeforeRequestHook

type Request

+ Retry *Retry

+ type Retry struct

+ Backoff Backoff

+ MaxAttempts int

+ MaxWaitTime time.Duration

+ Trigger func(resp *Response) bool

+ WaitTime time.Duration

Jan 11, 2020

Changes in this version

+ func Configure(opts ...ClientOption) error

+ type AfterResponseHook func(resp *Response)

+ type BeforeRequestHook func(req *Request) error

type Client

+ func (c *Client) Configure(opts ...ClientOption) error

+ func (c *Client) OnAfterResponse(hooks ...AfterResponseHook)

+ func (c *Client) OnBeforeRequest(hooks ...BeforeRequestHook)

+ func (c *Client) SetRetryOptions(opts ...RetryOption)

+ type ClientOption func(c *Client) error

+ func OnAfterResponse(hooks ...AfterResponseHook) ClientOption

+ func OnBeforeRequest(hooks ...BeforeRequestHook) ClientOption

+ func SetRetryOptions(opts ...RetryOption) ClientOption

type Response

+ func (resp *Response) Error() error

+ func (resp *Response) RaiseError(err error)

Jan 10, 2020

Changes in this version

+ func DefaultBackoff(min time.Duration, max time.Duration, attempt int, _ *Response) time.Duration

+ type Backoff func(min time.Duration, max time.Duration, attemptNum int, resp *Response) time.Duration

type Cookies

+ func (c Cookies) Has(key string) bool

type H

+ func (h H) Has(key string) bool

type RequestInterceptor

+ func SetBasicAuthDefault(username string, password string) RequestInterceptor

+ func SetBearerTokenDefault(token string) RequestInterceptor

+ func SetContentTypeDefault(contentType string) RequestInterceptor

+ func SetCookiesDefault(cookies Cookies) RequestInterceptor

+ func SetFormDefault(form Form) RequestInterceptor

+ func SetHeadersDefault(headers Headers) RequestInterceptor

+ func SetHostDefault(host string) RequestInterceptor

+ func SetQueryDefault(params Params) RequestInterceptor

+ func SetRefererDefault(referer string) RequestInterceptor

+ func SetUserAgentDefault(userAgent string) RequestInterceptor

type RetryOption

+ func WithBackoff(backoff Backoff) RetryOption

+ func WithMaxAttempts(maxAttempts int) RetryOption

+ func WithMaxWaitTime(maxWaitTime time.Duration) RetryOption

+ func WithTriggers(triggers ...func(resp *Response) bool) RetryOption

+ func WithWaitTime(waitTime time.Duration) RetryOption

type Values

+ func (v Values) Has(key string) bool

Jan 10, 2020

Changes in this version

+ func Raw() (*http.Client, error)

type Request

+ RetryOption *RetryOption

+ type RetryOption struct

+ Attempts int

+ Conditions []func(*Response) bool

+ Delay time.Duration

Jan 8, 2020

Changes in this version

type Request

+ Body io.Reader

+ Form Form

+ Params Params

Jan 7, 2020

Changes in this version

+ type Cookies map[string]string

+ func (c Cookies) Clone() Cookies

+ func (c Cookies) Decode() []*http.Cookie

+ func (c Cookies) Del(name string)

+ func (c Cookies) Get(name string) *http.Cookie

+ func (c Cookies) Merge(c2 Cookies)

+ func (c Cookies) Set(name string, value string)

+ func (c Cookies) SetDefault(name string, value string)

+ func (c Cookies) Update(c2 Cookies)

type Values

+ func (v Values) Decode() map[string][]string

Jan 7, 2020

Changes in this version

type H

+ func (h H) Decode(output interface{}) error

+ func (h H) GetNumber(key string) Number

+ func (h H) GetNumberDefault(key string, defaultValue Number) Number

+ func (h H) GetNumberSlice(key string) []Number

+ type Number float64

+ func (n Number) Float32() float32

+ func (n Number) Float64() float64

+ func (n Number) Int() int

+ func (n Number) Int16() int16

+ func (n Number) Int32() int32

+ func (n Number) Int64() int64

+ func (n Number) Int8() int8

+ func (n Number) String() string

+ func (n Number) Uint() uint

+ func (n Number) Uint16() uint16

+ func (n Number) Uint32() uint32

+ func (n Number) Uint64() uint64

+ func (n Number) Uint8() uint8

Jan 6, 2020

Changes in this version

+ func ToJSON(v interface{}, prefix string, indent string, escapeHTML bool) string

type KV

+ Clone func() map[string][]string

Jan 5, 2020

Changes in this version

type Headers

+ func (h Headers) Update(h2 Headers)

type Values

+ func (v Values) Update(v2 Values)

Jan 4, 2020

Changes in this version

type H

+ func (h H) Encode(v interface{}) error

type Headers

+ func (h Headers) SetDefault(key string, value interface{})

type Values

+ func (v Values) Clone() Values

+ func (v Values) Merge(values Values) Values

+ func (v Values) SetDefault(key string, value interface{})

Dec 31, 2019

Changes in this version

type H

+ func (h H) GetBoolDefault(key string, defaultValue bool) bool

+ func (h H) GetFloat32Default(key string, defaultValue float32) float32

+ func (h H) GetFloat64Default(key string, defaultValue float64) float64

+ func (h H) GetInt32Default(key string, defaultValue int32) int32

+ func (h H) GetInt64Default(key string, defaultValue int64) int64

+ func (h H) GetIntDefault(key string, defaultValue int) int

+ func (h H) GetStringDefault(key string, defaultValue string) string

+ func (h H) GetUint32Default(key string, defaultValue uint32) uint32

+ func (h H) GetUint64Default(key string, defaultValue uint64) uint64

+ func (h H) GetUintDefault(key string, defaultValue uint) uint

Dec 28, 2019

Changes in this version

type Client

+ func AppendRootCerts(pemFile string) *Client

+ func (c *Client) AppendRootCerts(pemFile string) *Client

Dec 28, 2019

Changes in this version

+ var ErrNoCookie = errors.New("sreq: named cookie not present")

+ var GlobalClient = New()

type Client

+ func AppendClientCerts(certs ...tls.Certificate) *Client

+ func AppendRootCertsFromPem(pemFilePath string) *Client

+ func (c *Client) AppendClientCerts(certs ...tls.Certificate) *Client

+ func (c *Client) AppendRootCertsFromPem(pemFile string) *Client

Dec 25, 2019

Changes in this version

+ var ErrJarNoCookie = errors.New("sreq: named cookie for the given URL not present")

+ var ErrResponseNoCookie = errors.New("sreq: named cookie not present")

type Values

+ func (v Values) Marshal() string

Dec 13, 2019

Changes in this version

+ type H map[string]interface

+ func (h H) Get(key string) interface{}

+ func (h H) GetBool(key string) bool

+ func (h H) GetBoolSlice(key string) []bool

+ func (h H) GetFloat32(key string) float32

+ func (h H) GetFloat32Slice(key string) []float32

+ func (h H) GetFloat64(key string) float64

+ func (h H) GetFloat64Slice(key string) []float64

+ func (h H) GetH(key string) H

+ func (h H) GetHSlice(key string) []H

+ func (h H) GetInt(key string) int

+ func (h H) GetInt32(key string) int32

+ func (h H) GetInt32Slice(key string) []int32

+ func (h H) GetInt64(key string) int64

+ func (h H) GetInt64Slice(key string) []int64

+ func (h H) GetIntSlice(key string) []int

+ func (h H) GetSlice(key string) []interface{}

+ func (h H) GetString(key string) string

+ func (h H) GetStringSlice(key string) []string

+ func (h H) GetUint(key string) uint

+ func (h H) GetUint32(key string) uint32

+ func (h H) GetUint32Slice(key string) []uint32

+ func (h H) GetUint64(key string) uint64

+ func (h H) GetUint64Slice(key string) []uint64

+ func (h H) GetUintSlice(key string) []uint

+ func (h H) String() string

type Response

+ func (resp *Response) H() (H, error)

Dec 11, 2019

Changes in this version

+ type File struct

+ Body io.Reader

+ Filename string

+ MIME string

+ func NewFile(filename string, body io.Reader) *File

+ func Open(filename string) (*File, error)

+ func (f *File) Close() error

+ func (f *File) Read(p []byte) (int, error)

+ func (f *File) SetFilename(filename string) *File

+ func (f *File) SetMIME(mime string) *File

type Headers

+ func (h Headers) Keys() []string

+ type KV interface

+ Get func(key string) []string

+ Keys func() []string

type Request

+ func (req *Request) SetXML(data interface{}) *Request

type RequestOption

+ func WithXML(data interface{}) RequestOption

type Response

+ func (resp *Response) XML(v interface{}) error

+ type Values map[string]interface

+ func (v Values) Del(key string)

+ func (v Values) Encode() string

+ func (v Values) Get(key string) []string

+ func (v Values) Keys() []string

+ func (v Values) Set(key string, value interface{})

+ func (v Values) String() string

Dec 7, 2019

Changes in this version

+ func MustOpen(filename string) *os.File

+ type FileForm struct

+ FileName string

+ MIME string

+ Reader io.Reader

type Request

+ func (req *Request) SetMultipart(files Files, form Form) *Request

type RequestOption

+ func WithMultipart(files Files, form Form) RequestOption

Dec 6, 2019

Changes in this version

type Client

+ func UseRequestInterceptors(interceptors ...RequestInterceptor) *Client

+ func UseResponseInterceptors(interceptors ...ResponseInterceptor) *Client

+ func (c *Client) UseRequestInterceptors(interceptors ...RequestInterceptor) *Client

+ func (c *Client) UseResponseInterceptors(interceptors ...ResponseInterceptor) *Client

+ type RequestInterceptor func(*Request) error

+ type ResponseInterceptor func(*Response) error

Dec 5, 2019

Changes in this version

+ var ErrResponseNamedCookieNotPresent = errors.New("sreq: named cookie not present")

Dec 4, 2019

Changes in this version

+ const DefaultTimeout

+ const MethodConnect

+ const MethodDelete

+ const MethodGet

+ const MethodHead

+ const MethodOptions

+ const MethodPatch

+ const MethodPost

+ const MethodPut

+ const MethodTrace

+ const Version

+ var DefaultClient = New()

+ var ErrJarCookiesNotPresent = errors.New("sreq: cookies for the given URL not present")

+ var ErrJarNamedCookieNotPresent = errors.New("sreq: named cookie for the given URL not present")

+ var ErrNilContext = errors.New("nil Context")

+ var ErrNilCookieJar = errors.New("sreq: nil cookie jar")

+ var ErrResponseCookiesNotPresent = errors.New("sreq: cookies not present")

+ var ErrResponseNameCookieNotPresent = errors.New("sreq: named cookie not present")

+ var ErrRetryMaxDurationExceeded = errors.New("sreq: retry max duration exceeded")

+ var ErrUnexpectedTransport = errors.New("current transport isn't a non-nil *http.Transport instance")

+ func DefaultTransport() http.RoundTripper

+ func FilterCookie(url string, name string) (*http.Cookie, error)

+ func FilterCookies(url string) ([]*http.Cookie, error)

+ type Client struct

+ Cookies []*http.Cookie

+ Err error

+ Headers Headers

+ Host string

+ RawClient *http.Client

+ func AppendClientCertificates(certs ...tls.Certificate) *Client

+ func AppendRootCAs(pemFilePath string) *Client

+ func DisableProxy() *Client

+ func DisableRedirect() *Client

+ func DisableSession() *Client

+ func DisableVerify() *Client

+ func New() *Client

+ func SetBasicAuth(username string, password string) *Client

+ func SetBearerToken(token string) *Client

+ func SetContext(ctx context.Context) *Client

+ func SetCookieJar(jar http.CookieJar) *Client

+ func SetCookies(cookies ...*http.Cookie) *Client

+ func SetHeaders(headers Headers) *Client

+ func SetHost(host string) *Client

+ func SetProxy(proxy func(*http.Request) (*stdurl.URL, error)) *Client

+ func SetProxyFromURL(url string) *Client

+ func SetRedirect(policy func(req *http.Request, via []*http.Request) error) *Client

+ func SetReferer(referer string) *Client

+ func SetRetry(attempts int, delay time.Duration, maxDuration time.Duration, ...) *Client

+ func SetTLSClientConfig(config *tls.Config) *Client

+ func SetTimeout(timeout time.Duration) *Client

+ func SetTransport(transport http.RoundTripper) *Client

+ func SetUserAgent(userAgent string) *Client

+ func (c *Client) AppendClientCertificates(certs ...tls.Certificate) *Client

+ func (c *Client) AppendRootCAs(pemFilePath string) *Client

+ func (c *Client) Delete(url string, opts ...RequestOption) *Response

+ func (c *Client) DisableProxy() *Client

+ func (c *Client) DisableRedirect() *Client

+ func (c *Client) DisableSession() *Client

+ func (c *Client) DisableVerify() *Client

+ func (c *Client) Do(req *Request) *Response

+ func (c *Client) FilterCookie(url string, name string) (*http.Cookie, error)

+ func (c *Client) FilterCookies(url string) ([]*http.Cookie, error)

+ func (c *Client) Get(url string, opts ...RequestOption) *Response

+ func (c *Client) Head(url string, opts ...RequestOption) *Response

+ func (c *Client) Patch(url string, opts ...RequestOption) *Response

+ func (c *Client) Post(url string, opts ...RequestOption) *Response

+ func (c *Client) Put(url string, opts ...RequestOption) *Response

+ func (c *Client) Raw() (*http.Client, error)

+ func (c *Client) Send(method string, url string, opts ...RequestOption) *Response

+ func (c *Client) SetBasicAuth(username string, password string) *Client

+ func (c *Client) SetBearerToken(token string) *Client

+ func (c *Client) SetContext(ctx context.Context) *Client

+ func (c *Client) SetCookieJar(jar http.CookieJar) *Client

+ func (c *Client) SetCookies(cookies ...*http.Cookie) *Client

+ func (c *Client) SetHeaders(headers Headers) *Client

+ func (c *Client) SetHost(host string) *Client

+ func (c *Client) SetProxy(proxy func(*http.Request) (*stdurl.URL, error)) *Client

+ func (c *Client) SetProxyFromURL(url string) *Client

+ func (c *Client) SetRedirect(policy func(req *http.Request, via []*http.Request) error) *Client

+ func (c *Client) SetReferer(referer string) *Client

+ func (c *Client) SetRetry(attempts int, delay time.Duration, maxDuration time.Duration, ...) *Client

+ func (c *Client) SetTLSClientConfig(config *tls.Config) *Client

+ func (c *Client) SetTimeout(timeout time.Duration) *Client

+ func (c *Client) SetTransport(transport http.RoundTripper) *Client

+ func (c *Client) SetUserAgent(userAgent string) *Client

+ type ClientError struct

+ Cause string

+ Err error

+ func (c *ClientError) Error() string

+ func (c *ClientError) Unwrap() error

+ type Files map[string]string

+ func (f Files) Del(key string)

+ func (f Files) Get(key string) string

+ func (f Files) Set(key string, value string)

+ func (f Files) String() string

+ type Form map[string]string

+ func (f Form) Clone() Form

+ func (f Form) Del(key string)

+ func (f Form) Encode() string

+ func (f Form) Get(key string) string

+ func (f Form) Merge(form Form) Form

+ func (f Form) Set(key string, value string)

+ func (f Form) String() string

+ type Headers map[string]string

+ func (h Headers) Clone() Headers

+ func (h Headers) Del(key string)

+ func (h Headers) Get(key string) string

+ func (h Headers) Merge(headers Headers) Headers

+ func (h Headers) Set(key string, value string)

+ func (h Headers) String() string

+ type JSON map[string]interface

+ func (j JSON) Clone() JSON

+ func (j JSON) Del(key string)

+ func (j JSON) Get(key string) interface{}

+ func (j JSON) Merge(data JSON) JSON

+ func (j JSON) Set(key string, value interface{})

+ func (j JSON) String() string

+ type Params map[string]string

+ func (p Params) Clone() Params

+ func (p Params) Del(key string)

+ func (p Params) Encode() string

+ func (p Params) Get(key string) string

+ func (p Params) Merge(params Params) Params

+ func (p Params) Set(key string, value string)

+ func (p Params) String() string

+ type Request struct

+ Cookies []*http.Cookie

+ Err error

+ Headers Headers

+ Host string

+ RawRequest *http.Request

+ Timeout time.Duration

+ func NewRequest(method string, url string) *Request

+ func (req *Request) Raw() (*http.Request, error)

+ func (req *Request) SetBasicAuth(username string, password string) *Request

+ func (req *Request) SetBearerToken(token string) *Request

+ func (req *Request) SetBody(body io.Reader) *Request

+ func (req *Request) SetContent(content []byte) *Request

+ func (req *Request) SetContentType(contentType string) *Request

+ func (req *Request) SetContext(ctx context.Context) *Request

+ func (req *Request) SetCookies(cookies ...*http.Cookie) *Request

+ func (req *Request) SetFiles(files Files) *Request

+ func (req *Request) SetForm(form Form) *Request

+ func (req *Request) SetHeaders(headers Headers) *Request

+ func (req *Request) SetHost(host string) *Request

+ func (req *Request) SetJSON(data JSON, escapeHTML bool) *Request

+ func (req *Request) SetQuery(params Params) *Request

+ func (req *Request) SetReferer(referer string) *Request

+ func (req *Request) SetRetry(attempts int, delay time.Duration, maxDuration time.Duration, ...) *Request

+ func (req *Request) SetText(text string) *Request

+ func (req *Request) SetTimeout(timeout time.Duration) *Request

+ func (req *Request) SetUserAgent(userAgent string) *Request

+ type RequestError struct

+ Cause string

+ Err error

+ func (req *RequestError) Error() string

+ func (req *RequestError) Unwrap() error

+ type RequestOption func(*Request) *Request

+ func WithBasicAuth(username string, password string) RequestOption

+ func WithBearerToken(token string) RequestOption

+ func WithBody(body io.Reader) RequestOption

+ func WithContent(content []byte) RequestOption

+ func WithContentType(contentType string) RequestOption

+ func WithContext(ctx context.Context) RequestOption

+ func WithCookies(cookies ...*http.Cookie) RequestOption

+ func WithFiles(files Files) RequestOption

+ func WithForm(form Form) RequestOption

+ func WithHeaders(headers Headers) RequestOption

+ func WithHost(host string) RequestOption

+ func WithJSON(data JSON, escapeHTML bool) RequestOption

+ func WithQuery(params Params) RequestOption

+ func WithReferer(referer string) RequestOption

+ func WithRetry(attempts int, delay time.Duration, maxDuration time.Duration, ...) RequestOption

+ func WithText(text string) RequestOption

+ func WithTimeout(timeout time.Duration) RequestOption

+ func WithUserAgent(userAgent string) RequestOption

+ type Response struct

+ Err error

+ RawResponse *http.Response

+ func Delete(url string, opts ...RequestOption) *Response

+ func Do(req *Request) *Response

+ func Get(url string, opts ...RequestOption) *Response

+ func Head(url string, opts ...RequestOption) *Response

+ func Patch(url string, opts ...RequestOption) *Response

+ func Post(url string, opts ...RequestOption) *Response

+ func Put(url string, opts ...RequestOption) *Response

+ func Send(method string, url string, opts ...RequestOption) *Response

+ func (resp *Response) Content() ([]byte, error)

+ func (resp *Response) Cookie(name string) (*http.Cookie, error)

+ func (resp *Response) Cookies() ([]*http.Cookie, error)

+ func (resp *Response) EnsureStatus(code int) *Response

+ func (resp *Response) EnsureStatus2xx() *Response

+ func (resp *Response) EnsureStatusOk() *Response

+ func (resp *Response) JSON(v interface{}) error

+ func (resp *Response) Raw() (*http.Response, error)

+ func (resp *Response) Save(filename string, perm os.FileMode) error

+ func (resp *Response) Text() (string, error)

+ func (resp *Response) Verbose(w io.Writer) error