fetch

Documentation

Index

• Variables
• func Fetch(url string) (*http.Response, error)
• func Get(url string, opts ...Option) (*http.Response, error)
• func Post(url string, body io.Reader, opts ...Option) (*http.Response, error)
• func Request(method, url string, body io.Reader, opts ...Option) (*http.Response, error)
• func WithJSONBody(v any) io.Reader
• func WithURLEncodedBody(query map[string]string) io.Reader
• type Config
• type Context
• type Fetcher
  • func Default(cfg *Config) *Fetcher
  • func New(c *http.Client, cfg *Config) *Fetcher
  • func (f *Fetcher) Fetch(url string) (resp *http.Response, err error)
  • func (f *Fetcher) Get(url string, opts ...Option) (resp *http.Response, err error)
  • func (f *Fetcher) Post(url string, body io.Reader, opts ...Option) (resp *http.Response, err error)
  • func (f *Fetcher) Request(method, url string, body io.Reader, opts ...Option) (resp *http.Response, err error)
• type Option
  • func WithAuthorization(token string) Option
  • func WithBasicAuth(username, password string) Option
  • func WithHeader(key, value string) Option
  • func WithHeaders(headers map[string]string) Option
  • func WithQuery(key, value string) Option
  • func WithQueryMap(query map[string]string) Option
  • func WithQueryPairs(kv ...string) Option
  • func WithRaiseForStatus(v bool) Option
  • func WithRandomUserAgent() Option
  • func WithReferer(referer string) Option
  • func WithRequest(fn func(req *http.Request)) Option
  • func WithUserAgent(ua string) Option

Variables

var DefaultFetcher = Default(&Config{RandomUserAgent: true})

Functions

func Fetch

func Fetch(url string) (*http.Response, error)

func Get

func Get(url string, opts ...Option) (*http.Response, error)

func Post

func Post(url string, body io.Reader, opts ...Option) (*http.Response, error)

func Request

func Request(method, url string, body io.Reader, opts ...Option) (*http.Response, error)

func WithJSONBody

func WithJSONBody(v any) io.Reader

func WithURLEncodedBody

func WithURLEncodedBody(query map[string]string) io.Reader

Types

type Config

type Config struct {
	// Set User-Agent Header.
	UserAgent string

	// Set Referer Header.
	Referer string

	// Enable cookies.
	EnableCookies bool

	// Use random User-Agent.
	RandomUserAgent bool

	// Return error when status is not OK.
	RaiseForStatus bool
}

type Context

type Context struct {
	Config
	// contains filtered or unexported fields
}

Context is used for each request.

type Fetcher

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

func Default

func Default(cfg *Config) *Fetcher

func New

func New(c *http.Client, cfg *Config) *Fetcher

func (*Fetcher) Fetch

func (f *Fetcher) Fetch(url string) (resp *http.Response, err error)

func (*Fetcher) Get

func (f *Fetcher) Get(url string, opts ...Option) (resp *http.Response, err error)

func (*Fetcher) Post

func (f *Fetcher) Post(url string, body io.Reader, opts ...Option) (resp *http.Response, err error)

func (*Fetcher) Request

func (f *Fetcher) Request(method, url string, body io.Reader, opts ...Option) (resp *http.Response, err error)

type Option

type Option func(*Context)

func WithAuthorization

func WithAuthorization(token string) Option

func WithBasicAuth

func WithBasicAuth(username, password string) Option

func WithHeader

func WithHeader(key, value string) Option

func WithHeaders

func WithHeaders(headers map[string]string) Option

func WithQuery

func WithQuery(key, value string) Option

func WithQueryMap

func WithQueryMap(query map[string]string) Option

func WithQueryPairs

func WithQueryPairs(kv ...string) Option

func WithRaiseForStatus

func WithRaiseForStatus(v bool) Option

func WithRandomUserAgent

func WithRandomUserAgent() Option

func WithReferer

func WithReferer(referer string) Option

func WithRequest

func WithRequest(fn func(req *http.Request)) Option

func WithUserAgent

func WithUserAgent(ua string) Option