restgo

type AfterHookFunc func(req IRequest, rsp IResponse)

type BaseParam struct {
	Name  string
	Value string
}

type BeforeHookFunc func(req IRequest)

type BodyParam struct {
	ContentType string
	Value       io.Reader
}

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

type CookieParam struct {
	http.Cookie
}

type FileParam struct {
	Name           string
	FileName       string
	ContentType    string
	ContentLength  int64
	FileWriterFunc WriterFunc
}

type FormDataBuilder struct {
	Fields map[string]string
	Files  map[string][]byte
}

type FormDataParam struct {
	BaseParam
}

type HeaderParam struct {
	BaseParam
}

type IParam interface {
	ParamName() string
}

type IRequest interface {
	AddParam(param IParam) IRequest
	AddParams(params ...IParam) IRequest
	AddCookie(name, value string) IRequest
	AddHeader(name, value string) IRequest
	AddURLQuery(name, value string) IRequest
	AddURLSegment(name, value, format string) IRequest
	AddFormItem(name, value string) IRequest
	AddFileBytes(fieldName, fileName string, bytes []byte) IRequest
	AddFilePath(fieldName, filePath string) IRequest
	SetBody(contentType string, value io.Reader) IRequest
	SetJSONBody(obj any) IRequest
	SetXMLBody(obj any) IRequest
	SetFormBody(fields map[string]string, files map[string][]byte) IRequest
	WithContentType(contentType string) IRequest

	MakeURL(baseURL *url.URL) (string, error)
	GetMethod() string
	MakeRequestBody() (io.Reader, error)
	WrapperHTTPRequest(req *http.Request)
}

type IResponse interface {
	// GetResponse get http response
	GetResponse() *http.Response
	// StatusCode get http status code
	StatusCode() int
	// Data get response data
	// it will automatically close response body
	Data() ([]byte, error)
	// Pipe : pipe response data to writer
	// it will automatically close response body
	Pipe(writer io.Writer) error
	// JSONUnmarshal unmarshal response data to json
	// it will automatically close response body
	JSONUnmarshal(i any) error
	// XMLUnmarshal unmarshal response data to xml
	// it will automatically close response body
	XMLUnmarshal(i any) error
	// SaveFile save response data to file
	// it will automatically close response body
	SaveFile(fileName string) error
	// ExplicitCloseBody close response body
	// If you get a response but never access it's body,
	// you should call this method to close response body.
	// Otherwise, it will cause resource leak.
	// Actually, you can use GetResponse().Body.Close() to close response body,
	// but this method is more convenient and remind you to close response body.
	ExplicitCloseBody() error
}

type OptionFn func(opt *option)

type Request struct {
	Resource string
	Method   string

	Cookies     []*CookieParam
	Headers     []*HeaderParam
	URLQueries  []*URLQueryParam
	URLSegments []*URLSegmentParam
	FormItems   []*FormDataParam
	Files       []*FileParam
	Body        *BodyParam
	ContentType string

	Err error
}

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

type URLQueryParam struct {
	BaseParam
}

type URLSegmentParam struct {
	BaseParam
	Format string
}

type WriterFunc func(w io.Writer) error