Added custom HTTP client capability

Signed-off-by: Levi Gross <[email protected]>

Author: levigross

base.go

@@ -1,5 +1,5 @@
 // Package grequests implements a friendly API over Go's existing net/http library
-package grequests // import "github.com/levigross/grequests"
+package grequests
 
 // Get takes 2 parameters and returns a Response Struct. These two options are:
 // 	1. A URL

base_get_test.go

@@ -98,6 +98,12 @@ func TestGetNoOptions(t *testing.T) {
 	verifyOkResponse(resp, t)
 }
 
+func TestGetNoOptionsCustomClient(t *testing.T) {
+	resp, _ := Get("http://httpbin.org/get",
+		&RequestOptions{HTTPClient: http.DefaultClient})
+	verifyOkResponse(resp, t)
+}
+
 func TestGetCustomTLSHandshakeTimeout(t *testing.T) {
 	ro := &RequestOptions{TLSHandshakeTimeout: 10 * time.Millisecond}
 	if _, err := Get("https://httpbin.org", ro); err == nil {

example_test.go

@@ -25,6 +25,21 @@ func Example_basicGet() {
 	log.Println(resp.String())
 }
 
+func Example_basicGetCustomHTTPClient() {
+	// This is a very basic GET request
+	resp, err := grequests.Get("http://httpbin.org/get", &grequests.RequestOptions{HTTPClient: http.DefaultClient})
+
+	if err != nil {
+		log.Println(err)
+	}
+
+	if resp.Ok != true {
+		log.Println("Request did not return OK")
+	}
+
+	log.Println(resp.String())
+}
+
 func Example_proxy() {
 	proxyURL, err := url.Parse("http://127.0.0.1:8080") // Proxy URL
 	if err != nil {

request.go

@@ -91,6 +91,10 @@ type RequestOptions struct {
 	// KeepAlive specifies the keep-alive period for an active
 	// network connection. If zero, keep-alive are not enabled.
 	DialKeepAlive time.Duration
+
+	// HTTPClient can be provided if you wish to supply a custom HTTP client
+	// this is useful if you want to use an OAUTH client with your request
+	HTTPClient *http.Client
 }
 
 func doRegularRequest(requestVerb, url string, ro *RequestOptions) (*Response, error) {
@@ -322,6 +326,11 @@ func (ro RequestOptions) DontUseDefaultClient() bool {
 // BuildHTTPClient is a function that will return a custom HTTP client based on the request options provided
 // the check is in UseDefaultClient
 func BuildHTTPClient(ro RequestOptions) *http.Client {
+
+	if ro.HTTPClient != nil {
+		return ro.HTTPClient
+	}
+
 	// Does the user want to change the defaults?
 	if !ro.DontUseDefaultClient() {
 		return http.DefaultClient