Merge pull request #757 from smallfish/develop

Add new function SetBasicAuth, and update README

@@ -6,53 +6,71 @@ httplib is an libs help you to curl remote url.
 ## GET
 ## GET
 you can use Get to crawl data.
 you can use Get to crawl data.
 
 
-	import "httplib"
+	import "github.com/astaxie/beego/httplib"
 	
 	
 	str, err := httplib.Get("http://beego.me/").String()
 	str, err := httplib.Get("http://beego.me/").String()
 	if err != nil {
 	if err != nil {
-		t.Fatal(err)
+        	// error
 	}
 	}
 	fmt.Println(str)
 	fmt.Println(str)
 	
 	
 ## POST
 ## POST
 POST data to remote url
 POST data to remote url
 
 
-	b:=httplib.Post("http://beego.me/")
-	b.Param("username","astaxie")
-	b.Param("password","123456")
-	str, err := b.String()
+	req := httplib.Post("http://beego.me/")
+	req.Param("username","astaxie")
+	req.Param("password","123456")
+	str, err := req.String()
 	if err != nil {
 	if err != nil {
-		t.Fatal(err)
+        	// error
 	}
 	}
 	fmt.Println(str)
 	fmt.Println(str)
 
 
-## set timeout
-you can set timeout in request.default is 60 seconds.
+## Set timeout
 
 
-set Get timeout:
+The default timeout is `60` seconds, function prototype:
 
 
+	SetTimeout(connectTimeout, readWriteTimeout time.Duration)
+
+Exmaple:
+
+	// GET
 	httplib.Get("http://beego.me/").SetTimeout(100 * time.Second, 30 * time.Second)
 	httplib.Get("http://beego.me/").SetTimeout(100 * time.Second, 30 * time.Second)
 	
 	
-set post timeout:	
-	
+	// POST
 	httplib.Post("http://beego.me/").SetTimeout(100 * time.Second, 30 * time.Second)
 	httplib.Post("http://beego.me/").SetTimeout(100 * time.Second, 30 * time.Second)
 
 
-- first param is connectTimeout.
-- second param is readWriteTimeout
 
 
-## debug
-if you want to debug the request info, set the debug on
+## Debug
+
+If you want to debug the request info, set the debug on
 
 
 	httplib.Get("http://beego.me/").Debug(true)
 	httplib.Get("http://beego.me/").Debug(true)
 	
 	
-## support HTTPS client
-if request url is https. You can set the client support TSL:
+## Set HTTP Basic Auth
+
+	str, err := Get("http://beego.me/").SetBasicAuth("user", "passwd").String()
+	if err != nil {
+        	// error
+	}
+	fmt.Println(str)
+	
+## Set HTTPS
+
+If request url is https, You can set the client support TSL:
 
 
 	httplib.SetTLSClientConfig(&tls.Config{InsecureSkipVerify: true})
 	httplib.SetTLSClientConfig(&tls.Config{InsecureSkipVerify: true})
 	
 	
-more info about the tls.Config please visit http://golang.org/pkg/crypto/tls/#Config	
-		
-## set cookie
+More info about the `tls.Config` please visit http://golang.org/pkg/crypto/tls/#Config	
+
+## Set HTTP Version
+
+some servers need to specify the protocol version of HTTP
+
+	httplib.Get("http://beego.me/").SetProtocolVersion("HTTP/1.1")
+	
+## Set Cookie
+
 some http request need setcookie. So set it like this:
 some http request need setcookie. So set it like this:
 
 
 	cookie := &http.Cookie{}
 	cookie := &http.Cookie{}
@@ -60,21 +78,20 @@ some http request need setcookie. So set it like this:
 	cookie.Value  = "astaxie"
 	cookie.Value  = "astaxie"
 	httplib.Get("http://beego.me/").SetCookie(cookie)
 	httplib.Get("http://beego.me/").SetCookie(cookie)
 
 
-## upload file
-httplib support mutil file upload, use `b.PostFile()`
+## Upload file
+
+httplib support mutil file upload, use `req.PostFile()`
 
 
-	b:=httplib.Post("http://beego.me/")
-	b.Param("username","astaxie")
-	b.Param("password","123456")
-	b.PostFile("uploadfile1", "httplib.pdf")
-	b.PostFile("uploadfile2", "httplib.txt")
-	str, err := b.String()
+	req := httplib.Post("http://beego.me/")
+	req.Param("username","astaxie")
+	req.PostFile("uploadfile1", "httplib.pdf")
+	str, err := req.String()
 	if err != nil {
 	if err != nil {
-		t.Fatal(err)
+        	// error
 	}
 	}
 	fmt.Println(str)
 	fmt.Println(str)
 
 
-## set HTTP version
-some servers need to specify the protocol version of HTTP
 
 
-	httplib.Get("http://beego.me/").SetProtocolVersion("HTTP/1.1")
\ No newline at end of file
+See godoc for further documentation and examples.
+
+* [godoc.org/github.com/astaxie/beego/httplib](https://godoc.org/github.com/astaxie/beego/httplib)

@@ -147,6 +147,12 @@ func (b *BeegoHttpRequest) Setting(setting BeegoHttpSettings) *BeegoHttpRequest
 	return b
 	return b
 }
 }
 
 
+// SetBasicAuth sets the request's Authorization header to use HTTP Basic Authentication with the provided username and password.
+func (b *BeegoHttpRequest) SetBasicAuth(username, password string) *BeegoHttpRequest {
+	b.req.SetBasicAuth(username, password)
+	return b
+}
+
 // SetEnableCookie sets enable/disable cookiejar
 // SetEnableCookie sets enable/disable cookiejar
 func (b *BeegoHttpRequest) SetEnableCookie(enable bool) *BeegoHttpRequest {
 func (b *BeegoHttpRequest) SetEnableCookie(enable bool) *BeegoHttpRequest {
 	b.setting.EnableCookie = enable
 	b.setting.EnableCookie = enable

@@ -120,6 +120,18 @@ func TestWithCookie(t *testing.T) {
 	}
 	}
 }
 }
 
 
+func TestWithBasicAuth(t *testing.T) {
+	str, err := Get("http://httpbin.org/basic-auth/user/passwd").SetBasicAuth("user", "passwd").String()
+	if err != nil {
+		t.Fatal(err)
+	}
+	t.Log(str)
+	n := strings.Index(str, "authenticated")
+	if n == -1 {
+		t.Fatal("authenticated not found in response")
+	}
+}
+
 func TestWithUserAgent(t *testing.T) {
 func TestWithUserAgent(t *testing.T) {
 	v := "beego"
 	v := "beego"
 	str, err := Get("http://httpbin.org/headers").SetUserAgent(v).String()
 	str, err := Get("http://httpbin.org/headers").SetUserAgent(v).String()