requests

Documentation

Index

• Variables
• func GetJSON(path string, result interface{}) error
• func GetStream(path string) (io.ReadCloser, error)
• func GetText(path string) (string, error)
• func PatchJSON(path string, body interface{}, result interface{}) error
• func PostJSON(path string, body interface{}, result interface{}) error
• func PutJSON(path string, body interface{}, result interface{}) error
• func SaveFile(path string, filename string) error
• type Builder
  • func NewBuilder() *Builder
  • func (b *Builder) Client(client *http.Client) *Builder
  • func (b *Builder) Delete(path string) *Builder
  • func (b *Builder) Do(client ...*http.Client) Response
  • func (b *Builder) Get(path string) *Builder
  • func (b *Builder) Header(k, v string) *Builder
  • func (b *Builder) Headers(m map[string]string) *Builder
  • func (b *Builder) Options(path string) *Builder
  • func (b *Builder) Patch(path string) *Builder
  • func (b *Builder) Post(path string) *Builder
  • func (b *Builder) Prefix(p string) *Builder
  • func (b *Builder) Put(path string) *Builder
  • func (b *Builder) Queries(m map[string]string) *Builder
  • func (b *Builder) Query(k, v string) *Builder
  • func (b *Builder) WriteBody(r io.Reader) *Builder
  • func (b *Builder) WriteFile(filename string) *Builder
  • func (b *Builder) WriteFormFile(formName string, fileName string) *Builder
  • func (b *Builder) WriteJSON(v interface{}) *Builder
  • func (b *Builder) WriteText(text string) *Builder
  • func (b *Builder) WriteXML(v interface{}) *Builder
• type Response
  • func ErrorResponse(err error) Response
  • func Get(path string) Response
  • func Patch(path string, reader io.Reader, contentType string) Response
  • func Post(path string, reader io.Reader, contentType string) Response
  • func PostFile(path string, fileName string) Response
  • func PostFormFile(path string, formName string, fileName string) Response
  • func Put(path string, reader io.Reader, contentType string) Response
  • func WrapResponse(r *http.Response) Response
• type Template
  • func (t *Template) New() *Builder

Variables

var ErrResponseBodyHasRead = newError("http response", "body has read")

Functions

func GetJSON

func GetJSON(path string, result interface{}) error

func GetStream

func GetStream(path string) (io.ReadCloser, error)

func GetText

func GetText(path string) (string, error)

func PatchJSON

func PatchJSON(path string, body interface{}, result interface{}) error

func PostJSON

func PostJSON(path string, body interface{}, result interface{}) error

func PutJSON

func PutJSON(path string, body interface{}, result interface{}) error

func SaveFile

func SaveFile(path string, filename string) error

Types

type Builder

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

func NewBuilder

func NewBuilder() *Builder

func (*Builder) Client

func (b *Builder) Client(client *http.Client) *Builder

func (*Builder) Delete

func (b *Builder) Delete(path string) *Builder

func (*Builder) Do

func (b *Builder) Do(client ...*http.Client) Response

func (*Builder) Get

func (b *Builder) Get(path string) *Builder

func (*Builder) Header

func (b *Builder) Header(k, v string) *Builder

func (*Builder) Headers

func (b *Builder) Headers(m map[string]string) *Builder

func (*Builder) Options

func (b *Builder) Options(path string) *Builder

func (*Builder) Patch

func (b *Builder) Patch(path string) *Builder

func (*Builder) Post

func (b *Builder) Post(path string) *Builder

func (*Builder) Prefix

func (b *Builder) Prefix(p string) *Builder

func (*Builder) Put

func (b *Builder) Put(path string) *Builder

func (*Builder) Queries

func (b *Builder) Queries(m map[string]string) *Builder

func (*Builder) Query

func (b *Builder) Query(k, v string) *Builder

func (*Builder) WriteBody

func (b *Builder) WriteBody(r io.Reader) *Builder

func (*Builder) WriteFile

func (b *Builder) WriteFile(filename string) *Builder

func (*Builder) WriteFormFile

func (b *Builder) WriteFormFile(formName string, fileName string) *Builder

func (*Builder) WriteJSON

func (b *Builder) WriteJSON(v interface{}) *Builder

func (*Builder) WriteText

func (b *Builder) WriteText(text string) *Builder

func (*Builder) WriteXML

func (b *Builder) WriteXML(v interface{}) *Builder

type Response

type Response interface {
	Raw() (*http.Response, error)
	Stream() (io.ReadCloser, error)
	Bytes() ([]byte, error)
	Text() (string, error)
	JSON(value interface{}) error
	XML(value interface{}) error
	Pipe(writer io.Writer) error
	SaveFile(filename string) error
	Dump(body bool) ([]byte, error)
}

func ErrorResponse

func ErrorResponse(err error) Response

func Get

func Get(path string) Response

func Patch

func Patch(path string, reader io.Reader, contentType string) Response

func Post

func Post(path string, reader io.Reader, contentType string) Response

func PostFile

func PostFile(path string, fileName string) Response

func PostFormFile

func PostFormFile(path string, formName string, fileName string) Response

func Put

func Put(path string, reader io.Reader, contentType string) Response

func WrapResponse

func WrapResponse(r *http.Response) Response

type Template

type Template struct {
	Client  *http.Client
	Prefix  string
	Queries map[string]string
	Headers map[string]string
}

func (*Template) New

func (t *Template) New() *Builder