rs

RS | 网络请求使用库

让 golang 更简单的发起 http 请求

链式的请求规则

Convenient http client for go.

HOW TO USE | 怎么用

go get github.com/Jecced/rs

Usage | 用法

Simple Case | 简单案例

一个简单的http请求示例, 示例执行http请求, 并将响应读取为字符串

One simple http request example that do http get request and read response as string:

resp := rs.Get("http://www.baidu.com/").
            Send().
            ReadText()
fmt.Println(resp)

WriteToFile | 写入到文件

将响应请求保存到本地文件中, 例如保存一个图片

Save the response request to a local file, such as an image

rs.Get("http://www.baidu.com/img/sug_bd.png?v=09816787.png").
		Send().
		SetTimeOut(30_000).
		WriteToFile("/Users/ankang/develop/test/1.png")

Parameters | 设置请求参数

Pass parameters in urls using params method:

resp := rs.Get(url).
            AddParam("key1", "value1").
            AddParam("key2", "value2").
            AddParam("key3", "value3").
            Send().
            ReadText()
fmt.Println(resp)

OR

resp := rs.Get(url).
            AddParams(map[string]string{
                "key1": "value1",
                "key2": "value2",
                "key3": "value3",
            }).
            Send().
            ReadText()
fmt.Println(resp)

Set Headers | 设置请求头

Http request headers can be set by headers method:

resp := rs.Get(url).
            AddHeader("key1", "value1").
            AddHeader("key2", "value2").
            AddHeader("key3", "value3").
            Send().
            ReadText()
fmt.Println(resp)

OR

resp := rs.Get(url).
            AddHeaders(map[string]string{
                "key1": "value1",
                "key2": "value2",
                "key3": "value3",
            }).
            Send().
            ReadText()
fmt.Println(resp)

Timeout | 设置超时时间

你可以设置连接超时时间, 和响应请求的超时时间

You can set connection connect timeout, and socket read/write timeout value

rs.Get(url).
    SetConnTimeOut(30_000).
    SetRespTimeOut(30_000).
    Send().
    ReadText()

你也可以同时修改他们

You can also change their values at the same time

rs.Get(url).
    SetTimeOut(30_000).
    Send().
    ReadText()

Proxy | 代理

通过代理方法设置代理

Set proxy by proxy method

resp := rs.Get("http://www.google.com").
            Proxy("127.0.0.1:1081").
            Send().
            ReadText()
fmt.Println(resp)

BasicAuth | 基础认证

resp := rs.Get(url).
    BasicAuth(user_name, password).
    Send().
    ReadText()
fmt.Println(resp)

Cookie | Cookie

resp := rs.Get(url).
    AddCookie("key1", "value1").
    AddCookies(map[string]string{
        "key2", "value2",
        "key3", "value3",
        "key4", "value4",
    }).
    Send().
    ReadText()
fmt.Println(resp)

Session | Session

会话为您维护cookie，在需要登录或其他情况时很有用。会话的用法与请求相同。

Session maintains cookies, useful when need login or other situations. Session have the same usage as Requests.

s := rs.Session()
get := s.Get(url1).Send().ReadText()
post := s.Post(url2).Send().ReadText()
fmt.Println(get)
fmt.Println(post)

Session.BaseAuth | 基于 Session 的 基础认证

所有由session发起的请求都会用这个基础认证信息

add session method new func

session := rs.Session()
session.BasicAuth("user", "password")
session.Get(url).Send().ReadText()

Session.Proxy | 基于 session 的代理

所有由session发起的请求都会用这个代理信息

add session method new func to use proxy

session := rs.Session().Proxy("127.0.0.1:1081")
session.Get(url1).Send().ReadText()
session.Get(url2).Send().ReadText()

Session.Header | 基于 session 的请求头

所有由session发起的请求都会用这些请求头

add session method new func to use header

session := rs.Session().
    AddHeader("header1", "value1").
    AddHeader("header2", "value2").
    AddHeaders(map[string]string{
        "key1": "value1",
        "key2": "value2",
        "key3": "value3",
    })
session.Get(url1).Send().ReadText()
session.Get(url2).Send().ReadText()

LICENSE

MIT License

Copyright (c) 2020 Jecced

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.