requests

README

Requests

Go HTTP Client Library

Usage

// New Request
r := NewRequest(WithTimout(time.Second))

// New Session
r := NewSession(WithTimout(time.Second))

// do http method
r.Get(url, map[string]string{})
r.Post(url, map[string]interface{}{})
r.Post(url, map[string]interface{}{})
r.PostFrom(url, map[string]string{})
r.Put(url, map[string]interface{}{})
r.Delete(url, map[string]interface{}{})

// download
r.Download(filePath, originUrl)
r.DownloadWithRateLimit(filePath, originUrl, rate)

// upload
r.Upload(originUrl, map[string]string{}, filepath1, filepath2 ...)

// response
r.Content()
r.ContentToString()
r.Status() // status code, status
r.Resp() // raw http.Response

Documentation

Index

• Constants
• func DefaultTransport() *http.Transport
• func ProxyFromEnvironment(req *http.Request) (*url.URL, error)
• type Option
  • func WithBasicAuth(username, password string) Option
  • func WithBearerTokenAuth(token string) Option
  • func WithCancelProxy() Option
  • func WithHeader(headers ...map[string]string) Option
  • func WithProxy(proxy map[string]string) Option
  • func WithSkipTLSVerify() Option
  • func WithTimeout(t time.Duration) Option
  • func WithTransport(transport *http.Transport) Option
• type Request
  • func NewRequest(options ...Option) *Request
  • func NewSession(options ...Option) *Request
  • func (r *Request) CancelProxy()
  • func (r Request) Content() []byte
  • func (r Request) ContentToString() string
  • func (r *Request) Delete(originUrl string, data map[string]interface{}) error
  • func (r *Request) Download(filePath, originUrl string) error
  • func (r *Request) DownloadWithRateLimit(filePath, originUrl string, rate int64) error
  • func (r *Request) Get(originUrl string, params map[string]string) error
  • func (r *Request) ParseUrl(originUrl string) error
  • func (r *Request) Post(originUrl string, data map[string]interface{}) error
  • func (r *Request) PostForm(originUrl string, data map[string]string) error
  • func (r *Request) Put(originUrl string, data map[string]interface{}) error
  • func (r Request) Request() *http.Request
  • func (r Request) Response() *http.Response
  • func (r *Request) SetBasicAuth(username, password string)
  • func (r *Request) SetBearerTokenAuth(token string)
  • func (r *Request) SetHeader(header map[string]string)
  • func (r *Request) SetProxy(proxy map[string]string)
  • func (r *Request) SetTimeout(t time.Duration)
  • func (r *Request) SetTransport(transport *http.Transport)
  • func (r *Request) SkipTLSVerify()
  • func (r Request) Status() (int, string)
  • func (r *Request) Upload(originUrl string, data map[string]string, filePaths ...string) error

Constants

const (
	ContentTypeJson string = "application/json;charset=utf-8"
	ContentTypeForm string = "application/x-www-form-urlencoded"
	HttpGet         string = "GET"
	HttpPost        string = "POST"
	HttpPut         string = "PUT"
	HttpDelete      string = "DELETE"
)

Functions

func DefaultTransport

func DefaultTransport() *http.Transport

func ProxyFromEnvironment

func ProxyFromEnvironment(req *http.Request) (*url.URL, error)

Types

type Option

type Option func(*Request)

func WithBasicAuth

func WithBasicAuth(username, password string) Option

func WithBearerTokenAuth

func WithBearerTokenAuth(token string) Option

func WithCancelProxy

func WithCancelProxy() Option

func WithHeader

func WithHeader(headers ...map[string]string) Option

func WithProxy

func WithProxy(proxy map[string]string) Option

func WithSkipTLSVerify

func WithSkipTLSVerify() Option

func WithTimeout

func WithTimeout(t time.Duration) Option

func WithTransport

func WithTransport(transport *http.Transport) Option

type Request

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

func NewRequest

func NewRequest(options ...Option) *Request

func NewSession

func NewSession(options ...Option) *Request

func (*Request) CancelProxy

func (r *Request) CancelProxy()

func (Request) Content

func (r Request) Content() []byte

func (Request) ContentToString

func (r Request) ContentToString() string

func (*Request) Delete

func (r *Request) Delete(originUrl string, data map[string]interface{}) error

func (*Request) Download

func (r *Request) Download(filePath, originUrl string) error

func (*Request) DownloadWithRateLimit

func (r *Request) DownloadWithRateLimit(filePath, originUrl string, rate int64) error

func (*Request) Get

func (r *Request) Get(originUrl string, params map[string]string) error

func (*Request) ParseUrl

func (r *Request) ParseUrl(originUrl string) error

func (*Request) Post

func (r *Request) Post(originUrl string, data map[string]interface{}) error

func (*Request) PostForm

func (r *Request) PostForm(originUrl string, data map[string]string) error

func (*Request) Put

func (r *Request) Put(originUrl string, data map[string]interface{}) error

func (Request) Request

func (r Request) Request() *http.Request

func (Request) Response

func (r Request) Response() *http.Response

func (*Request) SetBasicAuth

func (r *Request) SetBasicAuth(username, password string)

func (*Request) SetBearerTokenAuth

func (r *Request) SetBearerTokenAuth(token string)

func (*Request) SetHeader

func (r *Request) SetHeader(header map[string]string)

func (*Request) SetProxy

func (r *Request) SetProxy(proxy map[string]string)

func (*Request) SetTimeout

func (r *Request) SetTimeout(t time.Duration)

func (*Request) SetTransport

func (r *Request) SetTransport(transport *http.Transport)

func (*Request) SkipTLSVerify

func (r *Request) SkipTLSVerify()

func (Request) Status

func (r Request) Status() (int, string)

func (*Request) Upload

func (r *Request) Upload(originUrl string, data map[string]string, filePaths ...string) error