requests

package module
v1.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 15, 2023 License: Apache-2.0 Imports: 17 Imported by: 3

README

license

requests

Requests is an HTTP library , it is easy to use. Similar to Python requests.

Installation

go get -u github.com/sjqzhang/requests

Start

package main

import "github.com/sjqzhang/requests"

func main (){

        resp,err := requests.Get("http://www.zhanluejia.net.cn")
        if err != nil{
          return
        }
        println(resp.Text())
}

Post

package main

import "github.com/sjqzhang/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...

{
  "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

package main

import "github.com/sjqzhang/requests"


func main (){

        jsonStr := "{\"name\":\"requests_post_test\"}"
        resp,_ := requests.PostJson("https://www.httpbin.org/post",jsonStr)
        println(resp.Text())
}


 Server return data...

{
  "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
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
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
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

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.

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

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

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

Constants

This section is empty.

Variables

View Source 
var Debug bool = false
View Source 
var VERSION string = "0.8"

Functions

func NewRecorder added in v1.0.1 

func NewRecorder() *httptest.ResponseRecorder

func NewRequestForTest added in v1.0.1 

func NewRequestForTest(method, origurl string, args ...interface{}) (*http.Request, error)

func RegisterCallback added in v1.0.7 

func RegisterCallback(callbacks ...Callback)

func SetLogger added in v1.0.7 

func SetLogger(log io.Writer)

Types

type Auth 

type Auth []string

{username,password}

type Callback added in v1.0.7 

type Callback func(ctx context.Context, req *http.Request, resp *http.Response, err error)

type Datas 

type Datas map[string]string // for post form

type Files 

type Files map[string]string // name ,filename

type Header map[string]string

type Params 

type Params map[string]string

type Request 

type Request struct {
	HttpRequest *http.Request
	Header      *http.Header
	Client      *http.Client
	Debug       bool
	Cookies     []*http.Cookie
	Logger      io.Writer
	Settings    Settings
	Callbacks   []Callback
}

func Requests 

func Requests() *Request

func (*Request) ClearCookies 

func (req *Request) ClearCookies()

func (*Request) ClientSetCookies 

func (req *Request) ClientSetCookies()

func (*Request) Close 

func (req *Request) Close()

func (*Request) Delete added in v1.0.5 

func (req *Request) Delete(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) Do added in v1.0.5 

func (req *Request) Do(method string, origurl string, args ...interface{}) (*Response, error)

func (*Request) Get 

func (req *Request) Get(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) GetJson added in v1.1.0 

func (req *Request) GetJson(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) Head added in v1.0.5 

func (req *Request) Head(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) Options added in v1.0.5 

func (req *Request) Options(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) Patch added in v1.0.5 

func (req *Request) Patch(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) Post 

func (req *Request) Post(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) PostJson 

func (req *Request) PostJson(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) Proxy 

func (req *Request) Proxy(proxyurl string)

func (*Request) Put added in v1.0.5 

func (req *Request) Put(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) PutJson added in v1.0.5 

func (req *Request) PutJson(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) RegisterCallback added in v1.0.7 

func (req *Request) RegisterCallback(callbacks ...Callback)

func (*Request) RequestDebug 

func (req *Request) RequestDebug()

func (*Request) SetCookie 

func (req *Request) SetCookie(cookie *http.Cookie)

cookies cookies only save to Client.Jar req.Cookies is temporary

func (*Request) SetTimeout 

func (req *Request) SetTimeout(n time.Duration)

set timeout s = second

func (*Request) Trace added in v1.0.5 

func (req *Request) Trace(origurl string, args ...interface{}) (resp *Response, err error)

func (*Request) WithContext added in v1.0.7 

func (req *Request) WithContext(ctx context.Context) *Request

type Response 

type Response struct {
	R *http.Response
	// contains filtered or unexported fields
}

func Delete added in v1.0.6 

func Delete(origurl string, args ...interface{}) (resp *Response, err error)

func Get 

func Get(origurl string, args ...interface{}) (resp *Response, err error)

func GetJson added in v1.1.0 

func GetJson(origurl string, args ...interface{}) (resp *Response, err error)
func Head(origurl string, args ...interface{}) (resp *Response, err error)

func Options added in v1.0.6 

func Options(origurl string, args ...interface{}) (resp *Response, err error)

func Patch added in v1.0.6 

func Patch(origurl string, args ...interface{}) (resp *Response, err error)

func Post 

func Post(origurl string, args ...interface{}) (resp *Response, err error)

*************post************************ call req.Post ,only for easy

func PostJson 

func PostJson(origurl string, args ...interface{}) (resp *Response, err error)

func Put added in v1.0.6 

func Put(origurl string, args ...interface{}) (resp *Response, err error)

func PutJson added in v1.0.6 

func PutJson(origurl string, args ...interface{}) (resp *Response, err error)

func Trace added in v1.0.6 

func Trace(origurl string, args ...interface{}) (resp *Response, err error)

func (*Response) Content 

func (resp *Response) Content() []byte

func (*Response) Cookies 

func (resp *Response) Cookies() (cookies []*http.Cookie)

func (*Response) Json 

func (resp *Response) Json(v interface{}) error

func (*Response) JsonPretty added in v1.0.6 

func (resp *Response) JsonPretty() (string, error)

func (*Response) JsonToMap added in v1.0.5 

func (resp *Response) JsonToMap() (map[string]interface{}, error)

func (*Response) PrintToConsole added in v1.0.6 

func (resp *Response) PrintToConsole()

func (*Response) ResponseDebug 

func (resp *Response) ResponseDebug()

************

func (*Response) SaveFile 

func (resp *Response) SaveFile(filename string) error

func (*Response) Text 

func (resp *Response) Text() string

type Settings added in v1.0.7 

type Settings struct {
	Debug     bool
	Callbacks []Callback
}

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.