gorest

type Executor interface {
	Execute() (resp *http.Response, err error)
	HandleBody(f func(body []uint8) error) error
	// HandleResponse require response handler,
	// if create a new response, MUST close old res.Body
	HandleResponse(func(*http.Request, *http.Response) (*http.Response, error)) ResponseHandler
}

type InvalidStatusCodeError struct {
	StatusCode   int
	ResponseBody []byte
}

type JSONContent interface {
	JSON(json []byte) JSONContent
	JSONString(json string) JSONContent
	// JSONStruct requires struct, not pointer.
	// if receive invalid, error occurs when executing.
	JSONStruct(data interface{}) JSONContent
	Executor
}

type Multipart interface {
	MultipartData(key string, value io.Reader, forceMultipart bool) Multipart
	MultipartAsFormFile(key string, fileName string, reader io.Reader, forceMultipart bool) Multipart
	Executor
}

type ResponseHandler interface {
	HandleBody(f func(body []uint8) error) error
}

type TerminalOperator interface {
	Path(pathFmt string, args ...interface{}) TerminalOperator
	URLParam(key string, value string) TerminalOperator

	BasicAuth(username string, password string) TerminalOperator

	Header(key, value string) TerminalOperator

	// client
	Client(client *http.Client) TerminalOperator

	JSON(json []byte) JSONContent
	JSONString(json string) JSONContent
	// JSONStruct requires struct, not pointer.
	// if receive invalid, error occurs when executing.
	JSONStruct(data interface{}) JSONContent

	// URLEncoded add value if same key
	URLEncoded(key string, value string) URLEncoded
	// URLEncodedList replace values if same key
	URLEncodedList(key string, values []string) URLEncoded
	// URLEncodedEscapedString receives raw data, but never check
	URLEncodedEscapedString(data string) URLEncoded
	URLEncodedString(data string) URLEncoded

	MultipartData(key string, value io.Reader, forceMultipart bool) Multipart
	MultipartAsFormFile(key string, fileName string, reader io.Reader, forceMultipart bool) Multipart

	// HandleResponse require response handler,
	// if create a new response, MUST close old res.Body
	HandleResponse(func(*http.Request, *http.Response) (*http.Response, error)) ResponseHandler

	Executor
}

type URLEncoded interface {
	// URLEncoded add value if same key
	URLEncoded(key string, value string) URLEncoded
	// URLEncodedList replace values if same key
	URLEncodedList(key string, values []string) URLEncoded
	// URLEncodedEscapedString receives raw data, but never check
	URLEncodedEscapedString(data string) URLEncoded
	URLEncodedString(data string) URLEncoded
	Executor
}