Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/asmcos/requests
A golang HTTP client library. Salute to python requests.
https://github.com/asmcos/requests
Last synced: 3 days ago
JSON representation
A golang HTTP client library. Salute to python requests.
- Host: GitHub
- URL: https://github.com/asmcos/requests
- Owner: asmcos
- License: other
- Created: 2018-08-27T03:34:39.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-07-04T07:13:01.000Z (5 months ago)
- Last Synced: 2024-08-04T01:14:01.069Z (3 months ago)
- Language: Go
- Size: 43.9 KB
- Stars: 665
- Watchers: 19
- Forks: 92
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-http - requests - activity/y/asmcos/requests) (Programming Languages / Go)
README
[](https://raw.githubusercontent.com/asmcos/requests/master/LICENSE)
# requests
Requests is an HTTP library , it is easy to use. Similar to Python requests.
# Installation
```
go get -u github.com/asmcos/requests
```
# Start
``` go
package main
import "github.com/asmcos/requests"
func main (){
resp,err := requests.Get("http://www.zhanluejia.net.cn")
if err != nil{
return
}
println(resp.Text())
}
```
## Post
``` go
package main
import "github.com/asmcos/requests"
func main (){
data := requests.Datas{
"name":"requests_post_test",
}
resp,_ := requests.Post("https://www.httpbin.org/post",data)
println(resp.Text())
}
```
Server return data...
``` json
{
"args": {},
"data": "",
"files": {},
"form": {
"name": "requests_post_test"
},
"headers": {
"Accept-Encoding": "gzip",
"Connection": "close",
"Content-Length": "23",
"Content-Type": "application/x-www-form-urlencoded",
"Host": "www.httpbin.org",
"User-Agent": "Go-Requests 0.5"
},
"json": null,
"origin": "114.242.34.110",
"url": "https://www.httpbin.org/post"
}
```
## PostJson
``` go
package main
import "github.com/asmcos/requests"
func main (){
jsonStr := "{\"name\":\"requests_post_test\"}"
resp,_ := requests.PostJson("https://www.httpbin.org/post",jsonStr)
println(resp.Text())
}
```
Server return data...
``` json
{
"args": {},
"data": "",
"files": {},
"form": {
"name": "requests_post_test"
},
"headers": {
"Accept-Encoding": "gzip",
"Connection": "close",
"Content-Length": "23",
"Content-Type": "application/x-www-form-urlencoded",
"Host": "www.httpbin.org",
"User-Agent": "Go-Requests 0.5"
},
"json": null,
"origin": "114.242.34.110",
"url": "https://www.httpbin.org/post"
}
```
# Feature Support
- Set headers
- Set params
- Multipart File Uploads
- Sessions with Cookie Persistence
- Proxy
- Authentication
- JSON
- Chunked Requests
- Debug
- SetTimeout
# Set header
### example 1
``` go
req := requests.Requests()
resp,err := req.Get("http://www.zhanluejia.net.cn",requests.Header{"Referer":"http://www.jeapedu.com"})
if (err == nil){
println(resp.Text())
}
```
### example 2
``` go
req := requests.Requests()
req.Header.Set("accept-encoding", "gzip, deflate, br")
resp,_ := req.Get("http://www.zhanluejia.net.cn",requests.Header{"Referer":"http://www.jeapedu.com"})
println(resp.Text())
```
### example 3
``` go
h := requests.Header{
"Referer": "http://www.jeapedu.com",
"Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
}
resp,_ := req.Get("http://wwww.zhanluejia.net.cn",h)
h2 := requests.Header{
...
...
}
h3,h4 ....
// two or more headers ...
resp,_ = req.Get("http://www.zhanluejia.net.cn",h,h2,h3,h4)
```
# Set params
``` go
p := requests.Params{
"title": "The blog",
"name": "file",
"id": "12345",
}
resp,_ := req.Get("http://www.cpython.org", p)
```
# Auth
Test with the `correct` user information.
``` go
req := requests.Requests()
resp,_ := req.Get("https://api.github.com/user",requests.Auth{"asmcos","password...."})
println(resp.Text())
```
github return
```
{"login":"asmcos","id":xxxxx,"node_id":"Mxxxxxxxxx==".....
```
# JSON
``` go
req := requests.Requests()
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 := Requests()
req.Debug = 1
// 20 Second
req.SetTimeout(20)
req.Get("http://golang.org")
```
# Get Cookies
``` go
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)
}
```