minireq

README

minireq

Simple HTTP Client.

Feature

• Socks5 Proxy
• HTTP Basic Auth
• Params
• JSON
• Form
• Upload File
• Raw Response
• JSON Response
• Cookies

Example

client := NewClient()
params := Params{"foo": "bar"}
res, _ := client.Get("https://postman-echo.com/get", params)
data, _ := res.RawJSON()
fmt.Println(data)

Documentation

Index

• Constants
• type Auth
• type Cookies
• type FormData
• type FormKV
• type Headers
• type HttpClient
  • func NewClient() *HttpClient
  • func (h *HttpClient) Connect(url string, opts ...any) (*MiniResponse, error)
  • func (h *HttpClient) Delete(url string, opts ...any) (*MiniResponse, error)
  • func (h *HttpClient) Get(url string, opts ...any) (*MiniResponse, error)
  • func (h *HttpClient) Head(url string, opts ...any) (*MiniResponse, error)
  • func (h *HttpClient) Options(url string, opts ...any) (*MiniResponse, error)
  • func (h *HttpClient) Patch(url string, opts ...any) (*MiniResponse, error)
  • func (h *HttpClient) Post(url string, opts ...any) (*MiniResponse, error)
  • func (h *HttpClient) Put(url string, opts ...any) (*MiniResponse, error)
  • func (h *HttpClient) Request(url string, opts ...any) (*MiniResponse, error)
  • func (h *HttpClient) SetAutoRedirectDisable(t bool)
  • func (h *HttpClient) SetInsecure(t bool)
  • func (h *HttpClient) SetProxy(addr string)
  • func (h *HttpClient) SetTimeout(t int)
  • func (h *HttpClient) Trace(url string, opts ...any) (*MiniResponse, error)
• type JSONData
• type MiniResponse
  • func (res *MiniResponse) RawData() ([]byte, error)
  • func (res *MiniResponse) RawJSON() (any, error)
  • func (res *MiniResponse) RawNumJSON() (any, error)
• type Params

Constants

const DefaultUA = "MiniRequest/" + DefaultVer

DefaultUA Default User-Agent

const DefaultVer = "2.0.0"

DefaultVer Library version

Types

type Auth

type Auth []string

Auth Set HTTP Basic Auth

type Cookies

type Cookies []*http.Cookie

Cookies Set Cookies

type FormData

type FormData struct {
	Values map[string]string
	Files  map[string]string
}

FormData Use multipart/form-data

type FormKV

type FormKV map[string]string

FormData Use application/x-www-from-urlencoded

type Headers

type Headers map[string]string

Headers Set Header

type HttpClient

type HttpClient struct {
	Method              string // Request Method
	AutoRedirectDisable bool   // automatic redirection
	Socks5Address       string // socks5 proxy addr
	Insecure            bool   // allow insecure request
	Timeout             int    // request timeout
}

func NewClient

func NewClient() *HttpClient

func (*HttpClient) Connect

func (h *HttpClient) Connect(url string, opts ...any) (*MiniResponse, error)

func (*HttpClient) Delete

func (h *HttpClient) Delete(url string, opts ...any) (*MiniResponse, error)

func (*HttpClient) Get

func (h *HttpClient) Get(url string, opts ...any) (*MiniResponse, error)

func (*HttpClient) Head

func (h *HttpClient) Head(url string, opts ...any) (*MiniResponse, error)

func (*HttpClient) Options

func (h *HttpClient) Options(url string, opts ...any) (*MiniResponse, error)

func (*HttpClient) Patch

func (h *HttpClient) Patch(url string, opts ...any) (*MiniResponse, error)

func (*HttpClient) Post

func (h *HttpClient) Post(url string, opts ...any) (*MiniResponse, error)

func (*HttpClient) Put

func (h *HttpClient) Put(url string, opts ...any) (*MiniResponse, error)

func (*HttpClient) Request

func (h *HttpClient) Request(url string, opts ...any) (*MiniResponse, error)

Request Universal client

func (*HttpClient) SetAutoRedirectDisable

func (h *HttpClient) SetAutoRedirectDisable(t bool)

SetAutoRedirectDisable Disable Redirect

func (*HttpClient) SetInsecure

func (h *HttpClient) SetInsecure(t bool)

SetInsecure Allow Insecure

func (*HttpClient) SetProxy

func (h *HttpClient) SetProxy(addr string)

SetProxy Set socks5 proxy

func (*HttpClient) SetTimeout

func (h *HttpClient) SetTimeout(t int)

SetTimeout Set timeout

func (*HttpClient) Trace

func (h *HttpClient) Trace(url string, opts ...any) (*MiniResponse, error)

type JSONData

type JSONData map[string]any

JSONData Use application/json

type MiniResponse

type MiniResponse struct {
	Request  *http.Request
	Response *http.Response
}

func (*MiniResponse) RawData

func (res *MiniResponse) RawData() ([]byte, error)

RawData bytes data

func (*MiniResponse) RawJSON

func (res *MiniResponse) RawJSON() (any, error)

RawJSON JSON data

func (*MiniResponse) RawNumJSON

func (res *MiniResponse) RawNumJSON() (any, error)

RawNumJSON JSON data with real number

type Params

type Params map[string]string

Params Set Params