rest

Documentation

Index

• Constants
• Variables
• func DiscardCloseBody(r *http.Response) error
• func DurationOr(a, b time.Duration) time.Duration
• func If(condition bool, a, b string) string
• func IsJSONBytes(b []byte) bool
• func JoinURL(base *url.URL, target string) (string, error)
• func LogRequest(r *http.Request, verbose string)
• func LogResponse(r *http.Response, verbose string)
• func MaybeURL(out string) (string, bool)
• func ReadCloseBody(r *http.Response) ([]byte, error)
• type FixURIConfig
• type FixURIConfigFn
  • func WithAuth(v string) FixURIConfigFn
  • func WithDefaultHost(v string) FixURIConfigFn
  • func WithDefaultPort(v int) FixURIConfigFn
  • func WithDefaultScheme(v string) FixURIConfigFn
  • func WithFatalErr(v bool) FixURIConfigFn
• type FixURIConfigFns
  • func (fns FixURIConfigFns) Create() *FixURIConfig
• type FixURIResult
  • func FixURI(uri string, fns ...FixURIConfigFn) (rr FixURIResult)
  • func (r FixURIResult) OK() bool
• type Rest
  • func (r Rest) Delete() (*Rsp, error)
  • func (r Rest) Do() (*Rsp, error)
  • func (r Rest) Get() (*Rsp, error)
  • func (r Rest) Post() (*Rsp, error)
  • func (r Rest) Upload(filename string, fileData []byte) (*Rsp, error)
• type Rsp
• type URL
  • func NewURL(base string) URL
  • func (u URL) Build() (string, error)
  • func (u URL) Paths(paths ...string) URL
  • func (u URL) Query(k, v string, kvs ...string) URL
  • func (u URL) QueryMap(m map[string]string) URL
  • func (u URL) String() string

Constants

const ContentTypeJSON = "application/json; charset=utf-8"

Variables

var Client = &http.Client{

	Transport: &http.Transport{
		TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
	},
}

Functions

func DiscardCloseBody

func DiscardCloseBody(r *http.Response) error

func DurationOr

func DurationOr(a, b time.Duration) time.Duration

func If

func If(condition bool, a, b string) string

If tests condition to return a or b.

func IsJSONBytes

func IsJSONBytes(b []byte) bool

IsJSONBytes tests bytes b is in JSON format.

func JoinURL

func JoinURL(base *url.URL, target string) (string, error)

func LogRequest

func LogRequest(r *http.Request, verbose string)

func LogResponse

func LogResponse(r *http.Response, verbose string)

func MaybeURL

func MaybeURL(out string) (string, bool)

func ReadCloseBody

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

Types

type FixURIConfig

type FixURIConfig struct {
	DefaultScheme string
	DefaultHost   string
	DefaultPort   int
	FatalErr      bool
	Auth          string
}

type FixURIConfigFn

type FixURIConfigFn func(*FixURIConfig)

func WithAuth

func WithAuth(v string) FixURIConfigFn

func WithDefaultHost

func WithDefaultHost(v string) FixURIConfigFn

func WithDefaultPort

func WithDefaultPort(v int) FixURIConfigFn

func WithDefaultScheme

func WithDefaultScheme(v string) FixURIConfigFn

func WithFatalErr

func WithFatalErr(v bool) FixURIConfigFn

type FixURIConfigFns

type FixURIConfigFns []FixURIConfigFn

func (FixURIConfigFns) Create

func (fns FixURIConfigFns) Create() *FixURIConfig

type FixURIResult

type FixURIResult struct {
	Data *url.URL
	Err  error
}

func FixURI

func FixURI(uri string, fns ...FixURIConfigFn) (rr FixURIResult)

func (FixURIResult) OK

func (r FixURIResult) OK() bool

type Rest

type Rest struct {
	Body             []byte
	Method, Addr     string
	Headers          map[string]string
	Result           interface{}
	DisableKeepAlive bool
	Context          context.Context
	Timeout          time.Duration
	BasicAuth        string
}

func (Rest) Delete

func (r Rest) Delete() (*Rsp, error)

Delete execute HTTP GET request.

func (Rest) Do

func (r Rest) Do() (*Rsp, error)

Do execute HTTP method request.

func (Rest) Get

func (r Rest) Get() (*Rsp, error)

Get execute HTTP GET request.

func (Rest) Post

func (r Rest) Post() (*Rsp, error)

Post execute HTTP POST request.

func (Rest) Upload

func (r Rest) Upload(filename string, fileData []byte) (*Rsp, error)

Upload execute HTTP GET request.

type Rsp

type Rsp struct {
	Body   []byte
	Status int
	Header http.Header
	Cost   time.Duration
}

type URL

type URL struct {
	Base        string
	SubPaths    []string
	QueryValues url.Values
}

func NewURL

func NewURL(base string) URL

func (URL) Build

func (u URL) Build() (string, error)

func (URL) Paths

func (u URL) Paths(paths ...string) URL

func (URL) Query

func (u URL) Query(k, v string, kvs ...string) URL

func (URL) QueryMap

func (u URL) QueryMap(m map[string]string) URL

func (URL) String

func (u URL) String() string