https://github.com/telanflow/quick
HTTP Request library for Go (简洁高效的HTTP请求库)
https://github.com/telanflow/quick
basic-authentication cookies easy go http http-request middleware quick request requests session spider
Last synced: 6 months ago
JSON representation
HTTP Request library for Go (简洁高效的HTTP请求库)
- Host: GitHub
- URL: https://github.com/telanflow/quick
- Owner: telanflow
- License: mit
- Created: 2020-02-07T14:44:27.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-10-11T22:08:42.000Z (about 2 years ago)
- Last Synced: 2025-04-01T18:50:14.850Z (7 months ago)
- Topics: basic-authentication, cookies, easy, go, http, http-request, middleware, quick, request, requests, session, spider
- Language: Go
- Homepage:
- Size: 51.8 KB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Quick
## 📖 Introduction
[](https://godoc.org/github.com/telanflow/quick)
[](https://github.com/telanflow/quick/LICENSE)
Simple and efficient HTTP request library
Go开发的简单高效Http请求中间件
## 🚀 Feature
- 支持GET, POST, PUT, DELETE, HEAD, PATCH, OPTIONS 请求
- 支持请求的链式调用
- Request Body支持 string, []byte, struct, map, slice， io.Reader等类型
- 兼容Go原生Http.Request请求
- Response 对象支持请求Trace追踪，内置JSON、XML格式解析
- 支持Request URL 路径参数、代理设置、Context、BasicAuth
- 支持设置自定义根证书、客户端证书
- 支持CookieJar持久化
- Client支持细粒度超时控制，重定向控制，高并发控制
- 支持自定义Logger接口
## 🛠 Examples
```go
package main
import (
"fmt"
"github.com/telanflow/quick"
"net/http"
)
func main() {
// quick.Post("example.com")
// quick.PostFormData("example.com")
// quick.Put("example.com")
// quick.Head("example.com")
// quick.Delete("example.com")
// quick.Patch("example.com")
// quick.Options("example.com")
// quick.Trace("example.com")
// https ssl skip verify 取消https验证
quick.InsecureSkipVerify(true)
// set header
quick.SetHeader(http.Header{
"Context-Type": []string{"text/html"},
})
// set UserAgent to request
quick.SetHeaderSingle("User-Agent", "A go request libraries for quick")
quick.SetUserAgent("A go request libraries for quick")
// You should init it by using NewCookiesWithString like this:
// cookies := quick.NewCookiesWithString(
// "key1=value1; key2=value2; key3=value3"
// )
// Note: param is cookie string
cookies := quick.NewCookiesWithString("sessionid=11111")
// request
resp, err := quick.Get(
"http://example.com?bb=1",
quick.OptionQueryString("name=quick&aa=11"), // set Get params eg. "example.com?bb=1&name=quick&aa=11"
quick.OptionHeaderSingle("User-Agent", ""), // set http header
quick.OptionHeader(http.Header{}), // set http header eg. http.Header || map[string]string || []string
quick.OptionRedirectNum(10), // set redirect num
quick.OptionCookies(cookies), // set cookies to request
// quick.OptionProxy("http://127.0.0.1:8080"), // set proxy address
// quick.OptionBody(""), // POST body
// quick.OptionBasicAuth("username", "password"), // HTTP Basic Authentication
// ... quick.Option
)
if err != nil {
panic(err)
}
fmt.Println(resp)
}
```
### ♻️ Session
Request based session
所有Request都基于session（http.Client）
```go
func main() {
// cookieJar
cookieJar, err := quick.NewCookieJar()
if err != nil {
panic(err)
}
// quick use default global session
// create session
session := quick.NewSession()
// https ssl skip verify 取消https验证
session.InsecureSkipVerify(true)
// set cookieJar
session.SetCookieJar(cookieJar)
resp, err := session.Get("http://example.com")
if err != nil {
panic(err)
}
//resp.Status e.g. "200 OK"
//resp.StatusCode e.g. 200
//...
fmt.Println(resp)
}
```
Other example:
```go
func main() {
// new Request
req := quick.NewRequest().SetUrl("http://example.com").SetMethod(http.MethodGet)
// send Request
session := quick.NewSession()
session.EnableTrace() // trace
resp, err := session.Suck(
req,
quick.OptionHeaderSingle("User-Agent", ""), // set http header
// ... quick.Option
)
if err != nil {
panic(err)
}
// resp.Status e.g. "200 OK"
// resp.StatusCode e.g. 200
// ...
//
// TraceInfo:
// DNSLookup: 4ms
// ConnTime: 1230ms
// TCPConnTime: 405ms
// TLSHandshake: 819ms
// ServerTime: 299ms
fmt.Println(resp)
fmt.Println(resp.TraceInfo())
}
```
## 🧬 Middleware（中间件）
```go
func main() {
// new Request
req := quick.NewRequest().SetUrl("http://example.com").SetMethod(http.MethodGet)
// create session
session := quick.NewSession()
// use middleware
session.Use(
// middleware 1
func(r *http.Request) {
log.Printf(
"Middleware: %v RedirectNum: %v Proxy: %v \n",
r.URL,
r.Context().Value(quick.ContextRedirectNumKey),
r.Context().Value(quick.ContextProxyKey),
)
},
// middleware 2
func(r *http.Request) {
log.Printf(
"Middleware2: %v RedirectNum: %v Proxy: %v \n",
r.URL,
r.Context().Value(quick.ContextRedirectNumKey),
r.Context().Value(quick.ContextProxyKey),
)
},
)
// send Request
resp, err := session.Suck(
req,
quick.OptionHeaderSingle("User-Agent", ""), // set http header
// ... quick.Option
)
if err != nil {
panic(err)
}
//resp.Status e.g. "200 OK"
//resp.StatusCode e.g. 200
//...
fmt.Println(resp)
}
```
## 📄 License
Source code in `QUICK` is available under the [MIT License](/LICENSE).