README
¶
tgun
a http and tcp client with common options
- Use Proxy (http, socks4, socks5, tor)
- Use custom UserAgent (even during redirects)
- Set headers
- Use simple authentication
- Custom timeout
// set headers if necessary
headers := map[string]string{
"API_KEY": "12345"
"API_SECRET": "12345"
}
// set user agent and proxy in the initialization
dialer := tgun.Client{
Proxy: "socks5://localhost:1080",
UserAgent: "MyCrawler/0.1 (https://github.com/user/repo)",
Headers: headers,
}
// get bytes
b, err := dialer.GetBytes("https://example.org")
See tgun_test.go for more examples.
c usage
harness tgun in your c application!
first make in plugin directory, creating tgun.a tgun.so tgun.h and an example tgun curl-like application.
#include <tgun.h>
int main(){
// set user-agent
easy_ua("libtgun/1.0");
// set proxy url, or alias 'tor' (9050 or 9150 depending on platform) or 'socks' (127.0.0.1:1080)
easy_proxy("tor");
char* b = get_url("http://example.org");
// if any errors, NULL is returned and an error is waiting
if (!b) {
fprintf(stderr, "error: %s\n", tgunerr());
} else {
// normal string, do something with it, then free().
printf("%s", b);
free(b);
}
}
see plugin directory for c usage example
Documentation
¶
Overview ¶
Package tgun provides a TCP/http(s) client with common options
Index ¶
- Variables
- func Join(s ...string) string
- type Client
- func (c *Client) Dial(network string, addr string) (net.Conn, error)
- func (c *Client) DialTCP(addr string) (net.Conn, error)
- func (c *Client) Do(req *http.Request) (*http.Response, error)
- func (c *Client) Get(url string) (*http.Response, error)
- func (c *Client) GetBytes(url string) ([]byte, error)
- func (c Client) HTTPClient() (*http.Client, error)
- func (c *Client) Join(s ...string) string
- func (c *Client) Unmarshal(url string, ptr interface{}) error
- func (c *Client) UnmarshalPost(url string, ptr interface{}, body io.Reader) error
Constants ¶
This section is empty.
Variables ¶
var DefaultProxy = "socks5://127.0.0.1:1080"
DefaultProxy is used when c.Proxy is "1080" or "socks" or "proxy" or "true" or "1"
var DefaultTimeout = time.Second * 30
DefaultTimeout is used if c.Timeout is not set
var DefaultTor = func() string { if runtime.GOOS == "windows" { return "socks5://127.0.0.1:9150" } return "socks5://127.0.0.1:9050" }()
DefaultTor proxy is used when c.Proxy is set to "tor"
var DefaultUserAgent = fmt.Sprintf("tgun/%s", version)
DefaultUserAgent is used when c.UserAgent is empty
Functions ¶
Types ¶
type Client ¶
type Client struct {
DirectConnect bool // Set to true to bypass proxy
Proxy string // In the format: socks5://localhost:1080
UserAgent string // In the format: "MyThing/0.1" or "MyThing/0.1 (http://example.org)"
Timeout time.Duration // If unset, DefaultTimeout is used.
AuthUser string
AuthPassword string
Headers map[string]string
// contains filtered or unexported fields
}
Client holds connection options
func (*Client) Do ¶
Do returns an http response. The request's config is *fortified* with http.Client, proxy, headers, authentication, and user agent.
func (Client) HTTPClient ¶
HTTPClient returns a http.Client with proxy (but no headers, auth, user-agent)
Source Files
Directories