README
¶
HTTP咩
A next generation HTTP client for Golang. Like Python httpx/requests.
次时代Golang HTTP客户端
因为Go上没有像Python中httpx或是requests那样完美好用的HTTP客户端，并且目前现有的多个名为requests都有一些跨平台等的兼容性问题不好处理，并且已经多年未维护（可能已经停止维护），迫不得已来造轮子（因为我也要用的），实现类似Python库httpx简单易用的特性
可以向下兼容github.com/asmcos/requests方便升級，为了避免产生混淆，库名为httpme既http咩（罗马音），就不叫requests混入其中了
可以在Issues提出需求，会尽可能的实现
Installation 安装
go get -u github.com/zanjie1999/httpme
Use 使用
Get
package main
import (
"fmt"
"github.com/zanjie1999/httpme"
)
func main (){
resp,err := httpme.Get("http://google.cn")
if err != nil{
return
}
// raw Body
fmt.println(resp.Content())
// string
fmt.println(resp.Text())
// save to file
resp.SaveFile("file.html")
}
Post
package main
import (
"fmt"
"github.com/zanjie1999/httpme"
)
func main (){
data := httpme.Datas{
"name":"httpme_post_test",
}
resp,_ := httpme.Post("https://www.httpbin.org/post",data)
// raw Body
fmt.println(resp.Content())
// string
fmt.println(resp.Text())
}
Server return data...
{
"args": {},
"data": "",
"files": {},
"form": {
"name": "httpme_post_test"
},
"headers": {
"Accept-Encoding": "gzip",
"Connection": "close",
"Content-Length": "23",
"Content-Type": "application/x-www-form-urlencoded",
"Host": "www.httpbin.org",
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36"
},
"json": null,
"origin": "114.242.34.110",
"url": "https://www.httpbin.org/post"
}
PostJson
package main
import "github.com/zanjie1999/httpme"
func main (){
jsonStr := "{\"name\":\"httpme_post_test\"}"
resp,_ := httpme.PostJson("https://www.httpbin.org/post",jsonStr)
println(resp.Text())
}
Server return data...
{
"args": {},
"data": "",
"files": {},
"form": {
"name": "httpme_post_test"
},
"headers": {
"Accept-Encoding": "gzip",
"Connection": "close",
"Content-Length": "23",
"Content-Type": "application/x-www-form-urlencoded",
"Host": "www.httpbin.org",
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36"
},
"json": null,
"origin": "114.242.34.110",
"url": "https://www.httpbin.org/post"
}
On Android
Android必须设置一个dns才能正常解析域名，只需要在生命周期开始前设置一次
package main
import (
"fmt"
"github.com/zanjie1999/httpme"
)
func main (){
httpme.SetDns("223.6.6.6:53")
resp,err := httpme.Get("http://google.cn")
if err != nil{
return
}
// raw Body
fmt.println(resp.Content())
// string
fmt.println(resp.Text())
// save to file
resp.SaveFile("file.html")
}
# Feature Support
- Set headers
- Set params
- Multipart File Uploads
- Sessions with Cookie Persistence
- Proxy
- Authentication
- JSON
- Chunked Httpme
- Debug
- SetTimeout
# Set header
### example 1
``` go
req := httpme.Httpme()
resp,err := req.Get("http://google.cn",httpme.Header{"Referer":"http://www.jeapedu.com"})
if (err == nil){
println(resp.Text())
}
example 2
req := httpme.Httpme()
req.Header.Set("accept-encoding", "gzip, deflate, br")
resp,_ := req.Get("http://google.cn",httpme.Header{"Referer":"http://www.jeapedu.com"})
println(resp.Text())
example 3
h := httpme.Header{
"Referer": "http://www.jeapedu.com",
"Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
}
resp,_ := req.Get("http://wgoogle.cn",h)
h2 := httpme.Header{
...
...
}
h3,h4 ....
// two or more headers ...
resp,_ = req.Get("http://google.cn",h,h2,h3,h4)
Set params
p := httpme.Params{
"title": "The blog",
"name": "file",
"id": "12345",
}
resp,_ := req.Get("http://www.cpython.org", p)
Auth
Test with the correct user information.
req := httpme.Httpme()
resp,_ := req.Get("https://api.github.com/user",httpme.Auth{"zanjie1999","password...."})
println(resp.Text())
github return
{"login":"zanjie1999","id":xxxxx,"node_id":"Mxxxxxxxxx==".....
JSON
req := httpme.Httpme()
req.Header.Set("Content-Type","application/json")
resp,_ = req.Get("https://httpbin.org/json")
var json map[string]interface{}
resp.Json(&json)
for k,v := range json{
fmt.Println(k,v)
}
SetTimeout
req := Httpme()
req.Debug = 1
// 20 Second
req.SetTimeout(20)
req.Get("http://golang.org")
Get Cookies
resp,_ = req.Get("https://www.httpbin.org")
coo := resp.Cookies()
// coo is [] *http.Cookies
println("********cookies*******")
for _, c:= range coo{
fmt.Println(c.Name,c.Value)
}
Documentation
¶
Index ¶
- Variables
- func SetDns(dnsWithPort string)
- func SetSkipVerify(skip bool)
- type Auth
- type Datas
- type Files
- type Header
- type Params
- type Request
- func (req *Request) ClearCookies()
- func (req *Request) ClientSetCookies()
- func (req *Request) Close()
- func (req *Request) Get(origurl string, args ...interface{}) (resp *Response, err error)
- func (req *Request) Post(origurl string, args ...interface{}) (resp *Response, err error)
- func (req *Request) PostJson(origurl string, args ...interface{}) (resp *Response, err error)
- func (req *Request) Proxy(proxyurl string)
- func (req *Request) RequestDebug()
- func (req *Request) SetCookie(cookie *http.Cookie)
- func (req *Request) SetTimeout(n time.Duration)
- func (req *Request) SkipVerify(skip bool) *Request
- type Response
Constants ¶
This section is empty.
Variables ¶
View Source
var VERSION string = "2.0.0"
Functions ¶
func SetSkipVerify ¶ added in v1.1.0
func SetSkipVerify(skip bool)
Global disable TLS verify for all request
Types ¶
type Request ¶
type Request struct {
Header *http.Header
Client *http.Client
Debug int
Cookies []*http.Cookie
// contains filtered or unexported fields
}
func (*Request) ClearCookies ¶
func (req *Request) ClearCookies()
func (*Request) ClientSetCookies ¶
func (req *Request) ClientSetCookies()
func (*Request) RequestDebug ¶
func (req *Request) RequestDebug()
func (*Request) SkipVerify ¶ added in v1.1.0
Disable TLS verify
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.