From ce26751a5a3ed13e9a6aa010d9a7fa767de91b8c Mon Sep 17 00:00:00 2001
From: 178inaba <178inaba@users.noreply.github.com>
Date: Thu, 28 Jan 2016 02:32:44 +0900
Subject: [PATCH 001/113] add import path to .travis.yml

---
 .travis.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.travis.yml b/.travis.yml
index 695f0b7e..e4f7e05e 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -5,6 +5,8 @@ go:
   - 1.4.2
   - tip
 
+go_import_path: github.com/gin-gonic/gin
+
 script:
   - go get golang.org/x/tools/cmd/cover
   - go get github.com/mattn/goveralls

From 781cbd19f02c42795bdc3adc2fda287d95f91500 Mon Sep 17 00:00:00 2001
From: Ammar Bandukwala <ammar@ammar.io>
Date: Mon, 8 May 2017 19:04:22 -0500
Subject: [PATCH 002/113] panic if err is nil on c.Error

A panic here provides a more informative stack trace than the panic which would otherwise occur while errors are being collected.
---
 context.go      | 4 ++++
 context_test.go | 7 +++++++
 2 files changed, 11 insertions(+)

diff --git a/context.go b/context.go
index 7b57150d..dd0dc5dc 100644
--- a/context.go
+++ b/context.go
@@ -144,7 +144,11 @@ func (c *Context) AbortWithError(code int, err error) *Error {
 // It's a good idea to call Error for each error that occurred during the resolution of a request.
 // A middleware can be used to collect all the errors
 // and push them to a database together, print a log, or append it in the HTTP response.
+// Error will panic if err is nil.
 func (c *Context) Error(err error) *Error {
+	if err == nil {
+		panic("err is nil")
+	}
 	var parsedError *Error
 	switch err.(type) {
 	case *Error:
diff --git a/context_test.go b/context_test.go
index 0feeca89..b4c1f08d 100644
--- a/context_test.go
+++ b/context_test.go
@@ -852,6 +852,13 @@ func TestContextError(t *testing.T) {
 	assert.Equal(t, c.Errors[1].Type, ErrorTypePublic)
 
 	assert.Equal(t, c.Errors.Last(), c.Errors[1])
+
+	defer func() {
+		if recover() == nil {
+			t.Error("didn't panic")
+		}
+	}()
+	c.Error(nil)
 }
 
 func TestContextTypedError(t *testing.T) {

From 0cbf0f48aaa3573141922d9dbdc57a15ea3aa626 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 11:58:19 +0200
Subject: [PATCH 003/113] docs(readme): update contribution guide

- change new prs base branch from develop to master
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 029606b7..76ec40db 100644
--- a/README.md
+++ b/README.md
@@ -963,7 +963,7 @@ func main() {
   - Please provide source code and commit sha if you found a bug.
   - Review existing issues and provide feedback or react to them.
 - With pull requests:
-  - Open your pull request against develop
+  - Open your pull request against master
   - Your pull request should have no more than two commits, if not you should squash them.
   - It should pass all tests in the available continuous integrations systems such as TravisCI.
   - You should add/modify tests to cover your proposed code changes.

From 55dd6364cbdf2a4db3c2edbabc5377a708d5d282 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 12:23:54 +0200
Subject: [PATCH 004/113] docs(readme): update to color logo

---
 README.md |   2 +-
 logo.jpg  | Bin 12200 -> 0 bytes
 logo.png  | Bin 0 -> 16831 bytes
 3 files changed, 1 insertion(+), 1 deletion(-)
 delete mode 100644 logo.jpg
 create mode 100644 logo.png

diff --git a/README.md b/README.md
index 76ec40db..e35c2f94 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Gin Web Framework
 
-<img align="right" src="https://raw.githubusercontent.com/gin-gonic/gin/master/logo.jpg">
+<img align="right" src="https://raw.githubusercontent.com/gin-gonic/gin/master/logo.png">
 
 [![Build Status](https://travis-ci.org/gin-gonic/gin.svg)](https://travis-ci.org/gin-gonic/gin)
  [![codecov](https://codecov.io/gh/gin-gonic/gin/branch/master/graph/badge.svg)](https://codecov.io/gh/gin-gonic/gin)
diff --git a/logo.jpg b/logo.jpg
deleted file mode 100644
index bb51852e49aa24ab09ff7826b1f6c3dfdc99b16f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 12200
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

diff --git a/logo.png b/logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..c58c79864852b50763c2aab9106dd9ebd2290cf9
GIT binary patch
literal 16831
zcmV(;K-<5GP)<h;3K|Lk000e1NJLTq00EEy00EE)0{{R3w_(Qq00093P)t-s0002@
z_xJSl^!@$)|NsB-@$v8P@8RL#=jP<=>+9#|=iuPr>+S90;^OJ)=>U+?0002?*&Y7=
z{x_GXC8^-_*&W!gE<K~7{QUeimZm_g+}N%xJffn(m}mtB1qlfW4Gj(R*dg%MA`uZ0
z1C7hs+1J09X!rN``}_JPCM6mh8x#~1+}zys^z_x$)fX2RJgL|&E-v8U-#k1#(b3RN
zPEJBXLLng`DJm<#z`#gINIIaUczAg7*emhz@G~<r?bI%ikdTFih0V>)mX?+-l&kI4
zHys`xyu7=(xVT_oU<{7N3mPHA!^1eBtbc!huCA`3p`lk-SLx~Li;Iiu&?CL#@(O{s
z5F{-NlhDe_%I3~4>*?KUYHHTOI}t58)2l8SkG^GPWj8lBE}6%ioSa)*TbR=9HlfT6
zkjfHwr4=_u<IO+i<I@O;!4iF~DUYb7rKLBWr03OJ^YP+4rqMK=zq7Nmsi~<45Eb6X
zGA56_Ra8^k!zk?R>=cN()6cauowFiabll8gBtJ{}`T6ed?mD8zByp6_#fMQ*QQXN*
z-r2z1(1X**a>J=Xf5+$U*hJ5;K;G7(-_ddoQE=ww<~F0!$H&Ls*t8sVoilluH*JJ*
zad96{WhO{h=F&^!$|5t3v@e&k9fYzffu_~Wln`Bi`1bA!ZJEftgC%Bz%eFG%<KxV{
zUev-=u#zSflg!G+snpG<7H5nkH9Q}d%H!b4B9OFhZf?xFN57&k8K2qk?bke_p~t|L
zf1q&a*lICOTehG*CZyNPs5R^4x#8E6FIQ<1KUCDbBQjug%cU&C=l1aG$jZKPDV@>4
zvU7-XA7D-sV7%ng(8G;(SEh|8NSV7#aeom=V8O9kQAjW;A_-QZj_%-owxd>aW*;r7
z+`G4)yR(XPWKTUb4eR5op@m<jmq%n-I909EM1!8Plxsp;W}AvHJEgh5opne*7pKI}
zzS7#?@c273Cw#xzbGgiDtHHFSfsV7okAyaSa$atxdXu7FmD8Ds0000FbW%=J07zgL
zFL;si+Nr|Ysi`koPpuRH06t$yL_t(|+U%W6NK|1IfRAO*mG_4u7cQ9h#^7YrNYi8*
zPHBccKzh1yrr}c5$`+zfNQDqBEK?dKauMi8B1}UULrR2*EkcSG)}lp0fwhSCtvdhA
zo$<cZY91Q>Uo>;)CN1Xcob#XmaRb4!#B@FOVgm@)3NeM4?F7LZ;e)~{j(I?^23WWk
zol}YlW$sM?1glK@M?{PzB82Cy2@tF*??Q+Y*3NPv#azj^bs$(Z{O}UF5FC1H2%$Go
z+*b`hKvYUH6iXy6j{X<~t3r@|qm%$KG&{$I^iGkIQIWP*i_0jbz>X<hQI4@M6e}|k
z5agWz{r-Yd8pJVD;bptN(rC*Mf;_Vkh)Fd0KxtCZCm8dN>&k352=dDYE+vGP5RrP7
zsW@Y-n<~iw2=YlI5DVOgIYz>|61z`E=4XYG)u2bRfg?1~Vnl=ryvSO4r^W6AYe~c>
zFJp4&oT4{_AYW7i(TS2BwU>8>WQ2_>R8K&VPo|whaD+lc8NS6>oZe%iAIU4VE<&)F
zH|%d2V^8T~1_XH_2!tOc7a=+qqQ~mXrufAu2=ajsh$y;6$cU1pm(TwydKU=tL`0RG
zB-ciY(}=-uUho4kfesmjgmYFQPsOrs?%4!H6T0}Id#^}{nNJ|dF&-fL(4~IVl9B5+
zA&OYA$_s7ijF30}LB#N!O~|b1M)E*CqBBHZ%HC;7`eYNL%z+@6R2u<;2?=*_QOI+~
znnOqfUd19rB(2=DrNNLeR*#D#-UE!WR~UY8uOf3|?3+V^K)f;HBh-F*QAiIXI#8RO
zQV4U5d;meNC<Kn06r%o=`=k_VJNY<<C?U>}5HZrq2ZoSNBS2bY){l}wh%%P<9&&1X
zZ9-;2kQ)NP2^$Hko3W@N1o5UUvk5i%A*@@4D55>g4F$j%#-xINS)NY?2&#U@E+ZOt
zqPj(hnA6G;&A@3fDoC8MHk1s)Opb)5G*cpJ<$-$O^cit5>SagM{ULs2H_R(mTCXi>
ziIWQ1#{&uOaS4bRm)ohBq=XE-Xh6xth;`^IRu8jJ020irMiDQQhcWE{yU^kTL$-wx
zMXXijh(V*I`&h)}0C~(<u7`As5K%>P#Jp<sAYL{txq=*ev(GYq2SK(AI&sHn3OiY+
zwv>>5J`Th1tW}6E&a!8hAP@s6CFo!>&t2|}KSu5)W~=LOL69}J0-OY5%&>4*9>=AG
zOf#+xaYVP(b#anCd-%W~G|gg3fp*PZ2qMN=yPCM1vIr3&lI0epFi}B_<?}Oi<qB#O
zj144YVbtEPix9~c8xlbR<C-C4cy!757?zpQprFP>L{yO+;0M^kXBJxw3&?TzF~*qe
z9Z3qoNy<}VMk`nNAfl}(WYkMSUZWwTNfA{f7c}xBQlF?G%Yo$M5&2+al7VVpsVW9R
z7Vz-;Q2?)TB_We#j2OoBov3aVqK|_hV+xE@(ETguP<v#VG4DhZF5aBA3Q?v&kTC(C
zu8u-rrTAE2ggmaH>E4V@h$0?NlQsHr`T8;JWdy~C`EG}`tc%t4EU*rIKs?u$6;k{7
z79;wa(4xuOtrKE(JyU#%HpH{s5DO7&pY!^0pa;?R2QixvG4jn6KNRwpd3D)(9+#Oc
zM_QciNtA?$?G9NakXQ=Y1Z}vC5G_tR<gO4pg=kYYA<7pJWI#bOVZB6LIzDRSl&?HD
z(Y|PyfVQ7liGd*V%_gsw5uy#t?9nhHF8UbkPkq7;yAZtq1erDI9!NFct}(E{<jdC)
zlf^_udU@+*;nWW{*@Y;dL6FgN%7~~_NP}wJYj{%jMnlQi?;Dz&dDG2g)|1|2`oro&
zJm4X-A#Z@czHs=64tR~Zc)Z))k_s38s(y^{hP}_!tlP`_W)S=p!Gx3b>+DB75yKw2
zQ!|82hR`aj?GYInkWw`0T!?s@K<4<;t5c5k^M=R(rf_DnJ6^^DizU9;DnuMQ%w#8)
z2MU~r(g{sX>u`e9mfUJE3lXP9{s#Zi^`;MnMtBf2?%NY@b`4Cs3;D#@#G;Ux<Dm3L
z5V)|}Q{Q;(WNY1tbEhkJSCkYL7432S2yjNNE4N5AwRHsm3L6kzTxs31XJ|2HIa)(;
zHlc9chAo=|p8D#O7tfw}c4_~GeWgXNTmpmjsWK8Y9+;f&GALbz+Qv5+XQ^C;++=Lf
z^jVrJF8&`Lw^0!A1e>dmUAfwN>TuoJLnmq;o;!Z}_TI`p2Y2r)Cn_p-?%ck8dueIu
zwrwRPJOEavB;a}^<U=AbqK`W}7e2;67XmEaMrXg+RmQHU=6iG2MUj8=!DgOg7b%s{
z*L&e0ae>};SMAt$q`YEhDSf>~xuV7<JryvoJ0al6XC3I$z)!xu#n^)7UeqEa)*bt&
z7IN!P)}60BQuKS2WZO+0IO+S?1@0uaxu=>!{_9o$fXpZ2<7iG<A?xOoQC;!DzrY6n
z#Y^SCA)&P5$nI-3r>Z^aV5+-RRk5wepknXYtF33x?><uc=ROXCgK>(3QTLqLzPWwk
z+x4NLCQWN<3N^GnZj@OPe+ZXZ6j78Hu-2)ssVe=Af9$3E4^<a}J69?bx=ulwz~Rb2
z3ZRn1VCV86BC5~n%0CtgX+1$O_}mlH2r|($I{%39mU$^OQbwjNLay6|e1$bk<B7dh
zr7L|^J8svsR{K{f^C$Ojs|G8+qZiLrCgZMTXGM8Al_0mj|48MtQ_bMOe<$%DQ2;~+
z)#TjmG;q3ku1bU9wsB@9GH9NTSKr%&tkpFU->GL8wk>I4dsXG_OXq9qTB`$p^5_e9
z)~y2*>$mv)!RE$l;z4uJx8&3bZ~QRifrudh5u<TRuC-`?5PyFeGb6W~mEpI4L`bW<
ziEZUo`%fH&Rplx)`ruCTyS8p39g2h7-uJ;WnVH#jQ$@)@eQN6s*XqLhFY3-crmZTD
z<Hz^gl#?EFW0S$Xq-lASNrABu$~sso7#G=C6SEdv)TxQ|4@1pn1ww+L2!&J#4qpKi
z2|+f9i&<nL1UErZnL{U<ZBcy8Oih-|S9~S@&bjyY_R>p1rMs6;biJqd4!Zm8IluG!
zo!{?VEkPdGZH(vB97O0#Hirs<VOI@M{Rm8U9DGnM2xmV%B3~A=ED^-0#Z*P=fqYYG
zxnVwNB|^i53DSp9L?sBJ>rpBQAOx8V^goUs?6+gvMBBIv1bps;b+T%>PZ1+y*X|w2
zSoDc1G$Yi+s|E4a#-(5R!T}H=zj2~(uBsLE2>XbqHayL7jc*(m*Fy}Mot0Dha>1s%
z_Dd~inl!`7+h)M<=T#vV7~%a0b&>c0iK^*7oE@Ava#(T`-Ge3AP1r@x9c`JjSTqE=
zi1f!AbqWd)gEcd@Bja(Eyw4>e;KEJ9K_WbF?EKOlD-xN*E_qhgJgF&&1?f$3hDiZY
zwqzD<+jBKCC~vS~inzfQA&CXyLvFZ0CCEuES{(xT7BmI94(Z9&#VXIQ5E&Zkjr*k?
zG~Au4>H@x}Tdw;IHP3W+cWP@D=4O-=;?ty;3NnFo<gs+Mn^B33Oj*pD6rm`3)E*6b
zq_#IOH1W+bemOxJJ<<tfO9$g5!NXv+&iV%mXf4^gzTv+15K3ePtMVns&BQ3_dM>_)
zOe4Lh$WqBsV6@q-<|Z?B8iF+YagzYA?MIp-BqbrIInEyA%@Y<}G)TO6drZ7F_x_zX
zB7<`S0y^U7xxQ(K?Icfx(T+pi-o$2})Y3JPwiHDWzAH|UKaf7`6!l2kys3CUS~pBB
z6-4OC#*P^xw4dfC+E*;b9mJUPyJL;d@i;*`kuGF2J+@Y$bwUne_?A=_@EshjcCOol
z?OzgLh2m%$Kk1CUj0hh{I>_ujgLEOCPO8?=BQNE!Ca)T;_>)5%$Gzcevf)X0A~B@-
zu%E-+5h>KGEy&opRDGs4+e|<nS}$1T(7S3yymp#K3!BFMj=nmctSHD-6<Cm?F0$lV
z>#`sV^XJdeVPgZ*gF+K<Ct4>&3u(6SgebeoRAG!u28Efn=9RPnTx}p;%OtNp!yl)k
z)WZCw82=dQK#qyAUWTk}B-0QT#JvM^*lz77lobWxyBrvEwlhoT1fdT;_}IkISCDck
zGhuxsy;zmQNdhqYJVf_q@CafnMH}fPscE9Nre(&hXea78@~cM9fF8lDgR=i&c<%#n
zs@6j4JoGMi+Z^3fo)xE6a6Z)ho!<s>oDMfYGxl7=;(3!6IY<XmWks$-hKG5Cb4t7H
z<|_|Qgx&0>##a{-A}PW9LUmK8@<EGM|8!eBkuHZ<IO1n7UNXg@<3PSE8c*D2^i6B&
z7xuJ|2u(3D>S2wwbIF$Qg5YvT4xh;>=Qvx-&`?v~aX}r3B*MT#u4#F62_YSbSuo$2
z_ZTuRv<nXtz#Cn>47jz1Dw5KE{EIif9ts9+B^>4|0vEy_k040>CZ-5+5ppRLu?6Ws
zj!8vo?yl|m$fz6<$C?SLIp|fUz5u+`d=Z{L+S`j+_HJ4COnaokMTkbVbi-d~3r#Cg
zj`Sc^BmJ$Qbid(Lxe_{rS0%`I^h+O&EY?j8`*SeIq~Lldrh7s}My-cyc40BYv>NmY
zC*5yahK%Y1PU9@!mdO!!LWFCTloN?lWe!J)!`9Lg3=VzWba<R-bPHxP8ZH#EZ=it%
z$u}h+HGSjO`?nj!ZETiz<Yle7*vu<1-+;^I@`|ONT7tA+Je!r8FthvI$0Bn3G}47M
zQ{nFFqRk1vIO&C3H`P~{?%Tgdr`d5n_^`Z~rx23TPTb0UhZE5k`kpKaVYo&vE?zp9
zZc4zV`T4Q2F=-jsqUS7&MYGaai0IZm2X?;<#eErBi3<c$GjsC_9;z<BXWRCj2P*fM
z(_H8rYxecYoHf%AST3+TT^IG$T?9zr3wmacEzB=oN@%>ZGR~h}{A+Ba>oyUUAP12y
z6o6NV)MQs|FRtHOn7J`sqmQp#tFt*bZ&N}2UDd^<+x8tOFSBN6Uw8ctH(Yz|HCJAF
z^;Q4Ymfx6d-ErWqY5?2_zF`tYDZVf}-~|Q-1{xY>XJ;D*1mf~SV|L`i{Pz!}CHj!*
zS?4Z&dvV-N80sVkOR8Rup^{Erkl>C$0oz*zx#_0=!3LRBN*W~{$jZvvcxOiL*1Szc
z1qIL6*VjMv(60LWf+8pi&B&zXpkgtoGR^olYeQ-lKtJw7@QL8(!6k4FTm`^6)!)!!
zW6|P;!?dD`R|Vf^V+A>{Tj)edPuzNN72`&B4wTeZ?u4pwI<i68_<CVOVcy5{7srmx
zHn@p`s_0Wo5WV7io7rc6=)agSXa0_g13S0xzK7L27twm>jKa+HR3m5wB`oL9eoqZV
zEuW%AtTGWTL6A;7%SP4A&1>rm-js8&qLOM=3|bXzf|BXY8MJ6Rlh&rEC8=<l8HaP{
zzyEZhtDmTDc|6|!Q(F%0I4qv^#0nzMdy!7u1Hapf^x&#&=wX%nwv`rFKLna(WTu+_
zBX{O~KY!t{&+8Qgo|g-u6ALoyWD%C*>}-FmAoJ295z>hYHp4R(H{E4QNLEJP*^d|h
zS{OSv0<$X*kp)OuJ*1gc<W@23J_35kSQex?1kwxm<p+?#sJ_3rvZ9z~fM;c9<eoo&
z>FoF4FD}ksyZ{o^^ivm5asHSRs~1GcfafqUKs`#us4IeOLV5vf0{0+;V*OjX>+JtE
zg+1_|<ES8Hgh`<uvhG590rACWkwN*Ir=1}=f{->E8g{encMU;`kzVXGV!r!Tq8^a;
zmOR{57;j-(L+C_75@Z|Fi!F4DXGlPgBnm<Zj9J5kJ!VIvhg2fHaKdjlTyF0*NUL;^
z5MeDPa$q~lT^YA%2%=+E2K@F?WH6ivog^f_+MJ5CW;EgnHfMN8OOOE44cMfo9vO=q
zglO$xoFJXO(G8JhWys)64SVC?LOeFyO$fa1RS7a?V(3^1UP`y2G8DHU)Fx<U_)It=
z($Q3p6r$q&*w!&Bh>d^gh%|;s{La>*Am@>O?9ney0Q~Zy8pIeRBI*IFy@eZ>j`O*&
zARhYY77a~xE_E*vJpHw`k@!u4h+>Yc><O&IZP5~BGt!T%Ht1u*9)9@YPs|#eC_^)%
z=donR4AOydm(*}#E=;80xfO#X*4QZ-smm7=P}<aGAbgA<5xc#gW&DC1@k3TM(h*qf
zxgT9#KKbPK+s)dX_?ep#BZT2oYC&8!j7Mc_g1M3@BHeu|2(~rVD0(<JX_uKmLyAIs
zNwgf4KBTyf5RF}X$8?_c0(U0SHN1%~Yvn6#7?eH%HO$NM$WJ9_c-9{}u}3XPvmIlP
z)QZ5}4iM=?-4I7Ladg+nHovDY$1W-ovvU)PaGXCRUE*#%<bewzu&CKXu0=YMw+2S!
z8ny#mIb8%Pg*A}+qP*O~tPN>*-}lr@uiar@J$JO0bP>Y(K+7ai2_ocU?3CZ}wkmaL
zgp3Yhk;#4`8hCFX9~l|%SN(`LI4%%kZ@`c5VHb8;w0cMy(v#x<oXJ{Nxx2bx>qd=b
z^wcNv-v99j^9hQ1_59$lk4k!Q{uDK}7~^1cwmZy0v!5uPN5awR5ePLGE<Qd#%iD@^
zD>F8{vyTOdsZ*%YLo$(`RQ$U_Lu+N}E}Dmswn1w%%%WF*{OrjGKRWRhvj?BO`1+4e
z!{I9V-Ofpy{LI*^YSem=FvfT;DhTg~=4n|Fup=A>s3CU*=O&MQ9kd0zYvK~-Y8o*v
z8Gz%S2__rch+m_J<RV=$0oiCpc5Hv^*$3{7mmxLd&G+7Y{h8NZee!Yh|KawZ9M*Os
z?i$|9%}`xp7e02-YJa7;aF{OnjVg**nIv<~Q_Vet6Rpgsv;=y*OUiR*pyZQgZJ+WG
zwi2>eyNA4mbR~18=w|-@(gL_hMOx;)Z$A3U=P$f^hk0%I;SkJ;h*&Fdh_ia(6|$(?
zhQoCNJ#5FoNK}v%cYuTY?@E!|4FL>H6NY<qIAEhzJs1{~<W)7IHL})1mqojWlp|f)
znrPItma5BIz&zYt@X}|uo7b4%F&FfSD}N2W*iL6de5aFRMgHPM7vnNQh%)@x=_#e{
z&cVPbUakc3eKXVooytDSlh|@YSBGsx?sW}{Q>a=oOhx+gtZA75WBD%ie&CsJzXbN-
zD{~U~$&UZ<i2Wl}#W`3C`yj{x*gf>-O~aAuQ93+bVVa8#1s|ao2fRv&ZXHakux&zZ
zjfh*24wUVB6)cPJ?>vk2<z<%D7pF#Ej2NkJzW>atkDHUlBR^v-Phuk_7}FWA(AI((
zLjt{v@Gfpw*Lw89-S$M=VCXw-7+j5J5|j1bjlqSS5mXMl*6y&XysTYFU-pR`^2SYu
znNIiK_vWMTziLh<U;XaHCDW1#_hn;z)J^R#M;$xh8+x<Pz=2b}f(X6Ffz^*Y8u!!c
z&LbhBjBUO_Fg8uKVpA<>mzE&s;2*sk=?g25R(~({WSM{`-u}#-e7^dL!!0L?WM`W=
zJVfWd&7eS=A4F-5&=XD6?Td3P!Va|{WFWv~Y!;$|0Eat<8sik9KB0yndrd~ji;}CO
zZ<5-Th0J{ac*1-cxc!iw<C<kVOP_n*4zHdd#=V{h$iU2m3w&{hCr%LJ5th8epDE!$
zUw;o=sw4`zBChx@a!gB*MUxShv<qcRQB?ZaW2MjD$>eyS%8`72bHK3w1(6N4je~v2
z;HZt74B~@7Ptp_pEtne;G!}I=cKhjL8;Q?Nffk7_1fNiYONQ9wus|a{lbVg>^VOeV
zhJ$iYkPq82?%?T!)B$lpfp{SJ#4>fh!JOh1Dri3R%XPRHQ<z%_$bzWrt-O|H1t~y!
zQyizq-Orno4vV$Z&E29g@llL%6H~@XgSp`SVLU@<8!Ua5hpalG<kS%6m{$@J2+@>~
zEfi{S&SZqd!JVch+<SS3tJ|R;U~ANuo&ra%gc=G`XUDzNdl<mDmI^`xiydV3f)H1j
zW09?vV0W$h+^E1_e0!G>#1N^q<&ev2ied9d=F7q3RdnYuuY4C90vzsTw@)}t7X(3o
z2yWu3AX6B+3ba=ZN%3?xVn&I-Z@9gNr~Rz`i|(T>VzfnEDAX2Y3(^}aRB*+3f$2}0
zlMb6+(M8tiW(yuaT|Z)tW)63|s33J*9X(CD;l76cl^}r7+y{zN;LnnSWqYcaKCFkh
zx)KOtfM;@;Osy{~g1l(H9GocOu%nwq10UaTI2d9LVS@8}2n*>tSpVU3z(oI-^j=SA
zN02V(0-U(f!%z=%KN~E|31Wm<FP--~^Oe%bugsT$69+*LC3;Kx!0+%$3$UE6U-Thz
zhS~WM4&(5DO1>h5cb%E5bbufL_?8jE1bHrjARCeX++`|*m0XD=d*{mhs<%$rt_1uJ
zXGm%Vxi-<CYj+4lN@>8gDgOZ?Z71OIHTWW)2A@lM<M=Wr-C}_VMG?}Uov;E>A<uZt
z$%p9?2r2!e)4@6A1d(CfCpiz{BjWe@JIqzNQ`QPL#kx&f54vxF5uTW0HSLUU4fLov
z`G6jFzY+-{J$4+Jl{`4Ntt2G*?SW=dkRZnSWbO127A(sOVvyAHD^iQ;Iu+w{bJ97H
z!(rvYQPgN)=WNue<NBo&?Y)vl;CX+!hJuV*ma`yKkkl)X0Z4~|v*L0I@)3l0r-hX0
zYV4UR&KZ(hzQ!iGvb-ZKzBwvBD|M|nwl|?5X~+m<ro$guCd%99Bm;}*_&Y%fkB<bv
zekf@O0bVMq4LQWFLMAa?h)M{NSh;)f(nIpJ^;iHe3>kqUy0^!s%VN|YIfS_mfhY-y
zjbJ~bt=dC9L=;5WQ!ZY_2SE_`N`eeTJgb=)dm)CEK#-4Vc7YMtX4*#!6Bs|5lgSU@
z4}2Z7eDnoo_CszDekaNS(%>*5(X|jCNi4{q4dbK2ioK})*lh{0e2{8{;5#LU)&XZr
zc_qp8)PHhd+^I~j=={nts-)kJJ8R|1mQ{X~8c*H2y2OIGPtvU!hF6Gh)sF48Bot)K
z5W)9<m^<&-o1rL<`v>t?Zz@8$vBjqLs1c!vQDSc)4?nv~YmZvb9<fJaJR`)2y=TmS
zkRUM<67d%?5)nj#b5AdAUt7u}`oYuoz1NqV@4e^Td+sPwx;d^{cbNOH`i2&CKf2EG
z=yAJxu}YWR`ck&vb#~0B{a_lH4W|POi-blD|MQ@uIx9txDG)uP+PeUIxtoaOJJPVU
zGyR0q;KrsM+qZ8|{Z%=xd;q^P8mj=GkaGl*OSl6J54d~9QT%XJGqEi{Ji(HKYs>l!
z+`9JCY(dz<^XXA_qe%DZk#e9Q%NbYy`$`0FRG)|&D`(MW_Jb>bExY>;l6$kh58(mR
zyMiye1_$m2BptbVA$?NpDW6E%5f|Ug@tOa*SglMEUuyTw)@mX+Id=>SU!2FYmO1#U
zL^wFFfgv#-l9GwY^)gP8dOV1fnmv0<8{z^p73Xd?bJycDn|-jXtZT%DZ0qS&WnH^o
zYF6yFW5%+FA@sj-o?N?E#EB%;ws}U#SA!E<?a#GO13kpU*H1e$7Xe3`rl*%4K3Dx9
z)PW!upCFP{7?Gr%_#~HPFpgB=vmHuq76f6?#x(;8@^=FLvrjeH95$9s<czvj5zJh>
zwX4UrCB;|~2fD9fso4umkOSvL2Aq$^Tre_VMll@Q<v?9qdZLnufN~RV9ocXV*l=Xk
zglaS3M(>AR3<ab>Jc1-6*UPAe6IweF#_aL}<M`2$9e5?_#V_^#Gdb3M=z}Yq_*_w7
z+tS)-zBz7u-wJ~s(9#83?{Z8#XY14TqDzIXWq5S%Cjuu{_J!nn>**`UFTCGO3<4s~
zX!gN0^UUIMVX5%1k)+wU+%qB6B;#;n<%T;Om%3SA;G|wp2Df?{&yhQ4&z}9wP+t7A
z$f!66tj-%#kD-V&Ds|_A!0?`9^u9&Pu<{S^7q5YrEN%)<Jy;6!xY+d`!+y%gv`QT^
zF$H-vIZ2P?s>fET<S$983PSsy+l3#L@42x~$<nh0550dwlb7%IS4U&k==;5`+Inff
zV%*Yo`K2-kmvEOe;qZict_<u5t<T+7#ftqVR1}f-J?<5c#!_fe`h(Oj1(AR+phtqX
zMuKiSq&Z6ya!2rk5oPyO!AI}jy~9O$w%vN^D3RW|`O(0db+~m`Ia`8`+V^zBT93UK
z4mfjZ*{UTKP$4csBq+^2PVt}d7E~zu1DcVfU+VGoMJd7<oG&3v#APZ&3E3&c<gABh
zOpB=-ZyYO$F{gAX!s&>X96bjE$C3)~dw3YO!llR0;Gg;M5lEYI!2Ysny?txBZ`jl$
z2&IZ1Ly+ZnNiC9`ejz?fqzP`;v|IQCpt?MO)oua0p&o~u7Ga6?zJ0%@WjV{1UW)$&
zIZvY$?W?6^+4p7ePw1dD)46QY^WOSF4e8f{7|=_vQJD}JsY?o_NM(H8BK#TU$Mo#E
zebekM^=o=s%PmEq)f41A1r&Ro$H?n!O##51>_5#)`7}tS@Z4YO*<BRp9%=SvLs9Sz
zytyNkeg1q=7pNdH1i5;*6zSUd|F35A&;_^GZb*6wxpKVc#@!<cW8yq;OP{__uYC+&
zj@MZlDB*`{KlCzfjLVwkoaQOskEKx$w7U-*KT3VSM^!0Ci<ixAsMIAHld?FSaph-Y
z(xJSNGuS%YGh(U?=F$8CmQoWPkWF1j@AEHdM*xGpO950w)_g`r!xs*IAFGJv*F)E1
z2-1P&@5G_Wn3TmSSdvU*UBk&-keun60z;<!#h6mXLi-ktfcu@4Yili})NA}wHYm2_
z4d_&g)8ZY=1X&~wP09eSLuocP(~*?=TY?;tS!q4*3$TiX=2mF5ASTztCy18ihSq`0
z3lqfhUk5$n2y(JK6Qq+kjX)et4z+OmfKudv@OQYw^q^kz@c5Czi{VfkD-f#aUNC7<
zzaW+q=7WOZZ}JmBjS<hKL4v>p=`1#88z?7-7PvOLIeFMy_zU#DQ(VsYErzWljL*@~
zH1|e6+o$=tx7wiEAudbvct15x{b(-;LN5@cu2_eVq4^R7?)BG>OgsBm<Y0QxK<Njt
z_(wt4VcE|T(JC4ey=5i){#1jjhI7d3W3YY%<<Oz{VGSu+O{~TGVhN%$d$xKvQZ;u$
zj<ZOi2CSHey^BaWkQ9?FTSO_`vnknvq*?8X>#k6c42zgpLrSd`YqExBf~ZGI;dHq}
zxmJ&L*!m1O6vOGx{ag^4+mu61w0to3%j{N0mLBr=_Axy#F@D+HohdjBg!a|^VvuS`
z)bnSD5Ym!81Zhx?dVsCas@Z5U1feMm;T%eXT|I;rwXk!EogC_*Su$MV=P?rQAlTIM
zg2P-8r2346Ozd?j$)fr+GWIX%A)^h0H6-Y=f-xlR5ya%lsXz^(c}@q?)-=tww6_^N
zmoq4cg0&-F{Xi}gQngqO+|fEo)M3LjZOI-X7kHj2L=dGoqWn~mv`-MHQdwbw81O>@
zOv<n&DQ@$M^N^5QBHIQ(S&sqk#)kL{z@T~#oK!P;rj=1b1UaAL=A}Px_O5dU;ok`D
zLB0(tBC`&pfpYu`t_No~A&tdxAV}?eNum#?avDC$L66~iRz?ECj7~LfwU7>kV)JNh
zV;rF0o3YVh2P~hLT|YEz>jJ-)L-#dZ77#L6?3Soh7E+b<)hEu)q1`)3mn7y6AWI&e
z76D8pC`g*;x2S<>LoSFFE{GfQP1!TDlBNoiqi_r))t?~R4m}XDfAR$BL|Ve@v=x6I
z(RB$0$pkxpSmI?K*J(&BHz|H5<s?OT$_jZK;oblxW50c?tGcdgl<IM62LgKdcnMhw
zu}e~>zPr>Y$yymL|6Gvr+#X;TRS728&vQjACE(5Sc<7)Rx0x#y4+s(lMN}*cagZc+
zcy>Wzg4Ac5h9!*BIAHeYf*eAda7EN$C;`Kp;9b&6(59MAf22QbzaaLn1ThShBd#DP
zg#hIs+1v2{?<E(YNsfZF&$5ZCYKFo_UE$w%zi(M8o`i$rA$fdMHjfJu{&|W(+`zyQ
z7YXzT(tw;2%Oxz8g*5uBf=Gy}d!u;3k%bLVrHi5<RLx7}rB(cT0E{3R3HcpCrV1hS
zB8$2vWJz>@Tm%^orU@v*<GiF%7qn-1Yc|CMDNI?$7XL6@5%>i~wP9$M-#UKq0A>nd
z3?!8&5dup95(x<Mr>N3TY@rucA;)AeWuj{e%`;6CKCJL}&-?YDngJT9UKQd4Ux`T6
z%_Zg95thqKBp^u6J}amP!jE({W9X`_7>2=S@}M^O7vNq<H4JvefDpkaJQ#4C(Iw<h
z^k6rQN}O&XrOG9)qy9GpDgS%^oTKZ7bsJ@Ir?uf_ZvG6VlG~2@LnKUJMev9)N*2nO
zNO}l=&Q$3)ZRDc<xDb2~PjeMSA1*|}Rw5*27l#l8A*U#kL~wG65Xolp{~zS?j|6G|
zjlBC;jUtM|06vXi_kComv6x9QRia4LB8ngu1Hz4%LR>Z=a-&ga1Dol$SP+GjHZ~H|
zY#>+$WVv|;8z00su<_0XBg_7A*SWKM$oyX6<Lq7L-g8bvq%hQ&;_KxN1Ui&gBkuT^
zrp>~7Ak?#Ri3kiNPcYR9DX7746w1~}D5gxpf=MvlD=vTc)HEnZr=kK$HU8x-DPqX@
zB-c>RSuUhTTzOyyq@<3|5g$=jS4tqc!i<5)Tbu1O5GW%e5R+gg(b8AoPWJ}o>E-@x
zg;v_Zj7W)_{{04mR=T`ETq0e}>IW&R<FkT59G!b8694~oM;(#k9+D3E)q@v_Symt>
z!|aYDQrx@6A*)+w@I#peA0?rc&J_oaB2vWisfl*U@9;(CiwvZQql>v5kkSJoxdnf+
zys<E$QJB*{EdeW6C%aBEhEK{={(UPf^mT@L_2@{Mp*+qGtwVT~>9p!Vj85<$4oM3C
zwzy5}9(>DA($MjngOeH!t3)8On$(9qq!qQ`UuLQZq~A#}V*WFIBarI83#5ZeWcu%0
zo>E2O^tH-R(k2T6pITpd&O#HFQQGuN29l>n>%>bHAF?28jKi>97Ji~qEt^W3hT}9`
zR^fP!G&QD^!JlM}mW=IF<DIkc9t)5ps@KoM+2sAEYQaAhQ`7*=5l>i%TUeYV$ugzX
zKwG^F+8PX$lO?Fk5lLZ#PKNB!IYDjg%f6p_MCTi7qZd<RyUrhX=p3Uy-jRG7NOhIY
z2I`|taxV~zPBcJmG({{@pD3d98MSdB`v&)A?GBMsk~@J|U+BC*U9@9SLzG8s)47S7
zXs^?f+CODoAsvNU=*GgY)Po>qMC%l_@QD<(4{WTp^INY;ZlV@8gtzNhn~zs+tdemp
zezP*^H@MdAyDJ~o$*74MXwrEQ2=<%2y9sIJ4C4SUEwuDBf1cBOdS@V!d}s{OXrf3Y
z8i=(KzZU#}MXFU=1;tYp#X_-G_HHSD!m=VFdst9mp(jtf?4{T4vFFlT@11#PqT@Jm
z-pRHw<NjJG-H%x|Pv-r8o_D551rFdu`3NioeZx>!nxz5gu9c6#K7iod6YVaGUKpAt
zmB;T0!azfisWAPZJbqgcUN;0;9;O}T@yh{$x-rjHJ4|ns$BzRD^!}9L5T;Az(OZWu
zxb^)kC79G#%44?x1U<u0*9m+qn^Ze64L1ZD@Ud)CodZEn`81UAv20T9!qnLiXrl<~
zCe_vQ-p<A8#l_CT_?7Y>cn@80OOiT!b$p`)M|6B=s|hycxBKHCx*~lIQ%ggjb;9ya
z35)}k;~uWIKmRW#>iE1N&>CTxP=X<Pw1!$LM<395Ee1X*+63XlH>oC<cYZutoSvQS
znO;2Fy;yiv-zL&&5)a`=FO)h>ha?~g2p_gdwRCc<!Qt|JIjZ<Hp2rO>*E8BX@_m2*
z@LYF$Cdpyq@9O;KOd$AM>V|HhLxpa?{_)Tjhbw;UuZj7C!@_4;VsWM;9b?3PDy-am
zb?TeMW`dp+ZRrEr=RPEpYJHlcCO&a7DV^Z71(Vi2l_D3dBW6ta;_r%oxe)B&3Mx7Z
zDggdnU5);ciW@xh>~(KxWp$<0JJY7ZR6bXvyqJKHD2^F#1v!Wxim%R^&#a>-34DfO
zRT8uD9CXWyf8!Idq<aoKV`LK>nN=Z_7bH59Wfg|V&`<OLMx}I}Yj2S-Y#16c$kRZb
z$K{^G#0OfL;qGV0HfLell0JcuV)PKkSSnNBmYND6(D_qUPm!iU=-w)R?W@o=^=1o<
zxwSA98-}UkF{wKfPvRpn^1$?m4ne2-jR?Z9KV|qHoG}eRPVs3$1ImY;;$y0TwRWc=
z{5bhg|FH&LvXdCeD2a%O82c=@7_ghW-Ep)~8+7YF)4tczUEjx<(TqIQ#*EE#7>=T~
zpCp1-ZXsDC9DwTUWX8`h^*01w0wuE(Iq)|%pP3>lthMRkj$|?i9dBkNi}m{6GI$=2
zwMD}QHmKx(Ci0tjGi0#MXD}Q;l+Vwz#28825Y3<>?*yjihQJ$wx;^E4eeutKNM7nG
zYLDX<xaiLr`LUVs*=X%S-~qi5%<fC@=9u_UUMceaVT|O(2WpO0C#Rv?5bv8jHth4T
z%moDgSwrvvS<3jT=`bFdB7ay1YJ8;+po<j9C-xcum)}-94SEGkn>@ZWd-Y5C+{sSz
zDb-V>AFe=GB;QhLU#UiaAlUa$*}X=Io<O%2m8%$10UF7#KGn4!-iI!-$;iS;s&i*V
zEvldOp1(sBkYRMwDs<|S?A}{BPChXzy8RK+i0uVo?5F0bsaDzUWYo{j^L5Z`#M)%B
zL7no|<z4_-CI10QX)dqGvN`k-F9yX{)6iwIajA&>!hy8>4sNh-XuAUm>Vu&}kx&7e
zQjC0KgDyokccDwi#m_gEVQDK!J%7N*vhPIDOOo1UFxCP{?um?ZV1U&VkXZTtP_BI2
zVhu-dBh%>pIL5y8u_QVXg8Zo)PcYXEVL`4=UL&inu(Q^_spdE_sYa^=-QvCa-`sc~
zSf>V?%%=AvMI)G0<W$0tu2b~|)L!Z8aveaPEQQrFbmid~Nnk7j-IenMblUj2?IzqY
z8z*lw(g~~43WQ=qC`4e{lG+L#uvXkxZhl{GOsWxUcTU%L0W-d=4Gtype((CFbB&^F
zp*Z_qm4GGUy?UbEj8f-0ZX~nBBsVhNI}<TyiLpUA@kY-FvPS7O-)ICuzg@>}6w-Mj
zUjyhg+WbNX>=I+-t<l+u97ES3-kp1f$O|(Dz7@HE1paoNJBCqpB(wS5YV6LA;;wd*
zkajF8A6vh(5%=+J^0Li=HATj^Avq>j#bKG2S;jWH@F#HkmArKUNH_!1MO1`~Ir6|#
z(o@5~LNrk~WMFBMS;l6JHEM9m#mLhkfU<Jyjn!n$!^J3hF#^)0$aoWybBk5;s5+5Y
z#%4s%aNi(#DgsD4M_D~YZE(>>9#}y-AUzQB4IxoP)wM)GQWVp0-!n#DM%)6DU@QY0
zo=&DCD)>|Hy<yotWHRt~hdA`1suJ}MNHfjBh2|ZQ6#xn6#4y5W7Pm4lQ?XcTdwcsQ
z@8c7)qpYRC-yPzl!J;mC_aXg`X<XY(I|tB2Uf76Zl(h^)Gi!&<Mof08EGv5wU>pee
zRTWO{vYp5tfG4a8Hmi)W!c$;_Je3^tkXIbKZW@AJu2U`|Y!1M&Y}J5Z-;7YZ6WQ|q
zuFX>#Hd$sUi}|95A?NyR2XtDjk>ieHjAV2HI8!8?0YSgH+b#LC9rndPcdtY*JP(^L
z#)w!X;=M`2Mgbh$udmR^hH%#*Nf-mb6&VMisH<W333RE9L|Q@zfNU#=%~NBBq4s&U
zGmP>8*6;VWy{yoMJ2*)gkv^F5J{(m8>~a8JW;uXU?_Pa_&A@JS`!z2~ex-BD9hcB)
zn=Ia~;ue1@+hUz7GPc5VZqa@rRlk^^U3%{rHl=8Q!%iEKS?yi9zgl+1p(`@RT4xdw
zGuv~vcTD1-1M35zUdhc1Lz05)NLcR`pBOxr;Mc@v1#3y;R&JA#gn0maZt2QNM*2Ux
zmyIzI3*-Miunzg-y^$~-aj<AWJEbI&lg<I~myD>jvvfExnorL5X5(_>)Fcpzx>jU=
zee(cDlCoU-TFl=Af9tA?vN&y3mN+-i1fZMg$QLH2g$M3sdbDQphZU0Y$FkNDmW)rE
z4be4pNz8qZpc|~`)QRgtz;_eSl?(pj8y_;)d88~OEE%6R!+<(Q-QF`1<w^sPVT^q0
z2XIt#U1P@A1KIcRQIY!$VW>#z#DNyGS3i(BNxtDXBEM+0zS1YwNQ>l6X=2qx(oQG}
zU^-=hBK65+?ubT)7s+2l25Qe5PB{QxB55s20GClk(s?-QEjo+>9cFEQ&FgQv&Y@fN
z5fR3U4^44)&8%p-Gri1wKi0+{TX{d1^~JbkKJH&I49kzS*c7)tH!9rErx}XN_aE9f
zKFhub`#vxiS+Vt0g05ZhatxhXk_`t<sQ^DQdyMN!WzA5T{_!UA(GwNAwoQq*Za{3l
zJXho$!}MuGs5AlnBo@N?SDr;@7NO(aF(%VoQRy}l;YZk&-=0k>!a^CkWXa<tiLd6N
ztDHQ>YH|)6K#8_Bxk5D2X&9chlDDy$o2=;QDThP(+?<;%ZNbpiAG@1HWe<6*zXOK+
zxZ=lj$WCQhisIC6Lb8THG!H{$(5u~#^+j&u@dw--nElDVW=81yLfndo_>cIPF&5jL
z(;#d`6<>Nnb_mGQ2_%S$vNuRauVLVA+w_pE8MwcrW@GMdZQp!Js)=Wrp{x~=?Uv4F
zJ><U(KItf{5VSqTr(6h^vaC(2O)7Bd8(z*i4BFvK_t6&9b!*V6r$#)!T0|{;%WSun
z7hzG8`JPNp!#&qOD1JpkxRhnc0sTaI=+1prfm6Ht;^bm`B?&`iPyFf%9*|tHI`>5l
zweiJe#kWbAW*S0f2<SDFTd}Cfd8fjZUmc6xH2lPLv9Tu_4E*hP;**Al^Xdrh%^HU*
z^>SRP!_T2y%F<=UdD>OzB8sG?>)SSFbamSZhtNNhRAG&XqGGtq;pK0|5?%i>f_oAd
zOG;f%V47<P8x^xe1)o)8U%XdwBa-N8YwO7;QFXaz&NJR~c)Omo)qg*Gw^)Xy>GJ4e
zd{U{?MR;muIiy9tUzgct$@}`<1c#f-+ZT%P)ird9UU+!p_|RXiFQ1()y!cl6AO{Fl
z`jkx<uuZly8}hCWCe~Eg@U_a{&lO8_3qk^3c9s9Zn@}!g8AgCFi3aPtzaqNy!~X7Q
zdsqAX(eD29C3}0n1!;dN|GmZV)XMs|z55AiBa7nzKKlpu&*goY(_H#yV4^mOX^1g@
z48dR&Y@)@#pcW)ljjRzA54%=cC`h*}-t9_VD~LrzJP3B7*PfJK_9SiTaRupO!AlPd
z3p?{>Vn&VDWuM!;Y(ErJY3adVXWqZx@ApokW;v5jwMJNOmH@cl?(S(gK_7gxx4XZ8
zaCmrlu)lj(1)$y{-1UN?pG(4t!0(ggwB6N#lLZR*ZsnCLR}OdIymxza&FgWygGMM0
zuT)-fI($Qc))xK&5vW(z2{F(v+3rL$PWV^>-c(kyAAKeJG?<^2?7L$s_b4z;cxx3m
zAaP()mNzI2>)hVp;rtJteV!MP%C`Vk2xoqQdS#uE0{UgUU@gM!LdS#3D;IU(2Sy2J
zs$lhOP83lq<&)e0)E&esFCLJ}U4SkVu6`1AE6bDseq<A0Zfk-F4*p3%4m9rfVJ$$Y
z#xut~1B_8!(YReU`91LaKM6=>grzs~v@K-LiLC>;Cfi%^l*iqMPk>z(kc-;meurOF
z%oBCXP2h&z3x>}G^bs(~mKzs-X8}-02tR!g^F-ao=Dl)~+uerC0QL(3VY6NK8>ZOI
zmvUSKIcwDYl90^167ow!m2d#Sedq|tpL?AFzqffXz4vGFfcQDCft;!DZb?YbSOKgL
z%rBhwEfNRT!*ON*y%z=48+rfN{$XMHZv6Ty0>cjB=MhA?pRK5r)%Yp`G*IXq-sSgl
zt2?@P&-}6Pzef?O`~BO!U1N`NclYfZKTO&h;b&UJYMp`_>Xr>*psOF~AzZY)ru5D3
z9)*qKT)nplM}s1-3k@oMv}y;gRq%Od6)FjBfhylD@~BR6!gIpYCWN^TtT-=ftsWSY
zatI#2Z*nG9r6^U4U}#6Z;;Yl);Li0Co^r5FN@9w!)_N?hG{xqhn>~bw`>^QMtWB?u
zLQm@l3FN8MF2dIgggwBuG+{uN<t(83Y5;#CN?-Fj7GaXsg~LsSo^guuAOcI~9^q|O
z>~*053A^V)$_Jh&RS7WFvPE~6@=k(zMfjV8B_fH+PdBW9JX7qnbv|Ce6jEeM&=DL(
znFT=CT!g<l;hM>vG>Ehn5WUOI^C)-iSTk9rA3&p=cf($u^EW5>tk*35)Vr*via{NK
zcZBB_hWb!utU+X6k!?N|qvTS|3D>)<NZn4<*Nwbw!pS{=^(J80<sZ%-bOU%qF2$U1
zy~~Ofe+EMQa|wTS-jAm!b*vxMkrdq|mts!X#NH!1oPvZG9f0TRQ3L=?%6UpxkX(*A
z!IvS1Fq~)$;UoxPHXi^shIBY;d!Ccau`2R;p(T!Eo)Au+1IQ}*fTUT+v?Dcl$>rD*
z`ZR=@z%l+!!pAyWdE^BEqzjeLO#yN_X25hx;;LnxU><0^=UK}DRq{{BH3}dq=Ut6l
z)}X#1_FgZe0>kW#%0jmY7h@{ad>;T`6sCvvx5~V|0OfB@_(_%|#n^D0K%TZtcyLVt
zRWef*2a~m%UHXE+47n6JQLCpMvcPq_8dnATy3A__zD;4*(}!UR*a7K0T^i3h$KfkU
zV6`kDSs40{nkR5@hk~Y?y8D9~nEYO2b+C{p$=yA{H{VU4QQS6uOfXD@z^Ge%9+6YL
z&$`o&*)@N+ge^sI(AWy089-AlY_D7#hIKC(n%Vk;eD~;G>lE@bE^;}BL{2%$n?>4w
zv9~FMM-kzc>p)kC&9(eog=y49F3E4=&w3?k5()bTuK{^O1r~B!)1y0tgRyN2{SI;H
z>&dOHjrWnu@-s}0lGs$WN@g8OW3rMcT=L?YY5Dhq?0Sy;mwpp}OgFgEF3XCat)(Xm
z+32p!7!l3S0w-D*gxR)i98lS=6YU|w`c0_&3(t~7M6nLKt66Qr0y*M(F*>@vHbO)(
z1Vc~~TrFt5v7iPpA<H$?k$JM&3nu#57*9lSOSmrlMS0O+rRqFm^IyG>*m_X#bfKq@
zl)7<Y>phPNL04q?rj=ZH-H`@=567t6zmn3n2E)80x+GA;=2>o;y}H&&-bl+>PtSO6
z=EY8c!a!Ry>qDe;%?N&eYfAy`tV~3c4a3FjKR3r`=5~51K;5Hr>kA9FNC{d6&@2h>
z3+p;_yGpv^+`ZUG+nH7krl;$<o|Y0DR<?ysBP~b(KGs2C(L7J`Yvco#r`@p7@Z*`6
zE*B{gnX;H<Nm93!HFXzWg|%T^As;l-llx^U0*2~St-Yh~)}Q=DKC))PGaT|7ts7Od
zpk1t7V47Ueuj31=bB}j2PZNni;%O!`x-`9hhkP_cFoY!WeNGWDFOH%tMP1QHiI`T!
zE=6$A0Q1=hS=nr{RwAZM*#u<KssNlsL^dQfBBs`|2}m^%GgCZ)3ge>@%S1#g<#2#&
z^RvW4#f_}_;eSp<G>UQ=)Xma1uWY!DyRsoYMFcbkW>_i*i=eW>r>RwDTvYK63ypwK
z!Rrg1=7A0N&SGU8*RVpwvq@o!OJ%`t)sgojY<#U!w~2U0XgMSS<;`M1Hq=_XC&OCF
zY)@TW510w5EObLtWP=A2tjXLs5l#>&kMk*J9$;1FAvFJJoKmUlL^O}ZymIwSn$>q9
z30iFoBA%y2Ecfn1%nK#Yltx^(j?~*&#={RpAY(6JDvz8KTMD{j9jVg?vfPBnL>Rx`
zS8?RFR3>Wd21-$&!-xy*C4v~wP&izZ%7tdVv(i>JkQ+~k7)I8nckTniw=O#+4!2_0
zCDh6CEP4f6iaaX6A;bWr?0#=CHro<tKkF$Vep8K8JZ#&f&g!c)4~R4KT?fQ&F<x8{
zTD>gKTlKP6b>I;Z!<{LJ-mkZ)24L7KrGmO4&jP(-)FF&b0p+$Tv;cI&3J3<|CU)0~
z0B&h0&j-YOXJJvk0p{8~09Alvk(?jpIfB@|vuaad()AQT>n15}u4xShkuRP)M;(Ar
z11vXVFa%0_?z@tKN%-clXHfxYutYjw%8(NF98LkL><qwxg2|L>)zrwgx7_0)rBFm`
zNp5QOJoez2L7{sxoh9i;5!0nMkhJ9P!=Wr{q0chu$7$-jmnF2*=-Q^Rl<flKn8r>N
zp-%NKZIwX1XKtyL;-ukfsjO8eqbSbbyEHem(nmguzTE144^Htv6TSP-MO>ft;7l~J
z^UK<J&nEeg^lgr<ti5<jagypuq*K!WMJh^hJ~jM!;Rlz2@aHnMyj+-j7xbVQ8ZNhW
z`G<XWJ%kUUno;rDyYy=7$x9C1d|p1;T7C6A)7siPHKkFU#T)-Wyrzn3UyS0Ecz1Vq
z+u}fHY%rq1L2Hio8ik*)U(ZdiFRZQQ##ip#85;WeXX5nzci#;S-B}qoddtlLn*n70
zEc~)Q_j+e(>3*iS*X_|ME<nHA^uLXUrJ_3=!7<Tf-Nsef;;X)%jSq(t%_`1AEgyQ?
zygJU)9FE_RJ~1^UGzuquxV@{s>Z)9zJZwy5ll`H9SJzZZaXv~_Rnv4&A~yW2t?72E
zv8G-z{*4BlLDhpz(kD(|--rj`L^XdTF`R6#_)$JasjBbVsIHw@wEnsp@WV+DFJ|j1
zYBstauz)&Tt&33<q0eToeJOoXOylij=jrK}76}AH!~OB@Z2R?_6%Xqb*;3~P;y!k{
zD?>Xw=DW;4tgo0)wNG?pvrP>R-N|HIygxk~j%qkT4Rp5Mp8s6><O6Cu7H5NQ9cR+~
z?nE%=havRPY}#Q-w%_h(h^K=(&ZoNvL+RvXnJ>UEL0!|ppvSAJ6z9;gowxw1YP#2N
zJ`&}V4f?Ts@lExOj^scrs^XtgBZHxVwx-F(>aRbOKDh+nRy5Wb!$X!WR6^l|+oOT%
y%~9hGHapzE*w)?DG0{GG{l?AOimybet@#@YbX>$BMo%CB0000<MNUMnLSTYorCLP*

literal 0
HcmV?d00001


From 1d03a46c54078a9d6fcf69cd472e65c305d040b4 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 12:27:38 +0200
Subject: [PATCH 005/113] docs(readme): make logo smaller as before

---
 logo.png | Bin 16831 -> 21516 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/logo.png b/logo.png
index c58c79864852b50763c2aab9106dd9ebd2290cf9..5f4888c4ba851dbfbae9dd1eb77da5e153b39048 100644
GIT binary patch
literal 21516
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
DV^9bK

literal 16831
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


From 753d82e186e7754cae42b6d47faf79214c467bb9 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 12:29:50 +0200
Subject: [PATCH 006/113] docs(readme): compress logo size

---
 logo.png | Bin 21516 -> 7987 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/logo.png b/logo.png
index 5f4888c4ba851dbfbae9dd1eb77da5e153b39048..20b4fd6b5615c2d39231e7ad991abd5ce67ebcc8 100644
GIT binary patch
literal 7987
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

literal 21516
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
DV^9bK


From 5ce686113b29d5b275bcf3a46d5896a26ec23595 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 12:46:36 +0200
Subject: [PATCH 007/113] docs(readme): add example on using vendor tool for
 version lock

---
 README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/README.md b/README.md
index e35c2f94..494cc8bf 100644
--- a/README.md
+++ b/README.md
@@ -103,6 +103,38 @@ import "github.com/gin-gonic/gin"
 import "net/http"
 ```
 
+### Use a vendor tool like [Govendor](https://github.com/kardianos/govendor)
+
+1. `go get` govendor
+
+```sh
+$ go get github.com/kardianos/govendor
+```
+2. Create your project folder and `cd` inside
+
+```sh
+$ mkdir -p ~/go/src/github.com/myusername/project && cd "$_"
+```
+
+3. Vendor init your project and add gin
+
+```sh
+$ govendor init
+$ govendor add github.com/gin-gonic/gin@v1.2
+```
+
+4. Copy a starting template inside your project
+
+```sh
+$ cp ~/go/src/github.com/gin-gonic/gin/examples/basic/* .
+```
+
+5. Run your project
+
+```sh
+$ go run main.go
+```
+
 ## API Examples
 
 ### Using GET, POST, PUT, PATCH, DELETE and OPTIONS

From 84fc31f9f8e18e44bf0be5aae6ed64b50a60a373 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 14:35:10 +0200
Subject: [PATCH 008/113] docs(readme): move contribution guide to a separate
 file

---
 CONTRIBUTING.md | 12 ++++++++++++
 README.md       | 13 -------------
 2 files changed, 12 insertions(+), 13 deletions(-)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 00000000..eaa55a32
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,12 @@
+## Contributing 
+
+- With issues:
+  - Use the search tool before opening a new issue.
+  - Please provide source code and commit sha if you found a bug.
+  - Review existing issues and provide feedback or react to them.
+- With pull requests:
+  - Open your pull request against master
+  - Your pull request should have no more than two commits, if not you should squash them.
+  - It should pass all tests in the available continuous integrations systems such as TravisCI.
+  - You should add/modify tests to cover your proposed code changes.
+  - If your pull request contains a new feature, please document it on the README.
\ No newline at end of file
diff --git a/README.md b/README.md
index 494cc8bf..2200d9d9 100644
--- a/README.md
+++ b/README.md
@@ -988,19 +988,6 @@ func main() {
 }
 ```
 
-## Contributing 
-
-- With issues:
-  - Use the search tool before opening a new issue.
-  - Please provide source code and commit sha if you found a bug.
-  - Review existing issues and provide feedback or react to them.
-- With pull requests:
-  - Open your pull request against master
-  - Your pull request should have no more than two commits, if not you should squash them.
-  - It should pass all tests in the available continuous integrations systems such as TravisCI.
-  - You should add/modify tests to cover your proposed code changes.
-  - If your pull request contains a new feature, please document it on the README.
-
 ## Users
 
 Awesome project lists using [Gin](https://github.com/gin-gonic/gin) web framework.

From 912a7df572192e140e27854a57b1ad2cf80d3037 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 16:28:37 +0200
Subject: [PATCH 009/113] docs(readme): fix step in vendor tool example

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2200d9d9..8275383d 100644
--- a/README.md
+++ b/README.md
@@ -126,7 +126,7 @@ $ govendor add github.com/gin-gonic/gin@v1.2
 4. Copy a starting template inside your project
 
 ```sh
-$ cp ~/go/src/github.com/gin-gonic/gin/examples/basic/* .
+$ curl https://raw.githubusercontent.com/gin-gonic/gin/master/examples/basic/main.go > main.go
 ```
 
 5. Run your project

From de1fdfd1e54eb09f33b3a62a1b3ad6a955847351 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 16:34:52 +0200
Subject: [PATCH 010/113] docs(readme): fix embedmd build

---
 CONTRIBUTING.md | 3 ++-
 README.md       | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index eaa55a32..4583205e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -4,9 +4,10 @@
   - Use the search tool before opening a new issue.
   - Please provide source code and commit sha if you found a bug.
   - Review existing issues and provide feedback or react to them.
+
 - With pull requests:
   - Open your pull request against master
   - Your pull request should have no more than two commits, if not you should squash them.
   - It should pass all tests in the available continuous integrations systems such as TravisCI.
   - You should add/modify tests to cover your proposed code changes.
-  - If your pull request contains a new feature, please document it on the README.
\ No newline at end of file
+  - If your pull request contains a new feature, please document it on the README.
diff --git a/README.md b/README.md
index 8275383d..8b7d9b22 100644
--- a/README.md
+++ b/README.md
@@ -120,7 +120,7 @@ $ mkdir -p ~/go/src/github.com/myusername/project && cd "$_"
 
 ```sh
 $ govendor init
-$ govendor add github.com/gin-gonic/gin@v1.2
+$ govendor fetch github.com/gin-gonic/gin@v1.2
 ```
 
 4. Copy a starting template inside your project

From 1923b3598377f53e0dd2e108e7f52761e3a69692 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Sun, 2 Jul 2017 09:41:06 -0500
Subject: [PATCH 011/113] update document format. (#964)

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
---
 CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4583205e..547b777a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -6,7 +6,7 @@
   - Review existing issues and provide feedback or react to them.
 
 - With pull requests:
-  - Open your pull request against master
+  - Open your pull request against `master`
   - Your pull request should have no more than two commits, if not you should squash them.
   - It should pass all tests in the available continuous integrations systems such as TravisCI.
   - You should add/modify tests to cover your proposed code changes.

From 89f0acc2f853be6e5af92a247e87a6d66613b819 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 16:54:49 +0200
Subject: [PATCH 012/113] docs(auth): add missing logs for auth.go

---
 auth.go | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/auth.go b/auth.go
index 125e659f..5f6d68e9 100644
--- a/auth.go
+++ b/auth.go
@@ -10,9 +10,11 @@ import (
 	"strconv"
 )
 
+// AuthUserKey is the cookie name for user credential in basic auth
 const AuthUserKey = "user"
 
 type (
+	// Accounts defines a key/value for user/pass list of authorized logins
 	Accounts map[string]string
 	authPair struct {
 		Value string

From 114b71868ab46a299c1d9daa8aa20e2f5e7018b6 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 16:59:21 +0200
Subject: [PATCH 013/113] refactor(deprecated): remove getcookie

---
 deprecated.go | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/deprecated.go b/deprecated.go
index 27e8f558..7b50dc70 100644
--- a/deprecated.go
+++ b/deprecated.go
@@ -5,14 +5,10 @@
 package gin
 
 import (
-	"github.com/gin-gonic/gin/binding"
 	"log"
-)
 
-func (c *Context) GetCookie(name string) (string, error) {
-	log.Println("GetCookie() method is deprecated. Use Cookie() instead.")
-	return c.Cookie(name)
-}
+	"github.com/gin-gonic/gin/binding"
+)
 
 // BindWith binds the passed struct pointer using the specified binding engine.
 // See the binding package.

From 484acfc30396fa215376f9c2454d1bdf14c86c29 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 17:05:21 +0200
Subject: [PATCH 014/113] docs(logger): add missing inline docs

---
 logger.go | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/logger.go b/logger.go
index dc6f1415..a03cde6f 100644
--- a/logger.go
+++ b/logger.go
@@ -25,14 +25,17 @@ var (
 	disableColor = false
 )
 
+// DisableConsoleColor disables color output in the console
 func DisableConsoleColor() {
 	disableColor = true
 }
 
+// ErrorLogger returns a handlerfunc for any error type
 func ErrorLogger() HandlerFunc {
 	return ErrorLoggerT(ErrorTypeAny)
 }
 
+// ErrorLoggerT returns a handlerfunc for a given error type
 func ErrorLoggerT(typ ErrorType) HandlerFunc {
 	return func(c *Context) {
 		c.Next()

From 92ddc7d2405b441d5fc9b64e938628dec1382759 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 2 Jul 2017 17:06:53 +0200
Subject: [PATCH 015/113] docs(test): add missing inline docs

---
 test_helpers.go | 1 +
 1 file changed, 1 insertion(+)

diff --git a/test_helpers.go b/test_helpers.go
index e7dd55f7..2aed37f2 100644
--- a/test_helpers.go
+++ b/test_helpers.go
@@ -8,6 +8,7 @@ import (
 	"net/http"
 )
 
+// CreateTestContext returns a fresh engine and context for testing purposes
 func CreateTestContext(w http.ResponseWriter) (c *Context, r *Engine) {
 	r = New()
 	c = r.allocateContext()

From f0b54a30238973ddb0bc9c9a58d8b7af038139b1 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Mon, 3 Jul 2017 00:55:21 -0500
Subject: [PATCH 016/113] fix: update autotls example. (#965)

---
 README.md                     | 2 +-
 examples/auto-tls/example2.go | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 8b7d9b22..de38839c 100644
--- a/README.md
+++ b/README.md
@@ -910,7 +910,7 @@ func main() {
 		Cache:      autocert.DirCache("/var/www/.cache"),
 	}
 
-	log.Fatal(autotls.RunWithManager(r, m))
+	log.Fatal(autotls.RunWithManager(r, &m))
 }
 ```
 
diff --git a/examples/auto-tls/example2.go b/examples/auto-tls/example2.go
index ab8b81e7..01718689 100644
--- a/examples/auto-tls/example2.go
+++ b/examples/auto-tls/example2.go
@@ -22,5 +22,5 @@ func main() {
 		Cache:      autocert.DirCache("/var/www/.cache"),
 	}
 
-	log.Fatal(autotls.RunWithManager(r, m))
+	log.Fatal(autotls.RunWithManager(r, &m))
 }

From df67c644795eaa050b378df62129eb08bd98d0ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Tue, 4 Jul 2017 10:08:41 +0800
Subject: [PATCH 017/113] fix cleanPath spell (#969)

---
 path.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/path.go b/path.go
index d7e7458b..e3424b13 100644
--- a/path.go
+++ b/path.go
@@ -5,7 +5,7 @@
 
 package gin
 
-// CleanPath is the URL version of path.Clean, it returns a canonical URL path
+// cleanPath is the URL version of path.Clean, it returns a canonical URL path
 // for p, eliminating . and .. elements.
 //
 // The following rules are applied iteratively until no further processing can

From baf216e1675df21daf66e4b9e904e13116f09a35 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Tue, 4 Jul 2017 03:12:29 -0500
Subject: [PATCH 018/113] add error check. (#972)

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
---
 examples/upload-file/multiple/main.go | 18 +++++++++++++++---
 examples/upload-file/single/main.go   | 18 +++++++++++++++---
 2 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/examples/upload-file/multiple/main.go b/examples/upload-file/multiple/main.go
index 2f4e9b52..22588348 100644
--- a/examples/upload-file/multiple/main.go
+++ b/examples/upload-file/multiple/main.go
@@ -17,16 +17,28 @@ func main() {
 		email := c.PostForm("email")
 
 		// Multipart form
-		form, _ := c.MultipartForm()
+		form, err := c.MultipartForm()
+		if err != nil {
+			c.String(http.StatusBadRequest, fmt.Sprintf("get form err: %s", err.Error()))
+			return
+		}
 		files := form.File["files"]
 
 		for _, file := range files {
 			// Source
-			src, _ := file.Open()
+			src, err := file.Open()
+			if err != nil {
+				c.String(http.StatusBadRequest, fmt.Sprintf("file open err: %s", err.Error()))
+				return
+			}
 			defer src.Close()
 
 			// Destination
-			dst, _ := os.Create(file.Filename)
+			dst, err := os.Create(file.Filename)
+			if err != nil {
+				c.String(http.StatusBadRequest, fmt.Sprintf("Create file err: %s", err.Error()))
+				return
+			}
 			defer dst.Close()
 
 			// Copy
diff --git a/examples/upload-file/single/main.go b/examples/upload-file/single/main.go
index 9acf5009..1e9596cb 100644
--- a/examples/upload-file/single/main.go
+++ b/examples/upload-file/single/main.go
@@ -17,12 +17,24 @@ func main() {
 		email := c.PostForm("email")
 
 		// Source
-		file, _ := c.FormFile("file")
-		src, _ := file.Open()
+		file, err := c.FormFile("file")
+		if err != nil {
+			c.String(http.StatusBadRequest, fmt.Sprintf("get form err: %s", err.Error()))
+			return
+		}
+		src, err := file.Open()
+		if err != nil {
+			c.String(http.StatusBadRequest, fmt.Sprintf("file open err: %s", err.Error()))
+			return
+		}
 		defer src.Close()
 
 		// Destination
-		dst, _ := os.Create(file.Filename)
+		dst, err := os.Create(file.Filename)
+		if err != nil {
+			c.String(http.StatusBadRequest, fmt.Sprintf("Create file err: %s", err.Error()))
+			return
+		}
 		defer dst.Close()
 
 		// Copy

From ecf1b37850461f680d48ba1cd1351e79b26f742a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Tue, 4 Jul 2017 16:17:54 +0800
Subject: [PATCH 019/113] add doc.go (#970)

---
 doc.go | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 doc.go

diff --git a/doc.go b/doc.go
new file mode 100644
index 00000000..01ac4a90
--- /dev/null
+++ b/doc.go
@@ -0,0 +1,6 @@
+/*
+Package gin implements a HTTP web framework called gin.
+
+See https://gin-gonic.github.io/gin/ for more information about gin.
+*/
+package gin // import "github.com/gin-gonic/gin"

From 735748b359cee5e7f7597128580f6f94bbc0987f Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Tue, 4 Jul 2017 16:36:12 +0800
Subject: [PATCH 020/113] fix(tests): TestDebugPrintLoadTemplate use
 assert.Regep instead of assert.Equal (#973)

---
 debug_test.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/debug_test.go b/debug_test.go
index c30081c5..2b010858 100644
--- a/debug_test.go
+++ b/debug_test.go
@@ -74,7 +74,7 @@ func TestDebugPrintLoadTemplate(t *testing.T) {
 
 	templ := template.Must(template.New("").Delims("{[{", "}]}").ParseGlob("./fixtures/basic/hello.tmpl"))
 	debugPrintLoadTemplate(templ)
-	assert.Equal(t, w.String(), "[GIN-debug] Loaded HTML Templates (2): \n\t- \n\t- hello.tmpl\n\n")
+	assert.Regexp(t, `^\[GIN-debug\] Loaded HTML Templates \(2\): \n(\t- \n|\t- hello\.tmpl\n){2}\n`, w.String())
 }
 
 func TestDebugPrintWARNINGSetHTMLTemplate(t *testing.T) {

From 7d043cedb1ba33756ae9b69fa554a3062bff70d6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Wed, 5 Jul 2017 09:55:50 +0800
Subject: [PATCH 021/113] improved swap (#974)

---
 tree.go | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/tree.go b/tree.go
index a39f43bf..55eab99e 100644
--- a/tree.go
+++ b/tree.go
@@ -105,9 +105,7 @@ func (n *node) incrementChildPrio(pos int) int {
 	newPos := pos
 	for newPos > 0 && n.children[newPos-1].priority < prio {
 		// swap node positions
-		tmpN := n.children[newPos-1]
-		n.children[newPos-1] = n.children[newPos]
-		n.children[newPos] = tmpN
+		n.children[newPos-1], n.children[newPos] = n.children[newPos], n.children[newPos-1]
 
 		newPos--
 	}

From 22fc0284e3ae2101f44e8188dde8cad797ce51e6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Wed, 5 Jul 2017 10:42:56 +0800
Subject: [PATCH 022/113] update readme (#976)

---
 README.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index de38839c..80158c8f 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,8 @@ Gin is a web framework written in Go (Golang). It features a martini-like API wi
 ![Gin console logger](https://gin-gonic.github.io/gin/other/console.png)
 
 ```sh
-$ cat test.go
+# assume the following codes in example.go file
+$ cat example.go
 ```
 
 ```go
@@ -32,6 +33,11 @@ func main() {
 }
 ```
 
+```
+# run example.go and visit 0.0.0.0:8080/ping on browser
+$ go run example.go
+```
+
 ## Benchmarks
 
 Gin uses a custom version of [HttpRouter](https://github.com/julienschmidt/httprouter)  

From d535fcd59842094ea88307eafc48bc163c6a2f35 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Wed, 5 Jul 2017 15:47:36 +0800
Subject: [PATCH 023/113] separate type define (#975)

---
 auth.go            |  18 ++++----
 errors.go          |  14 +++---
 fs.go              |  15 +++----
 gin.go             | 109 ++++++++++++++++++++++-----------------------
 response_writer.go |  46 +++++++++----------
 routergroup.go     |  56 +++++++++++------------
 6 files changed, 125 insertions(+), 133 deletions(-)

diff --git a/auth.go b/auth.go
index 5f6d68e9..410fe5cc 100644
--- a/auth.go
+++ b/auth.go
@@ -13,15 +13,15 @@ import (
 // AuthUserKey is the cookie name for user credential in basic auth
 const AuthUserKey = "user"
 
-type (
-	// Accounts defines a key/value for user/pass list of authorized logins
-	Accounts map[string]string
-	authPair struct {
-		Value string
-		User  string
-	}
-	authPairs []authPair
-)
+// Accounts defines a key/value for user/pass list of authorized logins
+type Accounts map[string]string
+
+type authPair struct {
+	Value string
+	User  string
+}
+
+type authPairs []authPair
 
 func (a authPairs) searchCredential(authValue string) (string, bool) {
 	if len(authValue) == 0 {
diff --git a/errors.go b/errors.go
index 896af6fc..599d458a 100644
--- a/errors.go
+++ b/errors.go
@@ -23,15 +23,13 @@ const (
 	ErrorTypeNu            = 2
 )
 
-type (
-	Error struct {
-		Err  error
-		Type ErrorType
-		Meta interface{}
-	}
+type Error struct {
+	Err  error
+	Type ErrorType
+	Meta interface{}
+}
 
-	errorMsgs []*Error
-)
+type errorMsgs []*Error
 
 var _ error = &Error{}
 
diff --git a/fs.go b/fs.go
index 12645826..c1693dd5 100644
--- a/fs.go
+++ b/fs.go
@@ -9,14 +9,13 @@ import (
 	"os"
 )
 
-type (
-	onlyfilesFS struct {
-		fs http.FileSystem
-	}
-	neuteredReaddirFile struct {
-		http.File
-	}
-)
+type onlyfilesFS struct {
+	fs http.FileSystem
+}
+
+type neuteredReaddirFile struct {
+	http.File
+}
 
 // Dir returns a http.Filesystem that can be used by http.FileServer(). It is used internally
 // in router.Static().
diff --git a/gin.go b/gin.go
index c4118a4e..e7b1fc15 100644
--- a/gin.go
+++ b/gin.go
@@ -33,67 +33,66 @@ func (c HandlersChain) Last() HandlerFunc {
 	return nil
 }
 
-type (
-	RoutesInfo []RouteInfo
-	RouteInfo  struct {
-		Method  string
-		Path    string
-		Handler string
-	}
+type RouteInfo struct {
+	Method  string
+	Path    string
+	Handler string
+}
 
-	// Engine is the framework's instance, it contains the muxer, middleware and configuration settings.
-	// Create an instance of Engine, by using New() or Default()
-	Engine struct {
-		RouterGroup
-		delims      render.Delims
-		HTMLRender  render.HTMLRender
-		FuncMap     template.FuncMap
-		allNoRoute  HandlersChain
-		allNoMethod HandlersChain
-		noRoute     HandlersChain
-		noMethod    HandlersChain
-		pool        sync.Pool
-		trees       methodTrees
+type RoutesInfo []RouteInfo
 
-		// Enables automatic redirection if the current route can't be matched but a
-		// handler for the path with (without) the trailing slash exists.
-		// For example if /foo/ is requested but a route only exists for /foo, the
-		// client is redirected to /foo with http status code 301 for GET requests
-		// and 307 for all other request methods.
-		RedirectTrailingSlash bool
+// Engine is the framework's instance, it contains the muxer, middleware and configuration settings.
+// Create an instance of Engine, by using New() or Default()
+type Engine struct {
+	RouterGroup
+	delims      render.Delims
+	HTMLRender  render.HTMLRender
+	FuncMap     template.FuncMap
+	allNoRoute  HandlersChain
+	allNoMethod HandlersChain
+	noRoute     HandlersChain
+	noMethod    HandlersChain
+	pool        sync.Pool
+	trees       methodTrees
 
-		// If enabled, the router tries to fix the current request path, if no
-		// handle is registered for it.
-		// First superfluous path elements like ../ or // are removed.
-		// Afterwards the router does a case-insensitive lookup of the cleaned path.
-		// If a handle can be found for this route, the router makes a redirection
-		// to the corrected path with status code 301 for GET requests and 307 for
-		// all other request methods.
-		// For example /FOO and /..//Foo could be redirected to /foo.
-		// RedirectTrailingSlash is independent of this option.
-		RedirectFixedPath bool
+	// Enables automatic redirection if the current route can't be matched but a
+	// handler for the path with (without) the trailing slash exists.
+	// For example if /foo/ is requested but a route only exists for /foo, the
+	// client is redirected to /foo with http status code 301 for GET requests
+	// and 307 for all other request methods.
+	RedirectTrailingSlash bool
 
-		// If enabled, the router checks if another method is allowed for the
-		// current route, if the current request can not be routed.
-		// If this is the case, the request is answered with 'Method Not Allowed'
-		// and HTTP status code 405.
-		// If no other Method is allowed, the request is delegated to the NotFound
-		// handler.
-		HandleMethodNotAllowed bool
-		ForwardedByClientIP    bool
+	// If enabled, the router tries to fix the current request path, if no
+	// handle is registered for it.
+	// First superfluous path elements like ../ or // are removed.
+	// Afterwards the router does a case-insensitive lookup of the cleaned path.
+	// If a handle can be found for this route, the router makes a redirection
+	// to the corrected path with status code 301 for GET requests and 307 for
+	// all other request methods.
+	// For example /FOO and /..//Foo could be redirected to /foo.
+	// RedirectTrailingSlash is independent of this option.
+	RedirectFixedPath bool
 
-		// #726 #755 If enabled, it will thrust some headers starting with
-		// 'X-AppEngine...' for better integration with that PaaS.
-		AppEngine bool
+	// If enabled, the router checks if another method is allowed for the
+	// current route, if the current request can not be routed.
+	// If this is the case, the request is answered with 'Method Not Allowed'
+	// and HTTP status code 405.
+	// If no other Method is allowed, the request is delegated to the NotFound
+	// handler.
+	HandleMethodNotAllowed bool
+	ForwardedByClientIP    bool
 
-		// If enabled, the url.RawPath will be used to find parameters.
-		UseRawPath bool
-		// If true, the path value will be unescaped.
-		// If UseRawPath is false (by default), the UnescapePathValues effectively is true,
-		// as url.Path gonna be used, which is already unescaped.
-		UnescapePathValues bool
-	}
-)
+	// #726 #755 If enabled, it will thrust some headers starting with
+	// 'X-AppEngine...' for better integration with that PaaS.
+	AppEngine bool
+
+	// If enabled, the url.RawPath will be used to find parameters.
+	UseRawPath bool
+	// If true, the path value will be unescaped.
+	// If UseRawPath is false (by default), the UnescapePathValues effectively is true,
+	// as url.Path gonna be used, which is already unescaped.
+	UnescapePathValues bool
+}
 
 var _ IRouter = &Engine{}
 
diff --git a/response_writer.go b/response_writer.go
index fcbe230d..c9d07c33 100644
--- a/response_writer.go
+++ b/response_writer.go
@@ -16,36 +16,34 @@ const (
 	defaultStatus = 200
 )
 
-type (
-	ResponseWriter interface {
-		http.ResponseWriter
-		http.Hijacker
-		http.Flusher
-		http.CloseNotifier
+type ResponseWriter interface {
+	http.ResponseWriter
+	http.Hijacker
+	http.Flusher
+	http.CloseNotifier
 
-		// Returns the HTTP response status code of the current request.
-		Status() int
+	// Returns the HTTP response status code of the current request.
+	Status() int
 
-		// Returns the number of bytes already written into the response http body.
-		// See Written()
-		Size() int
+	// Returns the number of bytes already written into the response http body.
+	// See Written()
+	Size() int
 
-		// Writes the string into the response body.
-		WriteString(string) (int, error)
+	// Writes the string into the response body.
+	WriteString(string) (int, error)
 
-		// Returns true if the response body was already written.
-		Written() bool
+	// Returns true if the response body was already written.
+	Written() bool
 
-		// Forces to write the http header (status code + headers).
-		WriteHeaderNow()
-	}
+	// Forces to write the http header (status code + headers).
+	WriteHeaderNow()
+}
 
-	responseWriter struct {
-		http.ResponseWriter
-		size   int
-		status int
-	}
-)
+type responseWriter struct {
+	http.ResponseWriter
+	size   int
+	status int
+}
 
 var _ ResponseWriter = &responseWriter{}
 
diff --git a/routergroup.go b/routergroup.go
index f22729bb..89ec89aa 100644
--- a/routergroup.go
+++ b/routergroup.go
@@ -11,39 +11,37 @@ import (
 	"strings"
 )
 
-type (
-	IRouter interface {
-		IRoutes
-		Group(string, ...HandlerFunc) *RouterGroup
-	}
+type IRouter interface {
+	IRoutes
+	Group(string, ...HandlerFunc) *RouterGroup
+}
 
-	IRoutes interface {
-		Use(...HandlerFunc) IRoutes
+type IRoutes interface {
+	Use(...HandlerFunc) IRoutes
 
-		Handle(string, string, ...HandlerFunc) IRoutes
-		Any(string, ...HandlerFunc) IRoutes
-		GET(string, ...HandlerFunc) IRoutes
-		POST(string, ...HandlerFunc) IRoutes
-		DELETE(string, ...HandlerFunc) IRoutes
-		PATCH(string, ...HandlerFunc) IRoutes
-		PUT(string, ...HandlerFunc) IRoutes
-		OPTIONS(string, ...HandlerFunc) IRoutes
-		HEAD(string, ...HandlerFunc) IRoutes
+	Handle(string, string, ...HandlerFunc) IRoutes
+	Any(string, ...HandlerFunc) IRoutes
+	GET(string, ...HandlerFunc) IRoutes
+	POST(string, ...HandlerFunc) IRoutes
+	DELETE(string, ...HandlerFunc) IRoutes
+	PATCH(string, ...HandlerFunc) IRoutes
+	PUT(string, ...HandlerFunc) IRoutes
+	OPTIONS(string, ...HandlerFunc) IRoutes
+	HEAD(string, ...HandlerFunc) IRoutes
 
-		StaticFile(string, string) IRoutes
-		Static(string, string) IRoutes
-		StaticFS(string, http.FileSystem) IRoutes
-	}
+	StaticFile(string, string) IRoutes
+	Static(string, string) IRoutes
+	StaticFS(string, http.FileSystem) IRoutes
+}
 
-	// RouterGroup is used internally to configure router, a RouterGroup is associated with a prefix
-	// and an array of handlers (middleware)
-	RouterGroup struct {
-		Handlers HandlersChain
-		basePath string
-		engine   *Engine
-		root     bool
-	}
-)
+// RouterGroup is used internally to configure router, a RouterGroup is associated with a prefix
+// and an array of handlers (middleware)
+type RouterGroup struct {
+	Handlers HandlersChain
+	basePath string
+	engine   *Engine
+	root     bool
+}
 
 var _ IRouter = &RouterGroup{}
 

From 31ac11a29891bf2d7c2da20054507f3fb5350a25 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Wed, 5 Jul 2017 17:37:24 +0800
Subject: [PATCH 024/113] update comment method (#977)

---
 auth.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/auth.go b/auth.go
index 410fe5cc..7ebf5576 100644
--- a/auth.go
+++ b/auth.go
@@ -89,6 +89,6 @@ func secureCompare(given, actual string) bool {
 	if subtle.ConstantTimeEq(int32(len(given)), int32(len(actual))) == 1 {
 		return subtle.ConstantTimeCompare([]byte(given), []byte(actual)) == 1
 	}
-	/* Securely compare actual to itself to keep constant time, but always return false */
+	// Securely compare actual to itself to keep constant time, but always return false
 	return subtle.ConstantTimeCompare([]byte(actual), []byte(actual)) == 1 && false
 }

From 2a36eefcffe31ad16d9b27fdc64c083e246e80f0 Mon Sep 17 00:00:00 2001
From: thinkerou <thinkerou@gmail.com>
Date: Wed, 5 Jul 2017 20:37:28 +0800
Subject: [PATCH 025/113] add test case of mode

---
 mode_test.go | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/mode_test.go b/mode_test.go
index 2a23d85e..bf6a5a1a 100644
--- a/mode_test.go
+++ b/mode_test.go
@@ -5,6 +5,7 @@
 package gin
 
 import (
+	"os"
 	"testing"
 
 	"github.com/stretchr/testify/assert"
@@ -28,4 +29,9 @@ func TestSetMode(t *testing.T) {
 	assert.Equal(t, Mode(), TestMode)
 
 	assert.Panics(t, func() { SetMode("unknown") })
+
+	os.Setenv(ENV_GIN_MODE, DebugMode)
+	assert.Equal(t, ginMode, debugCode)
+	assert.Equal(t, Mode(), DebugMode)
+	os.Unsetenv(ENV_GIN_MODE)
 }

From f843c333702ca0c52b6170b34b5b514f7e530521 Mon Sep 17 00:00:00 2001
From: thinkerou <thinkerou@gmail.com>
Date: Wed, 5 Jul 2017 21:05:02 +0800
Subject: [PATCH 026/113] add test case of mode

---
 mode_test.go | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/mode_test.go b/mode_test.go
index bf6a5a1a..0a9cbc3c 100644
--- a/mode_test.go
+++ b/mode_test.go
@@ -12,10 +12,14 @@ import (
 )
 
 func init() {
-	SetMode(TestMode)
+	os.Setenv(ENV_GIN_MODE, TestMode)
 }
 
 func TestSetMode(t *testing.T) {
+	assert.Equal(t, ginMode, testCode)
+	assert.Equal(t, Mode(), TestMode)
+	os.Unsetenv(ENV_GIN_MODE)
+
 	SetMode(DebugMode)
 	assert.Equal(t, ginMode, debugCode)
 	assert.Equal(t, Mode(), DebugMode)
@@ -29,9 +33,4 @@ func TestSetMode(t *testing.T) {
 	assert.Equal(t, Mode(), TestMode)
 
 	assert.Panics(t, func() { SetMode("unknown") })
-
-	os.Setenv(ENV_GIN_MODE, DebugMode)
-	assert.Equal(t, ginMode, debugCode)
-	assert.Equal(t, Mode(), DebugMode)
-	os.Unsetenv(ENV_GIN_MODE)
 }

From ee7b912a242e84896be96b3d921354a9b6cc6950 Mon Sep 17 00:00:00 2001
From: Regner Blok-Andersen <shadowdf@gmail.com>
Date: Wed, 5 Jul 2017 07:17:03 -0700
Subject: [PATCH 027/113] Updating IsDebugging docs to remove redudent words.
 (#868)

---
 debug.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/debug.go b/debug.go
index a121591a..b31ca685 100644
--- a/debug.go
+++ b/debug.go
@@ -15,7 +15,7 @@ func init() {
 }
 
 // IsDebugging returns true if the framework is running in debug mode.
-// Use SetMode(gin.Release) to switch to disable the debug mode.
+// Use SetMode(gin.Release) to disable debug mode.
 func IsDebugging() bool {
 	return ginMode == debugCode
 }

From e4fd80c627c9a63247373a5818f0628cb5ccc103 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Wed, 5 Jul 2017 16:22:58 +0200
Subject: [PATCH 028/113] docs(readme): add sections to template docs

---
 README.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 80158c8f..ecba6662 100644
--- a/README.md
+++ b/README.md
@@ -645,6 +645,8 @@ templates/users/index.tmpl
 {{ end }}
 ```
 
+#### Custom Template renderer
+
 You can also use your own html template render
 
 ```go
@@ -658,6 +660,8 @@ func main() {
 }
 ```
 
+#### Custom Delimiters
+
 You may use custom delims
 
 ```go
@@ -666,7 +670,7 @@ You may use custom delims
 	r.LoadHTMLGlob("/path/to/templates"))
 ```  
 
-#### Add custom template funcs
+#### Custom Template Funcs
 
 main.go
 

From 71d3ae4f922f4d674bc4760b9b9eb290b645fb55 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Wed, 5 Jul 2017 22:50:33 +0800
Subject: [PATCH 029/113] fix(comment): remove todo

---
 gin.go | 1 -
 1 file changed, 1 deletion(-)

diff --git a/gin.go b/gin.go
index e7b1fc15..92a41449 100644
--- a/gin.go
+++ b/gin.go
@@ -345,7 +345,6 @@ func (engine *Engine) handleHTTPRequest(context *Context) {
 		}
 	}
 
-	// TODO: unit test
 	if engine.HandleMethodNotAllowed {
 		for _, tree := range engine.trees {
 			if tree.method != httpMethod {

From 42a34cdc35f72b6b146f48242c52a875bf698dcb Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Wed, 5 Jul 2017 16:55:59 +0200
Subject: [PATCH 030/113] docs(context): document keys, errors, and accepted,
 close #488

---
 context.go | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/context.go b/context.go
index 5196bb13..d8c9af08 100644
--- a/context.go
+++ b/context.go
@@ -48,9 +48,15 @@ type Context struct {
 	handlers HandlersChain
 	index    int8
 
-	engine   *Engine
-	Keys     map[string]interface{}
-	Errors   errorMsgs
+	engine *Engine
+
+	// Keys is a key/value pair exclusively for the context of each request
+	Keys map[string]interface{}
+
+	// Errors is a list of errors attached to all the handlers/middlewares who used this context
+	Errors errorMsgs
+
+	// Accepted defines a list of manually accepted formats for content negotiation
 	Accepted []string
 }
 

From 22ee916dfecdaabe7b541b7f76bdc8c64e99c145 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Wed, 5 Jul 2017 18:25:37 +0200
Subject: [PATCH 031/113] docs(conduct): add code of conduct

---
 CODE_OF_CONDUCT.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 CODE_OF_CONDUCT.md

diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
new file mode 100644
index 00000000..4ea14f39
--- /dev/null
+++ b/CODE_OF_CONDUCT.md
@@ -0,0 +1,46 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at teamgingonic@gmail.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

From b985857899c60f029f73331b81ce281a25724f94 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Thu, 6 Jul 2017 09:28:16 +0800
Subject: [PATCH 032/113] update func comment (#981)

---
 context.go         |  2 +-
 errors.go          | 11 +++++------
 fs.go              |  4 ++--
 gin.go             |  4 ++--
 response_writer.go |  6 +++---
 tree.go            |  4 ++--
 6 files changed, 15 insertions(+), 16 deletions(-)

diff --git a/context.go b/context.go
index d8c9af08..2134b8fe 100644
--- a/context.go
+++ b/context.go
@@ -151,7 +151,7 @@ func (c *Context) AbortWithError(code int, err error) *Error {
 /********* ERROR MANAGEMENT *********/
 /************************************/
 
-// Attaches an error to the current context. The error is pushed to a list of errors.
+// Error attaches an error to the current context. The error is pushed to a list of errors.
 // It's a good idea to call Error for each error that occurred during the resolution of a request.
 // A middleware can be used to collect all the errors
 // and push them to a database together, print a log, or append it in the HTTP response.
diff --git a/errors.go b/errors.go
index 599d458a..f38d3ff1 100644
--- a/errors.go
+++ b/errors.go
@@ -69,7 +69,7 @@ func (msg *Error) MarshalJSON() ([]byte, error) {
 	return json.Marshal(msg.JSON())
 }
 
-// Implements the error interface
+// Error implements the error interface
 func (msg Error) Error() string {
 	return msg.Err.Error()
 }
@@ -78,7 +78,7 @@ func (msg *Error) IsType(flags ErrorType) bool {
 	return (msg.Type & flags) > 0
 }
 
-// Returns a readonly copy filtered the byte.
+// ByType returns a readonly copy filtered the byte.
 // ie ByType(gin.ErrorTypePublic) returns a slice of errors with type=ErrorTypePublic
 func (a errorMsgs) ByType(typ ErrorType) errorMsgs {
 	if len(a) == 0 {
@@ -96,17 +96,16 @@ func (a errorMsgs) ByType(typ ErrorType) errorMsgs {
 	return result
 }
 
-// Returns the last error in the slice. It returns nil if the array is empty.
+// Last returns the last error in the slice. It returns nil if the array is empty.
 // Shortcut for errors[len(errors)-1]
 func (a errorMsgs) Last() *Error {
-	length := len(a)
-	if length > 0 {
+	if length := len(a); length > 0 {
 		return a[length-1]
 	}
 	return nil
 }
 
-// Returns an array will all the error messages.
+// Errors returns an array will all the error messages.
 // Example:
 // 		c.Error(errors.New("first"))
 // 		c.Error(errors.New("second"))
diff --git a/fs.go b/fs.go
index c1693dd5..8570a9a9 100644
--- a/fs.go
+++ b/fs.go
@@ -29,7 +29,7 @@ func Dir(root string, listDirectory bool) http.FileSystem {
 	return &onlyfilesFS{fs}
 }
 
-// Conforms to http.Filesystem
+// Open conforms to http.Filesystem
 func (fs onlyfilesFS) Open(name string) (http.File, error) {
 	f, err := fs.fs.Open(name)
 	if err != nil {
@@ -38,7 +38,7 @@ func (fs onlyfilesFS) Open(name string) (http.File, error) {
 	return neuteredReaddirFile{f}, nil
 }
 
-// Overrides the http.File default implementation
+// Readdir overrides the http.File default implementation
 func (f neuteredReaddirFile) Readdir(count int) ([]os.FileInfo, error) {
 	// this disables directory listing
 	return nil, nil
diff --git a/gin.go b/gin.go
index 92a41449..ca8d75e9 100644
--- a/gin.go
+++ b/gin.go
@@ -285,7 +285,7 @@ func (engine *Engine) RunUnix(file string) (err error) {
 	return
 }
 
-// Conforms to the http.Handler interface.
+// ServeHTTP conforms to the http.Handler interface.
 func (engine *Engine) ServeHTTP(w http.ResponseWriter, req *http.Request) {
 	c := engine.pool.Get().(*Context)
 	c.writermem.reset(w)
@@ -297,7 +297,7 @@ func (engine *Engine) ServeHTTP(w http.ResponseWriter, req *http.Request) {
 	engine.pool.Put(c)
 }
 
-// Re-enter a context that has been rewritten.
+// HandleContext re-enter a context that has been rewritten.
 // This can be done by setting c.Request.Path to your new target.
 // Disclaimer: You can loop yourself to death with this, use wisely.
 func (engine *Engine) HandleContext(c *Context) {
diff --git a/response_writer.go b/response_writer.go
index c9d07c33..216165b9 100644
--- a/response_writer.go
+++ b/response_writer.go
@@ -95,7 +95,7 @@ func (w *responseWriter) Written() bool {
 	return w.size != noWritten
 }
 
-// Implements the http.Hijacker interface
+// Hijack implements the http.Hijacker interface
 func (w *responseWriter) Hijack() (net.Conn, *bufio.ReadWriter, error) {
 	if w.size < 0 {
 		w.size = 0
@@ -103,12 +103,12 @@ func (w *responseWriter) Hijack() (net.Conn, *bufio.ReadWriter, error) {
 	return w.ResponseWriter.(http.Hijacker).Hijack()
 }
 
-// Implements the http.CloseNotify interface
+// CloseNotify implements the http.CloseNotify interface
 func (w *responseWriter) CloseNotify() <-chan bool {
 	return w.ResponseWriter.(http.CloseNotifier).CloseNotify()
 }
 
-// Implements the http.Flush interface
+// Flush implements the http.Flush interface
 func (w *responseWriter) Flush() {
 	w.ResponseWriter.(http.Flusher).Flush()
 }
diff --git a/tree.go b/tree.go
index 55eab99e..750ffae8 100644
--- a/tree.go
+++ b/tree.go
@@ -357,7 +357,7 @@ func (n *node) insertChild(numParams uint8, path string, fullPath string, handle
 	n.handlers = handlers
 }
 
-// Returns the handle registered with the given path (key). The values of
+// getValue returns the handle registered with the given path (key). The values of
 // wildcards are saved to a map.
 // If no handle can be found, a TSR (trailing slash redirect) recommendation is
 // made if a handle exists with an extra (without the) trailing slash for the
@@ -499,7 +499,7 @@ walk: // Outer loop for walking the tree
 	}
 }
 
-// Makes a case-insensitive lookup of the given path and tries to find a handler.
+// findCaseInsensitivePath makes a case-insensitive lookup of the given path and tries to find a handler.
 // It can optionally also fix trailing slashes.
 // It returns the case-corrected path and a bool indicating whether the lookup
 // was successful.

From 436d8e2af9198f5548a73cb96dbeb1cede403a5b Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Thu, 6 Jul 2017 09:30:09 +0800
Subject: [PATCH 033/113] Improve serveError code coverage (#980)

---
 routes_test.go | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/routes_test.go b/routes_test.go
index 7464d5d0..41693eed 100644
--- a/routes_test.go
+++ b/routes_test.go
@@ -439,3 +439,15 @@ func TestRouteRawPathNoUnescape(t *testing.T) {
 	w := performRequest(route, "POST", "/project/Some%2FOther%2FProject/build/333")
 	assert.Equal(t, w.Code, 200)
 }
+
+func TestRouteServeErrorWithWriteHeader(t *testing.T) {
+	route := New()
+	route.Use(func(c *Context) {
+		c.Status(421)
+		c.Next()
+	})
+
+	w := performRequest(route, "GET", "/NotFound")
+	assert.Equal(t, 421, w.Code)
+	assert.Equal(t, 0, w.Body.Len())
+}

From ff5788bfdd513e659ee15db712a65370db4eb6ab Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Thu, 6 Jul 2017 08:41:27 +0200
Subject: [PATCH 034/113] docs(readme): upload full size logo

---
 README.md |   2 +-
 logo.png  | Bin 7987 -> 87064 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index ecba6662..191546fa 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Gin Web Framework
 
-<img align="right" src="https://raw.githubusercontent.com/gin-gonic/gin/master/logo.png">
+<img align="right" width="159px" src="https://raw.githubusercontent.com/gin-gonic/gin/master/logo.png">
 
 [![Build Status](https://travis-ci.org/gin-gonic/gin.svg)](https://travis-ci.org/gin-gonic/gin)
  [![codecov](https://codecov.io/gh/gin-gonic/gin/branch/master/graph/badge.svg)](https://codecov.io/gh/gin-gonic/gin)
diff --git a/logo.png b/logo.png
index 20b4fd6b5615c2d39231e7ad991abd5ce67ebcc8..7942ad563f911cf8e828e140c549e1f7f7c34b8c 100644
GIT binary patch
literal 87064
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

literal 7987
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


From 7387ef60bec9d9d68e36127896075391431bb343 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Thu, 6 Jul 2017 08:53:48 +0200
Subject: [PATCH 035/113] docs(readme): add badge for projects who use gin

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 191546fa..fcf3b8cf 100644
--- a/README.md
+++ b/README.md
@@ -998,7 +998,7 @@ func main() {
 }
 ```
 
-## Users
+## Users  [![Sourcegraph](https://sourcegraph.com/github.com/gin-gonic/gin/-/badge.svg)](https://sourcegraph.com/github.com/gin-gonic/gin?badge)
 
 Awesome project lists using [Gin](https://github.com/gin-gonic/gin) web framework.
 

From 34e972e15545847386a54f9268141cd3a789170a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Thu, 6 Jul 2017 20:59:27 +0800
Subject: [PATCH 036/113] Separate type define (#983)

---
 render/html.go | 46 ++++++++++++++++++++++------------------------
 render/json.go | 14 ++++++--------
 2 files changed, 28 insertions(+), 32 deletions(-)

diff --git a/render/html.go b/render/html.go
index cf91219c..332d3ba2 100644
--- a/render/html.go
+++ b/render/html.go
@@ -9,34 +9,32 @@ import (
 	"net/http"
 )
 
-type (
-	Delims struct {
-		Left  string
-		Right string
-	}
+type Delims struct {
+	Left  string
+	Right string
+}
 
-	HTMLRender interface {
-		Instance(string, interface{}) Render
-	}
+type HTMLRender interface {
+	Instance(string, interface{}) Render
+}
 
-	HTMLProduction struct {
-		Template *template.Template
-		Delims   Delims
-	}
+type HTMLProduction struct {
+	Template *template.Template
+	Delims   Delims
+}
 
-	HTMLDebug struct {
-		Files   []string
-		Glob    string
-		Delims  Delims
-		FuncMap template.FuncMap
-	}
+type HTMLDebug struct {
+	Files   []string
+	Glob    string
+	Delims  Delims
+	FuncMap template.FuncMap
+}
 
-	HTML struct {
-		Template *template.Template
-		Name     string
-		Data     interface{}
-	}
-)
+type HTML struct {
+	Template *template.Template
+	Name     string
+	Data     interface{}
+}
 
 var htmlContentType = []string{"text/html; charset=utf-8"}
 
diff --git a/render/json.go b/render/json.go
index 3ee8b132..4e3b66b2 100644
--- a/render/json.go
+++ b/render/json.go
@@ -9,15 +9,13 @@ import (
 	"net/http"
 )
 
-type (
-	JSON struct {
-		Data interface{}
-	}
+type JSON struct {
+	Data interface{}
+}
 
-	IndentedJSON struct {
-		Data interface{}
-	}
-)
+type IndentedJSON struct {
+	Data interface{}
+}
 
 var jsonContentType = []string{"application/json; charset=utf-8"}
 

From e0fd6238d3cb237d3eb4c3d13792caa265ecdf29 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Thu, 6 Jul 2017 22:49:54 +0800
Subject: [PATCH 037/113] use comma ok and use single line (#984)

---
 context.go | 10 +---------
 gin.go     |  3 +--
 2 files changed, 2 insertions(+), 11 deletions(-)

diff --git a/context.go b/context.go
index 2134b8fe..604dc4ef 100644
--- a/context.go
+++ b/context.go
@@ -562,15 +562,7 @@ func (c *Context) GetRawData() ([]byte, error) {
 	return ioutil.ReadAll(c.Request.Body)
 }
 
-func (c *Context) SetCookie(
-	name string,
-	value string,
-	maxAge int,
-	path string,
-	domain string,
-	secure bool,
-	httpOnly bool,
-) {
+func (c *Context) SetCookie(name, value string, maxAge int, path, domain string, secure, httpOnly bool) {
 	if path == "" {
 		path = "/"
 	}
diff --git a/gin.go b/gin.go
index ca8d75e9..3cac936c 100644
--- a/gin.go
+++ b/gin.go
@@ -26,8 +26,7 @@ type HandlersChain []HandlerFunc
 
 // Last returns the last handler in the chain. ie. the last handler is the main own.
 func (c HandlersChain) Last() HandlerFunc {
-	length := len(c)
-	if length > 0 {
+	if length := len(c); length > 0 {
 		return c[length-1]
 	}
 	return nil

From 7eb943e70aa5d526ad61d6a6ab576ef01bcf29c8 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Fri, 7 Jul 2017 08:43:47 +0800
Subject: [PATCH 038/113] Use single line (#985)

---
 utils.go | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/utils.go b/utils.go
index 18064fb5..968570c7 100644
--- a/utils.go
+++ b/utils.go
@@ -100,12 +100,10 @@ func parseAccept(acceptHeader string) []string {
 	parts := strings.Split(acceptHeader, ",")
 	out := make([]string, 0, len(parts))
 	for _, part := range parts {
-		index := strings.IndexByte(part, ';')
-		if index >= 0 {
+		if index := strings.IndexByte(part, ';'); index >= 0 {
 			part = part[0:index]
 		}
-		part = strings.TrimSpace(part)
-		if len(part) > 0 {
+		if part = strings.TrimSpace(part); len(part) > 0 {
 			out = append(out, part)
 		}
 	}

From 0c3726b2061604995defd15bbd673dc4d7065e1c Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Fri, 7 Jul 2017 09:21:44 +0200
Subject: [PATCH 039/113] docs(readme): remove logo, relink it to
 gin-gonic/logo

---
 README.md |   2 +-
 logo.png  | Bin 87064 -> 0 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)
 delete mode 100644 logo.png

diff --git a/README.md b/README.md
index fcf3b8cf..4117769a 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Gin Web Framework
 
-<img align="right" width="159px" src="https://raw.githubusercontent.com/gin-gonic/gin/master/logo.png">
+<img align="right" width="159px" src="https://raw.githubusercontent.com/gin-gonic/logo/master/color.png">
 
 [![Build Status](https://travis-ci.org/gin-gonic/gin.svg)](https://travis-ci.org/gin-gonic/gin)
  [![codecov](https://codecov.io/gh/gin-gonic/gin/branch/master/graph/badge.svg)](https://codecov.io/gh/gin-gonic/gin)
diff --git a/logo.png b/logo.png
deleted file mode 100644
index 7942ad563f911cf8e828e140c549e1f7f7c34b8c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 87064
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


From 75ed286c6038b2a366ecf033a79d31764eeeb041 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Sat, 8 Jul 2017 01:21:30 +0800
Subject: [PATCH 040/113] feat: add SecureJSON func to prevent json hijacking

---
 context.go            |  7 +++++++
 context_test.go       | 26 ++++++++++++++++++++++++++
 gin.go                | 25 ++++++++++++++++---------
 render/json.go        | 26 ++++++++++++++++++++++++++
 render/render.go      |  1 +
 render/render_test.go | 25 +++++++++++++++++++++++++
 6 files changed, 101 insertions(+), 9 deletions(-)

diff --git a/context.go b/context.go
index 604dc4ef..acf2cd23 100644
--- a/context.go
+++ b/context.go
@@ -616,6 +616,13 @@ func (c *Context) IndentedJSON(code int, obj interface{}) {
 	c.Render(code, render.IndentedJSON{Data: obj})
 }
 
+// SecureJSON serializes the given struct as Secure JSON into the response body.
+// Default prepends "while(1)," to response body if the given struct is array values.
+// It also sets the Content-Type as "application/json".
+func (c *Context) SecureJSON(code int, obj interface{}) {
+	c.Render(code, render.SecureJSON{Prefix: c.engine.secureJsonPrefix, Data: obj})
+}
+
 // JSON serializes the given struct as JSON into the response body.
 // It also sets the Content-Type as "application/json".
 func (c *Context) JSON(code int, obj interface{}) {
diff --git a/context_test.go b/context_test.go
index fe31f09a..96e9f08e 100644
--- a/context_test.go
+++ b/context_test.go
@@ -598,6 +598,32 @@ func TestContextRenderNoContentIndentedJSON(t *testing.T) {
 	assert.Equal(t, w.HeaderMap.Get("Content-Type"), "application/json; charset=utf-8")
 }
 
+// Tests that the response is serialized as Secure JSON
+// and Content-Type is set to application/json
+func TestContextRenderSecureJSON(t *testing.T) {
+	w := httptest.NewRecorder()
+	c, router := CreateTestContext(w)
+
+	router.SecureJsonPrefix("&&&START&&&")
+	c.SecureJSON(201, []string{"foo", "bar"})
+
+	assert.Equal(t, w.Code, 201)
+	assert.Equal(t, w.Body.String(), "&&&START&&&[\"foo\",\"bar\"]")
+	assert.Equal(t, w.HeaderMap.Get("Content-Type"), "application/json; charset=utf-8")
+}
+
+// Tests that no Custom JSON is rendered if code is 204
+func TestContextRenderNoContentSecureJSON(t *testing.T) {
+	w := httptest.NewRecorder()
+	c, _ := CreateTestContext(w)
+
+	c.SecureJSON(204, []string{"foo", "bar"})
+
+	assert.Equal(t, 204, w.Code)
+	assert.Equal(t, "", w.Body.String())
+	assert.Equal(t, w.HeaderMap.Get("Content-Type"), "application/json; charset=utf-8")
+}
+
 // Tests that the response executes the templates
 // and responds with Content-Type set to text/html
 func TestContextRenderHTML(t *testing.T) {
diff --git a/gin.go b/gin.go
index 3cac936c..8388ac7b 100644
--- a/gin.go
+++ b/gin.go
@@ -44,15 +44,16 @@ type RoutesInfo []RouteInfo
 // Create an instance of Engine, by using New() or Default()
 type Engine struct {
 	RouterGroup
-	delims      render.Delims
-	HTMLRender  render.HTMLRender
-	FuncMap     template.FuncMap
-	allNoRoute  HandlersChain
-	allNoMethod HandlersChain
-	noRoute     HandlersChain
-	noMethod    HandlersChain
-	pool        sync.Pool
-	trees       methodTrees
+	delims           render.Delims
+	secureJsonPrefix string
+	HTMLRender       render.HTMLRender
+	FuncMap          template.FuncMap
+	allNoRoute       HandlersChain
+	allNoMethod      HandlersChain
+	noRoute          HandlersChain
+	noMethod         HandlersChain
+	pool             sync.Pool
+	trees            methodTrees
 
 	// Enables automatic redirection if the current route can't be matched but a
 	// handler for the path with (without) the trailing slash exists.
@@ -121,6 +122,7 @@ func New() *Engine {
 		UnescapePathValues:     true,
 		trees:                  make(methodTrees, 0, 9),
 		delims:                 render.Delims{"{{", "}}"},
+		secureJsonPrefix:       "while(1);",
 	}
 	engine.RouterGroup.engine = engine
 	engine.pool.New = func() interface{} {
@@ -145,6 +147,11 @@ func (engine *Engine) Delims(left, right string) *Engine {
 	return engine
 }
 
+func (engine *Engine) SecureJsonPrefix(prefix string) *Engine {
+	engine.secureJsonPrefix = prefix
+	return engine
+}
+
 func (engine *Engine) LoadHTMLGlob(pattern string) {
 	if IsDebugging() {
 		debugPrintLoadTemplate(template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseGlob(pattern)))
diff --git a/render/json.go b/render/json.go
index 4e3b66b2..8b64f533 100644
--- a/render/json.go
+++ b/render/json.go
@@ -5,6 +5,7 @@
 package render
 
 import (
+	"bytes"
 	"encoding/json"
 	"net/http"
 )
@@ -17,6 +18,13 @@ type IndentedJSON struct {
 	Data interface{}
 }
 
+type SecureJSON struct {
+	Prefix string
+	Data   interface{}
+}
+
+type SecureJSONPrefix string
+
 var jsonContentType = []string{"application/json; charset=utf-8"}
 
 func (r JSON) Render(w http.ResponseWriter) (err error) {
@@ -53,3 +61,21 @@ func (r IndentedJSON) Render(w http.ResponseWriter) error {
 func (r IndentedJSON) WriteContentType(w http.ResponseWriter) {
 	writeContentType(w, jsonContentType)
 }
+
+func (r SecureJSON) Render(w http.ResponseWriter) error {
+	r.WriteContentType(w)
+	jsonBytes, err := json.Marshal(r.Data)
+	if err != nil {
+		return err
+	}
+	// if the jsonBytes is array values
+	if bytes.HasPrefix(jsonBytes, []byte("[")) && bytes.HasSuffix(jsonBytes, []byte("]")) {
+		w.Write([]byte(r.Prefix))
+	}
+	w.Write(jsonBytes)
+	return nil
+}
+
+func (r SecureJSON) WriteContentType(w http.ResponseWriter) {
+	writeContentType(w, jsonContentType)
+}
diff --git a/render/render.go b/render/render.go
index 46291421..620b0d87 100644
--- a/render/render.go
+++ b/render/render.go
@@ -14,6 +14,7 @@ type Render interface {
 var (
 	_ Render     = JSON{}
 	_ Render     = IndentedJSON{}
+	_ Render     = SecureJSON{}
 	_ Render     = XML{}
 	_ Render     = String{}
 	_ Render     = Redirect{}
diff --git a/render/render_test.go b/render/render_test.go
index c48235c3..e4df5b6d 100644
--- a/render/render_test.go
+++ b/render/render_test.go
@@ -66,6 +66,31 @@ func TestRenderIndentedJSON(t *testing.T) {
 	assert.Equal(t, w.Header().Get("Content-Type"), "application/json; charset=utf-8")
 }
 
+func TestRenderSecureJSON(t *testing.T) {
+	w1 := httptest.NewRecorder()
+	data := map[string]interface{}{
+		"foo": "bar",
+	}
+
+	err1 := (SecureJSON{"while(1);", data}).Render(w1)
+
+	assert.NoError(t, err1)
+	assert.Equal(t, "{\"foo\":\"bar\"}", w1.Body.String())
+	assert.Equal(t, "application/json; charset=utf-8", w1.Header().Get("Content-Type"))
+
+	w2 := httptest.NewRecorder()
+	datas := []map[string]interface{}{{
+		"foo": "bar",
+	}, {
+		"bar": "foo",
+	}}
+
+	err2 := (SecureJSON{"while(1);", datas}).Render(w2)
+	assert.NoError(t, err2)
+	assert.Equal(t, "while(1);[{\"foo\":\"bar\"},{\"bar\":\"foo\"}]", w2.Body.String())
+	assert.Equal(t, "application/json; charset=utf-8", w2.Header().Get("Content-Type"))
+}
+
 type xmlmap map[string]interface{}
 
 // Allows type H to be used with xml.Marshal

From b060a5f409b8d3d24bf547cc737d688743fd8810 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Sat, 8 Jul 2017 16:16:59 +0800
Subject: [PATCH 041/113] docs(readme): fix code link (#989)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4117769a..eda1dd70 100644
--- a/README.md
+++ b/README.md
@@ -471,7 +471,7 @@ func startPage(c *gin.Context) {
 	var person Person
 	// If `GET`, only `Form` binding engine (`query`) used.
 	// If `POST`, first checks the `content-type` for `JSON` or `XML`, then uses `Form` (`form-data`).
-	// See more at https://github.com/gin-gonic/gin/blob/develop/binding/binding.go#L45
+	// See more at https://github.com/gin-gonic/gin/blob/master/binding/binding.go#L48
 	if c.Bind(&person) == nil {
 		log.Println(person.Name)
 		log.Println(person.Address)

From 12508320c2834204677e29be58fec8103facdaf8 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Sat, 8 Jul 2017 16:49:09 +0800
Subject: [PATCH 042/113] feat: change json lib to jsoniter

A high-performance 100% compatible drop-in replacement of "encoding/json"

https://github.com/json-iterator/go

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
---
 binding/json.go    | 3 ++-
 errors.go          | 3 ++-
 errors_test.go     | 2 +-
 render/json.go     | 3 ++-
 vendor/vendor.json | 6 ++++++
 5 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/binding/json.go b/binding/json.go
index 486b9733..aa7039d3 100644
--- a/binding/json.go
+++ b/binding/json.go
@@ -5,8 +5,9 @@
 package binding
 
 import (
-	"encoding/json"
 	"net/http"
+
+	json "github.com/json-iterator/go"
 )
 
 type jsonBinding struct{}
diff --git a/errors.go b/errors.go
index f38d3ff1..19b2cfbe 100644
--- a/errors.go
+++ b/errors.go
@@ -6,9 +6,10 @@ package gin
 
 import (
 	"bytes"
-	"encoding/json"
 	"fmt"
 	"reflect"
+
+	json "github.com/json-iterator/go"
 )
 
 type ErrorType uint64
diff --git a/errors_test.go b/errors_test.go
index 1aa0cdde..46ae536e 100644
--- a/errors_test.go
+++ b/errors_test.go
@@ -5,10 +5,10 @@
 package gin
 
 import (
-	"encoding/json"
 	"errors"
 	"testing"
 
+	json "github.com/json-iterator/go"
 	"github.com/stretchr/testify/assert"
 )
 
diff --git a/render/json.go b/render/json.go
index 8b64f533..38967409 100644
--- a/render/json.go
+++ b/render/json.go
@@ -6,8 +6,9 @@ package render
 
 import (
 	"bytes"
-	"encoding/json"
 	"net/http"
+
+	json "github.com/json-iterator/go"
 )
 
 type JSON struct {
diff --git a/vendor/vendor.json b/vendor/vendor.json
index e520540b..547bb2e0 100644
--- a/vendor/vendor.json
+++ b/vendor/vendor.json
@@ -33,6 +33,12 @@
 			"revision": "5a0f697c9ed9d68fef0116532c6e05cfeae00e55",
 			"revisionTime": "2017-06-01T23:02:30Z"
 		},
+		{
+			"checksumSHA1": "gWQ2ncPI6qpTwS3e6/ShPwUP1uo=",
+			"path": "github.com/json-iterator/go",
+			"revision": "b1afefe0580e6e818dd50da9593f477c80ccd67d",
+			"revisionTime": "2017-07-07T13:43:33Z"
+		},
 		{
 			"checksumSHA1": "9if9IBLsxkarJ804NPWAzgskIAk=",
 			"path": "github.com/manucorporat/stats",

From 08338eff821be0a8805aab51ac35eac856e6a3ed Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Sat, 8 Jul 2017 17:03:14 +0800
Subject: [PATCH 043/113] fix testing

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
---
 context_test.go | 6 +++---
 errors_test.go  | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/context_test.go b/context_test.go
index 96e9f08e..6c4af42f 100644
--- a/context_test.go
+++ b/context_test.go
@@ -582,8 +582,8 @@ func TestContextRenderIndentedJSON(t *testing.T) {
 	c.IndentedJSON(201, H{"foo": "bar", "bar": "foo", "nested": H{"foo": "bar"}})
 
 	assert.Equal(t, w.Code, 201)
-	assert.Equal(t, w.Body.String(), "{\n    \"bar\": \"foo\",\n    \"foo\": \"bar\",\n    \"nested\": {\n        \"foo\": \"bar\"\n    }\n}")
-	assert.Equal(t, w.HeaderMap.Get("Content-Type"), "application/json; charset=utf-8")
+	assert.Equal(t, "{\n    \"foo\":\"bar\",\n    \"bar\":\"foo\",\n    \"nested\":{\n        \"foo\":\"bar\"\n    }\n}", w.Body.String())
+	assert.Equal(t, "application/json; charset=utf-8", w.HeaderMap.Get("Content-Type"))
 }
 
 // Tests that no Custom JSON is rendered if code is 204
@@ -595,7 +595,7 @@ func TestContextRenderNoContentIndentedJSON(t *testing.T) {
 
 	assert.Equal(t, 204, w.Code)
 	assert.Equal(t, "", w.Body.String())
-	assert.Equal(t, w.HeaderMap.Get("Content-Type"), "application/json; charset=utf-8")
+	assert.Equal(t, "application/json; charset=utf-8", w.HeaderMap.Get("Content-Type"))
 }
 
 // Tests that the response is serialized as Secure JSON
diff --git a/errors_test.go b/errors_test.go
index 46ae536e..85782c07 100644
--- a/errors_test.go
+++ b/errors_test.go
@@ -91,7 +91,7 @@ Error #03: third
 		H{"error": "third", "status": "400"},
 	})
 	jsonBytes, _ := json.Marshal(errs)
-	assert.Equal(t, string(jsonBytes), "[{\"error\":\"first\"},{\"error\":\"second\",\"meta\":\"some data\"},{\"error\":\"third\",\"status\":\"400\"}]")
+	assert.Equal(t, "[{\"error\":\"first\"},{\"meta\":\"some data\",\"error\":\"second\"},{\"status\":\"400\",\"error\":\"third\"}]", string(jsonBytes))
 	errs = errorMsgs{
 		{Err: errors.New("first"), Type: ErrorTypePrivate},
 	}

From cb524fc94e322efd6b1bf82688af5109cffd06c7 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Sat, 8 Jul 2017 17:11:28 +0800
Subject: [PATCH 044/113] fix testing

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
---
 errors_test.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/errors_test.go b/errors_test.go
index 85782c07..778ecf0a 100644
--- a/errors_test.go
+++ b/errors_test.go
@@ -32,7 +32,7 @@ func TestError(t *testing.T) {
 	})
 
 	jsonBytes, _ := json.Marshal(err)
-	assert.Equal(t, string(jsonBytes), "{\"error\":\"test error\",\"meta\":\"some data\"}")
+	assert.Equal(t, "{\"meta\":\"some data\",\"error\":\"test error\"}", string(jsonBytes))
 
 	err.SetMeta(H{
 		"status": "200",

From e23842ecab161390b6b537c1c906d7e713f07db0 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Sat, 8 Jul 2017 18:19:09 +0800
Subject: [PATCH 045/113] fix json sort the map keys

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
---
 binding/json.go | 4 +++-
 context_test.go | 2 +-
 errors.go       | 4 +++-
 errors_test.go  | 5 ++---
 render/json.go  | 4 +++-
 5 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/binding/json.go b/binding/json.go
index aa7039d3..20aae8cf 100644
--- a/binding/json.go
+++ b/binding/json.go
@@ -7,9 +7,11 @@ package binding
 import (
 	"net/http"
 
-	json "github.com/json-iterator/go"
+	"github.com/json-iterator/go"
 )
 
+var json = jsoniter.ConfigCompatibleWithStandardLibrary
+
 type jsonBinding struct{}
 
 func (jsonBinding) Name() string {
diff --git a/context_test.go b/context_test.go
index 6c4af42f..f57fa6fd 100644
--- a/context_test.go
+++ b/context_test.go
@@ -582,7 +582,7 @@ func TestContextRenderIndentedJSON(t *testing.T) {
 	c.IndentedJSON(201, H{"foo": "bar", "bar": "foo", "nested": H{"foo": "bar"}})
 
 	assert.Equal(t, w.Code, 201)
-	assert.Equal(t, "{\n    \"foo\":\"bar\",\n    \"bar\":\"foo\",\n    \"nested\":{\n        \"foo\":\"bar\"\n    }\n}", w.Body.String())
+	assert.Equal(t, "{\n    \"bar\":\"foo\",\n    \"foo\":\"bar\",\n    \"nested\":{\n        \"foo\":\"bar\"\n    }\n}", w.Body.String())
 	assert.Equal(t, "application/json; charset=utf-8", w.HeaderMap.Get("Content-Type"))
 }
 
diff --git a/errors.go b/errors.go
index 19b2cfbe..26d4e474 100644
--- a/errors.go
+++ b/errors.go
@@ -9,9 +9,11 @@ import (
 	"fmt"
 	"reflect"
 
-	json "github.com/json-iterator/go"
+	"github.com/json-iterator/go"
 )
 
+var json = jsoniter.ConfigCompatibleWithStandardLibrary
+
 type ErrorType uint64
 
 const (
diff --git a/errors_test.go b/errors_test.go
index 778ecf0a..a0d95504 100644
--- a/errors_test.go
+++ b/errors_test.go
@@ -8,7 +8,6 @@ import (
 	"errors"
 	"testing"
 
-	json "github.com/json-iterator/go"
 	"github.com/stretchr/testify/assert"
 )
 
@@ -32,7 +31,7 @@ func TestError(t *testing.T) {
 	})
 
 	jsonBytes, _ := json.Marshal(err)
-	assert.Equal(t, "{\"meta\":\"some data\",\"error\":\"test error\"}", string(jsonBytes))
+	assert.Equal(t, "{\"error\":\"test error\",\"meta\":\"some data\"}", string(jsonBytes))
 
 	err.SetMeta(H{
 		"status": "200",
@@ -91,7 +90,7 @@ Error #03: third
 		H{"error": "third", "status": "400"},
 	})
 	jsonBytes, _ := json.Marshal(errs)
-	assert.Equal(t, "[{\"error\":\"first\"},{\"meta\":\"some data\",\"error\":\"second\"},{\"status\":\"400\",\"error\":\"third\"}]", string(jsonBytes))
+	assert.Equal(t, "[{\"error\":\"first\"},{\"error\":\"second\",\"meta\":\"some data\"},{\"error\":\"third\",\"status\":\"400\"}]", string(jsonBytes))
 	errs = errorMsgs{
 		{Err: errors.New("first"), Type: ErrorTypePrivate},
 	}
diff --git a/render/json.go b/render/json.go
index 38967409..17e6ac86 100644
--- a/render/json.go
+++ b/render/json.go
@@ -8,9 +8,11 @@ import (
 	"bytes"
 	"net/http"
 
-	json "github.com/json-iterator/go"
+	"github.com/json-iterator/go"
 )
 
+var json = jsoniter.ConfigCompatibleWithStandardLibrary
+
 type JSON struct {
 	Data interface{}
 }

From bf9758ca05e47a74d55995ef62042a1c62cbb53c Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Sun, 9 Jul 2017 01:54:43 +0800
Subject: [PATCH 046/113] Add SecureJSON doc

---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index eda1dd70..cc97c7a5 100644
--- a/README.md
+++ b/README.md
@@ -559,6 +559,29 @@ func main() {
 }
 ```
 
+#### SecureJSON
+
+Using SecureJSON to prevent json hijacking. Default prepends `"while(1),"` to response body if the given struct is array values.
+
+```go
+func main() {
+	r := gin.Default()
+
+	// You can also use your own secure json prefix
+	// r.SecureJsonPrefix(")]}',\n")
+
+	r.GET("/someJSON", func(c *gin.Context) {
+		names := []string{"lena", "austin", "foo"}
+
+		// Will output  :   while(1);["lena","austin","foo"]
+		c.SecureJSON(http.StatusOK, names)
+	})
+
+	// Listen and serve on 0.0.0.0:8080
+	r.Run(":8080")
+}
+```  
+
 ### Serving static files
 
 ```go

From df3b79e805233f553c0495cfa1fb76766b9d80b3 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Sun, 9 Jul 2017 11:02:44 +0200
Subject: [PATCH 047/113] docs(readme): add binding html checkbox example,
 close #129 (#994)

---
 README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/README.md b/README.md
index cc97c7a5..05b696df 100644
--- a/README.md
+++ b/README.md
@@ -481,6 +481,52 @@ func startPage(c *gin.Context) {
 }
 ```
 
+### Bind HTML checkboxes
+
+See the [detail information](https://github.com/gin-gonic/gin/issues/129#issuecomment-124260092)
+
+main.go
+
+```go
+...
+
+type myForm struct {
+    Colors []string `form:"colors[]"`
+}
+
+...
+
+func formHandler(c *gin.Context) {
+    var fakeForm myForm
+    c.Bind(&fakeForm)
+    c.JSON(200, gin.H{"color": fakeForm.Colors})
+}
+
+...
+
+```
+
+form.html
+
+```html
+<form action="/" method="POST">
+    <p>Check some colors</p>
+    <label for="red">Red</label>
+    <input type="checkbox" name="colors[]" value="red" id="red" />
+    <label for="green">Green</label>
+    <input type="checkbox" name="colors[]" value="green" id="green" />
+    <label for="blue">Blue</label>
+    <input type="checkbox" name="colors[]" value="blue" id="blue" />
+    <input type="submit" />
+</form>
+```
+
+result:
+
+```
+{"color":["red","green","blue"]}
+```
+
 ### Multipart/Urlencoded binding
 
 ```go

From 8436a9d829f22f56cbc059e06a68d19163161391 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Mon, 10 Jul 2017 14:45:19 +0800
Subject: [PATCH 048/113] fix(render): remove repeated static check. (#998)

---
 render/render.go | 1 -
 1 file changed, 1 deletion(-)

diff --git a/render/render.go b/render/render.go
index 620b0d87..71852364 100644
--- a/render/render.go
+++ b/render/render.go
@@ -24,7 +24,6 @@ var (
 	_ HTMLRender = HTMLProduction{}
 	_ Render     = YAML{}
 	_ Render     = MsgPack{}
-	_ Render     = MsgPack{}
 )
 
 func writeContentType(w http.ResponseWriter, value []string) {

From b6256dbe0ce7b14e1b8da3abbc710c01ac56c658 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Mon, 10 Jul 2017 08:57:09 +0200
Subject: [PATCH 049/113] chore(vendor): update jsonite rev, close #991 (#992)

---
 vendor/vendor.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/vendor/vendor.json b/vendor/vendor.json
index 547bb2e0..cb752e91 100644
--- a/vendor/vendor.json
+++ b/vendor/vendor.json
@@ -34,10 +34,10 @@
 			"revisionTime": "2017-06-01T23:02:30Z"
 		},
 		{
-			"checksumSHA1": "gWQ2ncPI6qpTwS3e6/ShPwUP1uo=",
+			"checksumSHA1": "YY//OXgGrJOsiR8Cz1xexk/zwkc=",
 			"path": "github.com/json-iterator/go",
-			"revision": "b1afefe0580e6e818dd50da9593f477c80ccd67d",
-			"revisionTime": "2017-07-07T13:43:33Z"
+			"revision": "37ba1b32b5ed52dfaff0fe50d923d210c11c8daf",
+			"revisionTime": "2017-07-08T17:01:13Z"
 		},
 		{
 			"checksumSHA1": "9if9IBLsxkarJ804NPWAzgskIAk=",

From fb7448f081196b9c86cade4f58b663cab2207025 Mon Sep 17 00:00:00 2001
From: whirosan <whirosan@users.noreply.github.com>
Date: Mon, 10 Jul 2017 17:33:35 +0900
Subject: [PATCH 050/113] feat(binding): add UseNumber() in
 gin.Context.BindJSON() (#997) close #368

* resolve #368 add option to UseNumber() in gin.Context.BindJSON()

* add test
---
 binding/json.go | 8 +++++++-
 mode.go         | 4 ++++
 mode_test.go    | 7 +++++++
 3 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/binding/json.go b/binding/json.go
index 20aae8cf..215fa9bf 100644
--- a/binding/json.go
+++ b/binding/json.go
@@ -10,7 +10,10 @@ import (
 	"github.com/json-iterator/go"
 )
 
-var json = jsoniter.ConfigCompatibleWithStandardLibrary
+var (
+	json                   = jsoniter.ConfigCompatibleWithStandardLibrary
+	EnableDecoderUseNumber = false
+)
 
 type jsonBinding struct{}
 
@@ -20,6 +23,9 @@ func (jsonBinding) Name() string {
 
 func (jsonBinding) Bind(req *http.Request, obj interface{}) error {
 	decoder := json.NewDecoder(req.Body)
+	if EnableDecoderUseNumber {
+		decoder.UseNumber()
+	}
 	if err := decoder.Decode(obj); err != nil {
 		return err
 	}
diff --git a/mode.go b/mode.go
index e24dbdc2..b0d2c27d 100644
--- a/mode.go
+++ b/mode.go
@@ -64,6 +64,10 @@ func DisableBindValidation() {
 	binding.Validator = nil
 }
 
+func EnableJsonDecoderUseNumber() {
+	binding.EnableDecoderUseNumber = true
+}
+
 func Mode() string {
 	return modeName
 }
diff --git a/mode_test.go b/mode_test.go
index 0a9cbc3c..f3b88a12 100644
--- a/mode_test.go
+++ b/mode_test.go
@@ -8,6 +8,7 @@ import (
 	"os"
 	"testing"
 
+	"github.com/gin-gonic/gin/binding"
 	"github.com/stretchr/testify/assert"
 )
 
@@ -34,3 +35,9 @@ func TestSetMode(t *testing.T) {
 
 	assert.Panics(t, func() { SetMode("unknown") })
 }
+
+func TestEnableJsonDecoderUseNumber(t *testing.T) {
+	assert.False(t, binding.EnableDecoderUseNumber)
+	EnableJsonDecoderUseNumber()
+	assert.True(t, binding.EnableDecoderUseNumber)
+}

From e31cbdf241b1ff161e3bc5eb4af1c9601fbb7639 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Mon, 10 Jul 2017 03:41:20 -0500
Subject: [PATCH 051/113] feat(logger): show query string in logger. (#999)
 close #988

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
---
 logger.go      | 5 +++++
 logger_test.go | 3 ++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/logger.go b/logger.go
index a03cde6f..470e4bb6 100644
--- a/logger.go
+++ b/logger.go
@@ -77,6 +77,7 @@ func LoggerWithWriter(out io.Writer, notlogged ...string) HandlerFunc {
 		// Start timer
 		start := time.Now()
 		path := c.Request.URL.Path
+		raw := c.Request.URL.RawQuery
 
 		// Process request
 		c.Next()
@@ -97,6 +98,10 @@ func LoggerWithWriter(out io.Writer, notlogged ...string) HandlerFunc {
 			}
 			comment := c.Errors.ByType(ErrorTypePrivate).String()
 
+			if raw != "" {
+				path = path + "?" + raw
+			}
+
 			fmt.Fprintf(out, "[GIN] %v |%s %3d %s| %13v | %15s |%s  %s %-7s %s\n%s",
 				end.Format("2006/01/02 - 15:04:05"),
 				statusColor, statusCode, reset,
diff --git a/logger_test.go b/logger_test.go
index 15d6ee9c..62c1366f 100644
--- a/logger_test.go
+++ b/logger_test.go
@@ -28,10 +28,11 @@ func TestLogger(t *testing.T) {
 	router.HEAD("/example", func(c *Context) {})
 	router.OPTIONS("/example", func(c *Context) {})
 
-	performRequest(router, "GET", "/example")
+	performRequest(router, "GET", "/example?a=100")
 	assert.Contains(t, buffer.String(), "200")
 	assert.Contains(t, buffer.String(), "GET")
 	assert.Contains(t, buffer.String(), "/example")
+	assert.Contains(t, buffer.String(), "a=100")
 
 	// I wrote these first (extending the above) but then realized they are more
 	// like integration tests because they test the whole logging process rather

From 44da058aa09ea4241c37d8f92b6ac6225a4b1aa2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Mon, 10 Jul 2017 22:21:42 +0800
Subject: [PATCH 052/113] add favicon example (#1001)

---
 examples/favicon/favicon.ico | Bin 0 -> 1150 bytes
 examples/favicon/main.go     |  15 +++++++++++++++
 2 files changed, 15 insertions(+)
 create mode 100644 examples/favicon/favicon.ico
 create mode 100644 examples/favicon/main.go

diff --git a/examples/favicon/favicon.ico b/examples/favicon/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..3959cd7f9b13333df2f132f736c5f1d562278895
GIT binary patch
literal 1150
zcmZvaZAep57{~u-FK%{oZPV!zqumdgW0lj0f*e`-B@(PiL9v7&C`hOvv*<%AsnCmM
z1{IQ-Wf{?n%U;YZA+mQGi`IuSL&;vX7hRjRdwR}RV$i+(&bjCOpZ|03bM6B$x{XHA
zXu~=U5Dy@Qpe@>o?9&907Ar*vum3Z+TrJ4TYEn6!ZB~b)J=Nj3J|jKdZO+d>z?Lj&
z_>Uv9Ww+Nrr5c6J){<<sw(T*QZg>rb+kFDFx&2;ZqPs+vPbDNJxiNe8wtw=N&0AqM
zcOowC@WP1`Pd?LV&T_`u9s(V?#9GE$d$rm#++a9y!(ypRwpflKCMItzha??@B<-87
z(;f9PR?mT^uRv=S;09x7Del60;CM)-s^@zB;Z{kiHbqD84*MC~Los%yRyWo#)=b{h
z#QD3xRReH|V%h}LfOCC7GksU{PmQKwjaDo2mXP-%)qNq6u}&Y*MP9+}6F@NoTK@R2
zP_C|fe|5$>T2-osD8^2c?j<~Pfu3)`8}jxNo_zpKI7zsP<59r#D-m79ynF#Xumbn#
z{X@j3OvZlrfgou=h@NW3g#Qq6m8hUU|CWjodXQ=udBa%0jlhHneqtnDl9WM7;#`tK
zJSwVhe?o%ri~4U8^*X)&<F$w`Vt#p}qle-MBqjMVWr{ymmX$}c%(=~`aEoPt3d>Xh
zx9Du{kiWw?dGcUb7csINYBHJn)mG~eoK8P-ayVQrWot$TR|xKKe11%47^~HG!({SM
zZ$F)pmNxuOXf7B3o{^zsFId1abLIf$23D`;g80HheyyN@^XzQDUzU9<Gc&)0^;xre
zx35?+%1KjJt>OoZinxyEuqKAfmpL|X4q(TQVDg3yLC>a53eU?Md^Kmz%hLJtUsn|s
zegCv^qr!`egXgQOL#DDaWy~9SFd{Xz2M&iX)o%ZKv$T|#)YK?vcJ2(^FE0<?t*zxp
z3kyRPDJg>&)6%-lPA8Q&?sB<0v3N1ZvSkD1^X3h2@%dik{d=zVczBH0%jvIh>Q6<#
zXwkPLxw(DI3kp7ra|274KB09EcI_HTuB;3gtEvM3=#7mZP**pKy?X=J%F5yR+S;FE
kdSEK>WfFCrj=Hk~C=--X$BaX)h1R8x#EIB`qMMHYHxij({r~^~

literal 0
HcmV?d00001

diff --git a/examples/favicon/main.go b/examples/favicon/main.go
new file mode 100644
index 00000000..5ad39331
--- /dev/null
+++ b/examples/favicon/main.go
@@ -0,0 +1,15 @@
+package main
+
+import (
+	"github.com/gin-gonic/gin"
+	"github.com/thinkerou/favicon"
+)
+
+func main() {
+	app := gin.Default()
+	app.Use(favicon.New("./favicon.ico"))
+	app.GET("/ping", func(c *gin.Context) {
+		c.String(200, "Hello favicon.")
+	})
+	app.Run(":8080")
+}

From 87fdff8f88e22722ce258ebb46e5285341ebe523 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Tue, 11 Jul 2017 09:03:09 +0800
Subject: [PATCH 053/113] [docs] add http2 example (#1000)

---
 examples/http2/README.md           | 18 +++++++++++++++++
 examples/http2/main.go             | 32 ++++++++++++++++++++++++++++++
 examples/http2/testdata/ca.pem     | 15 ++++++++++++++
 examples/http2/testdata/server.key | 16 +++++++++++++++
 examples/http2/testdata/server.pem | 16 +++++++++++++++
 5 files changed, 97 insertions(+)
 create mode 100644 examples/http2/README.md
 create mode 100644 examples/http2/main.go
 create mode 100644 examples/http2/testdata/ca.pem
 create mode 100644 examples/http2/testdata/server.key
 create mode 100644 examples/http2/testdata/server.pem

diff --git a/examples/http2/README.md b/examples/http2/README.md
new file mode 100644
index 00000000..42dd4b8a
--- /dev/null
+++ b/examples/http2/README.md
@@ -0,0 +1,18 @@
+## How to generate RSA private key and digital certificate
+
+1. Install Openssl
+
+Please visit https://github.com/openssl/openssl to get pkg and install.
+
+2. Generate RSA private key
+
+```sh
+$ mkdir testdata
+$ openssl genrsa -out ./testdata/server.key 2048
+```
+
+3. Generate digital certificate
+
+```sh
+$ openssl req -new -x509 -key ./testdata/server.key -out ./testdata/server.pem -days 365
+```
diff --git a/examples/http2/main.go b/examples/http2/main.go
new file mode 100644
index 00000000..19e65f84
--- /dev/null
+++ b/examples/http2/main.go
@@ -0,0 +1,32 @@
+package main
+
+import (
+	"html/template"
+
+	"github.com/gin-gonic/gin"
+)
+
+var html = template.Must(template.New("https").Parse(`
+<html>
+<head>
+  <title>Https Test</title>
+</head>
+<body>
+  <h1 style="color:red;">Welcome, Ginner!</h1>
+</body>
+</html>
+`))
+
+func main() {
+	r := gin.Default()
+	r.SetHTMLTemplate(html)
+
+	r.GET("/welcome", func(c *gin.Context) {
+		c.HTML(200, "https", gin.H{
+			"status": "success",
+		})
+	})
+
+	// Listen and Server in https://127.0.0.1:8080
+	r.RunTLS(":8080", "./testdata/server.pem", "./testdata/server.key")
+}
diff --git a/examples/http2/testdata/ca.pem b/examples/http2/testdata/ca.pem
new file mode 100644
index 00000000..6c8511a7
--- /dev/null
+++ b/examples/http2/testdata/ca.pem
@@ -0,0 +1,15 @@
+-----BEGIN CERTIFICATE-----
+MIICSjCCAbOgAwIBAgIJAJHGGR4dGioHMA0GCSqGSIb3DQEBCwUAMFYxCzAJBgNV
+BAYTAkFVMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX
+aWRnaXRzIFB0eSBMdGQxDzANBgNVBAMTBnRlc3RjYTAeFw0xNDExMTEyMjMxMjla
+Fw0yNDExMDgyMjMxMjlaMFYxCzAJBgNVBAYTAkFVMRMwEQYDVQQIEwpTb21lLVN0
+YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBXaWRnaXRzIFB0eSBMdGQxDzANBgNVBAMT
+BnRlc3RjYTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAwEDfBV5MYdlHVHJ7
++L4nxrZy7mBfAVXpOc5vMYztssUI7mL2/iYujiIXM+weZYNTEpLdjyJdu7R5gGUu
+g1jSVK/EPHfc74O7AyZU34PNIP4Sh33N+/A5YexrNgJlPY+E3GdVYi4ldWJjgkAd
+Qah2PH5ACLrIIC6tRka9hcaBlIECAwEAAaMgMB4wDAYDVR0TBAUwAwEB/zAOBgNV
+HQ8BAf8EBAMCAgQwDQYJKoZIhvcNAQELBQADgYEAHzC7jdYlzAVmddi/gdAeKPau
+sPBG/C2HCWqHzpCUHcKuvMzDVkY/MP2o6JIW2DBbY64bO/FceExhjcykgaYtCH/m
+oIU63+CFOTtR7otyQAWHqXa7q4SbCDlG7DyRFxqG0txPtGvy12lgldA2+RgcigQG
+Dfcog5wrJytaQ6UA0wE=
+-----END CERTIFICATE-----
diff --git a/examples/http2/testdata/server.key b/examples/http2/testdata/server.key
new file mode 100644
index 00000000..143a5b87
--- /dev/null
+++ b/examples/http2/testdata/server.key
@@ -0,0 +1,16 @@
+-----BEGIN PRIVATE KEY-----
+MIICdQIBADANBgkqhkiG9w0BAQEFAASCAl8wggJbAgEAAoGBAOHDFScoLCVJpYDD
+M4HYtIdV6Ake/sMNaaKdODjDMsux/4tDydlumN+fm+AjPEK5GHhGn1BgzkWF+slf
+3BxhrA/8dNsnunstVA7ZBgA/5qQxMfGAq4wHNVX77fBZOgp9VlSMVfyd9N8YwbBY
+AckOeUQadTi2X1S6OgJXgQ0m3MWhAgMBAAECgYAn7qGnM2vbjJNBm0VZCkOkTIWm
+V10okw7EPJrdL2mkre9NasghNXbE1y5zDshx5Nt3KsazKOxTT8d0Jwh/3KbaN+YY
+tTCbKGW0pXDRBhwUHRcuRzScjli8Rih5UOCiZkhefUTcRb6xIhZJuQy71tjaSy0p
+dHZRmYyBYO2YEQ8xoQJBAPrJPhMBkzmEYFtyIEqAxQ/o/A6E+E4w8i+KM7nQCK7q
+K4JXzyXVAjLfyBZWHGM2uro/fjqPggGD6QH1qXCkI4MCQQDmdKeb2TrKRh5BY1LR
+81aJGKcJ2XbcDu6wMZK4oqWbTX2KiYn9GB0woM6nSr/Y6iy1u145YzYxEV/iMwff
+DJULAkB8B2MnyzOg0pNFJqBJuH29bKCcHa8gHJzqXhNO5lAlEbMK95p/P2Wi+4Hd
+aiEIAF1BF326QJcvYKmwSmrORp85AkAlSNxRJ50OWrfMZnBgzVjDx3xG6KsFQVk2
+ol6VhqL6dFgKUORFUWBvnKSyhjJxurlPEahV6oo6+A+mPhFY8eUvAkAZQyTdupP3
+XEFQKctGz+9+gKkemDp7LBBMEMBXrGTLPhpEfcjv/7KPdnFHYmhYeBTBnuVmTVWe
+F98XJ7tIFfJq
+-----END PRIVATE KEY-----
diff --git a/examples/http2/testdata/server.pem b/examples/http2/testdata/server.pem
new file mode 100644
index 00000000..f3d43fcc
--- /dev/null
+++ b/examples/http2/testdata/server.pem
@@ -0,0 +1,16 @@
+-----BEGIN CERTIFICATE-----
+MIICnDCCAgWgAwIBAgIBBzANBgkqhkiG9w0BAQsFADBWMQswCQYDVQQGEwJBVTET
+MBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50ZXJuZXQgV2lkZ2l0cyBQ
+dHkgTHRkMQ8wDQYDVQQDEwZ0ZXN0Y2EwHhcNMTUxMTA0MDIyMDI0WhcNMjUxMTAx
+MDIyMDI0WjBlMQswCQYDVQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNV
+BAcTB0NoaWNhZ28xFTATBgNVBAoTDEV4YW1wbGUsIENvLjEaMBgGA1UEAxQRKi50
+ZXN0Lmdvb2dsZS5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAOHDFSco
+LCVJpYDDM4HYtIdV6Ake/sMNaaKdODjDMsux/4tDydlumN+fm+AjPEK5GHhGn1Bg
+zkWF+slf3BxhrA/8dNsnunstVA7ZBgA/5qQxMfGAq4wHNVX77fBZOgp9VlSMVfyd
+9N8YwbBYAckOeUQadTi2X1S6OgJXgQ0m3MWhAgMBAAGjazBpMAkGA1UdEwQCMAAw
+CwYDVR0PBAQDAgXgME8GA1UdEQRIMEaCECoudGVzdC5nb29nbGUuZnKCGHdhdGVy
+em9vaS50ZXN0Lmdvb2dsZS5iZYISKi50ZXN0LnlvdXR1YmUuY29thwTAqAEDMA0G
+CSqGSIb3DQEBCwUAA4GBAJFXVifQNub1LUP4JlnX5lXNlo8FxZ2a12AFQs+bzoJ6
+hM044EDjqyxUqSbVePK0ni3w1fHQB5rY9yYC5f8G7aqqTY1QOhoUk8ZTSTRpnkTh
+y4jjdvTZeLDVBlueZUTDRmy2feY5aZIU18vFDK08dTG0A87pppuv1LNIR3loveU8
+-----END CERTIFICATE-----

From 02a6f9b6bc8ffba2e8b55ca78d5a9448ea8aef1e Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Tue, 11 Jul 2017 13:59:03 +0800
Subject: [PATCH 054/113] chore(vendor): update json-iterator revison to fix
 TestRenderIndentedJSON failed (#1003)

* update json-iterator revison to fix TestRenderIndentedJSON failed

* fix(test): add space between key and value as same as standard JSON.

* fix(test): add space between key and value as same as standard JSON.
---
 context_test.go    | 2 +-
 vendor/vendor.json | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/context_test.go b/context_test.go
index f57fa6fd..758fecdc 100644
--- a/context_test.go
+++ b/context_test.go
@@ -582,7 +582,7 @@ func TestContextRenderIndentedJSON(t *testing.T) {
 	c.IndentedJSON(201, H{"foo": "bar", "bar": "foo", "nested": H{"foo": "bar"}})
 
 	assert.Equal(t, w.Code, 201)
-	assert.Equal(t, "{\n    \"bar\":\"foo\",\n    \"foo\":\"bar\",\n    \"nested\":{\n        \"foo\":\"bar\"\n    }\n}", w.Body.String())
+	assert.Equal(t, "{\n    \"bar\": \"foo\",\n    \"foo\": \"bar\",\n    \"nested\": {\n        \"foo\": \"bar\"\n    }\n}", w.Body.String())
 	assert.Equal(t, "application/json; charset=utf-8", w.HeaderMap.Get("Content-Type"))
 }
 
diff --git a/vendor/vendor.json b/vendor/vendor.json
index cb752e91..3af3cb55 100644
--- a/vendor/vendor.json
+++ b/vendor/vendor.json
@@ -34,10 +34,10 @@
 			"revisionTime": "2017-06-01T23:02:30Z"
 		},
 		{
-			"checksumSHA1": "YY//OXgGrJOsiR8Cz1xexk/zwkc=",
+			"checksumSHA1": "bgb/lk2wroBJ5z+JI2xnVj7WkwI=",
 			"path": "github.com/json-iterator/go",
-			"revision": "37ba1b32b5ed52dfaff0fe50d923d210c11c8daf",
-			"revisionTime": "2017-07-08T17:01:13Z"
+			"revision": "845d8438db34cc782608bbee7647a522b4e87de0",
+			"revisionTime": "2017-07-10T17:07:18Z"
 		},
 		{
 			"checksumSHA1": "9if9IBLsxkarJ804NPWAzgskIAk=",

From aa6d2d29f8ac39c365aa5b72fdec01029b0d5264 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Tue, 11 Jul 2017 23:28:08 +0800
Subject: [PATCH 055/113] refactor(doc): use space not tab (#1006)

---
 context.go | 63 +++++++++++++++++++++++++++---------------------------
 1 file changed, 32 insertions(+), 31 deletions(-)

diff --git a/context.go b/context.go
index acf2cd23..198dd3e3 100644
--- a/context.go
+++ b/context.go
@@ -85,8 +85,8 @@ func (c *Context) Copy() *Context {
 	return &cp
 }
 
-// HandlerName returns the main handler's name. For example if the handler is "handleGetUsers()", this
-// function will return "main.handleGetUsers"
+// HandlerName returns the main handler's name. For example if the handler is "handleGetUsers()",
+// this function will return "main.handleGetUsers"
 func (c *Context) HandlerName() string {
 	return nameOfFunction(c.handlers.Last())
 }
@@ -117,8 +117,8 @@ func (c *Context) IsAborted() bool {
 }
 
 // Abort prevents pending handlers from being called. Note that this will not stop the current handler.
-// Let's say you have an authorization middleware that validates that the current request is authorized. If the
-// authorization fails (ex: the password does not match), call Abort to ensure the remaining handlers
+// Let's say you have an authorization middleware that validates that the current request is authorized.
+// If the authorization fails (ex: the password does not match), call Abort to ensure the remaining handlers
 // for this request are not called.
 func (c *Context) Abort() {
 	c.index = abortIndex
@@ -132,15 +132,16 @@ func (c *Context) AbortWithStatus(code int) {
 	c.Abort()
 }
 
-// AbortWithStatusJSON calls `Abort()` and then `JSON` internally. This method stops the chain, writes the status code and return a JSON body
+// AbortWithStatusJSON calls `Abort()` and then `JSON` internally.
+// This method stops the chain, writes the status code and return a JSON body.
 // It also sets the Content-Type as "application/json".
 func (c *Context) AbortWithStatusJSON(code int, jsonObj interface{}) {
 	c.Abort()
 	c.JSON(code, jsonObj)
 }
 
-// AbortWithError calls `AbortWithStatus()` and `Error()` internally. This method stops the chain, writes the status code and
-// pushes the specified error to `c.Errors`.
+// AbortWithError calls `AbortWithStatus()` and `Error()` internally.
+// This method stops the chain, writes the status code and pushes the specified error to `c.Errors`.
 // See Context.Error() for more details.
 func (c *Context) AbortWithError(code int, err error) *Error {
 	c.AbortWithStatus(code)
@@ -153,8 +154,8 @@ func (c *Context) AbortWithError(code int, err error) *Error {
 
 // Error attaches an error to the current context. The error is pushed to a list of errors.
 // It's a good idea to call Error for each error that occurred during the resolution of a request.
-// A middleware can be used to collect all the errors
-// and push them to a database together, print a log, or append it in the HTTP response.
+// A middleware can be used to collect all the errors and push them to a database together,
+// print a log, or append it in the HTTP response.
 // Error will panic if err is nil.
 func (c *Context) Error(err error) *Error {
 	if err == nil {
@@ -296,10 +297,10 @@ func (c *Context) GetStringMapStringSlice(key string) (smss map[string][]string)
 
 // Param returns the value of the URL param.
 // It is a shortcut for c.Params.ByName(key)
-//		router.GET("/user/:id", func(c *gin.Context) {
-//			// a GET request to /user/john
-//			id := c.Param("id") // id == "john"
-//		})
+//     router.GET("/user/:id", func(c *gin.Context) {
+//         // a GET request to /user/john
+//         id := c.Param("id") // id == "john"
+//     })
 func (c *Context) Param(key string) string {
 	return c.Params.ByName(key)
 }
@@ -307,11 +308,11 @@ func (c *Context) Param(key string) string {
 // Query returns the keyed url query value if it exists,
 // otherwise it returns an empty string `("")`.
 // It is shortcut for `c.Request.URL.Query().Get(key)`
-// 		GET /path?id=1234&name=Manu&value=
-// 		c.Query("id") == "1234"
-// 		c.Query("name") == "Manu"
-// 		c.Query("value") == ""
-// 		c.Query("wtf") == ""
+//     GET /path?id=1234&name=Manu&value=
+// 	   c.Query("id") == "1234"
+// 	   c.Query("name") == "Manu"
+// 	   c.Query("value") == ""
+// 	   c.Query("wtf") == ""
 func (c *Context) Query(key string) string {
 	value, _ := c.GetQuery(key)
 	return value
@@ -320,10 +321,10 @@ func (c *Context) Query(key string) string {
 // DefaultQuery returns the keyed url query value if it exists,
 // otherwise it returns the specified defaultValue string.
 // See: Query() and GetQuery() for further information.
-// 		GET /?name=Manu&lastname=
-// 		c.DefaultQuery("name", "unknown") == "Manu"
-// 		c.DefaultQuery("id", "none") == "none"
-// 		c.DefaultQuery("lastname", "none") == ""
+//     GET /?name=Manu&lastname=
+//     c.DefaultQuery("name", "unknown") == "Manu"
+//     c.DefaultQuery("id", "none") == "none"
+//     c.DefaultQuery("lastname", "none") == ""
 func (c *Context) DefaultQuery(key, defaultValue string) string {
 	if value, ok := c.GetQuery(key); ok {
 		return value
@@ -335,10 +336,10 @@ func (c *Context) DefaultQuery(key, defaultValue string) string {
 // if it exists `(value, true)` (even when the value is an empty string),
 // otherwise it returns `("", false)`.
 // It is shortcut for `c.Request.URL.Query().Get(key)`
-// 		GET /?name=Manu&lastname=
-// 		("Manu", true) == c.GetQuery("name")
-// 		("", false) == c.GetQuery("id")
-// 		("", true) == c.GetQuery("lastname")
+//     GET /?name=Manu&lastname=
+//     ("Manu", true) == c.GetQuery("name")
+//     ("", false) == c.GetQuery("id")
+//     ("", true) == c.GetQuery("lastname")
 func (c *Context) GetQuery(key string) (string, bool) {
 	if values, ok := c.GetQueryArray(key); ok {
 		return values[0], ok
@@ -384,9 +385,9 @@ func (c *Context) DefaultPostForm(key, defaultValue string) string {
 // form or multipart form when it exists `(value, true)` (even when the value is an empty string),
 // otherwise it returns ("", false).
 // For example, during a PATCH request to update the user's email:
-// 		email=mail@example.com  -->  ("mail@example.com", true) := GetPostForm("email") // set email to "mail@example.com"
-// 		email=  			  	-->  ("", true) := GetPostForm("email") // set email to ""
-//							 	-->  ("", false) := GetPostForm("email") // do nothing with email
+//     email=mail@example.com  -->  ("mail@example.com", true) := GetPostForm("email") // set email to "mail@example.com"
+// 	   email=                  -->  ("", true) := GetPostForm("email") // set email to ""
+//                             -->  ("", false) := GetPostForm("email") // do nothing with email
 func (c *Context) GetPostForm(key string) (string, bool) {
 	if values, ok := c.GetPostFormArray(key); ok {
 		return values[0], ok
@@ -432,8 +433,8 @@ func (c *Context) MultipartForm() (*multipart.Form, error) {
 
 // Bind checks the Content-Type to select a binding engine automatically,
 // Depending the "Content-Type" header different bindings are used:
-// 		"application/json" --> JSON binding
-// 		"application/xml"  --> XML binding
+//     "application/json" --> JSON binding
+//     "application/xml"  --> XML binding
 // otherwise --> returns an error
 // It parses the request's body as JSON if Content-Type == "application/json" using JSON or XML as a JSON input.
 // It decodes the json payload into the struct specified as a pointer.

From bbd4dfee5056087c640a75c6cc21567f4f47585d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Wed, 12 Jul 2017 15:01:46 +0800
Subject: [PATCH 056/113] add warning using http2 example (#1009)

---
 examples/http2/main.go | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/examples/http2/main.go b/examples/http2/main.go
index 19e65f84..07df01e2 100644
--- a/examples/http2/main.go
+++ b/examples/http2/main.go
@@ -2,6 +2,8 @@ package main
 
 import (
 	"html/template"
+	"log"
+	"os"
 
 	"github.com/gin-gonic/gin"
 )
@@ -18,6 +20,9 @@ var html = template.Must(template.New("https").Parse(`
 `))
 
 func main() {
+	logger := log.New(os.Stderr, "", 0)
+	logger.Println("[WARNING] DON'T USE THE EMBED CERTS FROM THIS EXAMPLE IN PRODUCTION ENVIRONMENT, GENERATE YOUR OWN!")
+
 	r := gin.Default()
 	r.SetHTMLTemplate(html)
 

From 986049d24c3980e773b15ba271de58046f16200b Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Wed, 12 Jul 2017 04:26:58 -0500
Subject: [PATCH 057/113] chore(vendor): upgrade jsonite rev (#1011)

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
---
 vendor/vendor.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/vendor/vendor.json b/vendor/vendor.json
index 3af3cb55..822e201f 100644
--- a/vendor/vendor.json
+++ b/vendor/vendor.json
@@ -34,10 +34,10 @@
 			"revisionTime": "2017-06-01T23:02:30Z"
 		},
 		{
-			"checksumSHA1": "bgb/lk2wroBJ5z+JI2xnVj7WkwI=",
+			"checksumSHA1": "1K394KhUNPplCZzaz69+az17fR0=",
 			"path": "github.com/json-iterator/go",
-			"revision": "845d8438db34cc782608bbee7647a522b4e87de0",
-			"revisionTime": "2017-07-10T17:07:18Z"
+			"revision": "dc388588a371d252dabef1f758e53a958fa11726",
+			"revisionTime": "2017-07-12T08:40:14Z"
 		},
 		{
 			"checksumSHA1": "9if9IBLsxkarJ804NPWAzgskIAk=",

From 65a6dd46a50bd435597b5bcababd1b2a811c9073 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Wed, 12 Jul 2017 13:02:00 +0200
Subject: [PATCH 058/113] chore(vendor): update jsonite rev, #1010 (#1012)

---
 vendor/vendor.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/vendor/vendor.json b/vendor/vendor.json
index 822e201f..29141c4c 100644
--- a/vendor/vendor.json
+++ b/vendor/vendor.json
@@ -34,10 +34,10 @@
 			"revisionTime": "2017-06-01T23:02:30Z"
 		},
 		{
-			"checksumSHA1": "1K394KhUNPplCZzaz69+az17fR0=",
+			"checksumSHA1": "WFJPa8cL6nzQU3yA1iN+gmaqrSU=",
 			"path": "github.com/json-iterator/go",
-			"revision": "dc388588a371d252dabef1f758e53a958fa11726",
-			"revisionTime": "2017-07-12T08:40:14Z"
+			"revision": "4b33139ad07fda872cb378bb4218b2fab74ce62b",
+			"revisionTime": "2017-07-12T09:56:51Z"
 		},
 		{
 			"checksumSHA1": "9if9IBLsxkarJ804NPWAzgskIAk=",

From fe4d405108edbe697305be4bfa86ad8fde64a975 Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Fri, 14 Jul 2017 18:52:16 +0200
Subject: [PATCH 059/113] docs(readme): fix single file example (#1017)

issue discovered by @sgon00 at gitter
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 05b696df..d4dcb9d2 100644
--- a/README.md
+++ b/README.md
@@ -276,7 +276,7 @@ func main() {
 		file, _ := c.FormFile("file")
 		log.Println(file.Filename)
 
-		c.String(http.StatusOK, fmt.Printf("'%s' uploaded!", file.Filename))
+		c.String(http.StatusOK, fmt.Sprintf("'%s' uploaded!", file.Filename))
 	})
 	router.Run(":8080")
 }

From 5cb25a6410a299dcc31e7f31b41c60c90e30b3f6 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Sat, 15 Jul 2017 01:28:16 +0800
Subject: [PATCH 060/113] docs(readme): fix multiple file example (#1018)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d4dcb9d2..86001aed 100644
--- a/README.md
+++ b/README.md
@@ -305,7 +305,7 @@ func main() {
 		for _, file := range files {
 			log.Println(file.Filename)
 		}
-		c.String(http.StatusOK, fmt.Printf("%d files uploaded!", len(files)))
+		c.String(http.StatusOK, fmt.Sprintf("%d files uploaded!", len(files)))
 	})
 	router.Run(":8080")
 }

From 93b3a0d7ec95c33dc327397ab1756c36853328ee Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Sun, 16 Jul 2017 11:42:08 +0800
Subject: [PATCH 061/113] feat(context): add SaveUploadedFile func. (#1022)

* feat(context): add SaveUploadedFile func.

* feat(context): update multiple upload examples.

* style(example): fix gofmt

* fix(example): add missing return
---
 README.md                             |  8 ++++-
 context.go                            | 19 ++++++++++++
 context_test.go                       | 42 +++++++++++++++++++++++++++
 examples/upload-file/multiple/main.go | 20 ++-----------
 examples/upload-file/single/main.go   | 20 ++-----------
 5 files changed, 73 insertions(+), 36 deletions(-)

diff --git a/README.md b/README.md
index 86001aed..ccc5bcc5 100644
--- a/README.md
+++ b/README.md
@@ -275,7 +275,10 @@ func main() {
 		// single file
 		file, _ := c.FormFile("file")
 		log.Println(file.Filename)
-
+        
+        // Upload the file to specific dst.
+        // c.SaveUploadedFile(file, dst)       
+		
 		c.String(http.StatusOK, fmt.Sprintf("'%s' uploaded!", file.Filename))
 	})
 	router.Run(":8080")
@@ -304,6 +307,9 @@ func main() {
 
 		for _, file := range files {
 			log.Println(file.Filename)
+			
+			// Upload the file to specific dst.
+            // c.SaveUploadedFile(file, dst)       
 		}
 		c.String(http.StatusOK, fmt.Sprintf("%d files uploaded!", len(files)))
 	})
diff --git a/context.go b/context.go
index 198dd3e3..f29464d7 100644
--- a/context.go
+++ b/context.go
@@ -13,6 +13,7 @@ import (
 	"net"
 	"net/http"
 	"net/url"
+	"os"
 	"strings"
 	"time"
 
@@ -431,6 +432,24 @@ func (c *Context) MultipartForm() (*multipart.Form, error) {
 	return c.Request.MultipartForm, err
 }
 
+// SaveUploadedFile uploads the form file to specific dst.
+func (c *Context) SaveUploadedFile(file *multipart.FileHeader, dst string) error {
+	src, err := file.Open()
+	if err != nil {
+		return err
+	}
+	defer src.Close()
+
+	out, err := os.Create(dst)
+	if err != nil {
+		return err
+	}
+	defer out.Close()
+
+	io.Copy(out, src)
+	return nil
+}
+
 // Bind checks the Content-Type to select a binding engine automatically,
 // Depending the "Content-Type" header different bindings are used:
 //     "application/json" --> JSON binding
diff --git a/context_test.go b/context_test.go
index 758fecdc..db960fb3 100644
--- a/context_test.go
+++ b/context_test.go
@@ -72,12 +72,18 @@ func TestContextFormFile(t *testing.T) {
 	if assert.NoError(t, err) {
 		assert.Equal(t, "test", f.Filename)
 	}
+
+	assert.NoError(t, c.SaveUploadedFile(f, "test"))
 }
 
 func TestContextMultipartForm(t *testing.T) {
 	buf := new(bytes.Buffer)
 	mw := multipart.NewWriter(buf)
 	mw.WriteField("foo", "bar")
+	w, err := mw.CreateFormFile("file", "test")
+	if assert.NoError(t, err) {
+		w.Write([]byte("test"))
+	}
 	mw.Close()
 	c, _ := CreateTestContext(httptest.NewRecorder())
 	c.Request, _ = http.NewRequest("POST", "/", buf)
@@ -86,6 +92,42 @@ func TestContextMultipartForm(t *testing.T) {
 	if assert.NoError(t, err) {
 		assert.NotNil(t, f)
 	}
+
+	assert.NoError(t, c.SaveUploadedFile(f.File["file"][0], "test"))
+}
+
+func TestSaveUploadedOpenFailed(t *testing.T) {
+	buf := new(bytes.Buffer)
+	mw := multipart.NewWriter(buf)
+	mw.Close()
+
+	c, _ := CreateTestContext(httptest.NewRecorder())
+	c.Request, _ = http.NewRequest("POST", "/", buf)
+	c.Request.Header.Set("Content-Type", mw.FormDataContentType())
+
+	f := &multipart.FileHeader{
+		Filename: "file",
+	}
+	assert.Error(t, c.SaveUploadedFile(f, "test"))
+}
+
+func TestSaveUploadedCreateFailed(t *testing.T) {
+	buf := new(bytes.Buffer)
+	mw := multipart.NewWriter(buf)
+	w, err := mw.CreateFormFile("file", "test")
+	if assert.NoError(t, err) {
+		w.Write([]byte("test"))
+	}
+	mw.Close()
+	c, _ := CreateTestContext(httptest.NewRecorder())
+	c.Request, _ = http.NewRequest("POST", "/", buf)
+	c.Request.Header.Set("Content-Type", mw.FormDataContentType())
+	f, err := c.FormFile("file")
+	if assert.NoError(t, err) {
+		assert.Equal(t, "test", f.Filename)
+	}
+
+	assert.Error(t, c.SaveUploadedFile(f, "/"))
 }
 
 func TestContextReset(t *testing.T) {
diff --git a/examples/upload-file/multiple/main.go b/examples/upload-file/multiple/main.go
index 22588348..4bb4cdcb 100644
--- a/examples/upload-file/multiple/main.go
+++ b/examples/upload-file/multiple/main.go
@@ -2,9 +2,7 @@ package main
 
 import (
 	"fmt"
-	"io"
 	"net/http"
-	"os"
 
 	"github.com/gin-gonic/gin"
 )
@@ -25,24 +23,10 @@ func main() {
 		files := form.File["files"]
 
 		for _, file := range files {
-			// Source
-			src, err := file.Open()
-			if err != nil {
-				c.String(http.StatusBadRequest, fmt.Sprintf("file open err: %s", err.Error()))
+			if err := c.SaveUploadedFile(file, file.Filename); err != nil {
+				c.String(http.StatusBadRequest, fmt.Sprintf("upload file err: %s", err.Error()))
 				return
 			}
-			defer src.Close()
-
-			// Destination
-			dst, err := os.Create(file.Filename)
-			if err != nil {
-				c.String(http.StatusBadRequest, fmt.Sprintf("Create file err: %s", err.Error()))
-				return
-			}
-			defer dst.Close()
-
-			// Copy
-			io.Copy(dst, src)
 		}
 
 		c.String(http.StatusOK, fmt.Sprintf("Uploaded successfully %d files with fields name=%s and email=%s.", len(files), name, email))
diff --git a/examples/upload-file/single/main.go b/examples/upload-file/single/main.go
index 1e9596cb..372a2994 100644
--- a/examples/upload-file/single/main.go
+++ b/examples/upload-file/single/main.go
@@ -2,9 +2,7 @@ package main
 
 import (
 	"fmt"
-	"io"
 	"net/http"
-	"os"
 
 	"github.com/gin-gonic/gin"
 )
@@ -22,23 +20,11 @@ func main() {
 			c.String(http.StatusBadRequest, fmt.Sprintf("get form err: %s", err.Error()))
 			return
 		}
-		src, err := file.Open()
-		if err != nil {
-			c.String(http.StatusBadRequest, fmt.Sprintf("file open err: %s", err.Error()))
+
+		if err := c.SaveUploadedFile(file, file.Filename); err != nil {
+			c.String(http.StatusBadRequest, fmt.Sprintf("upload file err: %s", err.Error()))
 			return
 		}
-		defer src.Close()
-
-		// Destination
-		dst, err := os.Create(file.Filename)
-		if err != nil {
-			c.String(http.StatusBadRequest, fmt.Sprintf("Create file err: %s", err.Error()))
-			return
-		}
-		defer dst.Close()
-
-		// Copy
-		io.Copy(dst, src)
 
 		c.String(http.StatusOK, fmt.Sprintf("File %s uploaded successfully with fields name=%s and email=%s.", file.Filename, name, email))
 	})

From 8678b3df962ee52c8795802b4bee3c439cc9aeda Mon Sep 17 00:00:00 2001
From: Javier Provecho Fernandez <javiertitan@gmail.com>
Date: Mon, 17 Jul 2017 02:50:45 +0200
Subject: [PATCH 062/113] docs(readme): add reference to validator.v8 docs,
 close #738 (#1024)

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index ccc5bcc5..211ed59d 100644
--- a/README.md
+++ b/README.md
@@ -406,6 +406,8 @@ func main() {
 
 To bind a request body into a type, use model binding. We currently support binding of JSON, XML and standard form values (foo=bar&boo=baz).
 
+Gin uses [**go-playground/validator.v8**](https://github.com/go-playground/validator) for validation. Check the full docs on tags usage [here](http://godoc.org/gopkg.in/go-playground/validator.v8#hdr-Baked_In_Validators_and_Tags).
+
 Note that you need to set the corresponding binding tag on all fields you want to bind. For example, when binding from JSON, set `json:"fieldname"`.
 
 When using the Bind-method, Gin tries to infer the binder depending on the Content-Type header. If you are sure what you are binding, you can use BindWith.

From 8f861946b028a0b5ed4acf8df4b673e23e8c5634 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Mon, 17 Jul 2017 18:57:59 +0800
Subject: [PATCH 063/113] style(msgpack): remove redundant comments (#1027)

---
 binding/msgpack.go | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/binding/msgpack.go b/binding/msgpack.go
index 69367175..7faea4b5 100644
--- a/binding/msgpack.go
+++ b/binding/msgpack.go
@@ -17,12 +17,8 @@ func (msgpackBinding) Name() string {
 }
 
 func (msgpackBinding) Bind(req *http.Request, obj interface{}) error {
-
 	if err := codec.NewDecoder(req.Body, new(codec.MsgpackHandle)).Decode(&obj); err != nil {
-		//var decoder *codec.Decoder = codec.NewDecoder(req.Body, &codec.MsgpackHandle)
-		//if err := decoder.Decode(&obj); err != nil {
 		return err
 	}
 	return validate(obj)
-
 }

From b539606eedd1eabd650b2284394a8ada992fd411 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Tue, 18 Jul 2017 08:54:38 +0800
Subject: [PATCH 064/113] use return not use else (#1028)

---
 auth.go | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/auth.go b/auth.go
index 7ebf5576..75a7c892 100644
--- a/auth.go
+++ b/auth.go
@@ -52,11 +52,13 @@ func BasicAuthForRealm(accounts Accounts, realm string) HandlerFunc {
 			// Credentials doesn't match, we return 401 and abort handlers chain.
 			c.Header("WWW-Authenticate", realm)
 			c.AbortWithStatus(401)
-		} else {
-			// The user credentials was found, set user's id to key AuthUserKey in this context, the userId can be read later using
-			// c.MustGet(gin.AuthUserKey)
-			c.Set(AuthUserKey, user)
+			return
 		}
+
+		// The user credentials was found, set user's id to key AuthUserKey in this context, the user's id can be read later using
+		// c.MustGet(gin.AuthUserKey)
+		c.Set(AuthUserKey, user)
+		return
 	}
 }
 

From 199bbf2ae55c3601425895a0e4a760599db3c6bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Tue, 18 Jul 2017 09:11:53 +0800
Subject: [PATCH 065/113] refactor(gin): use return not use else for reducing
 indent (#1031)

---
 gin.go | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/gin.go b/gin.go
index 8388ac7b..fc9214dc 100644
--- a/gin.go
+++ b/gin.go
@@ -156,19 +156,21 @@ func (engine *Engine) LoadHTMLGlob(pattern string) {
 	if IsDebugging() {
 		debugPrintLoadTemplate(template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseGlob(pattern)))
 		engine.HTMLRender = render.HTMLDebug{Glob: pattern, FuncMap: engine.FuncMap, Delims: engine.delims}
-	} else {
-		templ := template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseGlob(pattern))
-		engine.SetHTMLTemplate(templ)
+		return
 	}
+	templ := template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseGlob(pattern))
+	engine.SetHTMLTemplate(templ)
+	return
 }
 
 func (engine *Engine) LoadHTMLFiles(files ...string) {
 	if IsDebugging() {
 		engine.HTMLRender = render.HTMLDebug{Files: files, FuncMap: engine.FuncMap, Delims: engine.delims}
-	} else {
-		templ := template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseFiles(files...))
-		engine.SetHTMLTemplate(templ)
+		return
 	}
+	templ := template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseFiles(files...))
+	engine.SetHTMLTemplate(templ)
+	return
 }
 
 func (engine *Engine) SetHTMLTemplate(templ *template.Template) {

From 30cfa590bb2b851d521da0198d3803eca2cc2a4b Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Tue, 18 Jul 2017 09:23:10 +0800
Subject: [PATCH 066/113] dos(upload): fix alignment (#1030)

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 211ed59d..7e3df99f 100644
--- a/README.md
+++ b/README.md
@@ -276,8 +276,8 @@ func main() {
 		file, _ := c.FormFile("file")
 		log.Println(file.Filename)
         
-        // Upload the file to specific dst.
-        // c.SaveUploadedFile(file, dst)       
+		// Upload the file to specific dst.
+		// c.SaveUploadedFile(file, dst)       
 		
 		c.String(http.StatusOK, fmt.Sprintf("'%s' uploaded!", file.Filename))
 	})
@@ -309,7 +309,7 @@ func main() {
 			log.Println(file.Filename)
 			
 			// Upload the file to specific dst.
-            // c.SaveUploadedFile(file, dst)       
+			// c.SaveUploadedFile(file, dst)       
 		}
 		c.String(http.StatusOK, fmt.Sprintf("%d files uploaded!", len(files)))
 	})

From 7180f2ba62d6aa9c81fafbac409a07ebeaa26fff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Tue, 18 Jul 2017 11:39:39 +0800
Subject: [PATCH 067/113] not use tmp var (#1032)

---
 context.go | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/context.go b/context.go
index f29464d7..306e2055 100644
--- a/context.go
+++ b/context.go
@@ -358,8 +358,7 @@ func (c *Context) QueryArray(key string) []string {
 // GetQueryArray returns a slice of strings for a given query key, plus
 // a boolean value whether at least one value exists for the given key.
 func (c *Context) GetQueryArray(key string) ([]string, bool) {
-	req := c.Request
-	if values, ok := req.URL.Query()[key]; ok && len(values) > 0 {
+	if values, ok := c.Request.URL.Query()[key]; ok && len(values) > 0 {
 		return values, true
 	}
 	return []string{}, false

From ce670a64977a513d8caa58c143471ddbbf641bd4 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Tue, 18 Jul 2017 16:01:29 -0500
Subject: [PATCH 068/113] refactor(json): make jsonite optional with build tags
 (#1026)

* refactor(json): Restore gin support for app engine

Create new folder to support multiple json package.
restore gin support for app engine (disable jsonite through tags)

use jsoniter

$ go build -tags=jsoniter .

use default json

$ go build .

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>

* rename json file.

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>

* docs(json): add build tags document.

* fix(docs): markdown format.

* fix(json): missing space.
---
 README.md        |  9 ++++++++-
 binding/json.go  |  3 +--
 errors.go        |  4 +---
 errors_test.go   |  1 +
 json/json.go     | 17 +++++++++++++++++
 json/jsoniter.go | 18 ++++++++++++++++++
 render/json.go   |  4 +---
 7 files changed, 47 insertions(+), 9 deletions(-)
 create mode 100644 json/json.go
 create mode 100644 json/jsoniter.go

diff --git a/README.md b/README.md
index 7e3df99f..76ab3b01 100644
--- a/README.md
+++ b/README.md
@@ -88,7 +88,6 @@ BenchmarkZeus_GithubAll 		| 2000 		| 944234 	| 300688 	| 2648
 - [x] Battle tested
 - [x] API frozen, new releases will not break your code.
 
-
 ## Start using it
 
 1. Download and install it:
@@ -141,6 +140,14 @@ $ curl https://raw.githubusercontent.com/gin-gonic/gin/master/examples/basic/mai
 $ go run main.go
 ```
 
+## Build with [jsoniter](https://github.com/json-iterator/go)
+
+Gin use `encoding/json` as default json package but you can change to [jsoniter](https://github.com/json-iterator/go) by build from other tags.
+
+```sh
+$ go build -tags=jsoniter .
+```
+
 ## API Examples
 
 ### Using GET, POST, PUT, PATCH, DELETE and OPTIONS
diff --git a/binding/json.go b/binding/json.go
index 215fa9bf..f600a5f4 100644
--- a/binding/json.go
+++ b/binding/json.go
@@ -7,11 +7,10 @@ package binding
 import (
 	"net/http"
 
-	"github.com/json-iterator/go"
+	"github.com/gin-gonic/gin/json"
 )
 
 var (
-	json                   = jsoniter.ConfigCompatibleWithStandardLibrary
 	EnableDecoderUseNumber = false
 )
 
diff --git a/errors.go b/errors.go
index 26d4e474..19761106 100644
--- a/errors.go
+++ b/errors.go
@@ -9,11 +9,9 @@ import (
 	"fmt"
 	"reflect"
 
-	"github.com/json-iterator/go"
+	"github.com/gin-gonic/gin/json"
 )
 
-var json = jsoniter.ConfigCompatibleWithStandardLibrary
-
 type ErrorType uint64
 
 const (
diff --git a/errors_test.go b/errors_test.go
index a0d95504..5e596aff 100644
--- a/errors_test.go
+++ b/errors_test.go
@@ -8,6 +8,7 @@ import (
 	"errors"
 	"testing"
 
+	"github.com/gin-gonic/gin/json"
 	"github.com/stretchr/testify/assert"
 )
 
diff --git a/json/json.go b/json/json.go
new file mode 100644
index 00000000..d2d0f8b3
--- /dev/null
+++ b/json/json.go
@@ -0,0 +1,17 @@
+// Copyright 2017 Bo-Yi Wu.  All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+// +build !jsoniter
+
+package json
+
+import (
+	"encoding/json"
+)
+
+var (
+	Marshal       = json.Marshal
+	MarshalIndent = json.MarshalIndent
+	NewDecoder    = json.NewDecoder
+)
diff --git a/json/jsoniter.go b/json/jsoniter.go
new file mode 100644
index 00000000..65deee59
--- /dev/null
+++ b/json/jsoniter.go
@@ -0,0 +1,18 @@
+// Copyright 2017 Bo-Yi Wu.  All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+// +build jsoniter
+
+package json
+
+import (
+	"github.com/json-iterator/go"
+)
+
+var (
+	json          = jsoniter.ConfigCompatibleWithStandardLibrary
+	Marshal       = json.Marshal
+	MarshalIndent = json.MarshalIndent
+	NewDecoder    = json.NewDecoder
+)
diff --git a/render/json.go b/render/json.go
index 17e6ac86..eb2548e2 100644
--- a/render/json.go
+++ b/render/json.go
@@ -8,11 +8,9 @@ import (
 	"bytes"
 	"net/http"
 
-	"github.com/json-iterator/go"
+	"github.com/gin-gonic/gin/json"
 )
 
-var json = jsoniter.ConfigCompatibleWithStandardLibrary
-
 type JSON struct {
 	Data interface{}
 }

From 88566b928cabbe45f0e6e9ae4f8fad97fc8ae9d4 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Tue, 18 Jul 2017 16:06:14 -0500
Subject: [PATCH 069/113] chore(vendor): update jsoniter package (#1033)

---
 vendor/vendor.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/vendor/vendor.json b/vendor/vendor.json
index 29141c4c..e8690a2c 100644
--- a/vendor/vendor.json
+++ b/vendor/vendor.json
@@ -34,10 +34,10 @@
 			"revisionTime": "2017-06-01T23:02:30Z"
 		},
 		{
-			"checksumSHA1": "WFJPa8cL6nzQU3yA1iN+gmaqrSU=",
+			"checksumSHA1": "0e59uuETpidkmpaRwipQ8auqwhM=",
 			"path": "github.com/json-iterator/go",
-			"revision": "4b33139ad07fda872cb378bb4218b2fab74ce62b",
-			"revisionTime": "2017-07-12T09:56:51Z"
+			"revision": "6b6938829d6156d7b9825f83eec757f0f571c981",
+			"revisionTime": "2017-07-18T14:19:52Z"
 		},
 		{
 			"checksumSHA1": "9if9IBLsxkarJ804NPWAzgskIAk=",

From 74221b8a35319c6aaf1b7826069fb19302e3276e Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Wed, 19 Jul 2017 02:40:05 -0500
Subject: [PATCH 070/113] docs(benchmark): update benchmark data (#1035)

* feat(Benchmark): update benchmark data

* fix format.

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>

* docs(benchmarks): re indent column, feature gin

* docs(benchmark): fix newline on vm details

* docs(readme): beautify bench table, explain result
---
 BENCHMARKS.md | 896 +++++++++++++++++++++++++++++++++-----------------
 README.md     |  67 ++--
 2 files changed, 634 insertions(+), 329 deletions(-)

diff --git a/BENCHMARKS.md b/BENCHMARKS.md
index 6efe3ca4..9a7df86a 100644
--- a/BENCHMARKS.md
+++ b/BENCHMARKS.md
@@ -1,298 +1,604 @@
-**Machine:** intel i7 ivy bridge quad-core. 8GB RAM.  
-**Date:** June 4th, 2015  
-[https://github.com/gin-gonic/go-http-routing-benchmark](https://github.com/gin-gonic/go-http-routing-benchmark)
+
+## Benchmark System
+
+**VM HOST:** DigitalOcean  
+**Machine:** 4 CPU, 8 GB RAM. Ubuntu 16.04.2 x64  
+**Date:** July 19th, 2017  
+**Go Version:** 1.8.3 linux/amd64  
+**Source:** [Go HTTP Router Benchmark](https://github.com/julienschmidt/go-http-routing-benchmark)  
+
+## Static Routes: 157
 
 ```
-BenchmarkAce_Param   5000000           372 ns/op          32 B/op          1 allocs/op
-BenchmarkBear_Param  1000000          1165 ns/op         424 B/op          5 allocs/op
-BenchmarkBeego_Param     1000000          2440 ns/op         720 B/op         10 allocs/op
-BenchmarkBone_Param  1000000          1067 ns/op         384 B/op          3 allocs/op
-BenchmarkDenco_Param     5000000           240 ns/op          32 B/op          1 allocs/op
-BenchmarkEcho_Param 10000000           130 ns/op           0 B/op          0 allocs/op
-BenchmarkGin_Param  10000000           133 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_Param    1000000          1826 ns/op         656 B/op          9 allocs/op
-BenchmarkGoji_Param  2000000           957 ns/op         336 B/op          2 allocs/op
-BenchmarkGoJsonRest_Param    1000000          2021 ns/op         657 B/op         14 allocs/op
-BenchmarkGoRestful_Param      200000          8825 ns/op        2496 B/op         31 allocs/op
-BenchmarkGorillaMux_Param     500000          3340 ns/op         784 B/op          9 allocs/op
-BenchmarkHttpRouter_Param   10000000           152 ns/op          32 B/op          1 allocs/op
-BenchmarkHttpTreeMux_Param   2000000           717 ns/op         336 B/op          2 allocs/op
-BenchmarkKocha_Param     3000000           423 ns/op          56 B/op          3 allocs/op
-BenchmarkMacaron_Param   1000000          3410 ns/op        1104 B/op         11 allocs/op
-BenchmarkMartini_Param    200000          7101 ns/op        1152 B/op         12 allocs/op
-BenchmarkPat_Param   1000000          2040 ns/op         656 B/op         14 allocs/op
-BenchmarkPossum_Param    1000000          2048 ns/op         624 B/op          7 allocs/op
-BenchmarkR2router_Param  1000000          1144 ns/op         432 B/op          6 allocs/op
-BenchmarkRevel_Param      200000          6725 ns/op        1672 B/op         28 allocs/op
-BenchmarkRivet_Param     1000000          1121 ns/op         464 B/op          5 allocs/op
-BenchmarkTango_Param     1000000          1479 ns/op         256 B/op         10 allocs/op
-BenchmarkTigerTonic_Param    1000000          3393 ns/op         992 B/op         19 allocs/op
-BenchmarkTraffic_Param    300000          5525 ns/op        1984 B/op         23 allocs/op
-BenchmarkVulcan_Param    2000000           924 ns/op          98 B/op          3 allocs/op
-BenchmarkZeus_Param  1000000          1084 ns/op         368 B/op          3 allocs/op
-BenchmarkAce_Param5  3000000           614 ns/op         160 B/op          1 allocs/op
-BenchmarkBear_Param5     1000000          1617 ns/op         469 B/op          5 allocs/op
-BenchmarkBeego_Param5    1000000          3373 ns/op         992 B/op         13 allocs/op
-BenchmarkBone_Param5     1000000          1478 ns/op         432 B/op          3 allocs/op
-BenchmarkDenco_Param5    3000000           570 ns/op         160 B/op          1 allocs/op
-BenchmarkEcho_Param5     5000000           256 ns/op           0 B/op          0 allocs/op
-BenchmarkGin_Param5 10000000           222 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_Param5   1000000          2789 ns/op         928 B/op         12 allocs/op
-BenchmarkGoji_Param5     1000000          1287 ns/op         336 B/op          2 allocs/op
-BenchmarkGoJsonRest_Param5   1000000          3670 ns/op        1105 B/op         17 allocs/op
-BenchmarkGoRestful_Param5     200000         10756 ns/op        2672 B/op         31 allocs/op
-BenchmarkGorillaMux_Param5    300000          5543 ns/op         912 B/op          9 allocs/op
-BenchmarkHttpRouter_Param5   5000000           403 ns/op         160 B/op          1 allocs/op
-BenchmarkHttpTreeMux_Param5  1000000          1089 ns/op         336 B/op          2 allocs/op
-BenchmarkKocha_Param5    1000000          1682 ns/op         440 B/op         10 allocs/op
-BenchmarkMacaron_Param5   300000          4596 ns/op        1376 B/op         14 allocs/op
-BenchmarkMartini_Param5   100000         15703 ns/op        1280 B/op         12 allocs/op
-BenchmarkPat_Param5   300000          5320 ns/op        1008 B/op         42 allocs/op
-BenchmarkPossum_Param5   1000000          2155 ns/op         624 B/op          7 allocs/op
-BenchmarkR2router_Param5     1000000          1559 ns/op         432 B/op          6 allocs/op
-BenchmarkRevel_Param5     200000          8184 ns/op        2024 B/op         35 allocs/op
-BenchmarkRivet_Param5    1000000          1914 ns/op         528 B/op          9 allocs/op
-BenchmarkTango_Param5    1000000          3280 ns/op         944 B/op         18 allocs/op
-BenchmarkTigerTonic_Param5    200000         11638 ns/op        2519 B/op         53 allocs/op
-BenchmarkTraffic_Param5   200000          8941 ns/op        2280 B/op         31 allocs/op
-BenchmarkVulcan_Param5   1000000          1279 ns/op          98 B/op          3 allocs/op
-BenchmarkZeus_Param5     1000000          1574 ns/op         416 B/op          3 allocs/op
-BenchmarkAce_Param20     1000000          1528 ns/op         640 B/op          1 allocs/op
-BenchmarkBear_Param20     300000          4906 ns/op        1633 B/op          5 allocs/op
-BenchmarkBeego_Param20    200000         10529 ns/op        3868 B/op         17 allocs/op
-BenchmarkBone_Param20     300000          7362 ns/op        2539 B/op          5 allocs/op
-BenchmarkDenco_Param20   1000000          1884 ns/op         640 B/op          1 allocs/op
-BenchmarkEcho_Param20    2000000           689 ns/op           0 B/op          0 allocs/op
-BenchmarkGin_Param20     3000000           545 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_Param20   200000          9437 ns/op        3804 B/op         16 allocs/op
-BenchmarkGoji_Param20     500000          3987 ns/op        1246 B/op          2 allocs/op
-BenchmarkGoJsonRest_Param20   100000         12799 ns/op        4492 B/op         21 allocs/op
-BenchmarkGoRestful_Param20    100000         19451 ns/op        5244 B/op         33 allocs/op
-BenchmarkGorillaMux_Param20   100000         12456 ns/op        3275 B/op         11 allocs/op
-BenchmarkHttpRouter_Param20  1000000          1333 ns/op         640 B/op          1 allocs/op
-BenchmarkHttpTreeMux_Param20      300000          6490 ns/op        2187 B/op          4 allocs/op
-BenchmarkKocha_Param20    300000          5335 ns/op        1808 B/op         27 allocs/op
-BenchmarkMacaron_Param20      200000         11325 ns/op        4252 B/op         18 allocs/op
-BenchmarkMartini_Param20       20000         64419 ns/op        3644 B/op         14 allocs/op
-BenchmarkPat_Param20       50000         24672 ns/op        4888 B/op        151 allocs/op
-BenchmarkPossum_Param20  1000000          2085 ns/op         624 B/op          7 allocs/op
-BenchmarkR2router_Param20     300000          6809 ns/op        2283 B/op          8 allocs/op
-BenchmarkRevel_Param20    100000         16600 ns/op        5551 B/op         54 allocs/op
-BenchmarkRivet_Param20    200000          8428 ns/op        2620 B/op         26 allocs/op
-BenchmarkTango_Param20    100000         16302 ns/op        8224 B/op         48 allocs/op
-BenchmarkTigerTonic_Param20    30000         46828 ns/op       10538 B/op        178 allocs/op
-BenchmarkTraffic_Param20       50000         28871 ns/op        7998 B/op         66 allocs/op
-BenchmarkVulcan_Param20  1000000          2267 ns/op          98 B/op          3 allocs/op
-BenchmarkZeus_Param20     300000          6828 ns/op        2507 B/op          5 allocs/op
-BenchmarkAce_ParamWrite  3000000           502 ns/op          40 B/op          2 allocs/op
-BenchmarkBear_ParamWrite     1000000          1303 ns/op         424 B/op          5 allocs/op
-BenchmarkBeego_ParamWrite    1000000          2489 ns/op         728 B/op         11 allocs/op
-BenchmarkBone_ParamWrite     1000000          1181 ns/op         384 B/op          3 allocs/op
-BenchmarkDenco_ParamWrite    5000000           315 ns/op          32 B/op          1 allocs/op
-BenchmarkEcho_ParamWrite    10000000           237 ns/op           8 B/op          1 allocs/op
-BenchmarkGin_ParamWrite  5000000           336 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_ParamWrite   1000000          2079 ns/op         664 B/op         10 allocs/op
-BenchmarkGoji_ParamWrite     1000000          1092 ns/op         336 B/op          2 allocs/op
-BenchmarkGoJsonRest_ParamWrite   1000000          3329 ns/op        1136 B/op         19 allocs/op
-BenchmarkGoRestful_ParamWrite     200000          9273 ns/op        2504 B/op         32 allocs/op
-BenchmarkGorillaMux_ParamWrite    500000          3919 ns/op         792 B/op         10 allocs/op
-BenchmarkHttpRouter_ParamWrite  10000000           223 ns/op          32 B/op          1 allocs/op
-BenchmarkHttpTreeMux_ParamWrite  2000000           788 ns/op         336 B/op          2 allocs/op
-BenchmarkKocha_ParamWrite    3000000           549 ns/op          56 B/op          3 allocs/op
-BenchmarkMacaron_ParamWrite   500000          4558 ns/op        1216 B/op         16 allocs/op
-BenchmarkMartini_ParamWrite   200000          8850 ns/op        1256 B/op         16 allocs/op
-BenchmarkPat_ParamWrite   500000          3679 ns/op        1088 B/op         19 allocs/op
-BenchmarkPossum_ParamWrite   1000000          2114 ns/op         624 B/op          7 allocs/op
-BenchmarkR2router_ParamWrite     1000000          1320 ns/op         432 B/op          6 allocs/op
-BenchmarkRevel_ParamWrite     200000          8048 ns/op        2128 B/op         33 allocs/op
-BenchmarkRivet_ParamWrite    1000000          1393 ns/op         472 B/op          6 allocs/op
-BenchmarkTango_ParamWrite    2000000           819 ns/op         136 B/op          5 allocs/op
-BenchmarkTigerTonic_ParamWrite    300000          5860 ns/op        1440 B/op         25 allocs/op
-BenchmarkTraffic_ParamWrite   200000          7429 ns/op        2400 B/op         27 allocs/op
-BenchmarkVulcan_ParamWrite   2000000           972 ns/op          98 B/op          3 allocs/op
-BenchmarkZeus_ParamWrite     1000000          1226 ns/op         368 B/op          3 allocs/op
-BenchmarkAce_GithubStatic    5000000           294 ns/op           0 B/op          0 allocs/op
-BenchmarkBear_GithubStatic   3000000           575 ns/op          88 B/op          3 allocs/op
-BenchmarkBeego_GithubStatic  1000000          1561 ns/op         368 B/op          7 allocs/op
-BenchmarkBone_GithubStatic    200000         12301 ns/op        2880 B/op         60 allocs/op
-BenchmarkDenco_GithubStatic 20000000            74.6 ns/op         0 B/op          0 allocs/op
-BenchmarkEcho_GithubStatic  10000000           176 ns/op           0 B/op          0 allocs/op
-BenchmarkGin_GithubStatic   10000000           159 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_GithubStatic     1000000          1116 ns/op         304 B/op          6 allocs/op
-BenchmarkGoji_GithubStatic   5000000           413 ns/op           0 B/op          0 allocs/op
-BenchmarkGoRestful_GithubStatic    30000         55200 ns/op        3520 B/op         36 allocs/op
-BenchmarkGoJsonRest_GithubStatic     1000000          1504 ns/op         337 B/op         12 allocs/op
-BenchmarkGorillaMux_GithubStatic      100000         23620 ns/op         464 B/op          8 allocs/op
-BenchmarkHttpRouter_GithubStatic    20000000            78.3 ns/op         0 B/op          0 allocs/op
-BenchmarkHttpTreeMux_GithubStatic   20000000            84.9 ns/op         0 B/op          0 allocs/op
-BenchmarkKocha_GithubStatic 20000000           111 ns/op           0 B/op          0 allocs/op
-BenchmarkMacaron_GithubStatic    1000000          2686 ns/op         752 B/op          8 allocs/op
-BenchmarkMartini_GithubStatic     100000         22244 ns/op         832 B/op         11 allocs/op
-BenchmarkPat_GithubStatic     100000         13278 ns/op        3648 B/op         76 allocs/op
-BenchmarkPossum_GithubStatic     1000000          1429 ns/op         480 B/op          4 allocs/op
-BenchmarkR2router_GithubStatic   2000000           726 ns/op         144 B/op          5 allocs/op
-BenchmarkRevel_GithubStatic   300000          6271 ns/op        1288 B/op         25 allocs/op
-BenchmarkRivet_GithubStatic  3000000           474 ns/op         112 B/op          2 allocs/op
-BenchmarkTango_GithubStatic  1000000          1842 ns/op         256 B/op         10 allocs/op
-BenchmarkTigerTonic_GithubStatic     5000000           361 ns/op          48 B/op          1 allocs/op
-BenchmarkTraffic_GithubStatic      30000         47197 ns/op       18920 B/op        149 allocs/op
-BenchmarkVulcan_GithubStatic     1000000          1415 ns/op          98 B/op          3 allocs/op
-BenchmarkZeus_GithubStatic   1000000          2522 ns/op         512 B/op         11 allocs/op
-BenchmarkAce_GithubParam     3000000           578 ns/op          96 B/op          1 allocs/op
-BenchmarkBear_GithubParam    1000000          1592 ns/op         464 B/op          5 allocs/op
-BenchmarkBeego_GithubParam   1000000          2891 ns/op         784 B/op         11 allocs/op
-BenchmarkBone_GithubParam     300000          6440 ns/op        1456 B/op         16 allocs/op
-BenchmarkDenco_GithubParam   3000000           514 ns/op         128 B/op          1 allocs/op
-BenchmarkEcho_GithubParam    5000000           292 ns/op           0 B/op          0 allocs/op
-BenchmarkGin_GithubParam    10000000           242 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_GithubParam  1000000          2343 ns/op         720 B/op         10 allocs/op
-BenchmarkGoji_GithubParam    1000000          1566 ns/op         336 B/op          2 allocs/op
-BenchmarkGoJsonRest_GithubParam  1000000          2828 ns/op         721 B/op         15 allocs/op
-BenchmarkGoRestful_GithubParam     10000        177711 ns/op        2816 B/op         35 allocs/op
-BenchmarkGorillaMux_GithubParam   100000         13591 ns/op         816 B/op          9 allocs/op
-BenchmarkHttpRouter_GithubParam  5000000           352 ns/op          96 B/op          1 allocs/op
-BenchmarkHttpTreeMux_GithubParam     2000000           973 ns/op         336 B/op          2 allocs/op
-BenchmarkKocha_GithubParam   2000000           889 ns/op         128 B/op          5 allocs/op
-BenchmarkMacaron_GithubParam      500000          4047 ns/op        1168 B/op         12 allocs/op
-BenchmarkMartini_GithubParam       50000         28982 ns/op        1184 B/op         12 allocs/op
-BenchmarkPat_GithubParam      200000          8747 ns/op        2480 B/op         56 allocs/op
-BenchmarkPossum_GithubParam  1000000          2158 ns/op         624 B/op          7 allocs/op
-BenchmarkR2router_GithubParam    1000000          1352 ns/op         432 B/op          6 allocs/op
-BenchmarkRevel_GithubParam    200000          7673 ns/op        1784 B/op         30 allocs/op
-BenchmarkRivet_GithubParam   1000000          1573 ns/op         480 B/op          6 allocs/op
-BenchmarkTango_GithubParam   1000000          2418 ns/op         480 B/op         13 allocs/op
-BenchmarkTigerTonic_GithubParam   300000          6048 ns/op        1440 B/op         28 allocs/op
-BenchmarkTraffic_GithubParam      100000         20143 ns/op        6024 B/op         55 allocs/op
-BenchmarkVulcan_GithubParam  1000000          2224 ns/op          98 B/op          3 allocs/op
-BenchmarkZeus_GithubParam     500000          4156 ns/op        1312 B/op         12 allocs/op
-BenchmarkAce_GithubAll     10000        109482 ns/op       13792 B/op        167 allocs/op
-BenchmarkBear_GithubAll    10000        287490 ns/op       79952 B/op        943 allocs/op
-BenchmarkBeego_GithubAll        3000        562184 ns/op      146272 B/op       2092 allocs/op
-BenchmarkBone_GithubAll      500       2578716 ns/op      648016 B/op       8119 allocs/op
-BenchmarkDenco_GithubAll       20000         94955 ns/op       20224 B/op        167 allocs/op
-BenchmarkEcho_GithubAll    30000         58705 ns/op           0 B/op          0 allocs/op
-BenchmarkGin_GithubAll     30000         50991 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_GithubAll       5000        449648 ns/op      133280 B/op       1889 allocs/op
-BenchmarkGoji_GithubAll     2000        689748 ns/op       56113 B/op        334 allocs/op
-BenchmarkGoJsonRest_GithubAll       5000        537769 ns/op      135995 B/op       2940 allocs/op
-BenchmarkGoRestful_GithubAll         100      18410628 ns/op      797236 B/op       7725 allocs/op
-BenchmarkGorillaMux_GithubAll        200       8036360 ns/op      153137 B/op       1791 allocs/op
-BenchmarkHttpRouter_GithubAll      20000         63506 ns/op       13792 B/op        167 allocs/op
-BenchmarkHttpTreeMux_GithubAll     10000        165927 ns/op       56112 B/op        334 allocs/op
-BenchmarkKocha_GithubAll       10000        171362 ns/op       23304 B/op        843 allocs/op
-BenchmarkMacaron_GithubAll      2000        817008 ns/op      224960 B/op       2315 allocs/op
-BenchmarkMartini_GithubAll       100      12609209 ns/op      237952 B/op       2686 allocs/op
-BenchmarkPat_GithubAll       300       4830398 ns/op     1504101 B/op      32222 allocs/op
-BenchmarkPossum_GithubAll      10000        301716 ns/op       97440 B/op        812 allocs/op
-BenchmarkR2router_GithubAll    10000        270691 ns/op       77328 B/op       1182 allocs/op
-BenchmarkRevel_GithubAll        1000       1491919 ns/op      345553 B/op       5918 allocs/op
-BenchmarkRivet_GithubAll       10000        283860 ns/op       84272 B/op       1079 allocs/op
-BenchmarkTango_GithubAll        5000        473821 ns/op       87078 B/op       2470 allocs/op
-BenchmarkTigerTonic_GithubAll       2000       1120131 ns/op      241088 B/op       6052 allocs/op
-BenchmarkTraffic_GithubAll       200       8708979 ns/op     2664762 B/op      22390 allocs/op
-BenchmarkVulcan_GithubAll       5000        353392 ns/op       19894 B/op        609 allocs/op
-BenchmarkZeus_GithubAll     2000        944234 ns/op      300688 B/op       2648 allocs/op
-BenchmarkAce_GPlusStatic     5000000           251 ns/op           0 B/op          0 allocs/op
-BenchmarkBear_GPlusStatic    3000000           415 ns/op          72 B/op          3 allocs/op
-BenchmarkBeego_GPlusStatic   1000000          1416 ns/op         352 B/op          7 allocs/op
-BenchmarkBone_GPlusStatic   10000000           192 ns/op          32 B/op          1 allocs/op
-BenchmarkDenco_GPlusStatic  30000000            47.6 ns/op         0 B/op          0 allocs/op
-BenchmarkEcho_GPlusStatic   10000000           131 ns/op           0 B/op          0 allocs/op
-BenchmarkGin_GPlusStatic    10000000           131 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_GPlusStatic  1000000          1035 ns/op         288 B/op          6 allocs/op
-BenchmarkGoji_GPlusStatic    5000000           304 ns/op           0 B/op          0 allocs/op
-BenchmarkGoJsonRest_GPlusStatic  1000000          1286 ns/op         337 B/op         12 allocs/op
-BenchmarkGoRestful_GPlusStatic    200000          9649 ns/op        2160 B/op         30 allocs/op
-BenchmarkGorillaMux_GPlusStatic  1000000          2346 ns/op         464 B/op          8 allocs/op
-BenchmarkHttpRouter_GPlusStatic 30000000            42.7 ns/op         0 B/op          0 allocs/op
-BenchmarkHttpTreeMux_GPlusStatic    30000000            49.5 ns/op         0 B/op          0 allocs/op
-BenchmarkKocha_GPlusStatic  20000000            74.8 ns/op         0 B/op          0 allocs/op
-BenchmarkMacaron_GPlusStatic     1000000          2520 ns/op         736 B/op          8 allocs/op
-BenchmarkMartini_GPlusStatic      300000          5310 ns/op         832 B/op         11 allocs/op
-BenchmarkPat_GPlusStatic     5000000           398 ns/op          96 B/op          2 allocs/op
-BenchmarkPossum_GPlusStatic  1000000          1434 ns/op         480 B/op          4 allocs/op
-BenchmarkR2router_GPlusStatic    2000000           646 ns/op         144 B/op          5 allocs/op
-BenchmarkRevel_GPlusStatic    300000          6172 ns/op        1272 B/op         25 allocs/op
-BenchmarkRivet_GPlusStatic   3000000           444 ns/op         112 B/op          2 allocs/op
-BenchmarkTango_GPlusStatic   1000000          1400 ns/op         208 B/op         10 allocs/op
-BenchmarkTigerTonic_GPlusStatic 10000000           213 ns/op          32 B/op          1 allocs/op
-BenchmarkTraffic_GPlusStatic     1000000          3091 ns/op        1208 B/op         16 allocs/op
-BenchmarkVulcan_GPlusStatic  2000000           863 ns/op          98 B/op          3 allocs/op
-BenchmarkZeus_GPlusStatic   10000000           237 ns/op          16 B/op          1 allocs/op
-BenchmarkAce_GPlusParam  3000000           435 ns/op          64 B/op          1 allocs/op
-BenchmarkBear_GPlusParam     1000000          1205 ns/op         448 B/op          5 allocs/op
-BenchmarkBeego_GPlusParam    1000000          2494 ns/op         720 B/op         10 allocs/op
-BenchmarkBone_GPlusParam     1000000          1126 ns/op         384 B/op          3 allocs/op
-BenchmarkDenco_GPlusParam    5000000           325 ns/op          64 B/op          1 allocs/op
-BenchmarkEcho_GPlusParam    10000000           168 ns/op           0 B/op          0 allocs/op
-BenchmarkGin_GPlusParam 10000000           170 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_GPlusParam   1000000          1895 ns/op         656 B/op          9 allocs/op
-BenchmarkGoji_GPlusParam     1000000          1071 ns/op         336 B/op          2 allocs/op
-BenchmarkGoJsonRest_GPlusParam   1000000          2282 ns/op         657 B/op         14 allocs/op
-BenchmarkGoRestful_GPlusParam     100000         19400 ns/op        2560 B/op         33 allocs/op
-BenchmarkGorillaMux_GPlusParam    500000          5001 ns/op         784 B/op          9 allocs/op
-BenchmarkHttpRouter_GPlusParam  10000000           240 ns/op          64 B/op          1 allocs/op
-BenchmarkHttpTreeMux_GPlusParam  2000000           797 ns/op         336 B/op          2 allocs/op
-BenchmarkKocha_GPlusParam    3000000           505 ns/op          56 B/op          3 allocs/op
-BenchmarkMacaron_GPlusParam  1000000          3668 ns/op        1104 B/op         11 allocs/op
-BenchmarkMartini_GPlusParam   200000         10672 ns/op        1152 B/op         12 allocs/op
-BenchmarkPat_GPlusParam  1000000          2376 ns/op         704 B/op         14 allocs/op
-BenchmarkPossum_GPlusParam   1000000          2090 ns/op         624 B/op          7 allocs/op
-BenchmarkR2router_GPlusParam     1000000          1233 ns/op         432 B/op          6 allocs/op
-BenchmarkRevel_GPlusParam     200000          6778 ns/op        1704 B/op         28 allocs/op
-BenchmarkRivet_GPlusParam    1000000          1279 ns/op         464 B/op          5 allocs/op
-BenchmarkTango_GPlusParam    1000000          1981 ns/op         272 B/op         10 allocs/op
-BenchmarkTigerTonic_GPlusParam    500000          3893 ns/op        1064 B/op         19 allocs/op
-BenchmarkTraffic_GPlusParam   200000          6585 ns/op        2000 B/op         23 allocs/op
-BenchmarkVulcan_GPlusParam   1000000          1233 ns/op          98 B/op          3 allocs/op
-BenchmarkZeus_GPlusParam     1000000          1350 ns/op         368 B/op          3 allocs/op
-BenchmarkAce_GPlus2Params    3000000           512 ns/op          64 B/op          1 allocs/op
-BenchmarkBear_GPlus2Params   1000000          1564 ns/op         464 B/op          5 allocs/op
-BenchmarkBeego_GPlus2Params  1000000          3043 ns/op         784 B/op         11 allocs/op
-BenchmarkBone_GPlus2Params   1000000          3152 ns/op         736 B/op          7 allocs/op
-BenchmarkDenco_GPlus2Params  3000000           431 ns/op          64 B/op          1 allocs/op
-BenchmarkEcho_GPlus2Params   5000000           247 ns/op           0 B/op          0 allocs/op
-BenchmarkGin_GPlus2Params   10000000           219 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_GPlus2Params     1000000          2363 ns/op         720 B/op         10 allocs/op
-BenchmarkGoji_GPlus2Params   1000000          1540 ns/op         336 B/op          2 allocs/op
-BenchmarkGoJsonRest_GPlus2Params     1000000          2872 ns/op         721 B/op         15 allocs/op
-BenchmarkGoRestful_GPlus2Params   100000         23030 ns/op        2720 B/op         35 allocs/op
-BenchmarkGorillaMux_GPlus2Params      200000         10516 ns/op         816 B/op          9 allocs/op
-BenchmarkHttpRouter_GPlus2Params     5000000           273 ns/op          64 B/op          1 allocs/op
-BenchmarkHttpTreeMux_GPlus2Params    2000000           939 ns/op         336 B/op          2 allocs/op
-BenchmarkKocha_GPlus2Params  2000000           844 ns/op         128 B/op          5 allocs/op
-BenchmarkMacaron_GPlus2Params     500000          3914 ns/op        1168 B/op         12 allocs/op
-BenchmarkMartini_GPlus2Params      50000         35759 ns/op        1280 B/op         16 allocs/op
-BenchmarkPat_GPlus2Params     200000          7089 ns/op        2304 B/op         41 allocs/op
-BenchmarkPossum_GPlus2Params     1000000          2093 ns/op         624 B/op          7 allocs/op
-BenchmarkR2router_GPlus2Params   1000000          1320 ns/op         432 B/op          6 allocs/op
-BenchmarkRevel_GPlus2Params   200000          7351 ns/op        1800 B/op         30 allocs/op
-BenchmarkRivet_GPlus2Params  1000000          1485 ns/op         480 B/op          6 allocs/op
-BenchmarkTango_GPlus2Params  1000000          2111 ns/op         448 B/op         12 allocs/op
-BenchmarkTigerTonic_GPlus2Params      300000          6271 ns/op        1528 B/op         28 allocs/op
-BenchmarkTraffic_GPlus2Params     100000         14886 ns/op        3312 B/op         34 allocs/op
-BenchmarkVulcan_GPlus2Params     1000000          1883 ns/op          98 B/op          3 allocs/op
-BenchmarkZeus_GPlus2Params   1000000          2686 ns/op         784 B/op          6 allocs/op
-BenchmarkAce_GPlusAll     300000          5912 ns/op         640 B/op         11 allocs/op
-BenchmarkBear_GPlusAll    100000         16448 ns/op        5072 B/op         61 allocs/op
-BenchmarkBeego_GPlusAll    50000         32916 ns/op        8976 B/op        129 allocs/op
-BenchmarkBone_GPlusAll     50000         25836 ns/op        6992 B/op         76 allocs/op
-BenchmarkDenco_GPlusAll   500000          4462 ns/op         672 B/op         11 allocs/op
-BenchmarkEcho_GPlusAll    500000          2806 ns/op           0 B/op          0 allocs/op
-BenchmarkGin_GPlusAll     500000          2579 ns/op           0 B/op          0 allocs/op
-BenchmarkGocraftWeb_GPlusAll       50000         25223 ns/op        8144 B/op        116 allocs/op
-BenchmarkGoji_GPlusAll    100000         14237 ns/op        3696 B/op         22 allocs/op
-BenchmarkGoJsonRest_GPlusAll       50000         29227 ns/op        8221 B/op        183 allocs/op
-BenchmarkGoRestful_GPlusAll    10000        203144 ns/op       36064 B/op        441 allocs/op
-BenchmarkGorillaMux_GPlusAll       20000         80906 ns/op        9712 B/op        115 allocs/op
-BenchmarkHttpRouter_GPlusAll      500000          3040 ns/op         640 B/op         11 allocs/op
-BenchmarkHttpTreeMux_GPlusAll     200000          9627 ns/op        3696 B/op         22 allocs/op
-BenchmarkKocha_GPlusAll   200000          8108 ns/op         976 B/op         43 allocs/op
-BenchmarkMacaron_GPlusAll      30000         48083 ns/op       13968 B/op        142 allocs/op
-BenchmarkMartini_GPlusAll      10000        196978 ns/op       15072 B/op        178 allocs/op
-BenchmarkPat_GPlusAll      30000         58865 ns/op       16880 B/op        343 allocs/op
-BenchmarkPossum_GPlusAll      100000         19685 ns/op        6240 B/op         52 allocs/op
-BenchmarkR2router_GPlusAll    100000         16251 ns/op        5040 B/op         76 allocs/op
-BenchmarkRevel_GPlusAll    20000         93489 ns/op       21656 B/op        368 allocs/op
-BenchmarkRivet_GPlusAll   100000         16907 ns/op        5408 B/op         64 allocs/op
+Gin:             30512 Bytes
+
+HttpServeMux:    17344 Bytes
+Ace:             30080 Bytes
+Bear:            30472 Bytes
+Beego:           96408 Bytes
+Bone:            37904 Bytes
+Denco:           10464 Bytes
+Echo:            73680 Bytes
+GocraftWeb:      55720 Bytes
+Goji:            27200 Bytes
+Gojiv2:         104464 Bytes
+GoJsonRest:     136472 Bytes
+GoRestful:      914904 Bytes
+GorillaMux:     675568 Bytes
+HttpRouter:      21128 Bytes
+HttpTreeMux:     73448 Bytes
+Kocha:          115072 Bytes
+LARS:            30120 Bytes
+Macaron:         37984 Bytes
+Martini:        310832 Bytes
+Pat:             20464 Bytes
+Possum:          91328 Bytes
+R2router:        23712 Bytes
+Rivet:           23880 Bytes
+Tango:           28008 Bytes
+TigerTonic:      80368 Bytes
+Traffic:        626480 Bytes
+Vulcan:         369064 Bytes
+```
+
+## GithubAPI Routes: 203
+
+```
+Gin:             52672 Bytes
+
+Ace:             48992 Bytes
+Bear:           161592 Bytes
+Beego:          147992 Bytes
+Bone:            97728 Bytes
+Denco:           36440 Bytes
+Echo:            95672 Bytes
+GocraftWeb:      95640 Bytes
+Goji:            86088 Bytes
+Gojiv2:         144392 Bytes
+GoJsonRest:     134648 Bytes
+GoRestful:     1410760 Bytes
+GorillaMux:    1509488 Bytes
+HttpRouter:      37464 Bytes
+HttpTreeMux:     78800 Bytes
+Kocha:          785408 Bytes
+LARS:            49032 Bytes
+Macaron:        132712 Bytes
+Martini:        564352 Bytes
+Pat:             21200 Bytes
+Possum:          83888 Bytes
+R2router:        47104 Bytes
+Rivet:           42840 Bytes
+Tango:           54584 Bytes
+TigerTonic:      96384 Bytes
+Traffic:       1061920 Bytes
+Vulcan:         465296 Bytes
+```
+
+## GPlusAPI Routes: 13
+
+```
+Gin:              3968 Bytes
+
+Ace:              3600 Bytes
+Bear:             7112 Bytes
+Beego:           10048 Bytes
+Bone:             6480 Bytes
+Denco:            3256 Bytes
+Echo:             9000 Bytes
+GocraftWeb:       7496 Bytes
+Goji:             2912 Bytes
+Gojiv2:           7376 Bytes
+GoJsonRest:      11544 Bytes
+GoRestful:       88776 Bytes
+GorillaMux:      71488 Bytes
+HttpRouter:       2712 Bytes
+HttpTreeMux:      7440 Bytes
+Kocha:          128880 Bytes
+LARS:             3640 Bytes
+Macaron:          8656 Bytes
+Martini:         23936 Bytes
+Pat:              1856 Bytes
+Possum:           7248 Bytes
+R2router:         3928 Bytes
+Rivet:            3064 Bytes
+Tango:            4912 Bytes
+TigerTonic:       9408 Bytes
+Traffic:         49472 Bytes
+Vulcan:          25496 Bytes
+```
+
+## ParseAPI Routes: 26
+
+```
+Gin:              6928 Bytes
+
+Ace:              6592 Bytes
+Bear:            12320 Bytes
+Beego:           18960 Bytes
+Bone:            11024 Bytes
+Denco:            4184 Bytes
+Echo:            11168 Bytes
+GocraftWeb:      12800 Bytes
+Goji:             5232 Bytes
+Gojiv2:          14464 Bytes
+GoJsonRest:      14216 Bytes
+GoRestful:      127368 Bytes
+GorillaMux:     123016 Bytes
+HttpRouter:       4976 Bytes
+HttpTreeMux:      7848 Bytes
+Kocha:          181712 Bytes
+LARS:             6632 Bytes
+Macaron:         13648 Bytes
+Martini:         45952 Bytes
+Pat:              2560 Bytes
+Possum:           9200 Bytes
+R2router:         7056 Bytes
+Rivet:            5680 Bytes
+Tango:            8664 Bytes
+TigerTonic:       9840 Bytes
+Traffic:         93480 Bytes
+Vulcan:          44504 Bytes
+```
+
+## Static Routes
+
+```
+BenchmarkGin_StaticAll                     50000             34506 ns/op               0 B/op          0 allocs/op
+
+BenchmarkAce_StaticAll                     30000             49657 ns/op               0 B/op          0 allocs/op
+BenchmarkHttpServeMux_StaticAll             2000           1183737 ns/op              96 B/op          8 allocs/op
+BenchmarkBeego_StaticAll                    5000            412621 ns/op           57776 B/op        628 allocs/op
+BenchmarkBear_StaticAll                    10000            149242 ns/op           20336 B/op        461 allocs/op
+BenchmarkBone_StaticAll                    10000            118583 ns/op               0 B/op          0 allocs/op
+BenchmarkDenco_StaticAll                  100000             13247 ns/op               0 B/op          0 allocs/op
+BenchmarkEcho_StaticAll                    20000             79914 ns/op            5024 B/op        157 allocs/op
+BenchmarkGocraftWeb_StaticAll              10000            211823 ns/op           46440 B/op        785 allocs/op
+BenchmarkGoji_StaticAll                    10000            109390 ns/op               0 B/op          0 allocs/op
+BenchmarkGojiv2_StaticAll                   3000            415533 ns/op          145696 B/op       1099 allocs/op
+BenchmarkGoJsonRest_StaticAll               5000            364403 ns/op           51653 B/op       1727 allocs/op
+BenchmarkGoRestful_StaticAll                 500           2578579 ns/op          314936 B/op       3144 allocs/op
+BenchmarkGorillaMux_StaticAll                500           2704856 ns/op          115648 B/op       1578 allocs/op
+BenchmarkHttpRouter_StaticAll             100000             18541 ns/op               0 B/op          0 allocs/op
+BenchmarkHttpTreeMux_StaticAll            100000             22332 ns/op               0 B/op          0 allocs/op
+BenchmarkKocha_StaticAll                   50000             31176 ns/op               0 B/op          0 allocs/op
+BenchmarkLARS_StaticAll                    50000             40840 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_StaticAll                  5000            517656 ns/op          120576 B/op       1413 allocs/op
+BenchmarkMartini_StaticAll                   300           4462289 ns/op          125442 B/op       1717 allocs/op
+BenchmarkPat_StaticAll                       500           2157275 ns/op          533904 B/op      11123 allocs/op
+BenchmarkPossum_StaticAll                  10000            254701 ns/op           65312 B/op        471 allocs/op
+BenchmarkR2router_StaticAll                10000            133956 ns/op           22608 B/op        628 allocs/op
+BenchmarkRivet_StaticAll                   30000             46812 ns/op               0 B/op          0 allocs/op
+BenchmarkTango_StaticAll                    5000            390613 ns/op           39225 B/op       1256 allocs/op
+BenchmarkTigerTonic_StaticAll              20000             88060 ns/op            7504 B/op        157 allocs/op
+BenchmarkTraffic_StaticAll                   500           2910236 ns/op          729736 B/op      14287 allocs/op
+BenchmarkVulcan_StaticAll                   5000            277366 ns/op           15386 B/op        471 allocs/op
+```
+
+## Micro Benchmarks
+
+```
+BenchmarkGin_Param                      20000000               113 ns/op               0 B/op          0 allocs/op
+
+BenchmarkAce_Param                       5000000               375 ns/op              32 B/op          1 allocs/op
+BenchmarkBear_Param                      1000000              1709 ns/op             456 B/op          5 allocs/op
+BenchmarkBeego_Param                     1000000              2484 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_Param                      1000000              2391 ns/op             688 B/op          5 allocs/op
+BenchmarkDenco_Param                    10000000               240 ns/op              32 B/op          1 allocs/op
+BenchmarkEcho_Param                      5000000               366 ns/op              32 B/op          1 allocs/op
+BenchmarkGocraftWeb_Param                1000000              2343 ns/op             648 B/op          8 allocs/op
+BenchmarkGoji_Param                      1000000              1197 ns/op             336 B/op          2 allocs/op
+BenchmarkGojiv2_Param                    1000000              2771 ns/op             944 B/op          8 allocs/op
+BenchmarkGoJsonRest_Param                1000000              2993 ns/op             649 B/op         13 allocs/op
+BenchmarkGoRestful_Param                  200000              8860 ns/op            2296 B/op         21 allocs/op
+BenchmarkGorillaMux_Param                 500000              4461 ns/op            1056 B/op         11 allocs/op
+BenchmarkHttpRouter_Param               10000000               175 ns/op              32 B/op          1 allocs/op
+BenchmarkHttpTreeMux_Param               1000000              1167 ns/op             352 B/op          3 allocs/op
+BenchmarkKocha_Param                     3000000               429 ns/op              56 B/op          3 allocs/op
+BenchmarkLARS_Param                     10000000               134 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_Param                    500000              4635 ns/op            1056 B/op         10 allocs/op
+BenchmarkMartini_Param                    200000              9933 ns/op            1072 B/op         10 allocs/op
+BenchmarkPat_Param                       1000000              2929 ns/op             648 B/op         12 allocs/op
+BenchmarkPossum_Param                    1000000              2503 ns/op             560 B/op          6 allocs/op
+BenchmarkR2router_Param                  1000000              1507 ns/op             432 B/op          5 allocs/op
+BenchmarkRivet_Param                     5000000               297 ns/op              48 B/op          1 allocs/op
+BenchmarkTango_Param                     1000000              1862 ns/op             248 B/op          8 allocs/op
+BenchmarkTigerTonic_Param                 500000              5660 ns/op             992 B/op         17 allocs/op
+BenchmarkTraffic_Param                    200000              8408 ns/op            1960 B/op         21 allocs/op
+BenchmarkVulcan_Param                    2000000               963 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_Param5                      2000000               740 ns/op             160 B/op          1 allocs/op
+BenchmarkBear_Param5                     1000000              2777 ns/op             501 B/op          5 allocs/op
+BenchmarkBeego_Param5                    1000000              3740 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_Param5                     1000000              2950 ns/op             736 B/op          5 allocs/op
+BenchmarkDenco_Param5                    2000000               644 ns/op             160 B/op          1 allocs/op
+BenchmarkEcho_Param5                     3000000               558 ns/op              32 B/op          1 allocs/op
+BenchmarkGin_Param5                     10000000               198 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_Param5                500000              3870 ns/op             920 B/op         11 allocs/op
+BenchmarkGoji_Param5                     1000000              1746 ns/op             336 B/op          2 allocs/op
+BenchmarkGojiv2_Param5                   1000000              3214 ns/op            1008 B/op          8 allocs/op
+BenchmarkGoJsonRest_Param5                500000              5509 ns/op            1097 B/op         16 allocs/op
+BenchmarkGoRestful_Param5                 200000             11232 ns/op            2392 B/op         21 allocs/op
+BenchmarkGorillaMux_Param5                300000              7777 ns/op            1184 B/op         11 allocs/op
+BenchmarkHttpRouter_Param5               3000000               631 ns/op             160 B/op          1 allocs/op
+BenchmarkHttpTreeMux_Param5              1000000              2800 ns/op             576 B/op          6 allocs/op
+BenchmarkKocha_Param5                    1000000              2053 ns/op             440 B/op         10 allocs/op
+BenchmarkLARS_Param5                    10000000               232 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_Param5                   500000              5888 ns/op            1056 B/op         10 allocs/op
+BenchmarkMartini_Param5                   200000             12807 ns/op            1232 B/op         11 allocs/op
+BenchmarkPat_Param5                       300000              7320 ns/op             964 B/op         32 allocs/op
+BenchmarkPossum_Param5                   1000000              2495 ns/op             560 B/op          6 allocs/op
+BenchmarkR2router_Param5                 1000000              1844 ns/op             432 B/op          5 allocs/op
+BenchmarkRivet_Param5                    2000000               935 ns/op             240 B/op          1 allocs/op
+BenchmarkTango_Param5                    1000000              2327 ns/op             360 B/op          8 allocs/op
+BenchmarkTigerTonic_Param5                100000             18514 ns/op            2551 B/op         43 allocs/op
+BenchmarkTraffic_Param5                   200000             11997 ns/op            2248 B/op         25 allocs/op
+BenchmarkVulcan_Param5                   1000000              1333 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_Param20                     1000000              2031 ns/op             640 B/op          1 allocs/op
+BenchmarkBear_Param20                     200000              7285 ns/op            1664 B/op          5 allocs/op
+BenchmarkBeego_Param20                    300000              6224 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_Param20                     200000              8023 ns/op            1903 B/op          5 allocs/op
+BenchmarkDenco_Param20                   1000000              2262 ns/op             640 B/op          1 allocs/op
+BenchmarkEcho_Param20                    1000000              1387 ns/op              32 B/op          1 allocs/op
+BenchmarkGin_Param20                     3000000               503 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_Param20               100000             14408 ns/op            3795 B/op         15 allocs/op
+BenchmarkGoji_Param20                     500000              5272 ns/op            1247 B/op          2 allocs/op
+BenchmarkGojiv2_Param20                  1000000              4163 ns/op            1248 B/op          8 allocs/op
+BenchmarkGoJsonRest_Param20               100000             17866 ns/op            4485 B/op         20 allocs/op
+BenchmarkGoRestful_Param20                100000             21022 ns/op            4724 B/op         23 allocs/op
+BenchmarkGorillaMux_Param20               100000             17055 ns/op            3547 B/op         13 allocs/op
+BenchmarkHttpRouter_Param20              1000000              1748 ns/op             640 B/op          1 allocs/op
+BenchmarkHttpTreeMux_Param20              200000             12246 ns/op            3196 B/op         10 allocs/op
+BenchmarkKocha_Param20                    300000              6861 ns/op            1808 B/op         27 allocs/op
+BenchmarkLARS_Param20                    3000000               526 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_Param20                  100000             13069 ns/op            2906 B/op         12 allocs/op
+BenchmarkMartini_Param20                  100000             23602 ns/op            3597 B/op         13 allocs/op
+BenchmarkPat_Param20                       50000             32143 ns/op            4688 B/op        111 allocs/op
+BenchmarkPossum_Param20                  1000000              2396 ns/op             560 B/op          6 allocs/op
+BenchmarkR2router_Param20                 200000              8907 ns/op            2283 B/op          7 allocs/op
+BenchmarkRivet_Param20                   1000000              3280 ns/op            1024 B/op          1 allocs/op
+BenchmarkTango_Param20                    500000              4640 ns/op             856 B/op          8 allocs/op
+BenchmarkTigerTonic_Param20                20000             67581 ns/op           10532 B/op        138 allocs/op
+BenchmarkTraffic_Param20                   50000             40313 ns/op            7941 B/op         45 allocs/op
+BenchmarkVulcan_Param20                  1000000              2264 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_ParamWrite                  3000000               532 ns/op              40 B/op          2 allocs/op
+BenchmarkBear_ParamWrite                 1000000              1778 ns/op             456 B/op          5 allocs/op
+BenchmarkBeego_ParamWrite                1000000              2596 ns/op             376 B/op          5 allocs/op
+BenchmarkBone_ParamWrite                 1000000              2519 ns/op             688 B/op          5 allocs/op
+BenchmarkDenco_ParamWrite                5000000               411 ns/op              32 B/op          1 allocs/op
+BenchmarkEcho_ParamWrite                 2000000               718 ns/op              40 B/op          2 allocs/op
+BenchmarkGin_ParamWrite                  5000000               283 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_ParamWrite           1000000              2561 ns/op             656 B/op          9 allocs/op
+BenchmarkGoji_ParamWrite                 1000000              1378 ns/op             336 B/op          2 allocs/op
+BenchmarkGojiv2_ParamWrite               1000000              3128 ns/op             976 B/op         10 allocs/op
+BenchmarkGoJsonRest_ParamWrite            500000              4446 ns/op            1128 B/op         18 allocs/op
+BenchmarkGoRestful_ParamWrite             200000             10291 ns/op            2304 B/op         22 allocs/op
+BenchmarkGorillaMux_ParamWrite            500000              5153 ns/op            1064 B/op         12 allocs/op
+BenchmarkHttpRouter_ParamWrite           5000000               263 ns/op              32 B/op          1 allocs/op
+BenchmarkHttpTreeMux_ParamWrite          1000000              1351 ns/op             352 B/op          3 allocs/op
+BenchmarkKocha_ParamWrite                3000000               538 ns/op              56 B/op          3 allocs/op
+BenchmarkLARS_ParamWrite                 5000000               316 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_ParamWrite               500000              5756 ns/op            1160 B/op         14 allocs/op
+BenchmarkMartini_ParamWrite               200000             13097 ns/op            1176 B/op         14 allocs/op
+BenchmarkPat_ParamWrite                   500000              4954 ns/op            1072 B/op         17 allocs/op
+BenchmarkPossum_ParamWrite               1000000              2499 ns/op             560 B/op          6 allocs/op
+BenchmarkR2router_ParamWrite             1000000              1531 ns/op             432 B/op          5 allocs/op
+BenchmarkRivet_ParamWrite                3000000               570 ns/op             112 B/op          2 allocs/op
+BenchmarkTango_ParamWrite                2000000               957 ns/op             136 B/op          4 allocs/op
+BenchmarkTigerTonic_ParamWrite            200000              7025 ns/op            1424 B/op         23 allocs/op
+BenchmarkTraffic_ParamWrite               200000             10112 ns/op            2384 B/op         25 allocs/op
+BenchmarkVulcan_ParamWrite               1000000              1006 ns/op              98 B/op          3 allocs/op
+```
+
+## GitHub
+
+```
+BenchmarkGin_GithubStatic               10000000               156 ns/op               0 B/op          0 allocs/op
+
+BenchmarkAce_GithubStatic                5000000               294 ns/op               0 B/op          0 allocs/op
+BenchmarkBear_GithubStatic               2000000               893 ns/op             120 B/op          3 allocs/op
+BenchmarkBeego_GithubStatic              1000000              2491 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_GithubStatic                 50000             25300 ns/op            2880 B/op         60 allocs/op
+BenchmarkDenco_GithubStatic             20000000                76.0 ns/op             0 B/op          0 allocs/op
+BenchmarkEcho_GithubStatic               2000000               516 ns/op              32 B/op          1 allocs/op
+BenchmarkGocraftWeb_GithubStatic         1000000              1448 ns/op             296 B/op          5 allocs/op
+BenchmarkGoji_GithubStatic               3000000               496 ns/op               0 B/op          0 allocs/op
+BenchmarkGojiv2_GithubStatic             1000000              2941 ns/op             928 B/op          7 allocs/op
+BenchmarkGoRestful_GithubStatic           100000             27256 ns/op            3224 B/op         22 allocs/op
+BenchmarkGoJsonRest_GithubStatic         1000000              2196 ns/op             329 B/op         11 allocs/op
+BenchmarkGorillaMux_GithubStatic           50000             31617 ns/op             736 B/op         10 allocs/op
+BenchmarkHttpRouter_GithubStatic        20000000                88.4 ns/op             0 B/op          0 allocs/op
+BenchmarkHttpTreeMux_GithubStatic       10000000               134 ns/op               0 B/op          0 allocs/op
+BenchmarkKocha_GithubStatic             20000000               113 ns/op               0 B/op          0 allocs/op
+BenchmarkLARS_GithubStatic              10000000               195 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_GithubStatic             500000              3740 ns/op             768 B/op          9 allocs/op
+BenchmarkMartini_GithubStatic              50000             27673 ns/op             768 B/op          9 allocs/op
+BenchmarkPat_GithubStatic                 100000             19470 ns/op            3648 B/op         76 allocs/op
+BenchmarkPossum_GithubStatic             1000000              1729 ns/op             416 B/op          3 allocs/op
+BenchmarkR2router_GithubStatic           2000000               879 ns/op             144 B/op          4 allocs/op
+BenchmarkRivet_GithubStatic             10000000               231 ns/op               0 B/op          0 allocs/op
+BenchmarkTango_GithubStatic              1000000              2325 ns/op             248 B/op          8 allocs/op
+BenchmarkTigerTonic_GithubStatic         3000000               610 ns/op              48 B/op          1 allocs/op
+BenchmarkTraffic_GithubStatic              20000             62973 ns/op           18904 B/op        148 allocs/op
+BenchmarkVulcan_GithubStatic             1000000              1447 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_GithubParam                 2000000               686 ns/op              96 B/op          1 allocs/op
+BenchmarkBear_GithubParam                1000000              2155 ns/op             496 B/op          5 allocs/op
+BenchmarkBeego_GithubParam               1000000              2713 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_GithubParam                 100000             15088 ns/op            1760 B/op         18 allocs/op
+BenchmarkDenco_GithubParam               2000000               629 ns/op             128 B/op          1 allocs/op
+BenchmarkEcho_GithubParam                2000000               653 ns/op              32 B/op          1 allocs/op
+BenchmarkGin_GithubParam                 5000000               255 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_GithubParam          1000000              3145 ns/op             712 B/op          9 allocs/op
+BenchmarkGoji_GithubParam                1000000              1916 ns/op             336 B/op          2 allocs/op
+BenchmarkGojiv2_GithubParam              1000000              3975 ns/op            1024 B/op         10 allocs/op
+BenchmarkGoJsonRest_GithubParam           300000              4134 ns/op             713 B/op         14 allocs/op
+BenchmarkGoRestful_GithubParam             50000             30782 ns/op            2360 B/op         21 allocs/op
+BenchmarkGorillaMux_GithubParam           100000             17148 ns/op            1088 B/op         11 allocs/op
+BenchmarkHttpRouter_GithubParam          3000000               523 ns/op              96 B/op          1 allocs/op
+BenchmarkHttpTreeMux_GithubParam         1000000              1671 ns/op             384 B/op          4 allocs/op
+BenchmarkKocha_GithubParam               1000000              1021 ns/op             128 B/op          5 allocs/op
+BenchmarkLARS_GithubParam                5000000               283 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_GithubParam              500000              4270 ns/op            1056 B/op         10 allocs/op
+BenchmarkMartini_GithubParam              100000             21728 ns/op            1152 B/op         11 allocs/op
+BenchmarkPat_GithubParam                  200000             11208 ns/op            2464 B/op         48 allocs/op
+BenchmarkPossum_GithubParam              1000000              2334 ns/op             560 B/op          6 allocs/op
+BenchmarkR2router_GithubParam            1000000              1487 ns/op             432 B/op          5 allocs/op
+BenchmarkRivet_GithubParam               2000000               782 ns/op              96 B/op          1 allocs/op
+BenchmarkTango_GithubParam               1000000              2653 ns/op             344 B/op          8 allocs/op
+BenchmarkTigerTonic_GithubParam           300000             14073 ns/op            1440 B/op         24 allocs/op
+BenchmarkTraffic_GithubParam               50000             29164 ns/op            5992 B/op         52 allocs/op
+BenchmarkVulcan_GithubParam              1000000              2529 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_GithubAll                     10000            134059 ns/op           13792 B/op        167 allocs/op
+BenchmarkBear_GithubAll                     5000            534445 ns/op           86448 B/op        943 allocs/op
+BenchmarkBeego_GithubAll                    3000            592444 ns/op           74705 B/op        812 allocs/op
+BenchmarkBone_GithubAll                      200           6957308 ns/op          698784 B/op       8453 allocs/op
+BenchmarkDenco_GithubAll                   10000            158819 ns/op           20224 B/op        167 allocs/op
+BenchmarkEcho_GithubAll                    10000            154700 ns/op            6496 B/op        203 allocs/op
+BenchmarkGin_GithubAll                     30000             48375 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_GithubAll               3000            570806 ns/op          131656 B/op       1686 allocs/op
+BenchmarkGoji_GithubAll                     2000            818034 ns/op           56112 B/op        334 allocs/op
+BenchmarkGojiv2_GithubAll                   2000           1213973 ns/op          274768 B/op       3712 allocs/op
+BenchmarkGoJsonRest_GithubAll               2000            785796 ns/op          134371 B/op       2737 allocs/op
+BenchmarkGoRestful_GithubAll                 300           5238188 ns/op          689672 B/op       4519 allocs/op
+BenchmarkGorillaMux_GithubAll                100          10257726 ns/op          211840 B/op       2272 allocs/op
+BenchmarkHttpRouter_GithubAll              20000            105414 ns/op           13792 B/op        167 allocs/op
+BenchmarkHttpTreeMux_GithubAll             10000            319934 ns/op           65856 B/op        671 allocs/op
+BenchmarkKocha_GithubAll                   10000            209442 ns/op           23304 B/op        843 allocs/op
+BenchmarkLARS_GithubAll                    20000             62565 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_GithubAll                  2000           1161270 ns/op          204194 B/op       2000 allocs/op
+BenchmarkMartini_GithubAll                   200           9991713 ns/op          226549 B/op       2325 allocs/op
+BenchmarkPat_GithubAll                       200           5590793 ns/op         1499568 B/op      27435 allocs/op
+BenchmarkPossum_GithubAll                  10000            319768 ns/op           84448 B/op        609 allocs/op
+BenchmarkR2router_GithubAll                10000            305134 ns/op           77328 B/op        979 allocs/op
+BenchmarkRivet_GithubAll                   10000            132134 ns/op           16272 B/op        167 allocs/op
+BenchmarkTango_GithubAll                    3000            552754 ns/op           63826 B/op       1618 allocs/op
+BenchmarkTigerTonic_GithubAll               1000           1439483 ns/op          239104 B/op       5374 allocs/op
+BenchmarkTraffic_GithubAll                   100          11383067 ns/op         2659329 B/op      21848 allocs/op
+BenchmarkVulcan_GithubAll                   5000            394253 ns/op           19894 B/op        609 allocs/op
+```
+
+## Google+
+
+```
+BenchmarkGin_GPlusStatic                10000000               183 ns/op               0 B/op          0 allocs/op
+
+BenchmarkAce_GPlusStatic                 5000000               276 ns/op               0 B/op          0 allocs/op
+BenchmarkBear_GPlusStatic                2000000               652 ns/op             104 B/op          3 allocs/op
+BenchmarkBeego_GPlusStatic               1000000              2239 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_GPlusStatic                5000000               380 ns/op              32 B/op          1 allocs/op
+BenchmarkDenco_GPlusStatic              30000000                45.8 ns/op             0 B/op          0 allocs/op
+BenchmarkEcho_GPlusStatic                5000000               338 ns/op              32 B/op          1 allocs/op
+BenchmarkGocraftWeb_GPlusStatic          1000000              1158 ns/op             280 B/op          5 allocs/op
+BenchmarkGoji_GPlusStatic                5000000               331 ns/op               0 B/op          0 allocs/op
+BenchmarkGojiv2_GPlusStatic              1000000              2106 ns/op             928 B/op          7 allocs/op
+BenchmarkGoJsonRest_GPlusStatic          1000000              1626 ns/op             329 B/op         11 allocs/op
+BenchmarkGoRestful_GPlusStatic            300000              7598 ns/op            1976 B/op         20 allocs/op
+BenchmarkGorillaMux_GPlusStatic          1000000              2629 ns/op             736 B/op         10 allocs/op
+BenchmarkHttpRouter_GPlusStatic         30000000                52.5 ns/op             0 B/op          0 allocs/op
+BenchmarkHttpTreeMux_GPlusStatic        20000000                85.8 ns/op             0 B/op          0 allocs/op
+BenchmarkKocha_GPlusStatic              20000000                89.2 ns/op             0 B/op          0 allocs/op
+BenchmarkLARS_GPlusStatic               10000000               162 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_GPlusStatic              500000              3479 ns/op             768 B/op          9 allocs/op
+BenchmarkMartini_GPlusStatic              200000              9092 ns/op             768 B/op          9 allocs/op
+BenchmarkPat_GPlusStatic                 3000000               493 ns/op              96 B/op          2 allocs/op
+BenchmarkPossum_GPlusStatic              1000000              1467 ns/op             416 B/op          3 allocs/op
+BenchmarkR2router_GPlusStatic            2000000               788 ns/op             144 B/op          4 allocs/op
+BenchmarkRivet_GPlusStatic              20000000               114 ns/op               0 B/op          0 allocs/op
+BenchmarkTango_GPlusStatic               1000000              1534 ns/op             200 B/op          8 allocs/op
+BenchmarkTigerTonic_GPlusStatic          5000000               282 ns/op              32 B/op          1 allocs/op
+BenchmarkTraffic_GPlusStatic              500000              3798 ns/op            1192 B/op         15 allocs/op
+BenchmarkVulcan_GPlusStatic              2000000              1125 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_GPlusParam                  3000000               528 ns/op              64 B/op          1 allocs/op
+BenchmarkBear_GPlusParam                 1000000              1570 ns/op             480 B/op          5 allocs/op
+BenchmarkBeego_GPlusParam                1000000              2369 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_GPlusParam                 1000000              2028 ns/op             688 B/op          5 allocs/op
+BenchmarkDenco_GPlusParam                5000000               385 ns/op              64 B/op          1 allocs/op
+BenchmarkEcho_GPlusParam                 3000000               441 ns/op              32 B/op          1 allocs/op
+BenchmarkGin_GPlusParam                 10000000               174 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_GPlusParam           1000000              2033 ns/op             648 B/op          8 allocs/op
+BenchmarkGoji_GPlusParam                 1000000              1399 ns/op             336 B/op          2 allocs/op
+BenchmarkGojiv2_GPlusParam               1000000              2641 ns/op             944 B/op          8 allocs/op
+BenchmarkGoJsonRest_GPlusParam           1000000              2824 ns/op             649 B/op         13 allocs/op
+BenchmarkGoRestful_GPlusParam             200000              8875 ns/op            2296 B/op         21 allocs/op
+BenchmarkGorillaMux_GPlusParam            200000              6291 ns/op            1056 B/op         11 allocs/op
+BenchmarkHttpRouter_GPlusParam           5000000               316 ns/op              64 B/op          1 allocs/op
+BenchmarkHttpTreeMux_GPlusParam          1000000              1129 ns/op             352 B/op          3 allocs/op
+BenchmarkKocha_GPlusParam                3000000               538 ns/op              56 B/op          3 allocs/op
+BenchmarkLARS_GPlusParam                10000000               198 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_GPlusParam               500000              3554 ns/op            1056 B/op         10 allocs/op
+BenchmarkMartini_GPlusParam               200000              9831 ns/op            1072 B/op         10 allocs/op
+BenchmarkPat_GPlusParam                  1000000              2706 ns/op             688 B/op         12 allocs/op
+BenchmarkPossum_GPlusParam               1000000              2297 ns/op             560 B/op          6 allocs/op
+BenchmarkR2router_GPlusParam             1000000              1318 ns/op             432 B/op          5 allocs/op
+BenchmarkRivet_GPlusParam                5000000               399 ns/op              48 B/op          1 allocs/op
+BenchmarkTango_GPlusParam                1000000              2070 ns/op             264 B/op          8 allocs/op
+BenchmarkTigerTonic_GPlusParam            500000              4853 ns/op            1056 B/op         17 allocs/op
+BenchmarkTraffic_GPlusParam               200000              8278 ns/op            1976 B/op         21 allocs/op
+BenchmarkVulcan_GPlusParam               1000000              1243 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_GPlus2Params                3000000               549 ns/op              64 B/op          1 allocs/op
+BenchmarkBear_GPlus2Params               1000000              2112 ns/op             496 B/op          5 allocs/op
+BenchmarkBeego_GPlus2Params               500000              2750 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_GPlus2Params                300000              7032 ns/op            1040 B/op          9 allocs/op
+BenchmarkDenco_GPlus2Params              3000000               502 ns/op              64 B/op          1 allocs/op
+BenchmarkEcho_GPlus2Params               3000000               641 ns/op              32 B/op          1 allocs/op
+BenchmarkGin_GPlus2Params                5000000               250 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_GPlus2Params         1000000              2681 ns/op             712 B/op          9 allocs/op
+BenchmarkGoji_GPlus2Params               1000000              1926 ns/op             336 B/op          2 allocs/op
+BenchmarkGojiv2_GPlus2Params              500000              3996 ns/op            1024 B/op         11 allocs/op
+BenchmarkGoJsonRest_GPlus2Params          500000              3886 ns/op             713 B/op         14 allocs/op
+BenchmarkGoRestful_GPlus2Params           200000             10376 ns/op            2360 B/op         21 allocs/op
+BenchmarkGorillaMux_GPlus2Params          100000             14162 ns/op            1088 B/op         11 allocs/op
+BenchmarkHttpRouter_GPlus2Params         5000000               336 ns/op              64 B/op          1 allocs/op
+BenchmarkHttpTreeMux_GPlus2Params        1000000              1523 ns/op             384 B/op          4 allocs/op
+BenchmarkKocha_GPlus2Params              2000000               970 ns/op             128 B/op          5 allocs/op
+BenchmarkLARS_GPlus2Params               5000000               238 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_GPlus2Params             500000              4016 ns/op            1056 B/op         10 allocs/op
+BenchmarkMartini_GPlus2Params             100000             21253 ns/op            1200 B/op         13 allocs/op
+BenchmarkPat_GPlus2Params                 200000              8632 ns/op            2256 B/op         34 allocs/op
+BenchmarkPossum_GPlus2Params             1000000              2171 ns/op             560 B/op          6 allocs/op
+BenchmarkR2router_GPlus2Params           1000000              1340 ns/op             432 B/op          5 allocs/op
+BenchmarkRivet_GPlus2Params              3000000               557 ns/op              96 B/op          1 allocs/op
+BenchmarkTango_GPlus2Params              1000000              2186 ns/op             344 B/op          8 allocs/op
+BenchmarkTigerTonic_GPlus2Params          200000              9060 ns/op            1488 B/op         24 allocs/op
+BenchmarkTraffic_GPlus2Params             100000             20324 ns/op            3272 B/op         31 allocs/op
+BenchmarkVulcan_GPlus2Params             1000000              2039 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_GPlusAll                     300000              6603 ns/op             640 B/op         11 allocs/op
+BenchmarkBear_GPlusAll                    100000             22363 ns/op            5488 B/op         61 allocs/op
+BenchmarkBeego_GPlusAll                    50000             38757 ns/op            4784 B/op         52 allocs/op
+BenchmarkBone_GPlusAll                     20000             54916 ns/op           10336 B/op         98 allocs/op
+BenchmarkDenco_GPlusAll                   300000              4959 ns/op             672 B/op         11 allocs/op
+BenchmarkEcho_GPlusAll                    200000              6558 ns/op             416 B/op         13 allocs/op
+BenchmarkGin_GPlusAll                     500000              2757 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_GPlusAll               50000             34615 ns/op            8040 B/op        103 allocs/op
+BenchmarkGoji_GPlusAll                    100000             16002 ns/op            3696 B/op         22 allocs/op
+BenchmarkGojiv2_GPlusAll                   50000             35060 ns/op           12624 B/op        115 allocs/op
+BenchmarkGoJsonRest_GPlusAll               50000             41479 ns/op            8117 B/op        170 allocs/op
+BenchmarkGoRestful_GPlusAll                10000            131653 ns/op           32024 B/op        275 allocs/op
+BenchmarkGorillaMux_GPlusAll               10000            101380 ns/op           13296 B/op        142 allocs/op
+BenchmarkHttpRouter_GPlusAll              500000              3711 ns/op             640 B/op         11 allocs/op
+BenchmarkHttpTreeMux_GPlusAll             100000             14438 ns/op            4032 B/op         38 allocs/op
+BenchmarkKocha_GPlusAll                   200000              8039 ns/op             976 B/op         43 allocs/op
+BenchmarkLARS_GPlusAll                    500000              2630 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_GPlusAll                  30000             51123 ns/op           13152 B/op        128 allocs/op
+BenchmarkMartini_GPlusAll                  10000            176157 ns/op           14016 B/op        145 allocs/op
+BenchmarkPat_GPlusAll                      20000             69911 ns/op           16576 B/op        298 allocs/op
+BenchmarkPossum_GPlusAll                  100000             20716 ns/op            5408 B/op         39 allocs/op
+BenchmarkR2router_GPlusAll                100000             17463 ns/op            5040 B/op         63 allocs/op
+BenchmarkRivet_GPlusAll                   300000              5142 ns/op             768 B/op         11 allocs/op
+BenchmarkTango_GPlusAll                    50000             27321 ns/op            3656 B/op        104 allocs/op
+BenchmarkTigerTonic_GPlusAll               20000             77597 ns/op           14512 B/op        288 allocs/op
+BenchmarkTraffic_GPlusAll                  10000            151406 ns/op           37360 B/op        392 allocs/op
+BenchmarkVulcan_GPlusAll                  100000             18555 ns/op            1274 B/op         39 allocs/op
+```
+
+## Parse.com
+
+```
+BenchmarkGin_ParseStatic                10000000               133 ns/op               0 B/op          0 allocs/op
+
+BenchmarkAce_ParseStatic                 5000000               241 ns/op               0 B/op          0 allocs/op
+BenchmarkBear_ParseStatic                2000000               728 ns/op             120 B/op          3 allocs/op
+BenchmarkBeego_ParseStatic               1000000              2623 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_ParseStatic                1000000              1285 ns/op             144 B/op          3 allocs/op
+BenchmarkDenco_ParseStatic              30000000                57.8 ns/op             0 B/op          0 allocs/op
+BenchmarkEcho_ParseStatic                5000000               342 ns/op              32 B/op          1 allocs/op
+BenchmarkGocraftWeb_ParseStatic          1000000              1478 ns/op             296 B/op          5 allocs/op
+BenchmarkGoji_ParseStatic                3000000               415 ns/op               0 B/op          0 allocs/op
+BenchmarkGojiv2_ParseStatic              1000000              2087 ns/op             928 B/op          7 allocs/op
+BenchmarkGoJsonRest_ParseStatic          1000000              1712 ns/op             329 B/op         11 allocs/op
+BenchmarkGoRestful_ParseStatic            200000             11072 ns/op            3224 B/op         22 allocs/op
+BenchmarkGorillaMux_ParseStatic           500000              4129 ns/op             752 B/op         11 allocs/op
+BenchmarkHttpRouter_ParseStatic         30000000                52.4 ns/op             0 B/op          0 allocs/op
+BenchmarkHttpTreeMux_ParseStatic        20000000               109 ns/op               0 B/op          0 allocs/op
+BenchmarkKocha_ParseStatic              20000000                81.8 ns/op             0 B/op          0 allocs/op
+BenchmarkLARS_ParseStatic               10000000               150 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_ParseStatic             1000000              3288 ns/op             768 B/op          9 allocs/op
+BenchmarkMartini_ParseStatic              200000              9110 ns/op             768 B/op          9 allocs/op
+BenchmarkPat_ParseStatic                 1000000              1135 ns/op             240 B/op          5 allocs/op
+BenchmarkPossum_ParseStatic              1000000              1557 ns/op             416 B/op          3 allocs/op
+BenchmarkR2router_ParseStatic            2000000               730 ns/op             144 B/op          4 allocs/op
+BenchmarkRivet_ParseStatic              10000000               121 ns/op               0 B/op          0 allocs/op
+BenchmarkTango_ParseStatic               1000000              1688 ns/op             248 B/op          8 allocs/op
+BenchmarkTigerTonic_ParseStatic          3000000               427 ns/op              48 B/op          1 allocs/op
+BenchmarkTraffic_ParseStatic              500000              5962 ns/op            1816 B/op         20 allocs/op
+BenchmarkVulcan_ParseStatic              2000000               969 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_ParseParam                  3000000               497 ns/op              64 B/op          1 allocs/op
+BenchmarkBear_ParseParam                 1000000              1473 ns/op             467 B/op          5 allocs/op
+BenchmarkBeego_ParseParam                1000000              2384 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_ParseParam                 1000000              2513 ns/op             768 B/op          6 allocs/op
+BenchmarkDenco_ParseParam                5000000               364 ns/op              64 B/op          1 allocs/op
+BenchmarkEcho_ParseParam                 5000000               418 ns/op              32 B/op          1 allocs/op
+BenchmarkGin_ParseParam                 10000000               163 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_ParseParam           1000000              2361 ns/op             664 B/op          8 allocs/op
+BenchmarkGoji_ParseParam                 1000000              1590 ns/op             336 B/op          2 allocs/op
+BenchmarkGojiv2_ParseParam               1000000              2851 ns/op             976 B/op          9 allocs/op
+BenchmarkGoJsonRest_ParseParam           1000000              2965 ns/op             649 B/op         13 allocs/op
+BenchmarkGoRestful_ParseParam             200000             12207 ns/op            3544 B/op         23 allocs/op
+BenchmarkGorillaMux_ParseParam            500000              5187 ns/op            1088 B/op         12 allocs/op
+BenchmarkHttpRouter_ParseParam           5000000               275 ns/op              64 B/op          1 allocs/op
+BenchmarkHttpTreeMux_ParseParam          1000000              1108 ns/op             352 B/op          3 allocs/op
+BenchmarkKocha_ParseParam                3000000               495 ns/op              56 B/op          3 allocs/op
+BenchmarkLARS_ParseParam                10000000               192 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_ParseParam               500000              4103 ns/op            1056 B/op         10 allocs/op
+BenchmarkMartini_ParseParam               200000              9878 ns/op            1072 B/op         10 allocs/op
+BenchmarkPat_ParseParam                   500000              3657 ns/op            1120 B/op         17 allocs/op
+BenchmarkPossum_ParseParam               1000000              2084 ns/op             560 B/op          6 allocs/op
+BenchmarkR2router_ParseParam             1000000              1251 ns/op             432 B/op          5 allocs/op
+BenchmarkRivet_ParseParam                5000000               335 ns/op              48 B/op          1 allocs/op
+BenchmarkTango_ParseParam                1000000              1854 ns/op             280 B/op          8 allocs/op
+BenchmarkTigerTonic_ParseParam            500000              4582 ns/op            1008 B/op         17 allocs/op
+BenchmarkTraffic_ParseParam               200000              8125 ns/op            2248 B/op         23 allocs/op
+BenchmarkVulcan_ParseParam               1000000              1148 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_Parse2Params                3000000               539 ns/op              64 B/op          1 allocs/op
+BenchmarkBear_Parse2Params               1000000              1778 ns/op             496 B/op          5 allocs/op
+BenchmarkBeego_Parse2Params              1000000              2519 ns/op             368 B/op          4 allocs/op
+BenchmarkBone_Parse2Params               1000000              2596 ns/op             720 B/op          5 allocs/op
+BenchmarkDenco_Parse2Params              3000000               492 ns/op              64 B/op          1 allocs/op
+BenchmarkEcho_Parse2Params               3000000               484 ns/op              32 B/op          1 allocs/op
+BenchmarkGin_Parse2Params               10000000               193 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_Parse2Params         1000000              2575 ns/op             712 B/op          9 allocs/op
+BenchmarkGoji_Parse2Params               1000000              1373 ns/op             336 B/op          2 allocs/op
+BenchmarkGojiv2_Parse2Params              500000              2416 ns/op             960 B/op          8 allocs/op
+BenchmarkGoJsonRest_Parse2Params          300000              3452 ns/op             713 B/op         14 allocs/op
+BenchmarkGoRestful_Parse2Params           100000             17719 ns/op            6008 B/op         25 allocs/op
+BenchmarkGorillaMux_Parse2Params          300000              5102 ns/op            1088 B/op         11 allocs/op
+BenchmarkHttpRouter_Parse2Params         5000000               303 ns/op              64 B/op          1 allocs/op
+BenchmarkHttpTreeMux_Parse2Params        1000000              1372 ns/op             384 B/op          4 allocs/op
+BenchmarkKocha_Parse2Params              2000000               874 ns/op             128 B/op          5 allocs/op
+BenchmarkLARS_Parse2Params              10000000               192 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_Parse2Params             500000              3871 ns/op            1056 B/op         10 allocs/op
+BenchmarkMartini_Parse2Params             200000              9954 ns/op            1152 B/op         11 allocs/op
+BenchmarkPat_Parse2Params                 500000              4194 ns/op             832 B/op         17 allocs/op
+BenchmarkPossum_Parse2Params             1000000              2121 ns/op             560 B/op          6 allocs/op
+BenchmarkR2router_Parse2Params           1000000              1415 ns/op             432 B/op          5 allocs/op
+BenchmarkRivet_Parse2Params              3000000               457 ns/op              96 B/op          1 allocs/op
+BenchmarkTango_Parse2Params              1000000              1914 ns/op             312 B/op          8 allocs/op
+BenchmarkTigerTonic_Parse2Params          300000              6895 ns/op            1408 B/op         24 allocs/op
+BenchmarkTraffic_Parse2Params             200000              8317 ns/op            2040 B/op         22 allocs/op
+BenchmarkVulcan_Parse2Params             1000000              1274 ns/op              98 B/op          3 allocs/op
+BenchmarkAce_ParseAll                     200000             10401 ns/op             640 B/op         16 allocs/op
+BenchmarkBear_ParseAll                     50000             37743 ns/op            8928 B/op        110 allocs/op
+BenchmarkBeego_ParseAll                    20000             63193 ns/op            9568 B/op        104 allocs/op
+BenchmarkBone_ParseAll                     20000             61767 ns/op           14160 B/op        131 allocs/op
+BenchmarkDenco_ParseAll                   300000              7036 ns/op             928 B/op         16 allocs/op
+BenchmarkEcho_ParseAll                    200000             11824 ns/op             832 B/op         26 allocs/op
+BenchmarkGin_ParseAll                     300000              4199 ns/op               0 B/op          0 allocs/op
+BenchmarkGocraftWeb_ParseAll               30000             51758 ns/op           13728 B/op        181 allocs/op
+BenchmarkGoji_ParseAll                     50000             29614 ns/op            5376 B/op         32 allocs/op
+BenchmarkGojiv2_ParseAll                   20000             68676 ns/op           24464 B/op        199 allocs/op
+BenchmarkGoJsonRest_ParseAll               20000             76135 ns/op           13866 B/op        321 allocs/op
+BenchmarkGoRestful_ParseAll                 5000            389487 ns/op          110928 B/op        600 allocs/op
+BenchmarkGorillaMux_ParseAll               10000            221250 ns/op           24864 B/op        292 allocs/op
+BenchmarkHttpRouter_ParseAll              200000              6444 ns/op             640 B/op         16 allocs/op
+BenchmarkHttpTreeMux_ParseAll              50000             30702 ns/op            5728 B/op         51 allocs/op
+BenchmarkKocha_ParseAll                   200000             13712 ns/op            1112 B/op         54 allocs/op
+BenchmarkLARS_ParseAll                    300000              6925 ns/op               0 B/op          0 allocs/op
+BenchmarkMacaron_ParseAll                  20000             96278 ns/op           24576 B/op        250 allocs/op
+BenchmarkMartini_ParseAll                   5000            271352 ns/op           25072 B/op        253 allocs/op
+BenchmarkPat_ParseAll                      20000             74941 ns/op           17264 B/op        343 allocs/op
+BenchmarkPossum_ParseAll                   50000             39947 ns/op           10816 B/op         78 allocs/op
+BenchmarkR2router_ParseAll                 50000             42479 ns/op            8352 B/op        120 allocs/op
+BenchmarkRivet_ParseAll                   200000              7726 ns/op             912 B/op         16 allocs/op
+BenchmarkTango_ParseAll                    30000             50014 ns/op            7168 B/op        208 allocs/op
+BenchmarkTigerTonic_ParseAll               10000            106550 ns/op           19728 B/op        379 allocs/op
+BenchmarkTraffic_ParseAll                  10000            216037 ns/op           57776 B/op        642 allocs/op
+BenchmarkVulcan_ParseAll                   50000             34379 ns/op            2548 B/op         78 allocs/op
 ```
diff --git a/README.md b/README.md
index 76ab3b01..07fc960e 100644
--- a/README.md
+++ b/README.md
@@ -44,41 +44,40 @@ Gin uses a custom version of [HttpRouter](https://github.com/julienschmidt/httpr
 
 [See all benchmarks](/BENCHMARKS.md)
 
+Benchmark name                              | (1)        | (2)         | (3) 		    | (4)
+--------------------------------------------|-----------:|------------:|-----------:|---------:
+**BenchmarkGin_GithubAll**                  | **30000**  |  **48375**  |     **0**  |   **0**
+BenchmarkAce_GithubAll                      |   10000    |   134059    |   13792    |   167
+BenchmarkBear_GithubAll                     |    5000    |   534445    |   86448    |   943
+BenchmarkBeego_GithubAll                    |    3000    |   592444    |   74705    |   812
+BenchmarkBone_GithubAll                     |     200    |  6957308    |  698784    |  8453
+BenchmarkDenco_GithubAll                    |   10000    |   158819    |   20224    |   167
+BenchmarkEcho_GithubAll                     |   10000    |   154700    |    6496    |   203
+BenchmarkGocraftWeb_GithubAll               |    3000    |   570806    |  131656    |  1686
+BenchmarkGoji_GithubAll                     |    2000    |   818034    |   56112    |   334
+BenchmarkGojiv2_GithubAll                   |    2000    |  1213973    |  274768    |  3712
+BenchmarkGoJsonRest_GithubAll               |    2000    |   785796    |  134371    |  2737
+BenchmarkGoRestful_GithubAll                |     300    |  5238188    |  689672    |  4519
+BenchmarkGorillaMux_GithubAll               |     100    | 10257726    |  211840    |  2272
+BenchmarkHttpRouter_GithubAll               |   20000    |   105414    |   13792    |   167
+BenchmarkHttpTreeMux_GithubAll              |   10000    |   319934    |   65856    |   671
+BenchmarkKocha_GithubAll                    |   10000    |   209442    |   23304    |   843
+BenchmarkLARS_GithubAll                     |   20000    |    62565    |       0    |     0
+BenchmarkMacaron_GithubAll                  |    2000    |  1161270    |  204194    |  2000
+BenchmarkMartini_GithubAll                  |     200    |  9991713    |  226549    |  2325
+BenchmarkPat_GithubAll                      |     200    |  5590793    | 1499568    | 27435
+BenchmarkPossum_GithubAll                   |   10000    |   319768    |   84448    |   609
+BenchmarkR2router_GithubAll                 |   10000    |   305134    |   77328    |   979
+BenchmarkRivet_GithubAll                    |   10000    |   132134    |   16272    |   167
+BenchmarkTango_GithubAll                    |    3000    |   552754    |   63826    |  1618
+BenchmarkTigerTonic_GithubAll               |    1000    |  1439483    |  239104    |  5374
+BenchmarkTraffic_GithubAll                  |     100    | 11383067    | 2659329    | 21848
+BenchmarkVulcan_GithubAll                   |    5000    |   394253    |   19894    |   609
 
-Benchmark name 					| (1) 		| (2) 		| (3) 		| (4)
---------------------------------|----------:|----------:|----------:|------:
-BenchmarkAce_GithubAll 			| 10000 	| 109482 	| 13792 	| 167
-BenchmarkBear_GithubAll 		| 10000 	| 287490 	| 79952 	| 943
-BenchmarkBeego_GithubAll 		| 3000 		| 562184 	| 146272 	| 2092
-BenchmarkBone_GithubAll 		| 500 		| 2578716 	| 648016 	| 8119
-BenchmarkDenco_GithubAll 		| 20000 	| 94955 	| 20224 	| 167
-BenchmarkEcho_GithubAll 		| 30000 	| 58705 	| 0 		| 0
-**BenchmarkGin_GithubAll** 		| **30000** | **50991** | **0** 	| **0**
-BenchmarkGocraftWeb_GithubAll 	| 5000 		| 449648 	| 133280 	| 1889
-BenchmarkGoji_GithubAll 		| 2000 		| 689748 	| 56113 	| 334
-BenchmarkGoJsonRest_GithubAll 	| 5000 		| 537769 	| 135995 	| 2940
-BenchmarkGoRestful_GithubAll 	| 100 		| 18410628 	| 797236 	| 7725
-BenchmarkGorillaMux_GithubAll 	| 200 		| 8036360 	| 153137 	| 1791
-BenchmarkHttpRouter_GithubAll 	| 20000 	| 63506 	| 13792 	| 167
-BenchmarkHttpTreeMux_GithubAll 	| 10000 	| 165927 	| 56112 	| 334
-BenchmarkKocha_GithubAll 		| 10000 	| 171362 	| 23304 	| 843
-BenchmarkMacaron_GithubAll 		| 2000 		| 817008 	| 224960 	| 2315
-BenchmarkMartini_GithubAll 		| 100 		| 12609209 	| 237952 	| 2686
-BenchmarkPat_GithubAll 			| 300 		| 4830398 	| 1504101 	| 32222
-BenchmarkPossum_GithubAll 		| 10000 	| 301716 	| 97440 	| 812
-BenchmarkR2router_GithubAll 	| 10000 	| 270691 	| 77328 	| 1182
-BenchmarkRevel_GithubAll 		| 1000 		| 1491919 	| 345553 	| 5918
-BenchmarkRivet_GithubAll 		| 10000 	| 283860 	| 84272 	| 1079
-BenchmarkTango_GithubAll 		| 5000 		| 473821 	| 87078 	| 2470
-BenchmarkTigerTonic_GithubAll 	| 2000 		| 1120131 	| 241088 	| 6052
-BenchmarkTraffic_GithubAll 		| 200 		| 8708979 	| 2664762 	| 22390
-BenchmarkVulcan_GithubAll 		| 5000 		| 353392 	| 19894 	| 609
-BenchmarkZeus_GithubAll 		| 2000 		| 944234 	| 300688 	| 2648
-
-(1): Total Repetitions  
-(2): Single Repetition Duration (ns/op)  
-(3): Heap Memory (B/op)  
-(4): Average Allocations per Repetition (allocs/op)  
+(1): Total Repetitions achieved in constant time, higher means more confident result  
+(2): Single Repetition Duration (ns/op), lower is better  
+(3): Heap Memory (B/op), lower is better  
+(4): Average Allocations per Repetition (allocs/op), lower is better  
 
 ## Gin v1. stable
 

From c19aa0598b6bab47f498e68ebc60ceafded8631f Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Wed, 19 Jul 2017 15:50:05 +0800
Subject: [PATCH 071/113] feat(context): add BindQuery func (#1029)

* feat(context): add BindQuery func, only parse/bind the query string params.

* docs(readme): add BindQuery section.

* docs(readme): fix import.

* docs(readme): separate import
---
 README.md               | 38 +++++++++++++++++++++++++++++++++++++-
 binding/binding.go      |  1 +
 binding/binding_test.go | 27 +++++++++++++++++++++++++++
 binding/query.go        | 23 +++++++++++++++++++++++
 context.go              |  5 +++++
 context_test.go         | 16 ++++++++++++++++
 6 files changed, 109 insertions(+), 1 deletion(-)
 create mode 100644 binding/query.go

diff --git a/README.md b/README.md
index 07fc960e..35858737 100644
--- a/README.md
+++ b/README.md
@@ -460,7 +460,43 @@ func main() {
 }
 ```
 
-### Bind Query String
+### Only Bind Query String
+
+`BindQuery` function only binds the query params and not the post data. See the [detail information](https://github.com/gin-gonic/gin/issues/742#issuecomment-315953017).
+
+```go
+package main
+
+import (
+	"log"
+
+	"github.com/gin-gonic/gin"
+)
+
+type Person struct {
+	Name    string `form:"name"`
+	Address string `form:"address"`
+}
+
+func main() {
+	route := gin.Default()
+	route.Any("/testing", startPage)
+	route.Run(":8085")
+}
+
+func startPage(c *gin.Context) {
+	var person Person
+	if c.BindQuery(&person) == nil {
+		log.Println("====== Only Bind By Query String ======")
+		log.Println(person.Name)
+		log.Println(person.Address)
+	}
+	c.String(200, "Success")
+}
+
+```
+
+### Bind Query String or Post Data
 
 See the [detail information](https://github.com/gin-gonic/gin/issues/742#issuecomment-264681292).
 
diff --git a/binding/binding.go b/binding/binding.go
index 1dbf2460..971547c2 100644
--- a/binding/binding.go
+++ b/binding/binding.go
@@ -39,6 +39,7 @@ var (
 	JSON          = jsonBinding{}
 	XML           = xmlBinding{}
 	Form          = formBinding{}
+	Query         = queryBinding{}
 	FormPost      = formPostBinding{}
 	FormMultipart = formMultipartBinding{}
 	ProtoBuf      = protobufBinding{}
diff --git a/binding/binding_test.go b/binding/binding_test.go
index d7cdf77a..5575e166 100644
--- a/binding/binding_test.go
+++ b/binding/binding_test.go
@@ -67,6 +67,18 @@ func TestBindingForm2(t *testing.T) {
 		"", "")
 }
 
+func TestBindingQuery(t *testing.T) {
+	testQueryBinding(t, "POST",
+		"/?foo=bar&bar=foo", "/",
+		"foo=unused", "bar2=foo")
+}
+
+func TestBindingQuery2(t *testing.T) {
+	testQueryBinding(t, "GET",
+		"/?foo=bar&bar=foo", "/?bar2=foo",
+		"foo=unused", "")
+}
+
 func TestBindingXML(t *testing.T) {
 	testBodyBinding(t,
 		XML, "xml",
@@ -204,6 +216,21 @@ func testFormBinding(t *testing.T, method, path, badPath, body, badBody string)
 	assert.Error(t, err)
 }
 
+func testQueryBinding(t *testing.T, method, path, badPath, body, badBody string) {
+	b := Query
+	assert.Equal(t, b.Name(), "query")
+
+	obj := FooBarStruct{}
+	req := requestWithBody(method, path, body)
+	if method == "POST" {
+		req.Header.Add("Content-Type", MIMEPOSTForm)
+	}
+	err := b.Bind(req, &obj)
+	assert.NoError(t, err)
+	assert.Equal(t, obj.Foo, "bar")
+	assert.Equal(t, obj.Bar, "foo")
+}
+
 func testBodyBinding(t *testing.T, b Binding, name, path, badPath, body, badBody string) {
 	assert.Equal(t, b.Name(), name)
 
diff --git a/binding/query.go b/binding/query.go
new file mode 100644
index 00000000..a789f798
--- /dev/null
+++ b/binding/query.go
@@ -0,0 +1,23 @@
+// Copyright 2017 Manu Martinez-Almeida.  All rights reserved.
+// Use of this source code is governed by a MIT style
+// license that can be found in the LICENSE file.
+
+package binding
+
+import (
+	"net/http"
+)
+
+type queryBinding struct{}
+
+func (queryBinding) Name() string {
+	return "query"
+}
+
+func (queryBinding) Bind(req *http.Request, obj interface{}) error {
+	values := req.URL.Query()
+	if err := mapForm(obj, values); err != nil {
+		return err
+	}
+	return validate(obj)
+}
diff --git a/context.go b/context.go
index 306e2055..87aa1bea 100644
--- a/context.go
+++ b/context.go
@@ -467,6 +467,11 @@ func (c *Context) BindJSON(obj interface{}) error {
 	return c.MustBindWith(obj, binding.JSON)
 }
 
+// BindQuery is a shortcut for c.MustBindWith(obj, binding.Query)
+func (c *Context) BindQuery(obj interface{}) error {
+	return c.MustBindWith(obj, binding.Query)
+}
+
 // MustBindWith binds the passed struct pointer using the specified binding
 // engine. It will abort the request with HTTP 400 if any error ocurrs.
 // See the binding package.
diff --git a/context_test.go b/context_test.go
index db960fb3..15569bf2 100644
--- a/context_test.go
+++ b/context_test.go
@@ -1186,6 +1186,22 @@ func TestContextBindWithJSON(t *testing.T) {
 	assert.Equal(t, w.Body.Len(), 0)
 }
 
+func TestContextBindWithQuery(t *testing.T) {
+	w := httptest.NewRecorder()
+	c, _ := CreateTestContext(w)
+
+	c.Request, _ = http.NewRequest("POST", "/?foo=bar&bar=foo", bytes.NewBufferString("foo=unused"))
+
+	var obj struct {
+		Foo string `form:"foo"`
+		Bar string `form:"bar"`
+	}
+	assert.NoError(t, c.BindQuery(&obj))
+	assert.Equal(t, "foo", obj.Bar)
+	assert.Equal(t, "bar", obj.Foo)
+	assert.Equal(t, 0, w.Body.Len())
+}
+
 func TestContextBadAutoBind(t *testing.T) {
 	w := httptest.NewRecorder()
 	c, _ := CreateTestContext(w)

From 7b508186dd71146cbdb3d14f2c2e1aaaa51f7e45 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Wed, 19 Jul 2017 20:49:18 +0800
Subject: [PATCH 072/113] style: remove optional return (#1036)

---
 auth.go | 1 -
 gin.go  | 4 ++--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/auth.go b/auth.go
index 75a7c892..c214e213 100644
--- a/auth.go
+++ b/auth.go
@@ -58,7 +58,6 @@ func BasicAuthForRealm(accounts Accounts, realm string) HandlerFunc {
 		// The user credentials was found, set user's id to key AuthUserKey in this context, the user's id can be read later using
 		// c.MustGet(gin.AuthUserKey)
 		c.Set(AuthUserKey, user)
-		return
 	}
 }
 
diff --git a/gin.go b/gin.go
index fc9214dc..0372931d 100644
--- a/gin.go
+++ b/gin.go
@@ -158,9 +158,9 @@ func (engine *Engine) LoadHTMLGlob(pattern string) {
 		engine.HTMLRender = render.HTMLDebug{Glob: pattern, FuncMap: engine.FuncMap, Delims: engine.delims}
 		return
 	}
+
 	templ := template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseGlob(pattern))
 	engine.SetHTMLTemplate(templ)
-	return
 }
 
 func (engine *Engine) LoadHTMLFiles(files ...string) {
@@ -168,9 +168,9 @@ func (engine *Engine) LoadHTMLFiles(files ...string) {
 		engine.HTMLRender = render.HTMLDebug{Files: files, FuncMap: engine.FuncMap, Delims: engine.delims}
 		return
 	}
+
 	templ := template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseFiles(files...))
 	engine.SetHTMLTemplate(templ)
-	return
 }
 
 func (engine *Engine) SetHTMLTemplate(templ *template.Template) {

From d39ed41ab3795346f5f843ec31bc0138be07eaab Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Fri, 21 Jul 2017 10:29:23 +0800
Subject: [PATCH 073/113] update template example (#1038)

* update template example

* add template example folder
---
 README.md                 | 55 +++++++++++++++++++++++----------------
 examples/template/main.go | 32 +++++++++++++++++++++++
 2 files changed, 65 insertions(+), 22 deletions(-)
 create mode 100644 examples/template/main.go

diff --git a/README.md b/README.md
index 35858737..b14c2a2a 100644
--- a/README.md
+++ b/README.md
@@ -791,31 +791,42 @@ You may use custom delims
 
 #### Custom Template Funcs
 
+See the detail [example code](examples/template).
+
 main.go
 
 ```go
-	...
-	
-	func formatAsDate(t time.Time) string {
-		year, month, day := t.Date()
-		return fmt.Sprintf("%d/%02d/%02d", year, month, day)
-	}
-	
-	...
-	
-	router.SetFuncMap(template.FuncMap{
-		"formatAsDate": formatAsDate,
-	})
-	
-	...
-	
-	router.GET("/raw", func(c *Context) {
-		c.HTML(http.StatusOK, "raw.tmpl", map[string]interface{}{
-			"now": time.Date(2017, 07, 01, 0, 0, 0, 0, time.UTC),
-		})
-	})
-	
-	...
+import (
+    "fmt"
+    "html/template"
+    "net/http"
+    "time"
+
+    "github.com/gin-gonic/gin"
+)
+
+func formatAsDate(t time.Time) string {
+    year, month, day := t.Date()
+    return fmt.Sprintf("%d%02d/%02d", year, month, day)
+}
+
+func main() {
+    router := gin.Default()
+    router.Delims("{[{", "}]}")
+    router.SetFuncMap(template.FuncMap{
+        "formatAsDate": formatAsDate,
+    })
+    router.LoadHTMLFiles("./fixtures/basic/raw.tmpl")
+
+    router.GET("/raw", func(c *gin.Context) {
+        c.HTML(http.StatusOK, "raw.tmpl", map[string]interface{}{
+            "now": time.Date(2017, 07, 01, 0, 0, 0, 0, time.UTC),
+        })
+    })
+
+    router.Run(":8080")
+}
+
 ```
 
 raw.tmpl
diff --git a/examples/template/main.go b/examples/template/main.go
new file mode 100644
index 00000000..f9e611df
--- /dev/null
+++ b/examples/template/main.go
@@ -0,0 +1,32 @@
+package main
+
+import (
+	"fmt"
+	"html/template"
+	"net/http"
+	"time"
+
+	"github.com/gin-gonic/gin"
+)
+
+func formatAsDate(t time.Time) string {
+	year, month, day := t.Date()
+	return fmt.Sprintf("%d%02d/%02d", year, month, day)
+}
+
+func main() {
+	router := gin.Default()
+	router.Delims("{[{", "}]}")
+	router.SetFuncMap(template.FuncMap{
+		"formatAsDate": formatAsDate,
+	})
+	router.LoadHTMLFiles("../../fixtures/basic/raw.tmpl")
+
+	router.GET("/raw", func(c *gin.Context) {
+		c.HTML(http.StatusOK, "raw.tmpl", map[string]interface{}{
+			"now": time.Date(2017, 07, 01, 0, 0, 0, 0, time.UTC),
+		})
+	})
+
+	router.Run(":8080")
+}

From 7fafb3f4a177ca92821dc5bf6e59f17e5f130588 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Fri, 28 Jul 2017 08:50:58 +0800
Subject: [PATCH 074/113] doc(context): add status func comment. (#1042)

---
 context.go | 1 +
 1 file changed, 1 insertion(+)

diff --git a/context.go b/context.go
index 87aa1bea..35ca8d2e 100644
--- a/context.go
+++ b/context.go
@@ -561,6 +561,7 @@ func bodyAllowedForStatus(status int) bool {
 	return true
 }
 
+// Status sets the HTTP response code.
 func (c *Context) Status(code int) {
 	c.writermem.WriteHeader(code)
 }

From df37e74fa1bbf8897ec2fa6ab347b27acdf5c444 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Tue, 1 Aug 2017 12:49:28 +0800
Subject: [PATCH 075/113] doc(context):  more clearer bind doc when input is
 not valid (#1049)

---
 context.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/context.go b/context.go
index 35ca8d2e..895ba7a1 100644
--- a/context.go
+++ b/context.go
@@ -456,7 +456,7 @@ func (c *Context) SaveUploadedFile(file *multipart.FileHeader, dst string) error
 // otherwise --> returns an error
 // It parses the request's body as JSON if Content-Type == "application/json" using JSON or XML as a JSON input.
 // It decodes the json payload into the struct specified as a pointer.
-// Like ParseBody() but this method also writes a 400 error if the json is not valid.
+// It will writes a 400 error and sets Content-Type header "text/plain" in the response if input is not valid.
 func (c *Context) Bind(obj interface{}) error {
 	b := binding.Default(c.Request.Method, c.ContentType())
 	return c.MustBindWith(obj, b)

From 4b54b862720f68d1ee16e89384e370b04e78f659 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Wed, 2 Aug 2017 23:00:10 +0800
Subject: [PATCH 076/113] fix composite literal uses unkeyed fields warnings,
 #1050 (#1051)

---
 gin.go | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/gin.go b/gin.go
index 0372931d..8347ce22 100644
--- a/gin.go
+++ b/gin.go
@@ -121,7 +121,7 @@ func New() *Engine {
 		UseRawPath:             false,
 		UnescapePathValues:     true,
 		trees:                  make(methodTrees, 0, 9),
-		delims:                 render.Delims{"{{", "}}"},
+		delims:                 render.Delims{Left: "{{", Right: "}}"},
 		secureJsonPrefix:       "while(1);",
 	}
 	engine.RouterGroup.engine = engine
@@ -143,7 +143,7 @@ func (engine *Engine) allocateContext() *Context {
 }
 
 func (engine *Engine) Delims(left, right string) *Engine {
-	engine.delims = render.Delims{left, right}
+	engine.delims = render.Delims{Left: left, Right: right}
 	return engine
 }
 

From 81007d2ce0176f7a9ce52dd12e56edd7ef40e72c Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Fri, 4 Aug 2017 13:45:59 +0800
Subject: [PATCH 077/113] refactor(test): unify assert.Equal usage (#1054)

---
 auth_test.go            | 20 ++++++++++----------
 debug_test.go           |  6 +++---
 errors_test.go          | 24 ++++++++++++------------
 middleware_test.go      | 28 ++++++++++++++--------------
 response_writer_test.go | 36 ++++++++++++++++++------------------
 5 files changed, 57 insertions(+), 57 deletions(-)

diff --git a/auth_test.go b/auth_test.go
index b22d9ced..2f1ae70e 100644
--- a/auth_test.go
+++ b/auth_test.go
@@ -53,15 +53,15 @@ func TestBasicAuthSearchCredential(t *testing.T) {
 	})
 
 	user, found := pairs.searchCredential(authorizationHeader("admin", "password"))
-	assert.Equal(t, user, "admin")
+	assert.Equal(t, "admin", user)
 	assert.True(t, found)
 
 	user, found = pairs.searchCredential(authorizationHeader("foo", "bar"))
-	assert.Equal(t, user, "foo")
+	assert.Equal(t, "foo", user)
 	assert.True(t, found)
 
 	user, found = pairs.searchCredential(authorizationHeader("bar", "foo"))
-	assert.Equal(t, user, "bar")
+	assert.Equal(t, "bar", user)
 	assert.True(t, found)
 
 	user, found = pairs.searchCredential(authorizationHeader("admins", "password"))
@@ -78,7 +78,7 @@ func TestBasicAuthSearchCredential(t *testing.T) {
 }
 
 func TestBasicAuthAuthorizationHeader(t *testing.T) {
-	assert.Equal(t, authorizationHeader("admin", "password"), "Basic YWRtaW46cGFzc3dvcmQ=")
+	assert.Equal(t, "Basic YWRtaW46cGFzc3dvcmQ=", authorizationHeader("admin", "password"))
 }
 
 func TestBasicAuthSecureCompare(t *testing.T) {
@@ -101,8 +101,8 @@ func TestBasicAuthSucceed(t *testing.T) {
 	req.Header.Set("Authorization", authorizationHeader("admin", "password"))
 	router.ServeHTTP(w, req)
 
-	assert.Equal(t, w.Code, 200)
-	assert.Equal(t, w.Body.String(), "admin")
+	assert.Equal(t, 200, w.Code)
+	assert.Equal(t, "admin", w.Body.String())
 }
 
 func TestBasicAuth401(t *testing.T) {
@@ -121,8 +121,8 @@ func TestBasicAuth401(t *testing.T) {
 	router.ServeHTTP(w, req)
 
 	assert.False(t, called)
-	assert.Equal(t, w.Code, 401)
-	assert.Equal(t, w.HeaderMap.Get("WWW-Authenticate"), "Basic realm=\"Authorization Required\"")
+	assert.Equal(t, 401, w.Code)
+	assert.Equal(t, "Basic realm=\"Authorization Required\"", w.HeaderMap.Get("WWW-Authenticate"))
 }
 
 func TestBasicAuth401WithCustomRealm(t *testing.T) {
@@ -141,6 +141,6 @@ func TestBasicAuth401WithCustomRealm(t *testing.T) {
 	router.ServeHTTP(w, req)
 
 	assert.False(t, called)
-	assert.Equal(t, w.Code, 401)
-	assert.Equal(t, w.HeaderMap.Get("WWW-Authenticate"), "Basic realm=\"My Custom \\\"Realm\\\"\"")
+	assert.Equal(t, 401, w.Code)
+	assert.Equal(t, "Basic realm=\"My Custom \\\"Realm\\\"\"", w.HeaderMap.Get("WWW-Authenticate"))
 }
diff --git a/debug_test.go b/debug_test.go
index 2b010858..366d4613 100644
--- a/debug_test.go
+++ b/debug_test.go
@@ -42,7 +42,7 @@ func TestDebugPrint(t *testing.T) {
 
 	SetMode(DebugMode)
 	debugPrint("these are %d %s\n", 2, "error messages")
-	assert.Equal(t, w.String(), "[GIN-debug] these are 2 error messages\n")
+	assert.Equal(t, "[GIN-debug] these are 2 error messages\n", w.String())
 }
 
 func TestDebugPrintError(t *testing.T) {
@@ -55,7 +55,7 @@ func TestDebugPrintError(t *testing.T) {
 	assert.Empty(t, w.String())
 
 	debugPrintError(errors.New("this is an error"))
-	assert.Equal(t, w.String(), "[GIN-debug] [ERROR] this is an error\n")
+	assert.Equal(t, "[GIN-debug] [ERROR] this is an error\n", w.String())
 }
 
 func TestDebugPrintRoutes(t *testing.T) {
@@ -83,7 +83,7 @@ func TestDebugPrintWARNINGSetHTMLTemplate(t *testing.T) {
 	defer teardown()
 
 	debugPrintWARNINGSetHTMLTemplate()
-	assert.Equal(t, w.String(), "[GIN-debug] [WARNING] Since SetHTMLTemplate() is NOT thread-safe. It should only be called\nat initialization. ie. before any route is registered or the router is listening in a socket:\n\n\trouter := gin.Default()\n\trouter.SetHTMLTemplate(template) // << good place\n\n")
+	assert.Equal(t, "[GIN-debug] [WARNING] Since SetHTMLTemplate() is NOT thread-safe. It should only be called\nat initialization. ie. before any route is registered or the router is listening in a socket:\n\n\trouter := gin.Default()\n\trouter.SetHTMLTemplate(template) // << good place\n\n", w.String())
 }
 
 func setup(w io.Writer) {
diff --git a/errors_test.go b/errors_test.go
index 5e596aff..a666d7c1 100644
--- a/errors_test.go
+++ b/errors_test.go
@@ -60,7 +60,7 @@ func TestError(t *testing.T) {
 		data   string
 	}
 	err.SetMeta(customError{status: "200", data: "other data"})
-	assert.Equal(t, err.JSON(), customError{status: "200", data: "other data"})
+	assert.Equal(t, customError{status: "200", data: "other data"}, err.JSON())
 }
 
 func TestErrorSlice(t *testing.T) {
@@ -71,33 +71,33 @@ func TestErrorSlice(t *testing.T) {
 	}
 
 	assert.Equal(t, errs, errs.ByType(ErrorTypeAny))
-	assert.Equal(t, errs.Last().Error(), "third")
-	assert.Equal(t, errs.Errors(), []string{"first", "second", "third"})
-	assert.Equal(t, errs.ByType(ErrorTypePublic).Errors(), []string{"third"})
-	assert.Equal(t, errs.ByType(ErrorTypePrivate).Errors(), []string{"first", "second"})
-	assert.Equal(t, errs.ByType(ErrorTypePublic|ErrorTypePrivate).Errors(), []string{"first", "second", "third"})
+	assert.Equal(t, "third", errs.Last().Error())
+	assert.Equal(t, []string{"first", "second", "third"}, errs.Errors())
+	assert.Equal(t, []string{"third"}, errs.ByType(ErrorTypePublic).Errors())
+	assert.Equal(t, []string{"first", "second"}, errs.ByType(ErrorTypePrivate).Errors())
+	assert.Equal(t, []string{"first", "second", "third"}, errs.ByType(ErrorTypePublic|ErrorTypePrivate).Errors())
 	assert.Empty(t, errs.ByType(ErrorTypeBind))
 	assert.Empty(t, errs.ByType(ErrorTypeBind).String())
 
-	assert.Equal(t, errs.String(), `Error #01: first
+	assert.Equal(t, `Error #01: first
 Error #02: second
      Meta: some data
 Error #03: third
      Meta: map[status:400]
-`)
-	assert.Equal(t, errs.JSON(), []interface{}{
+`, errs.String())
+	assert.Equal(t, []interface{}{
 		H{"error": "first"},
 		H{"error": "second", "meta": "some data"},
 		H{"error": "third", "status": "400"},
-	})
+	}, errs.JSON())
 	jsonBytes, _ := json.Marshal(errs)
 	assert.Equal(t, "[{\"error\":\"first\"},{\"error\":\"second\",\"meta\":\"some data\"},{\"error\":\"third\",\"status\":\"400\"}]", string(jsonBytes))
 	errs = errorMsgs{
 		{Err: errors.New("first"), Type: ErrorTypePrivate},
 	}
-	assert.Equal(t, errs.JSON(), H{"error": "first"})
+	assert.Equal(t, H{"error": "first"}, errs.JSON())
 	jsonBytes, _ = json.Marshal(errs)
-	assert.Equal(t, string(jsonBytes), "{\"error\":\"first\"}")
+	assert.Equal(t, "{\"error\":\"first\"}", string(jsonBytes))
 
 	errs = errorMsgs{}
 	assert.Nil(t, errs.Last())
diff --git a/middleware_test.go b/middleware_test.go
index 5572e790..aa6a37a8 100644
--- a/middleware_test.go
+++ b/middleware_test.go
@@ -37,8 +37,8 @@ func TestMiddlewareGeneralCase(t *testing.T) {
 	w := performRequest(router, "GET", "/")
 
 	// TEST
-	assert.Equal(t, w.Code, 200)
-	assert.Equal(t, signature, "ACDB")
+	assert.Equal(t, 200, w.Code)
+	assert.Equal(t, "ACDB", signature)
 }
 
 func TestMiddlewareNoRoute(t *testing.T) {
@@ -73,8 +73,8 @@ func TestMiddlewareNoRoute(t *testing.T) {
 	w := performRequest(router, "GET", "/")
 
 	// TEST
-	assert.Equal(t, w.Code, 404)
-	assert.Equal(t, signature, "ACEGHFDB")
+	assert.Equal(t, 404, w.Code)
+	assert.Equal(t, "ACEGHFDB", signature)
 }
 
 func TestMiddlewareNoMethodEnabled(t *testing.T) {
@@ -110,8 +110,8 @@ func TestMiddlewareNoMethodEnabled(t *testing.T) {
 	w := performRequest(router, "GET", "/")
 
 	// TEST
-	assert.Equal(t, w.Code, 405)
-	assert.Equal(t, signature, "ACEGHFDB")
+	assert.Equal(t, 405, w.Code)
+	assert.Equal(t, "ACEGHFDB", signature)
 }
 
 func TestMiddlewareNoMethodDisabled(t *testing.T) {
@@ -147,8 +147,8 @@ func TestMiddlewareNoMethodDisabled(t *testing.T) {
 	w := performRequest(router, "GET", "/")
 
 	// TEST
-	assert.Equal(t, w.Code, 404)
-	assert.Equal(t, signature, "AC X DB")
+	assert.Equal(t, 404, w.Code)
+	assert.Equal(t, "AC X DB", signature)
 }
 
 func TestMiddlewareAbort(t *testing.T) {
@@ -173,8 +173,8 @@ func TestMiddlewareAbort(t *testing.T) {
 	w := performRequest(router, "GET", "/")
 
 	// TEST
-	assert.Equal(t, w.Code, 401)
-	assert.Equal(t, signature, "ACD")
+	assert.Equal(t, 401, w.Code)
+	assert.Equal(t, "ACD", signature)
 }
 
 func TestMiddlewareAbortHandlersChainAndNext(t *testing.T) {
@@ -195,8 +195,8 @@ func TestMiddlewareAbortHandlersChainAndNext(t *testing.T) {
 	w := performRequest(router, "GET", "/")
 
 	// TEST
-	assert.Equal(t, w.Code, 410)
-	assert.Equal(t, signature, "ACB")
+	assert.Equal(t, 410, w.Code)
+	assert.Equal(t, "ACB", signature)
 }
 
 // TestFailHandlersChain - ensure that Fail interrupt used middleware in fifo order as
@@ -218,8 +218,8 @@ func TestMiddlewareFailHandlersChain(t *testing.T) {
 	w := performRequest(router, "GET", "/")
 
 	// TEST
-	assert.Equal(t, w.Code, 500)
-	assert.Equal(t, signature, "A")
+	assert.Equal(t, 500, w.Code)
+	assert.Equal(t, "A", signature)
 }
 
 func TestMiddlewareWrite(t *testing.T) {
diff --git a/response_writer_test.go b/response_writer_test.go
index 7306d192..cec27338 100644
--- a/response_writer_test.go
+++ b/response_writer_test.go
@@ -34,11 +34,11 @@ func TestResponseWriterReset(t *testing.T) {
 	var w ResponseWriter = writer
 
 	writer.reset(testWritter)
-	assert.Equal(t, writer.size, -1)
-	assert.Equal(t, writer.status, 200)
-	assert.Equal(t, writer.ResponseWriter, testWritter)
-	assert.Equal(t, w.Size(), -1)
-	assert.Equal(t, w.Status(), 200)
+	assert.Equal(t, -1, writer.size)
+	assert.Equal(t, 200, writer.status)
+	assert.Equal(t, testWritter, writer.ResponseWriter)
+	assert.Equal(t, -1, w.Size())
+	assert.Equal(t, 200, w.Status())
 	assert.False(t, w.Written())
 }
 
@@ -50,11 +50,11 @@ func TestResponseWriterWriteHeader(t *testing.T) {
 
 	w.WriteHeader(300)
 	assert.False(t, w.Written())
-	assert.Equal(t, w.Status(), 300)
+	assert.Equal(t, 300, w.Status())
 	assert.NotEqual(t, testWritter.Code, 300)
 
 	w.WriteHeader(-1)
-	assert.Equal(t, w.Status(), 300)
+	assert.Equal(t, 300, w.Status())
 }
 
 func TestResponseWriterWriteHeadersNow(t *testing.T) {
@@ -67,12 +67,12 @@ func TestResponseWriterWriteHeadersNow(t *testing.T) {
 	w.WriteHeaderNow()
 
 	assert.True(t, w.Written())
-	assert.Equal(t, w.Size(), 0)
-	assert.Equal(t, testWritter.Code, 300)
+	assert.Equal(t, 0, w.Size())
+	assert.Equal(t, 300, testWritter.Code)
 
 	writer.size = 10
 	w.WriteHeaderNow()
-	assert.Equal(t, w.Size(), 10)
+	assert.Equal(t, 10, w.Size())
 }
 
 func TestResponseWriterWrite(t *testing.T) {
@@ -82,17 +82,17 @@ func TestResponseWriterWrite(t *testing.T) {
 	w := ResponseWriter(writer)
 
 	n, err := w.Write([]byte("hola"))
-	assert.Equal(t, n, 4)
-	assert.Equal(t, w.Size(), 4)
-	assert.Equal(t, w.Status(), 200)
-	assert.Equal(t, testWritter.Code, 200)
-	assert.Equal(t, testWritter.Body.String(), "hola")
+	assert.Equal(t, 4, n)
+	assert.Equal(t, 4, w.Size())
+	assert.Equal(t, 200, w.Status())
+	assert.Equal(t, 200, testWritter.Code)
+	assert.Equal(t, "hola", testWritter.Body.String())
 	assert.NoError(t, err)
 
 	n, err = w.Write([]byte(" adios"))
-	assert.Equal(t, n, 6)
-	assert.Equal(t, w.Size(), 10)
-	assert.Equal(t, testWritter.Body.String(), "hola adios")
+	assert.Equal(t, 6, n)
+	assert.Equal(t, 10, w.Size())
+	assert.Equal(t, "hola adios", testWritter.Body.String())
 	assert.NoError(t, err)
 }
 

From 4b5ec517daa247f8f3bd0448f82ca55c0d14fa0a Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Mon, 14 Aug 2017 11:02:31 +0800
Subject: [PATCH 078/113] fix(test): only check Location header (#1064)

* fix(test): only check Location header

* fix(test): rename field

* fix(test): not export field
---
 routes_test.go | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/routes_test.go b/routes_test.go
index 41693eed..b44b6431 100644
--- a/routes_test.go
+++ b/routes_test.go
@@ -356,25 +356,25 @@ func TestRouterNotFound(t *testing.T) {
 	router.GET("/", func(c *Context) {})
 
 	testRoutes := []struct {
-		route  string
-		code   int
-		header string
+		route    string
+		code     int
+		location string
 	}{
-		{"/path/", 301, "map[Location:[/path]]"},   // TSR -/
-		{"/dir", 301, "map[Location:[/dir/]]"},     // TSR +/
-		{"", 301, "map[Location:[/]]"},             // TSR +/
-		{"/PATH", 301, "map[Location:[/path]]"},    // Fixed Case
-		{"/DIR/", 301, "map[Location:[/dir/]]"},    // Fixed Case
-		{"/PATH/", 301, "map[Location:[/path]]"},   // Fixed Case -/
-		{"/DIR", 301, "map[Location:[/dir/]]"},     // Fixed Case +/
-		{"/../path", 301, "map[Location:[/path]]"}, // CleanPath
-		{"/nope", 404, ""},                         // NotFound
+		{"/path/", 301, "/path"},   // TSR -/
+		{"/dir", 301, "/dir/"},     // TSR +/
+		{"", 301, "/"},             // TSR +/
+		{"/PATH", 301, "/path"},    // Fixed Case
+		{"/DIR/", 301, "/dir/"},    // Fixed Case
+		{"/PATH/", 301, "/path"},   // Fixed Case -/
+		{"/DIR", 301, "/dir/"},     // Fixed Case +/
+		{"/../path", 301, "/path"}, // CleanPath
+		{"/nope", 404, ""},         // NotFound
 	}
 	for _, tr := range testRoutes {
 		w := performRequest(router, "GET", tr.route)
 		assert.Equal(t, w.Code, tr.code)
 		if w.Code != 404 {
-			assert.Equal(t, fmt.Sprint(w.Header()), tr.header)
+			assert.Equal(t, fmt.Sprint(w.Header().Get("Location")), tr.location)
 		}
 	}
 

From 25d20a4463a63083b85bb2d8ebb99c7f638920f2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Mon, 14 Aug 2017 12:21:05 +0800
Subject: [PATCH 079/113] merge args if it have same type (#1059)

---
 gin.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gin.go b/gin.go
index 8347ce22..e2c0105d 100644
--- a/gin.go
+++ b/gin.go
@@ -268,7 +268,7 @@ func (engine *Engine) Run(addr ...string) (err error) {
 // RunTLS attaches the router to a http.Server and starts listening and serving HTTPS (secure) requests.
 // It is a shortcut for http.ListenAndServeTLS(addr, certFile, keyFile, router)
 // Note: this method will block the calling goroutine indefinitely unless an error happens.
-func (engine *Engine) RunTLS(addr string, certFile string, keyFile string) (err error) {
+func (engine *Engine) RunTLS(addr, certFile, keyFile string) (err error) {
 	debugPrint("Listening and serving HTTPS on %s\n", addr)
 	defer func() { debugPrintError(err) }()
 

From 52c2ed34b3256727a0aeac5e57129eb788bac045 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Mon, 14 Aug 2017 14:34:29 +0800
Subject: [PATCH 080/113] log format (#1060)

---
 logger.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logger.go b/logger.go
index 470e4bb6..7edae415 100644
--- a/logger.go
+++ b/logger.go
@@ -102,7 +102,7 @@ func LoggerWithWriter(out io.Writer, notlogged ...string) HandlerFunc {
 				path = path + "?" + raw
 			}
 
-			fmt.Fprintf(out, "[GIN] %v |%s %3d %s| %13v | %15s |%s  %s %-7s %s\n%s",
+			fmt.Fprintf(out, "[GIN] %v |%s %3d %s| %13v | %15s |%s %-7s %s %s\n%s",
 				end.Format("2006/01/02 - 15:04:05"),
 				statusColor, statusCode, reset,
 				latency,

From ecae34c4e186d5190ca38ac225ce03e3894d99b7 Mon Sep 17 00:00:00 2001
From: keke <19yamashita15@gmail.com>
Date: Wed, 16 Aug 2017 10:50:43 +0900
Subject: [PATCH 081/113] fix 200 to http.Status (#1067)

---
 examples/app-engine/hello.go | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/examples/app-engine/hello.go b/examples/app-engine/hello.go
index da7e4ae4..f569dadb 100644
--- a/examples/app-engine/hello.go
+++ b/examples/app-engine/hello.go
@@ -13,10 +13,10 @@ func init() {
 
 	// Define your handlers
 	r.GET("/", func(c *gin.Context) {
-		c.String(200, "Hello World!")
+		c.String(http.StatusOK, "Hello World!")
 	})
 	r.GET("/ping", func(c *gin.Context) {
-		c.String(200, "pong")
+		c.String(http.StatusOK, "pong")
 	})
 
 	// Handle all requests using net/http

From a8fa424ae529397d4a0f2a1f9fda8031851a3269 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Wed, 16 Aug 2017 11:55:50 +0800
Subject: [PATCH 082/113] update comment (#1057)

---
 auth.go            |  8 ++++----
 context.go         | 29 ++++++++++++++---------------
 errors.go          |  6 +++---
 fs.go              |  4 ++--
 gin.go             |  4 ++--
 logger.go          | 10 +++++-----
 path.go            |  4 ++--
 recovery.go        |  2 +-
 render/data.go     |  2 +-
 response_writer.go |  6 +++---
 routergroup.go     | 18 +++++++++---------
 tree.go            |  2 +-
 utils.go           |  2 +-
 13 files changed, 48 insertions(+), 49 deletions(-)

diff --git a/auth.go b/auth.go
index c214e213..e7c46bf6 100644
--- a/auth.go
+++ b/auth.go
@@ -10,10 +10,10 @@ import (
 	"strconv"
 )
 
-// AuthUserKey is the cookie name for user credential in basic auth
+// AuthUserKey is the cookie name for user credential in basic auth.
 const AuthUserKey = "user"
 
-// Accounts defines a key/value for user/pass list of authorized logins
+// Accounts defines a key/value for user/pass list of authorized logins.
 type Accounts map[string]string
 
 type authPair struct {
@@ -56,7 +56,7 @@ func BasicAuthForRealm(accounts Accounts, realm string) HandlerFunc {
 		}
 
 		// The user credentials was found, set user's id to key AuthUserKey in this context, the user's id can be read later using
-		// c.MustGet(gin.AuthUserKey)
+		// c.MustGet(gin.AuthUserKey).
 		c.Set(AuthUserKey, user)
 	}
 }
@@ -90,6 +90,6 @@ func secureCompare(given, actual string) bool {
 	if subtle.ConstantTimeEq(int32(len(given)), int32(len(actual))) == 1 {
 		return subtle.ConstantTimeCompare([]byte(given), []byte(actual)) == 1
 	}
-	// Securely compare actual to itself to keep constant time, but always return false
+	// Securely compare actual to itself to keep constant time, but always return false.
 	return subtle.ConstantTimeCompare([]byte(actual), []byte(actual)) == 1 && false
 }
diff --git a/context.go b/context.go
index 895ba7a1..497cbfd6 100644
--- a/context.go
+++ b/context.go
@@ -22,7 +22,7 @@ import (
 	"github.com/gin-gonic/gin/render"
 )
 
-// Content-Type MIME of the most common data formats
+// Content-Type MIME of the most common data formats.
 const (
 	MIMEJSON              = binding.MIMEJSON
 	MIMEHTML              = binding.MIMEHTML
@@ -51,13 +51,13 @@ type Context struct {
 
 	engine *Engine
 
-	// Keys is a key/value pair exclusively for the context of each request
+	// Keys is a key/value pair exclusively for the context of each request.
 	Keys map[string]interface{}
 
-	// Errors is a list of errors attached to all the handlers/middlewares who used this context
+	// Errors is a list of errors attached to all the handlers/middlewares who used this context.
 	Errors errorMsgs
 
-	// Accepted defines a list of manually accepted formats for content negotiation
+	// Accepted defines a list of manually accepted formats for content negotiation.
 	Accepted []string
 }
 
@@ -87,7 +87,7 @@ func (c *Context) Copy() *Context {
 }
 
 // HandlerName returns the main handler's name. For example if the handler is "handleGetUsers()",
-// this function will return "main.handleGetUsers"
+// this function will return "main.handleGetUsers".
 func (c *Context) HandlerName() string {
 	return nameOfFunction(c.handlers.Last())
 }
@@ -462,18 +462,18 @@ func (c *Context) Bind(obj interface{}) error {
 	return c.MustBindWith(obj, b)
 }
 
-// BindJSON is a shortcut for c.MustBindWith(obj, binding.JSON)
+// BindJSON is a shortcut for c.MustBindWith(obj, binding.JSON).
 func (c *Context) BindJSON(obj interface{}) error {
 	return c.MustBindWith(obj, binding.JSON)
 }
 
-// BindQuery is a shortcut for c.MustBindWith(obj, binding.Query)
+// BindQuery is a shortcut for c.MustBindWith(obj, binding.Query).
 func (c *Context) BindQuery(obj interface{}) error {
 	return c.MustBindWith(obj, binding.Query)
 }
 
-// MustBindWith binds the passed struct pointer using the specified binding
-// engine. It will abort the request with HTTP 400 if any error ocurrs.
+// MustBindWith binds the passed struct pointer using the specified binding engine.
+// It will abort the request with HTTP 400 if any error ocurrs.
 // See the binding package.
 func (c *Context) MustBindWith(obj interface{}, b binding.Binding) (err error) {
 	if err = c.ShouldBindWith(obj, b); err != nil {
@@ -483,8 +483,7 @@ func (c *Context) MustBindWith(obj interface{}, b binding.Binding) (err error) {
 	return
 }
 
-// ShouldBindWith binds the passed struct pointer using the specified binding
-// engine.
+// ShouldBindWith binds the passed struct pointer using the specified binding engine.
 // See the binding package.
 func (c *Context) ShouldBindWith(obj interface{}, b binding.Binding) error {
 	return b.Bind(c.Request, obj)
@@ -548,7 +547,7 @@ func (c *Context) requestHeader(key string) string {
 /******** RESPONSE RENDERING ********/
 /************************************/
 
-// bodyAllowedForStatus is a copy of http.bodyAllowedForStatus non-exported function
+// bodyAllowedForStatus is a copy of http.bodyAllowedForStatus non-exported function.
 func bodyAllowedForStatus(status int) bool {
 	switch {
 	case status >= 100 && status <= 199:
@@ -566,7 +565,7 @@ func (c *Context) Status(code int) {
 	c.writermem.WriteHeader(code)
 }
 
-// Header is a intelligent shortcut for c.Writer.Header().Set(key, value)
+// Header is a intelligent shortcut for c.Writer.Header().Set(key, value).
 // It writes a header in the response.
 // If value == "", this method removes the header `c.Writer.Header().Del(key)`
 func (c *Context) Header(key, value string) {
@@ -577,12 +576,12 @@ func (c *Context) Header(key, value string) {
 	}
 }
 
-// GetHeader returns value from request headers
+// GetHeader returns value from request headers.
 func (c *Context) GetHeader(key string) string {
 	return c.requestHeader(key)
 }
 
-// GetRawData return stream data
+// GetRawData return stream data.
 func (c *Context) GetRawData() ([]byte, error) {
 	return ioutil.ReadAll(c.Request.Body)
 }
diff --git a/errors.go b/errors.go
index 19761106..6f3c9868 100644
--- a/errors.go
+++ b/errors.go
@@ -65,7 +65,7 @@ func (msg *Error) JSON() interface{} {
 	return json
 }
 
-// MarshalJSON implements the json.Marshaller interface
+// MarshalJSON implements the json.Marshaller interface.
 func (msg *Error) MarshalJSON() ([]byte, error) {
 	return json.Marshal(msg.JSON())
 }
@@ -80,7 +80,7 @@ func (msg *Error) IsType(flags ErrorType) bool {
 }
 
 // ByType returns a readonly copy filtered the byte.
-// ie ByType(gin.ErrorTypePublic) returns a slice of errors with type=ErrorTypePublic
+// ie ByType(gin.ErrorTypePublic) returns a slice of errors with type=ErrorTypePublic.
 func (a errorMsgs) ByType(typ ErrorType) errorMsgs {
 	if len(a) == 0 {
 		return nil
@@ -98,7 +98,7 @@ func (a errorMsgs) ByType(typ ErrorType) errorMsgs {
 }
 
 // Last returns the last error in the slice. It returns nil if the array is empty.
-// Shortcut for errors[len(errors)-1]
+// Shortcut for errors[len(errors)-1].
 func (a errorMsgs) Last() *Error {
 	if length := len(a); length > 0 {
 		return a[length-1]
diff --git a/fs.go b/fs.go
index 8570a9a9..7a6738a6 100644
--- a/fs.go
+++ b/fs.go
@@ -29,7 +29,7 @@ func Dir(root string, listDirectory bool) http.FileSystem {
 	return &onlyfilesFS{fs}
 }
 
-// Open conforms to http.Filesystem
+// Open conforms to http.Filesystem.
 func (fs onlyfilesFS) Open(name string) (http.File, error) {
 	f, err := fs.fs.Open(name)
 	if err != nil {
@@ -38,7 +38,7 @@ func (fs onlyfilesFS) Open(name string) (http.File, error) {
 	return neuteredReaddirFile{f}, nil
 }
 
-// Readdir overrides the http.File default implementation
+// Readdir overrides the http.File default implementation.
 func (f neuteredReaddirFile) Readdir(count int) ([]os.FileInfo, error) {
 	// this disables directory listing
 	return nil, nil
diff --git a/gin.go b/gin.go
index e2c0105d..23853a97 100644
--- a/gin.go
+++ b/gin.go
@@ -14,7 +14,7 @@ import (
 	"github.com/gin-gonic/gin/render"
 )
 
-// Version is Framework's version
+// Version is Framework's version.
 const Version = "v1.2"
 
 var default404Body = []byte("404 page not found")
@@ -191,7 +191,7 @@ func (engine *Engine) NoRoute(handlers ...HandlerFunc) {
 	engine.rebuild404Handlers()
 }
 
-// NoMethod sets the handlers called when... TODO
+// NoMethod sets the handlers called when... TODO.
 func (engine *Engine) NoMethod(handlers ...HandlerFunc) {
 	engine.noMethod = handlers
 	engine.rebuild405Handlers()
diff --git a/logger.go b/logger.go
index 7edae415..a6f7f140 100644
--- a/logger.go
+++ b/logger.go
@@ -25,17 +25,17 @@ var (
 	disableColor = false
 )
 
-// DisableConsoleColor disables color output in the console
+// DisableConsoleColor disables color output in the console.
 func DisableConsoleColor() {
 	disableColor = true
 }
 
-// ErrorLogger returns a handlerfunc for any error type
+// ErrorLogger returns a handlerfunc for any error type.
 func ErrorLogger() HandlerFunc {
 	return ErrorLoggerT(ErrorTypeAny)
 }
 
-// ErrorLoggerT returns a handlerfunc for a given error type
+// ErrorLoggerT returns a handlerfunc for a given error type.
 func ErrorLoggerT(typ ErrorType) HandlerFunc {
 	return func(c *Context) {
 		c.Next()
@@ -46,8 +46,8 @@ func ErrorLoggerT(typ ErrorType) HandlerFunc {
 	}
 }
 
-// Logger instances a Logger middleware that will write the logs to gin.DefaultWriter
-// By default gin.DefaultWriter = os.Stdout
+// Logger instances a Logger middleware that will write the logs to gin.DefaultWriter.
+// By default gin.DefaultWriter = os.Stdout.
 func Logger() HandlerFunc {
 	return LoggerWithWriter(DefaultWriter)
 }
diff --git a/path.go b/path.go
index e3424b13..ed63ad1a 100644
--- a/path.go
+++ b/path.go
@@ -17,7 +17,7 @@ package gin
 //	4. Eliminate .. elements that begin a rooted path:
 //	   that is, replace "/.." by "/" at the beginning of a path.
 //
-// If the result of this process is an empty string, "/" is returned
+// If the result of this process is an empty string, "/" is returned.
 func cleanPath(p string) string {
 	// Turn empty string into "/"
 	if p == "" {
@@ -109,7 +109,7 @@ func cleanPath(p string) string {
 	return string(buf[:w])
 }
 
-// internal helper to lazily create a buffer if necessary
+// internal helper to lazily create a buffer if necessary.
 func bufApp(buf *[]byte, s string, w int, c byte) {
 	if *buf == nil {
 		if s[w] == c {
diff --git a/recovery.go b/recovery.go
index c502f355..7aff3d87 100644
--- a/recovery.go
+++ b/recovery.go
@@ -46,7 +46,7 @@ func RecoveryWithWriter(out io.Writer) HandlerFunc {
 	}
 }
 
-// stack returns a nicely formated stack frame, skipping skip frames
+// stack returns a nicely formated stack frame, skipping skip frames.
 func stack(skip int) []byte {
 	buf := new(bytes.Buffer) // the returned data
 	// As we loop, we open files and read them. These variables record the currently
diff --git a/render/data.go b/render/data.go
index c296042c..33194913 100644
--- a/render/data.go
+++ b/render/data.go
@@ -11,7 +11,7 @@ type Data struct {
 	Data        []byte
 }
 
-// Render (Data) writes data with custom ContentType
+// Render (Data) writes data with custom ContentType.
 func (r Data) Render(w http.ResponseWriter) (err error) {
 	r.WriteContentType(w)
 	_, err = w.Write(r.Data)
diff --git a/response_writer.go b/response_writer.go
index 216165b9..232f00aa 100644
--- a/response_writer.go
+++ b/response_writer.go
@@ -95,7 +95,7 @@ func (w *responseWriter) Written() bool {
 	return w.size != noWritten
 }
 
-// Hijack implements the http.Hijacker interface
+// Hijack implements the http.Hijacker interface.
 func (w *responseWriter) Hijack() (net.Conn, *bufio.ReadWriter, error) {
 	if w.size < 0 {
 		w.size = 0
@@ -103,12 +103,12 @@ func (w *responseWriter) Hijack() (net.Conn, *bufio.ReadWriter, error) {
 	return w.ResponseWriter.(http.Hijacker).Hijack()
 }
 
-// CloseNotify implements the http.CloseNotify interface
+// CloseNotify implements the http.CloseNotify interface.
 func (w *responseWriter) CloseNotify() <-chan bool {
 	return w.ResponseWriter.(http.CloseNotifier).CloseNotify()
 }
 
-// Flush implements the http.Flush interface
+// Flush implements the http.Flush interface.
 func (w *responseWriter) Flush() {
 	w.ResponseWriter.(http.Flusher).Flush()
 }
diff --git a/routergroup.go b/routergroup.go
index 89ec89aa..5e681c1c 100644
--- a/routergroup.go
+++ b/routergroup.go
@@ -35,7 +35,7 @@ type IRoutes interface {
 }
 
 // RouterGroup is used internally to configure router, a RouterGroup is associated with a prefix
-// and an array of handlers (middleware)
+// and an array of handlers (middleware).
 type RouterGroup struct {
 	Handlers HandlersChain
 	basePath string
@@ -89,43 +89,43 @@ func (group *RouterGroup) Handle(httpMethod, relativePath string, handlers ...Ha
 	return group.handle(httpMethod, relativePath, handlers)
 }
 
-// POST is a shortcut for router.Handle("POST", path, handle)
+// POST is a shortcut for router.Handle("POST", path, handle).
 func (group *RouterGroup) POST(relativePath string, handlers ...HandlerFunc) IRoutes {
 	return group.handle("POST", relativePath, handlers)
 }
 
-// GET is a shortcut for router.Handle("GET", path, handle)
+// GET is a shortcut for router.Handle("GET", path, handle).
 func (group *RouterGroup) GET(relativePath string, handlers ...HandlerFunc) IRoutes {
 	return group.handle("GET", relativePath, handlers)
 }
 
-// DELETE is a shortcut for router.Handle("DELETE", path, handle)
+// DELETE is a shortcut for router.Handle("DELETE", path, handle).
 func (group *RouterGroup) DELETE(relativePath string, handlers ...HandlerFunc) IRoutes {
 	return group.handle("DELETE", relativePath, handlers)
 }
 
-// PATCH is a shortcut for router.Handle("PATCH", path, handle)
+// PATCH is a shortcut for router.Handle("PATCH", path, handle).
 func (group *RouterGroup) PATCH(relativePath string, handlers ...HandlerFunc) IRoutes {
 	return group.handle("PATCH", relativePath, handlers)
 }
 
-// PUT is a shortcut for router.Handle("PUT", path, handle)
+// PUT is a shortcut for router.Handle("PUT", path, handle).
 func (group *RouterGroup) PUT(relativePath string, handlers ...HandlerFunc) IRoutes {
 	return group.handle("PUT", relativePath, handlers)
 }
 
-// OPTIONS is a shortcut for router.Handle("OPTIONS", path, handle)
+// OPTIONS is a shortcut for router.Handle("OPTIONS", path, handle).
 func (group *RouterGroup) OPTIONS(relativePath string, handlers ...HandlerFunc) IRoutes {
 	return group.handle("OPTIONS", relativePath, handlers)
 }
 
-// HEAD is a shortcut for router.Handle("HEAD", path, handle)
+// HEAD is a shortcut for router.Handle("HEAD", path, handle).
 func (group *RouterGroup) HEAD(relativePath string, handlers ...HandlerFunc) IRoutes {
 	return group.handle("HEAD", relativePath, handlers)
 }
 
 // Any registers a route that matches all the HTTP methods.
-// GET, POST, PUT, PATCH, HEAD, OPTIONS, DELETE, CONNECT, TRACE
+// GET, POST, PUT, PATCH, HEAD, OPTIONS, DELETE, CONNECT, TRACE.
 func (group *RouterGroup) Any(relativePath string, handlers ...HandlerFunc) IRoutes {
 	group.handle("GET", relativePath, handlers)
 	group.handle("POST", relativePath, handlers)
diff --git a/tree.go b/tree.go
index 750ffae8..f67edd5d 100644
--- a/tree.go
+++ b/tree.go
@@ -96,7 +96,7 @@ type node struct {
 	priority  uint32
 }
 
-// increments priority of the given child and reorders if necessary
+// increments priority of the given child and reorders if necessary.
 func (n *node) incrementChildPrio(pos int) int {
 	n.children[pos].priority++
 	prio := n.children[pos].priority
diff --git a/utils.go b/utils.go
index 968570c7..ab06a759 100644
--- a/utils.go
+++ b/utils.go
@@ -47,7 +47,7 @@ func WrapH(h http.Handler) HandlerFunc {
 
 type H map[string]interface{}
 
-// MarshalXML allows type H to be used with xml.Marshal
+// MarshalXML allows type H to be used with xml.Marshal.
 func (h H) MarshalXML(e *xml.Encoder, start xml.StartElement) error {
 	start.Name = xml.Name{
 		Space: "",

From 3856206bd07d1a5627eb951e345fff25f9b6209c Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Thu, 17 Aug 2017 12:18:50 +0800
Subject: [PATCH 083/113] doc(readme): add additional middleware doc. (#1056)

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index b14c2a2a..dc3c8667 100644
--- a/README.md
+++ b/README.md
@@ -369,6 +369,7 @@ r := gin.New()
 instead of
 
 ```go
+// Default With the Logger and Recovery middleware already attached
 r := gin.Default()
 ```
 
@@ -380,7 +381,10 @@ func main() {
 	r := gin.New()
 
 	// Global middleware
+	// Logger middleware will write the logs to gin.DefaultWriter even you set with GIN_MODE=release. By default gin.DefaultWriter = os.Stdout
 	r.Use(gin.Logger())
+	
+	// Recovery middleware recovers from any panics and writes a 500 if there was one.
 	r.Use(gin.Recovery())
 
 	// Per route middleware, you can add as many as you desire.

From f4c9ac17a49e90c14ffe08b9e50aa4ee6abf6490 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Tue, 22 Aug 2017 10:27:28 +0800
Subject: [PATCH 084/113] not display color when set disableColor (#1072)

---
 logger.go | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/logger.go b/logger.go
index a6f7f140..c679c787 100644
--- a/logger.go
+++ b/logger.go
@@ -91,10 +91,11 @@ func LoggerWithWriter(out io.Writer, notlogged ...string) HandlerFunc {
 			clientIP := c.ClientIP()
 			method := c.Request.Method
 			statusCode := c.Writer.Status()
-			var statusColor, methodColor string
+			var statusColor, methodColor, resetColor string
 			if isTerm {
 				statusColor = colorForStatus(statusCode)
 				methodColor = colorForMethod(method)
+				resetColor = reset
 			}
 			comment := c.Errors.ByType(ErrorTypePrivate).String()
 
@@ -104,10 +105,10 @@ func LoggerWithWriter(out io.Writer, notlogged ...string) HandlerFunc {
 
 			fmt.Fprintf(out, "[GIN] %v |%s %3d %s| %13v | %15s |%s %-7s %s %s\n%s",
 				end.Format("2006/01/02 - 15:04:05"),
-				statusColor, statusCode, reset,
+				statusColor, statusCode, resetColor,
 				latency,
 				clientIP,
-				methodColor, method, reset,
+				methodColor, method, resetColor,
 				path,
 				comment,
 			)

From 8be30bd382890156e7e813beec9f18b2c65522a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Tue, 22 Aug 2017 13:55:32 +0800
Subject: [PATCH 085/113] Update readme for showing output log to file (#1073)

* Update readme for showing output log to file

* update indent
---
 README.md | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index dc3c8667..776ae8b8 100644
--- a/README.md
+++ b/README.md
@@ -381,7 +381,8 @@ func main() {
 	r := gin.New()
 
 	// Global middleware
-	// Logger middleware will write the logs to gin.DefaultWriter even you set with GIN_MODE=release. By default gin.DefaultWriter = os.Stdout
+	// Logger middleware will write the logs to gin.DefaultWriter even you set with GIN_MODE=release.
+	// By default gin.DefaultWriter = os.Stdout
 	r.Use(gin.Logger())
 	
 	// Recovery middleware recovers from any panics and writes a 500 if there was one.
@@ -412,6 +413,27 @@ func main() {
 }
 ```
 
+### Output log to file
+```go
+func main() {
+    // Disable Console Color, because not need color when output log to file
+    gin.DisableConsoleColor()
+    // Create one file to save logs
+    f, _ := os.Create("gin.log")
+    // Reset gin.DefaultWriter
+    gin.DefaultWriter = io.MultiWriter(f)
+    // If need to output log to file and console at a time, please use the following code:
+    // gin.DefaultWriter = io.MultiWriter(f, os.Stdout)
+
+    router := gin.Default()
+    router.GET("/ping", func(c *gin.Context) {
+        c.String(200, "pong")
+    })
+
+    r.Run(":8080")
+}
+```
+
 ### Model binding and validation
 
 To bind a request body into a type, use model binding. We currently support binding of JSON, XML and standard form values (foo=bar&boo=baz).

From 80152ac82c413e82275e828fdde8892c458715f7 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Thu, 24 Aug 2017 10:50:31 +0800
Subject: [PATCH 086/113] doc(readme): update writing logs section wording.
 (#1074)

* doc(readme): update writing logs section wording.

* doc(readme): update writing logs section wording.

* doc(readme): fix word formatting
---
 README.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 776ae8b8..b5644464 100644
--- a/README.md
+++ b/README.md
@@ -413,16 +413,17 @@ func main() {
 }
 ```
 
-### Output log to file
+### How to write log file
 ```go
 func main() {
-    // Disable Console Color, because not need color when output log to file
+    // Disable Console Color, you don't need console color when writing the logs to file.
     gin.DisableConsoleColor()
-    // Create one file to save logs
+    
+    // Logging to a file.
     f, _ := os.Create("gin.log")
-    // Reset gin.DefaultWriter
     gin.DefaultWriter = io.MultiWriter(f)
-    // If need to output log to file and console at a time, please use the following code:
+    
+    // Use the following code if you need to write the logs to file and console at the same time.
     // gin.DefaultWriter = io.MultiWriter(f, os.Stdout)
 
     router := gin.Default()

From c25254f563fc3685e22901edf2fd289902a76cf8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Fri, 25 Aug 2017 09:00:49 +0800
Subject: [PATCH 087/113] reduce go cyclo (#1076)

* reduce go cyclo

* use := var
---
 gin.go | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/gin.go b/gin.go
index 23853a97..ee39c9aa 100644
--- a/gin.go
+++ b/gin.go
@@ -316,14 +316,11 @@ func (engine *Engine) HandleContext(c *Context) {
 
 func (engine *Engine) handleHTTPRequest(context *Context) {
 	httpMethod := context.Request.Method
-	var path string
-	var unescape bool
+	path := context.Request.URL.Path
+	unescape := false
 	if engine.UseRawPath && len(context.Request.URL.RawPath) > 0 {
 		path = context.Request.URL.RawPath
 		unescape = engine.UnescapePathValues
-	} else {
-		path = context.Request.URL.Path
-		unescape = false
 	}
 
 	// Find root of the tree for the given HTTP method

From bc538849ebc41f2600338d9f65fad2c3008c95b2 Mon Sep 17 00:00:00 2001
From: stackerzzq <foo_stacker@yeah.net>
Date: Fri, 25 Aug 2017 09:06:13 +0800
Subject: [PATCH 088/113] Update readme for adding tag example of binding time
 field (#1080)

---
 README.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b5644464..879d77b4 100644
--- a/README.md
+++ b/README.md
@@ -532,10 +532,12 @@ package main
 
 import "log"
 import "github.com/gin-gonic/gin"
+import "time"
 
 type Person struct {
-	Name    string `form:"name"`
-	Address string `form:"address"`
+	Name     string    `form:"name"`
+	Address  string    `form:"address"`
+	Birthday time.Time `form:"birthday" time_format:"2006-01-02" time_utc:"1"`
 }
 
 func main() {
@@ -552,12 +554,18 @@ func startPage(c *gin.Context) {
 	if c.Bind(&person) == nil {
 		log.Println(person.Name)
 		log.Println(person.Address)
+		log.Println(person.Birthday)
 	}
 
 	c.String(200, "Success")
 }
 ```
 
+Test it with:
+```sh
+$ curl -X GET "localhost:8085/testing?name=appleboy&address=xyz&birthday=1992-03-15"
+```
+
 ### Bind HTML checkboxes
 
 See the [detail information](https://github.com/gin-gonic/gin/issues/129#issuecomment-124260092)

From 18b7c0892df51ba799473e57fd3d65f91c1c3aaf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Fri, 25 Aug 2017 09:13:53 +0800
Subject: [PATCH 089/113] not use dot when import package (#1077)

---
 ginS/gins.go | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/ginS/gins.go b/ginS/gins.go
index d40d1c3a..d238fcae 100644
--- a/ginS/gins.go
+++ b/ginS/gins.go
@@ -9,15 +9,15 @@ import (
 	"net/http"
 	"sync"
 
-	. "github.com/gin-gonic/gin"
+	"github.com/gin-gonic/gin"
 )
 
 var once sync.Once
-var internalEngine *Engine
+var internalEngine *gin.Engine
 
-func engine() *Engine {
+func engine() *gin.Engine {
 	once.Do(func() {
-		internalEngine = Default()
+		internalEngine = gin.Default()
 	})
 	return internalEngine
 }

From b9686e91fa271d2fe5da3108a2ea4087c0b0ad68 Mon Sep 17 00:00:00 2001
From: Dan Markham <dmarkham@gmail.com>
Date: Fri, 25 Aug 2017 21:53:27 -0700
Subject: [PATCH 090/113] Use standard library for retrieving header (#1081)

---
 context.go | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/context.go b/context.go
index 497cbfd6..6f2b0053 100644
--- a/context.go
+++ b/context.go
@@ -537,10 +537,7 @@ func (c *Context) IsWebsocket() bool {
 }
 
 func (c *Context) requestHeader(key string) string {
-	if values, _ := c.Request.Header[key]; len(values) > 0 {
-		return values[0]
-	}
-	return ""
+	return c.Request.Header.Get(key)
 }
 
 /************************************/

From fa391a4864cb2e249b4e82fd1d71261a1496f0f4 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Sat, 26 Aug 2017 03:48:56 -0500
Subject: [PATCH 091/113] chore(ci): add go 1.9 version (#1082)

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
---
 .travis.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.travis.yml b/.travis.yml
index 821ce8df..ec12cad6 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -4,6 +4,7 @@ go:
   - 1.6.x
   - 1.7.x
   - 1.8.x
+  - 1.9.x
   - master
 
 git:

From 211c48f0408804fdbc3b698cf53243da9699c376 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Sat, 26 Aug 2017 05:02:47 -0500
Subject: [PATCH 092/113] refactor: using requestHeader internal func (#1083)

* refactor: using requestHeader internal func.

* update

Signed-off-by: Bo-Yi Wu <appleboy.tw@gmail.com>
---
 auth.go    | 2 +-
 context.go | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/auth.go b/auth.go
index e7c46bf6..85d96fd3 100644
--- a/auth.go
+++ b/auth.go
@@ -47,7 +47,7 @@ func BasicAuthForRealm(accounts Accounts, realm string) HandlerFunc {
 	pairs := processAccounts(accounts)
 	return func(c *Context) {
 		// Search user in the slice of allowed credentials
-		user, found := pairs.searchCredential(c.Request.Header.Get("Authorization"))
+		user, found := pairs.searchCredential(c.requestHeader("Authorization"))
 		if !found {
 			// Credentials doesn't match, we return 401 and abort handlers chain.
 			c.Header("WWW-Authenticate", realm)
diff --git a/context.go b/context.go
index 6f2b0053..2be7010d 100644
--- a/context.go
+++ b/context.go
@@ -509,7 +509,7 @@ func (c *Context) ClientIP() string {
 	}
 
 	if c.engine.AppEngine {
-		if addr := c.Request.Header.Get("X-Appengine-Remote-Addr"); addr != "" {
+		if addr := c.requestHeader("X-Appengine-Remote-Addr"); addr != "" {
 			return addr
 		}
 	}

From 030b1aaf72ce020aa38b6c4bbdd6a4baf746051d Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Sat, 26 Aug 2017 12:37:19 -0500
Subject: [PATCH 093/113] chore(ci): replace travis ci go 1.9.x for 1.9 (#1085)

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index ec12cad6..72daa3f3 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -4,7 +4,7 @@ go:
   - 1.6.x
   - 1.7.x
   - 1.8.x
-  - 1.9.x
+  - 1.9
   - master
 
 git:

From 26c3f42095b8a1378617eb4756fbf8282cb1ae89 Mon Sep 17 00:00:00 2001
From: Suhas Karanth <sudo-suhas@users.noreply.github.com>
Date: Sun, 27 Aug 2017 13:07:39 +0530
Subject: [PATCH 094/113] feat(binding): add support for custom validator /
 validation tags (#1068)

* feat(binding): Add support for custom validation tags

* docs: Add example for custom validation tag

* test(binding): Add test for registering custom validation
---
 README.md                            | 85 ++++++++++++++++++++++++----
 binding/binding.go                   | 11 +++-
 binding/default_validator.go         |  5 ++
 binding/validate_test.go             | 42 ++++++++++++++
 examples/custom-validation/server.go | 45 +++++++++++++++
 5 files changed, 175 insertions(+), 13 deletions(-)
 create mode 100644 examples/custom-validation/server.go

diff --git a/README.md b/README.md
index 879d77b4..07357be4 100644
--- a/README.md
+++ b/README.md
@@ -40,7 +40,7 @@ $ go run example.go
 
 ## Benchmarks
 
-Gin uses a custom version of [HttpRouter](https://github.com/julienschmidt/httprouter)  
+Gin uses a custom version of [HttpRouter](https://github.com/julienschmidt/httprouter)
 
 [See all benchmarks](/BENCHMARKS.md)
 
@@ -74,10 +74,10 @@ BenchmarkTigerTonic_GithubAll               |    1000    |  1439483    |  239104
 BenchmarkTraffic_GithubAll                  |     100    | 11383067    | 2659329    | 21848
 BenchmarkVulcan_GithubAll                   |    5000    |   394253    |   19894    |   609
 
-(1): Total Repetitions achieved in constant time, higher means more confident result  
-(2): Single Repetition Duration (ns/op), lower is better  
-(3): Heap Memory (B/op), lower is better  
-(4): Average Allocations per Repetition (allocs/op), lower is better  
+(1): Total Repetitions achieved in constant time, higher means more confident result
+(2): Single Repetition Duration (ns/op), lower is better
+(3): Heap Memory (B/op), lower is better
+(4): Average Allocations per Repetition (allocs/op), lower is better
 
 ## Gin v1. stable
 
@@ -281,10 +281,10 @@ func main() {
 		// single file
 		file, _ := c.FormFile("file")
 		log.Println(file.Filename)
-        
+
 		// Upload the file to specific dst.
-		// c.SaveUploadedFile(file, dst)       
-		
+		// c.SaveUploadedFile(file, dst)
+
 		c.String(http.StatusOK, fmt.Sprintf("'%s' uploaded!", file.Filename))
 	})
 	router.Run(":8080")
@@ -313,9 +313,9 @@ func main() {
 
 		for _, file := range files {
 			log.Println(file.Filename)
-			
+
 			// Upload the file to specific dst.
-			// c.SaveUploadedFile(file, dst)       
+			// c.SaveUploadedFile(file, dst)
 		}
 		c.String(http.StatusOK, fmt.Sprintf("%d files uploaded!", len(files)))
 	})
@@ -487,6 +487,67 @@ func main() {
 }
 ```
 
+### Custom Validators
+
+It is also possible to register custom validators. See the [example code](examples/custom-validation/server.go).
+
+[embedmd]:# (examples/custom-validation/server.go go)
+```go
+package main
+
+import (
+	"net/http"
+	"reflect"
+	"time"
+
+	"github.com/gin-gonic/gin"
+	"github.com/gin-gonic/gin/binding"
+	validator "gopkg.in/go-playground/validator.v8"
+)
+
+type Booking struct {
+	CheckIn  time.Time `form:"check_in" binding:"required,bookabledate" time_format:"2006-01-02"`
+	CheckOut time.Time `form:"check_out" binding:"required,gtfield=CheckIn" time_format:"2006-01-02"`
+}
+
+func bookableDate(
+	v *validator.Validate, topStruct reflect.Value, currentStructOrField reflect.Value,
+	field reflect.Value, fieldType reflect.Type, fieldKind reflect.Kind, param string,
+) bool {
+	if date, ok := field.Interface().(time.Time); ok {
+		today := time.Now()
+		if today.Year() > date.Year() || today.YearDay() > date.YearDay() {
+			return false
+		}
+	}
+	return true
+}
+
+func main() {
+	route := gin.Default()
+	binding.Validator.RegisterValidation("bookabledate", bookableDate)
+	route.GET("/bookable", getBookable)
+	route.Run(":8085")
+}
+
+func getBookable(c *gin.Context) {
+	var b Booking
+	if err := c.ShouldBindWith(&b, binding.Query); err == nil {
+		c.JSON(http.StatusOK, gin.H{"message": "Booking dates are valid!"})
+	} else {
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+	}
+}
+```
+
+```console
+$ curl "localhost:8085/bookable?check_in=2017-08-16&check_out=2017-08-17"
+{"message":"Booking dates are valid!"}
+
+$ curl "localhost:8085/bookable?check_in=2017-08-15&check_out=2017-08-16"
+{"error":"Key: 'Booking.CheckIn' Error:Field validation for 'CheckIn' failed on the 'bookabledate' tag"}
+```
+
 ### Only Bind Query String
 
 `BindQuery` function only binds the query params and not the post data. See the [detail information](https://github.com/gin-gonic/gin/issues/742#issuecomment-315953017).
@@ -711,7 +772,7 @@ func main() {
 	// Listen and serve on 0.0.0.0:8080
 	r.Run(":8080")
 }
-```  
+```
 
 ### Serving static files
 
@@ -822,7 +883,7 @@ You may use custom delims
 	r := gin.Default()
 	r.Delims("{[{", "}]}")
 	r.LoadHTMLGlob("/path/to/templates"))
-```  
+```
 
 #### Custom Template Funcs
 
diff --git a/binding/binding.go b/binding/binding.go
index 971547c2..a09cc221 100644
--- a/binding/binding.go
+++ b/binding/binding.go
@@ -4,7 +4,11 @@
 
 package binding
 
-import "net/http"
+import (
+	"net/http"
+
+	validator "gopkg.in/go-playground/validator.v8"
+)
 
 const (
 	MIMEJSON              = "application/json"
@@ -31,6 +35,11 @@ type StructValidator interface {
 	// If the struct is not valid or the validation itself fails, a descriptive error should be returned.
 	// Otherwise nil must be returned.
 	ValidateStruct(interface{}) error
+
+	// RegisterValidation adds a validation Func to a Validate's map of validators denoted by the key
+	// NOTE: if the key already exists, the previous validation function will be replaced.
+	// NOTE: this method is not thread-safe it is intended that these all be registered prior to any validation
+	RegisterValidation(string, validator.Func) error
 }
 
 var Validator StructValidator = &defaultValidator{}
diff --git a/binding/default_validator.go b/binding/default_validator.go
index 19885f16..6336bb6e 100644
--- a/binding/default_validator.go
+++ b/binding/default_validator.go
@@ -28,6 +28,11 @@ func (v *defaultValidator) ValidateStruct(obj interface{}) error {
 	return nil
 }
 
+func (v *defaultValidator) RegisterValidation(key string, fn validator.Func) error {
+	v.lazyinit()
+	return v.validate.RegisterValidation(key, fn)
+}
+
 func (v *defaultValidator) lazyinit() {
 	v.once.Do(func() {
 		config := &validator.Config{TagName: "binding"}
diff --git a/binding/validate_test.go b/binding/validate_test.go
index cbcb389d..523e1298 100644
--- a/binding/validate_test.go
+++ b/binding/validate_test.go
@@ -6,9 +6,12 @@ package binding
 
 import (
 	"bytes"
+	"reflect"
 	"testing"
 	"time"
 
+	validator "gopkg.in/go-playground/validator.v8"
+
 	"github.com/stretchr/testify/assert"
 )
 
@@ -190,3 +193,42 @@ func TestValidatePrimitives(t *testing.T) {
 	assert.NoError(t, validate(&str))
 	assert.Equal(t, str, "value")
 }
+
+// structCustomValidation is a helper struct we use to check that
+// custom validation can be registered on it.
+// The `notone` binding directive is for custom validation and registered later.
+type structCustomValidation struct {
+	Integer int `binding:"notone"`
+}
+
+// notOne is a custom validator meant to be used with `validator.v8` library.
+// The method signature for `v9` is significantly different and this function
+// would need to be changed for tests to pass after upgrade.
+// See https://github.com/gin-gonic/gin/pull/1015.
+func notOne(
+	v *validator.Validate, topStruct reflect.Value, currentStructOrField reflect.Value,
+	field reflect.Value, fieldType reflect.Type, fieldKind reflect.Kind, param string,
+) bool {
+	if val, ok := field.Interface().(int); ok {
+		return val != 1
+	}
+	return false
+}
+
+func TestRegisterValidation(t *testing.T) {
+	// This validates that the function `notOne` matches
+	// the expected function signature by `defaultValidator`
+	// and by extension the validator library.
+	err := Validator.RegisterValidation("notone", notOne)
+	// Check that we can register custom validation without error
+	assert.Nil(t, err)
+
+	// Create an instance which will fail validation
+	withOne := structCustomValidation{Integer: 1}
+	errs := validate(withOne)
+
+	// Check that we got back non-nil errs
+	assert.NotNil(t, errs)
+	// Check that the error matches expactation
+	assert.Error(t, errs, "", "", "notone")
+}
diff --git a/examples/custom-validation/server.go b/examples/custom-validation/server.go
new file mode 100644
index 00000000..0b67ce10
--- /dev/null
+++ b/examples/custom-validation/server.go
@@ -0,0 +1,45 @@
+package main
+
+import (
+	"net/http"
+	"reflect"
+	"time"
+
+	"github.com/gin-gonic/gin"
+	"github.com/gin-gonic/gin/binding"
+	validator "gopkg.in/go-playground/validator.v8"
+)
+
+type Booking struct {
+	CheckIn  time.Time `form:"check_in" binding:"required,bookabledate" time_format:"2006-01-02"`
+	CheckOut time.Time `form:"check_out" binding:"required,gtfield=CheckIn" time_format:"2006-01-02"`
+}
+
+func bookableDate(
+	v *validator.Validate, topStruct reflect.Value, currentStructOrField reflect.Value,
+	field reflect.Value, fieldType reflect.Type, fieldKind reflect.Kind, param string,
+) bool {
+	if date, ok := field.Interface().(time.Time); ok {
+		today := time.Now()
+		if today.Year() > date.Year() || today.YearDay() > date.YearDay() {
+			return false
+		}
+	}
+	return true
+}
+
+func main() {
+	route := gin.Default()
+	binding.Validator.RegisterValidation("bookabledate", bookableDate)
+	route.GET("/bookable", getBookable)
+	route.Run(":8085")
+}
+
+func getBookable(c *gin.Context) {
+	var b Booking
+	if err := c.ShouldBindWith(&b, binding.Query); err == nil {
+		c.JSON(http.StatusOK, gin.H{"message": "Booking dates are valid!"})
+	} else {
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+	}
+}

From f1edd2c2d1c0ff06ab0a3e8f3c6a3d58ee4a0a68 Mon Sep 17 00:00:00 2001
From: vz <vzvway@gmail.com>
Date: Sun, 27 Aug 2017 17:11:38 +0800
Subject: [PATCH 095/113] fix(ginS): fix undefined ref (#1087)

---
 ginS/gins.go | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/ginS/gins.go b/ginS/gins.go
index d238fcae..ee00b381 100644
--- a/ginS/gins.go
+++ b/ginS/gins.go
@@ -35,65 +35,65 @@ func SetHTMLTemplate(templ *template.Template) {
 }
 
 // NoRoute adds handlers for NoRoute. It return a 404 code by default.
-func NoRoute(handlers ...HandlerFunc) {
+func NoRoute(handlers ...gin.HandlerFunc) {
 	engine().NoRoute(handlers...)
 }
 
 // NoMethod sets the handlers called when... TODO
-func NoMethod(handlers ...HandlerFunc) {
+func NoMethod(handlers ...gin.HandlerFunc) {
 	engine().NoMethod(handlers...)
 }
 
 // Group creates a new router group. You should add all the routes that have common middlwares or the same path prefix.
 // For example, all the routes that use a common middlware for authorization could be grouped.
-func Group(relativePath string, handlers ...HandlerFunc) *RouterGroup {
+func Group(relativePath string, handlers ...gin.HandlerFunc) *gin.RouterGroup {
 	return engine().Group(relativePath, handlers...)
 }
 
-func Handle(httpMethod, relativePath string, handlers ...HandlerFunc) IRoutes {
+func Handle(httpMethod, relativePath string, handlers ...gin.HandlerFunc) gin.IRoutes {
 	return engine().Handle(httpMethod, relativePath, handlers...)
 }
 
 // POST is a shortcut for router.Handle("POST", path, handle)
-func POST(relativePath string, handlers ...HandlerFunc) IRoutes {
+func POST(relativePath string, handlers ...gin.HandlerFunc) gin.IRoutes {
 	return engine().POST(relativePath, handlers...)
 }
 
 // GET is a shortcut for router.Handle("GET", path, handle)
-func GET(relativePath string, handlers ...HandlerFunc) IRoutes {
+func GET(relativePath string, handlers ...gin.HandlerFunc) gin.IRoutes {
 	return engine().GET(relativePath, handlers...)
 }
 
 // DELETE is a shortcut for router.Handle("DELETE", path, handle)
-func DELETE(relativePath string, handlers ...HandlerFunc) IRoutes {
+func DELETE(relativePath string, handlers ...gin.HandlerFunc) gin.IRoutes {
 	return engine().DELETE(relativePath, handlers...)
 }
 
 // PATCH is a shortcut for router.Handle("PATCH", path, handle)
-func PATCH(relativePath string, handlers ...HandlerFunc) IRoutes {
+func PATCH(relativePath string, handlers ...gin.HandlerFunc) gin.IRoutes {
 	return engine().PATCH(relativePath, handlers...)
 }
 
 // PUT is a shortcut for router.Handle("PUT", path, handle)
-func PUT(relativePath string, handlers ...HandlerFunc) IRoutes {
+func PUT(relativePath string, handlers ...gin.HandlerFunc) gin.IRoutes {
 	return engine().PUT(relativePath, handlers...)
 }
 
 // OPTIONS is a shortcut for router.Handle("OPTIONS", path, handle)
-func OPTIONS(relativePath string, handlers ...HandlerFunc) IRoutes {
+func OPTIONS(relativePath string, handlers ...gin.HandlerFunc) gin.IRoutes {
 	return engine().OPTIONS(relativePath, handlers...)
 }
 
 // HEAD is a shortcut for router.Handle("HEAD", path, handle)
-func HEAD(relativePath string, handlers ...HandlerFunc) IRoutes {
+func HEAD(relativePath string, handlers ...gin.HandlerFunc) gin.IRoutes {
 	return engine().HEAD(relativePath, handlers...)
 }
 
-func Any(relativePath string, handlers ...HandlerFunc) IRoutes {
+func Any(relativePath string, handlers ...gin.HandlerFunc) gin.IRoutes {
 	return engine().Any(relativePath, handlers...)
 }
 
-func StaticFile(relativePath, filepath string) IRoutes {
+func StaticFile(relativePath, filepath string) gin.IRoutes {
 	return engine().StaticFile(relativePath, filepath)
 }
 
@@ -103,18 +103,18 @@ func StaticFile(relativePath, filepath string) IRoutes {
 // To use the operating system's file system implementation,
 // use :
 //     router.Static("/static", "/var/www")
-func Static(relativePath, root string) IRoutes {
+func Static(relativePath, root string) gin.IRoutes {
 	return engine().Static(relativePath, root)
 }
 
-func StaticFS(relativePath string, fs http.FileSystem) IRoutes {
+func StaticFS(relativePath string, fs http.FileSystem) gin.IRoutes {
 	return engine().StaticFS(relativePath, fs)
 }
 
 // Use attachs a global middleware to the router. ie. the middlewares attached though Use() will be
 // included in the handlers chain for every single request. Even 404, 405, static files...
 // For example, this is the right place for a logger or error management middleware.
-func Use(middlewares ...HandlerFunc) IRoutes {
+func Use(middlewares ...gin.HandlerFunc) gin.IRoutes {
 	return engine().Use(middlewares...)
 }
 

From 8902826696c1dad024e1c8ba4f903aa61a25c839 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Tue, 29 Aug 2017 03:38:53 +0800
Subject: [PATCH 096/113] doc(context): add cookie doc (#1088)

---
 context.go | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/context.go b/context.go
index 2be7010d..d7b6c61d 100644
--- a/context.go
+++ b/context.go
@@ -583,6 +583,9 @@ func (c *Context) GetRawData() ([]byte, error) {
 	return ioutil.ReadAll(c.Request.Body)
 }
 
+// SetCookie adds a Set-Cookie header to the ResponseWriter's headers.
+// The provided cookie must have a valid Name. Invalid cookies may be
+// silently dropped.
 func (c *Context) SetCookie(name, value string, maxAge int, path, domain string, secure, httpOnly bool) {
 	if path == "" {
 		path = "/"
@@ -598,6 +601,10 @@ func (c *Context) SetCookie(name, value string, maxAge int, path, domain string,
 	})
 }
 
+// Cookie returns the named cookie provided in the request or
+// ErrNoCookie if not found. And return the named cookie is unescaped.
+// If multiple cookies match the given name, only one cookie will
+// be returned.
 func (c *Context) Cookie(name string) (string, error) {
 	cookie, err := c.Request.Cookie(name)
 	if err != nil {

From c16c2b7ec33175b23667be512a74dbb7f3943aa5 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Wed, 30 Aug 2017 12:18:57 +0800
Subject: [PATCH 097/113] chore(vendor): update jsoniter rev, #1086 (#1090)

---
 vendor/vendor.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/vendor/vendor.json b/vendor/vendor.json
index e8690a2c..bcefee10 100644
--- a/vendor/vendor.json
+++ b/vendor/vendor.json
@@ -34,10 +34,10 @@
 			"revisionTime": "2017-06-01T23:02:30Z"
 		},
 		{
-			"checksumSHA1": "0e59uuETpidkmpaRwipQ8auqwhM=",
+			"checksumSHA1": "Ajh8TemnItg4nn+jKmVcsMRALBc=",
 			"path": "github.com/json-iterator/go",
-			"revision": "6b6938829d6156d7b9825f83eec757f0f571c981",
-			"revisionTime": "2017-07-18T14:19:52Z"
+			"revision": "36b14963da70d11297d313183d7e6388c8510e1e",
+			"revisionTime": "2017-08-29T15:58:51Z"
 		},
 		{
 			"checksumSHA1": "9if9IBLsxkarJ804NPWAzgskIAk=",

From ab50cf97900b63748a62a81c06c9189ef536d121 Mon Sep 17 00:00:00 2001
From: Edward Betts <edward@4angle.com>
Date: Fri, 1 Sep 2017 15:02:25 +0100
Subject: [PATCH 098/113] correct spelling mistake (#1092)

---
 recovery.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/recovery.go b/recovery.go
index 7aff3d87..dfea8c23 100644
--- a/recovery.go
+++ b/recovery.go
@@ -46,7 +46,7 @@ func RecoveryWithWriter(out io.Writer) HandlerFunc {
 	}
 }
 
-// stack returns a nicely formated stack frame, skipping skip frames.
+// stack returns a nicely formatted stack frame, skipping skip frames.
 func stack(skip int) []byte {
 	buf := new(bytes.Buffer) // the returned data
 	// As we loop, we open files and read them. These variables record the currently

From cdf26f994bb551da109f4e4b8f206d8db4fdb354 Mon Sep 17 00:00:00 2001
From: George Kirilenko <necryin@users.noreply.github.com>
Date: Mon, 4 Sep 2017 04:15:50 +0300
Subject: [PATCH 099/113] 32 << 10 != 32 Mb (#1094)

---
 binding/form.go | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/binding/form.go b/binding/form.go
index 557333e6..0be59660 100644
--- a/binding/form.go
+++ b/binding/form.go
@@ -6,6 +6,8 @@ package binding
 
 import "net/http"
 
+const defaultMemory = 32 * 1024 * 1024
+
 type formBinding struct{}
 type formPostBinding struct{}
 type formMultipartBinding struct{}
@@ -18,7 +20,7 @@ func (formBinding) Bind(req *http.Request, obj interface{}) error {
 	if err := req.ParseForm(); err != nil {
 		return err
 	}
-	req.ParseMultipartForm(32 << 10) // 32 MB
+	req.ParseMultipartForm(defaultMemory)
 	if err := mapForm(obj, req.Form); err != nil {
 		return err
 	}
@@ -44,7 +46,7 @@ func (formMultipartBinding) Name() string {
 }
 
 func (formMultipartBinding) Bind(req *http.Request, obj interface{}) error {
-	if err := req.ParseMultipartForm(32 << 10); err != nil {
+	if err := req.ParseMultipartForm(defaultMemory); err != nil {
 		return err
 	}
 	if err := mapForm(obj, req.MultipartForm.Value); err != nil {

From 848fa41ca016fa3a3d385af710c4219c1cb477a4 Mon Sep 17 00:00:00 2001
From: Eason Lin <easonlin404@gmail.com>
Date: Tue, 5 Sep 2017 09:17:53 +0800
Subject: [PATCH 100/113] doc(recovery): add RecoveryWithWriter doc (#1097)

---
 recovery.go | 1 +
 1 file changed, 1 insertion(+)

diff --git a/recovery.go b/recovery.go
index dfea8c23..89b39fec 100644
--- a/recovery.go
+++ b/recovery.go
@@ -26,6 +26,7 @@ func Recovery() HandlerFunc {
 	return RecoveryWithWriter(DefaultErrorWriter)
 }
 
+// RecoveryWithWriter returns a middleware for a given writer that recovers from any panics and writes a 500 if there was one.
 func RecoveryWithWriter(out io.Writer) HandlerFunc {
 	var logger *log.Logger
 	if out != nil {

From c9b344118f6426e9211c2e4530ac983a541f437a Mon Sep 17 00:00:00 2001
From: "Daniel M. Lambea" <dmlambea@gmail.com>
Date: Thu, 7 Sep 2017 04:45:16 +0100
Subject: [PATCH 101/113] Moved const 'defaultMemory' to attrib.
 Engine.MaxMultipartMemory instead. (#1100)

---
 README.md                             |  4 ++++
 context.go                            |  7 +++----
 examples/upload-file/multiple/main.go |  2 ++
 examples/upload-file/single/main.go   |  2 ++
 gin.go                                | 10 +++++++++-
 5 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 07357be4..d16a8682 100644
--- a/README.md
+++ b/README.md
@@ -277,6 +277,8 @@ References issue [#774](https://github.com/gin-gonic/gin/issues/774) and detail
 ```go
 func main() {
 	router := gin.Default()
+	// Set a lower memory limit for multipart forms (default is 32 MiB)
+	// router.MaxMultipartMemory = 8 << 20  // 8 MiB
 	router.POST("/upload", func(c *gin.Context) {
 		// single file
 		file, _ := c.FormFile("file")
@@ -306,6 +308,8 @@ See the detail [example code](examples/upload-file/multiple).
 ```go
 func main() {
 	router := gin.Default()
+	// Set a lower memory limit for multipart forms (default is 32 MiB)
+	// router.MaxMultipartMemory = 8 << 20  // 8 MiB
 	router.POST("/upload", func(c *gin.Context) {
 		// Multipart form
 		form, _ := c.MultipartForm()
diff --git a/context.go b/context.go
index d7b6c61d..74995e68 100644
--- a/context.go
+++ b/context.go
@@ -34,8 +34,7 @@ const (
 )
 
 const (
-	defaultMemory      = 32 << 20 // 32 MB
-	abortIndex    int8 = math.MaxInt8 / 2
+	abortIndex int8 = math.MaxInt8 / 2
 )
 
 // Context is the most important part of gin. It allows us to pass variables between middleware,
@@ -407,7 +406,7 @@ func (c *Context) PostFormArray(key string) []string {
 func (c *Context) GetPostFormArray(key string) ([]string, bool) {
 	req := c.Request
 	req.ParseForm()
-	req.ParseMultipartForm(defaultMemory)
+	req.ParseMultipartForm(c.engine.MaxMultipartMemory)
 	if values := req.PostForm[key]; len(values) > 0 {
 		return values, true
 	}
@@ -427,7 +426,7 @@ func (c *Context) FormFile(name string) (*multipart.FileHeader, error) {
 
 // MultipartForm is the parsed multipart form, including file uploads.
 func (c *Context) MultipartForm() (*multipart.Form, error) {
-	err := c.Request.ParseMultipartForm(defaultMemory)
+	err := c.Request.ParseMultipartForm(c.engine.MaxMultipartMemory)
 	return c.Request.MultipartForm, err
 }
 
diff --git a/examples/upload-file/multiple/main.go b/examples/upload-file/multiple/main.go
index 4bb4cdcb..a55325ed 100644
--- a/examples/upload-file/multiple/main.go
+++ b/examples/upload-file/multiple/main.go
@@ -9,6 +9,8 @@ import (
 
 func main() {
 	router := gin.Default()
+	// Set a lower memory limit for multipart forms (default is 32 MiB)
+	router.MaxMultipartMemory = 8 << 20 // 8 MiB
 	router.Static("/", "./public")
 	router.POST("/upload", func(c *gin.Context) {
 		name := c.PostForm("name")
diff --git a/examples/upload-file/single/main.go b/examples/upload-file/single/main.go
index 372a2994..5d438651 100644
--- a/examples/upload-file/single/main.go
+++ b/examples/upload-file/single/main.go
@@ -9,6 +9,8 @@ import (
 
 func main() {
 	router := gin.Default()
+	// Set a lower memory limit for multipart forms (default is 32 MiB)
+	router.MaxMultipartMemory = 8 << 20 // 8 MiB
 	router.Static("/", "./public")
 	router.POST("/upload", func(c *gin.Context) {
 		name := c.PostForm("name")
diff --git a/gin.go b/gin.go
index ee39c9aa..24c4dd8d 100644
--- a/gin.go
+++ b/gin.go
@@ -15,7 +15,10 @@ import (
 )
 
 // Version is Framework's version.
-const Version = "v1.2"
+const (
+	Version                = "v1.2"
+	defaultMultipartMemory = 32 << 20 // 32 MB
+)
 
 var default404Body = []byte("404 page not found")
 var default405Body = []byte("405 method not allowed")
@@ -92,6 +95,10 @@ type Engine struct {
 	// If UseRawPath is false (by default), the UnescapePathValues effectively is true,
 	// as url.Path gonna be used, which is already unescaped.
 	UnescapePathValues bool
+
+	// Value of 'maxMemory' param that is given to http.Request's ParseMultipartForm
+	// method call.
+	MaxMultipartMemory int64
 }
 
 var _ IRouter = &Engine{}
@@ -120,6 +127,7 @@ func New() *Engine {
 		AppEngine:              defaultAppEngine,
 		UseRawPath:             false,
 		UnescapePathValues:     true,
+		MaxMultipartMemory:     defaultMultipartMemory,
 		trees:                  make(methodTrees, 0, 9),
 		delims:                 render.Delims{Left: "{{", Right: "}}"},
 		secureJsonPrefix:       "while(1);",

From b1ee49de8c80ea72acf019315d3dffc0ce6e06ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Fri, 8 Sep 2017 08:56:56 +0800
Subject: [PATCH 102/113] fix typo (#1103)

---
 deprecated.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/deprecated.go b/deprecated.go
index 7b50dc70..ab447429 100644
--- a/deprecated.go
+++ b/deprecated.go
@@ -15,7 +15,7 @@ import (
 func (c *Context) BindWith(obj interface{}, b binding.Binding) error {
 	log.Println(`BindWith(\"interface{}, binding.Binding\") error is going to
 	be deprecated, please check issue #662 and either use MustBindWith() if you
-	want HTTP 400 to be automatically returned if any error occur, of use
+	want HTTP 400 to be automatically returned if any error occur, or use
 	ShouldBindWith() if you need to manage the error.`)
 	return c.MustBindWith(obj, b)
 }

From 8c17c680d9e4a6a6d7c2fd48eafe463eac23372e Mon Sep 17 00:00:00 2001
From: "Kristoffer A. Iversen" <kristoffer.a.iversen@gmail.com>
Date: Mon, 11 Sep 2017 16:17:26 +0200
Subject: [PATCH 103/113] Fixed README.md typo (#1104)

* Fixed README.md typo

* Fixed example typo

* Fixed example typo
---
 README.md                                              | 2 +-
 examples/graceful-shutdown/close/server.go             | 2 +-
 examples/graceful-shutdown/graceful-shutdown/server.go | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index d16a8682..0dc165bc 100644
--- a/README.md
+++ b/README.md
@@ -1224,7 +1224,7 @@ func main() {
 	if err := srv.Shutdown(ctx); err != nil {
 		log.Fatal("Server Shutdown:", err)
 	}
-	log.Println("Server exist")
+	log.Println("Server exiting")
 }
 ```
 
diff --git a/examples/graceful-shutdown/close/server.go b/examples/graceful-shutdown/close/server.go
index 54778393..9c4e90fa 100644
--- a/examples/graceful-shutdown/close/server.go
+++ b/examples/graceful-shutdown/close/server.go
@@ -41,5 +41,5 @@ func main() {
 		}
 	}
 
-	log.Println("Server exist")
+	log.Println("Server exiting")
 }
diff --git a/examples/graceful-shutdown/graceful-shutdown/server.go b/examples/graceful-shutdown/graceful-shutdown/server.go
index 060de081..6debe7f5 100644
--- a/examples/graceful-shutdown/graceful-shutdown/server.go
+++ b/examples/graceful-shutdown/graceful-shutdown/server.go
@@ -44,5 +44,5 @@ func main() {
 	if err := srv.Shutdown(ctx); err != nil {
 		log.Fatal("Server Shutdown:", err)
 	}
-	log.Println("Server exist")
+	log.Println("Server exiting")
 }

From 5afc5b19730118c9b8324fe9dd995d44ec65c81a Mon Sep 17 00:00:00 2001
From: Davor Kapsa <dvrkps@users.noreply.github.com>
Date: Mon, 11 Sep 2017 16:33:19 +0200
Subject: [PATCH 104/113] travis: add 1.9.x instead 1.9 to go version (#1105)

1.9.x should be working now.
---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 72daa3f3..ec12cad6 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -4,7 +4,7 @@ go:
   - 1.6.x
   - 1.7.x
   - 1.8.x
-  - 1.9
+  - 1.9.x
   - master
 
 git:

From a8c53949e5b7d8a00a9e26b1609a7626e7d0b127 Mon Sep 17 00:00:00 2001
From: delphinus <delphinus@remora.cx>
Date: Thu, 28 Sep 2017 23:23:18 +0900
Subject: [PATCH 105/113] Support time location on form binding (#1117)

---
 binding/form_mapping.go |  8 ++++++++
 context_test.go         | 21 +++++++++++++--------
 2 files changed, 21 insertions(+), 8 deletions(-)

diff --git a/binding/form_mapping.go b/binding/form_mapping.go
index 34f12678..c968dc08 100644
--- a/binding/form_mapping.go
+++ b/binding/form_mapping.go
@@ -163,6 +163,14 @@ func setTimeField(val string, structField reflect.StructField, value reflect.Val
 		l = time.UTC
 	}
 
+	if locTag := structField.Tag.Get("time_location"); locTag != "" {
+		loc, err := time.LoadLocation(locTag)
+		if err != nil {
+			return err
+		}
+		l = loc
+	}
+
 	t, err := time.ParseInLocation(timeFormat, val, l)
 	if err != nil {
 		return err
diff --git a/context_test.go b/context_test.go
index 15569bf2..4854a8a8 100644
--- a/context_test.go
+++ b/context_test.go
@@ -45,6 +45,7 @@ func createMultipartRequest() *http.Request {
 	must(mw.WriteField("id", ""))
 	must(mw.WriteField("time_local", "31/12/2016 14:55"))
 	must(mw.WriteField("time_utc", "31/12/2016 14:55"))
+	must(mw.WriteField("time_location", "31/12/2016 14:55"))
 	req, err := http.NewRequest("POST", "/", body)
 	must(err)
 	req.Header.Set("Content-Type", MIMEMultipartPOSTForm+"; boundary="+boundary)
@@ -444,14 +445,15 @@ func TestContextPostFormMultipart(t *testing.T) {
 	c.Request = createMultipartRequest()
 
 	var obj struct {
-		Foo       string    `form:"foo"`
-		Bar       string    `form:"bar"`
-		BarAsInt  int       `form:"bar"`
-		Array     []string  `form:"array"`
-		ID        string    `form:"id"`
-		TimeLocal time.Time `form:"time_local" time_format:"02/01/2006 15:04"`
-		TimeUTC   time.Time `form:"time_utc" time_format:"02/01/2006 15:04" time_utc:"1"`
-		BlankTime time.Time `form:"blank_time" time_format:"02/01/2006 15:04"`
+		Foo          string    `form:"foo"`
+		Bar          string    `form:"bar"`
+		BarAsInt     int       `form:"bar"`
+		Array        []string  `form:"array"`
+		ID           string    `form:"id"`
+		TimeLocal    time.Time `form:"time_local" time_format:"02/01/2006 15:04"`
+		TimeUTC      time.Time `form:"time_utc" time_format:"02/01/2006 15:04" time_utc:"1"`
+		TimeLocation time.Time `form:"time_location" time_format:"02/01/2006 15:04" time_location:"Asia/Tokyo"`
+		BlankTime    time.Time `form:"blank_time" time_format:"02/01/2006 15:04"`
 	}
 	assert.NoError(t, c.Bind(&obj))
 	assert.Equal(t, obj.Foo, "bar")
@@ -463,6 +465,9 @@ func TestContextPostFormMultipart(t *testing.T) {
 	assert.Equal(t, obj.TimeLocal.Location(), time.Local)
 	assert.Equal(t, obj.TimeUTC.Format("02/01/2006 15:04"), "31/12/2016 14:55")
 	assert.Equal(t, obj.TimeUTC.Location(), time.UTC)
+	loc, _ := time.LoadLocation("Asia/Tokyo")
+	assert.Equal(t, obj.TimeLocation.Format("02/01/2006 15:04"), "31/12/2016 14:55")
+	assert.Equal(t, obj.TimeLocation.Location(), loc)
 	assert.True(t, obj.BlankTime.IsZero())
 
 	value, ok := c.GetQuery("foo")

From f7376f7c7fc73e2fdd30623f413f87a32e73baa2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Thu, 28 Sep 2017 09:54:37 -0500
Subject: [PATCH 106/113] combine var and use tmp var (#1108)

---
 gin.go | 48 +++++++++++++++++++++++++++---------------------
 1 file changed, 27 insertions(+), 21 deletions(-)

diff --git a/gin.go b/gin.go
index 24c4dd8d..3a51bc14 100644
--- a/gin.go
+++ b/gin.go
@@ -20,9 +20,11 @@ const (
 	defaultMultipartMemory = 32 << 20 // 32 MB
 )
 
-var default404Body = []byte("404 page not found")
-var default405Body = []byte("405 method not allowed")
-var defaultAppEngine bool
+var (
+	default404Body   = []byte("404 page not found")
+	default405Body   = []byte("405 method not allowed")
+	defaultAppEngine bool
+)
 
 type HandlerFunc func(*Context)
 type HandlersChain []HandlerFunc
@@ -91,6 +93,7 @@ type Engine struct {
 
 	// If enabled, the url.RawPath will be used to find parameters.
 	UseRawPath bool
+
 	// If true, the path value will be unescaped.
 	// If UseRawPath is false (by default), the UnescapePathValues effectively is true,
 	// as url.Path gonna be used, which is already unescaped.
@@ -161,13 +164,16 @@ func (engine *Engine) SecureJsonPrefix(prefix string) *Engine {
 }
 
 func (engine *Engine) LoadHTMLGlob(pattern string) {
+	left := engine.delims.Left
+	right := engine.delims.Right
+
 	if IsDebugging() {
-		debugPrintLoadTemplate(template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseGlob(pattern)))
+		debugPrintLoadTemplate(template.Must(template.New("").Delims(left, right).Funcs(engine.FuncMap).ParseGlob(pattern)))
 		engine.HTMLRender = render.HTMLDebug{Glob: pattern, FuncMap: engine.FuncMap, Delims: engine.delims}
 		return
 	}
 
-	templ := template.Must(template.New("").Delims(engine.delims.Left, engine.delims.Right).Funcs(engine.FuncMap).ParseGlob(pattern))
+	templ := template.Must(template.New("").Delims(left, right).Funcs(engine.FuncMap).ParseGlob(pattern))
 	engine.SetHTMLTemplate(templ)
 }
 
@@ -322,12 +328,12 @@ func (engine *Engine) HandleContext(c *Context) {
 	engine.pool.Put(c)
 }
 
-func (engine *Engine) handleHTTPRequest(context *Context) {
-	httpMethod := context.Request.Method
-	path := context.Request.URL.Path
+func (engine *Engine) handleHTTPRequest(c *Context) {
+	httpMethod := c.Request.Method
+	path := c.Request.URL.Path
 	unescape := false
-	if engine.UseRawPath && len(context.Request.URL.RawPath) > 0 {
-		path = context.Request.URL.RawPath
+	if engine.UseRawPath && len(c.Request.URL.RawPath) > 0 {
+		path = c.Request.URL.RawPath
 		unescape = engine.UnescapePathValues
 	}
 
@@ -337,20 +343,20 @@ func (engine *Engine) handleHTTPRequest(context *Context) {
 		if t[i].method == httpMethod {
 			root := t[i].root
 			// Find route in tree
-			handlers, params, tsr := root.getValue(path, context.Params, unescape)
+			handlers, params, tsr := root.getValue(path, c.Params, unescape)
 			if handlers != nil {
-				context.handlers = handlers
-				context.Params = params
-				context.Next()
-				context.writermem.WriteHeaderNow()
+				c.handlers = handlers
+				c.Params = params
+				c.Next()
+				c.writermem.WriteHeaderNow()
 				return
 			}
 			if httpMethod != "CONNECT" && path != "/" {
 				if tsr && engine.RedirectTrailingSlash {
-					redirectTrailingSlash(context)
+					redirectTrailingSlash(c)
 					return
 				}
-				if engine.RedirectFixedPath && redirectFixedPath(context, root, engine.RedirectFixedPath) {
+				if engine.RedirectFixedPath && redirectFixedPath(c, root, engine.RedirectFixedPath) {
 					return
 				}
 			}
@@ -362,15 +368,15 @@ func (engine *Engine) handleHTTPRequest(context *Context) {
 		for _, tree := range engine.trees {
 			if tree.method != httpMethod {
 				if handlers, _, _ := tree.root.getValue(path, nil, unescape); handlers != nil {
-					context.handlers = engine.allNoMethod
-					serveError(context, 405, default405Body)
+					c.handlers = engine.allNoMethod
+					serveError(c, 405, default405Body)
 					return
 				}
 			}
 		}
 	}
-	context.handlers = engine.allNoRoute
-	serveError(context, 404, default404Body)
+	c.handlers = engine.allNoRoute
+	serveError(c, 404, default404Body)
 }
 
 var mimePlain = []string{MIMEPlain}

From 3b300929e80cede939bd5f0016b6692d20491ce8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Thu, 28 Sep 2017 11:22:35 -0500
Subject: [PATCH 107/113] Empty string check (#1101)

---
 auth.go        |  4 ++--
 gin.go         |  2 +-
 mode.go        |  2 +-
 render/html.go |  4 ++--
 utils.go       | 11 +++++------
 5 files changed, 11 insertions(+), 12 deletions(-)

diff --git a/auth.go b/auth.go
index 85d96fd3..302a4fad 100644
--- a/auth.go
+++ b/auth.go
@@ -24,7 +24,7 @@ type authPair struct {
 type authPairs []authPair
 
 func (a authPairs) searchCredential(authValue string) (string, bool) {
-	if len(authValue) == 0 {
+	if authValue == "" {
 		return "", false
 	}
 	for _, pair := range a {
@@ -71,7 +71,7 @@ func processAccounts(accounts Accounts) authPairs {
 	assert1(len(accounts) > 0, "Empty list of authorized credentials")
 	pairs := make(authPairs, 0, len(accounts))
 	for user, password := range accounts {
-		assert1(len(user) > 0, "User can not be empty")
+		assert1(user != "", "User can not be empty")
 		value := authorizationHeader(user, password)
 		pairs = append(pairs, authPair{
 			Value: value,
diff --git a/gin.go b/gin.go
index 3a51bc14..9466e074 100644
--- a/gin.go
+++ b/gin.go
@@ -231,7 +231,7 @@ func (engine *Engine) rebuild405Handlers() {
 
 func (engine *Engine) addRoute(method, path string, handlers HandlersChain) {
 	assert1(path[0] == '/', "path must begin with '/'")
-	assert1(len(method) > 0, "HTTP method can not be empty")
+	assert1(method != "", "HTTP method can not be empty")
 	assert1(len(handlers) > 0, "there must be at least one handler")
 
 	debugPrintRoute(method, path, handlers)
diff --git a/mode.go b/mode.go
index b0d2c27d..393e13ec 100644
--- a/mode.go
+++ b/mode.go
@@ -39,7 +39,7 @@ var modeName = DebugMode
 
 func init() {
 	mode := os.Getenv(ENV_GIN_MODE)
-	if len(mode) == 0 {
+	if mode == "" {
 		SetMode(DebugMode)
 	} else {
 		SetMode(mode)
diff --git a/render/html.go b/render/html.go
index 332d3ba2..1e3be65b 100644
--- a/render/html.go
+++ b/render/html.go
@@ -60,7 +60,7 @@ func (r HTMLDebug) loadTemplate() *template.Template {
 	if len(r.Files) > 0 {
 		return template.Must(template.New("").Delims(r.Delims.Left, r.Delims.Right).Funcs(r.FuncMap).ParseFiles(r.Files...))
 	}
-	if len(r.Glob) > 0 {
+	if r.Glob != "" {
 		return template.Must(template.New("").Delims(r.Delims.Left, r.Delims.Right).Funcs(r.FuncMap).ParseGlob(r.Glob))
 	}
 	panic("the HTML debug render was created without files or glob pattern")
@@ -69,7 +69,7 @@ func (r HTMLDebug) loadTemplate() *template.Template {
 func (r HTML) Render(w http.ResponseWriter) error {
 	r.WriteContentType(w)
 
-	if len(r.Name) == 0 {
+	if r.Name == "" {
 		return r.Template.Execute(w, r.Data)
 	}
 	return r.Template.ExecuteTemplate(w, r.Name, r.Data)
diff --git a/utils.go b/utils.go
index ab06a759..e909bb70 100644
--- a/utils.go
+++ b/utils.go
@@ -103,7 +103,7 @@ func parseAccept(acceptHeader string) []string {
 		if index := strings.IndexByte(part, ';'); index >= 0 {
 			part = part[0:index]
 		}
-		if part = strings.TrimSpace(part); len(part) > 0 {
+		if part = strings.TrimSpace(part); part != "" {
 			out = append(out, part)
 		}
 	}
@@ -111,11 +111,10 @@ func parseAccept(acceptHeader string) []string {
 }
 
 func lastChar(str string) uint8 {
-	size := len(str)
-	if size == 0 {
+	if str == "" {
 		panic("The length of the string can't be 0")
 	}
-	return str[size-1]
+	return str[len(str)-1]
 }
 
 func nameOfFunction(f interface{}) string {
@@ -123,7 +122,7 @@ func nameOfFunction(f interface{}) string {
 }
 
 func joinPaths(absolutePath, relativePath string) string {
-	if len(relativePath) == 0 {
+	if relativePath == "" {
 		return absolutePath
 	}
 
@@ -138,7 +137,7 @@ func joinPaths(absolutePath, relativePath string) string {
 func resolveAddress(addr []string) string {
 	switch len(addr) {
 	case 0:
-		if port := os.Getenv("PORT"); len(port) > 0 {
+		if port := os.Getenv("PORT"); port != "" {
 			debugPrint("Environment variable PORT=\"%s\"", port)
 			return ":" + port
 		}

From 0cb7c44abc8280411ee5ab3cc67ff63aaee2bf3f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Thu, 28 Sep 2017 22:58:57 -0500
Subject: [PATCH 108/113] Print warning log when user create one engine using
 gin.Default in debug mode (#1121)

* empty string check

* add log when use Default

* fix unit test error

* fix unit test error
---
 debug.go      |  6 ++++++
 debug_test.go | 18 ++++++++++++++++++
 gin.go        |  1 +
 3 files changed, 25 insertions(+)

diff --git a/debug.go b/debug.go
index b31ca685..449291e6 100644
--- a/debug.go
+++ b/debug.go
@@ -46,6 +46,12 @@ func debugPrint(format string, values ...interface{}) {
 	}
 }
 
+func debugPrintWARNINGDefault() {
+	debugPrint(`[WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.
+
+`)
+}
+
 func debugPrintWARNINGNew() {
 	debugPrint(`[WARNING] Running in "debug" mode. Switch to "release" mode in production.
  - using env:	export GIN_MODE=release
diff --git a/debug_test.go b/debug_test.go
index 366d4613..dfd54c82 100644
--- a/debug_test.go
+++ b/debug_test.go
@@ -86,6 +86,24 @@ func TestDebugPrintWARNINGSetHTMLTemplate(t *testing.T) {
 	assert.Equal(t, "[GIN-debug] [WARNING] Since SetHTMLTemplate() is NOT thread-safe. It should only be called\nat initialization. ie. before any route is registered or the router is listening in a socket:\n\n\trouter := gin.Default()\n\trouter.SetHTMLTemplate(template) // << good place\n\n", w.String())
 }
 
+func TestDebugPrintWARNINGDefault(t *testing.T) {
+	var w bytes.Buffer
+	setup(&w)
+	defer teardown()
+
+	debugPrintWARNINGDefault()
+	assert.Equal(t, "[GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.\n\n", w.String())
+}
+
+func TestDebugPrintWARNINGNew(t *testing.T) {
+	var w bytes.Buffer
+	setup(&w)
+	defer teardown()
+
+	debugPrintWARNINGNew()
+	assert.Equal(t, "[GIN-debug] [WARNING] Running in \"debug\" mode. Switch to \"release\" mode in production.\n - using env:\texport GIN_MODE=release\n - using code:\tgin.SetMode(gin.ReleaseMode)\n\n", w.String())
+}
+
 func setup(w io.Writer) {
 	SetMode(DebugMode)
 	log.SetOutput(w)
diff --git a/gin.go b/gin.go
index 9466e074..8cfb1f13 100644
--- a/gin.go
+++ b/gin.go
@@ -144,6 +144,7 @@ func New() *Engine {
 
 // Default returns an Engine instance with the Logger and Recovery middleware already attached.
 func Default() *Engine {
+	debugPrintWARNINGDefault()
 	engine := New()
 	engine.Use(Logger(), Recovery())
 	return engine

From b8b68314faa067acae5b17c828127b04af51ebe2 Mon Sep 17 00:00:00 2001
From: Bo-Yi Wu <appleboy.tw@gmail.com>
Date: Fri, 29 Sep 2017 16:48:10 +0800
Subject: [PATCH 109/113] feat: add multiple service example. (#1119)

---
 README.md                         | 82 +++++++++++++++++++++++++++++++
 examples/multiple-service/main.go | 74 ++++++++++++++++++++++++++++
 2 files changed, 156 insertions(+)
 create mode 100644 examples/multiple-service/main.go

diff --git a/README.md b/README.md
index 0dc165bc..66c83fb1 100644
--- a/README.md
+++ b/README.md
@@ -1154,6 +1154,88 @@ func main() {
 }
 ```
 
+### Run multiple service using Gin
+
+See the [question](https://github.com/gin-gonic/gin/issues/346) and try the folling example:
+
+[embedmd]:# (examples/multiple-service/main.go go)
+```go
+package main
+
+import (
+	"log"
+	"net/http"
+	"time"
+
+	"github.com/gin-gonic/gin"
+	"golang.org/x/sync/errgroup"
+)
+
+var (
+	g errgroup.Group
+)
+
+func router01() http.Handler {
+	e := gin.New()
+	e.Use(gin.Recovery())
+	e.GET("/", func(c *gin.Context) {
+		c.JSON(
+			http.StatusOK,
+			gin.H{
+				"code":  http.StatusOK,
+				"error": "Welcome server 01",
+			},
+		)
+	})
+
+	return e
+}
+
+func router02() http.Handler {
+	e := gin.New()
+	e.Use(gin.Recovery())
+	e.GET("/", func(c *gin.Context) {
+		c.JSON(
+			http.StatusOK,
+			gin.H{
+				"code":  http.StatusOK,
+				"error": "Welcome server 02",
+			},
+		)
+	})
+
+	return e
+}
+
+func main() {
+	server01 := &http.Server{
+		Addr:         ":8080",
+		Handler:      router01(),
+		ReadTimeout:  5 * time.Second,
+		WriteTimeout: 10 * time.Second,
+	}
+
+	server02 := &http.Server{
+		Addr:         ":8081",
+		Handler:      router02(),
+		ReadTimeout:  5 * time.Second,
+		WriteTimeout: 10 * time.Second,
+	}
+
+	g.Go(func() error {
+		return server01.ListenAndServe()
+	})
+
+	g.Go(func() error {
+		return server02.ListenAndServe()
+	})
+
+	if err := g.Wait(); err != nil {
+		log.Fatal(err)
+	}
+}
+```
+
 ### Graceful restart or stop
 
 Do you want to graceful restart or stop your web server?
diff --git a/examples/multiple-service/main.go b/examples/multiple-service/main.go
new file mode 100644
index 00000000..ceddaa2e
--- /dev/null
+++ b/examples/multiple-service/main.go
@@ -0,0 +1,74 @@
+package main
+
+import (
+	"log"
+	"net/http"
+	"time"
+
+	"github.com/gin-gonic/gin"
+	"golang.org/x/sync/errgroup"
+)
+
+var (
+	g errgroup.Group
+)
+
+func router01() http.Handler {
+	e := gin.New()
+	e.Use(gin.Recovery())
+	e.GET("/", func(c *gin.Context) {
+		c.JSON(
+			http.StatusOK,
+			gin.H{
+				"code":  http.StatusOK,
+				"error": "Welcome server 01",
+			},
+		)
+	})
+
+	return e
+}
+
+func router02() http.Handler {
+	e := gin.New()
+	e.Use(gin.Recovery())
+	e.GET("/", func(c *gin.Context) {
+		c.JSON(
+			http.StatusOK,
+			gin.H{
+				"code":  http.StatusOK,
+				"error": "Welcome server 02",
+			},
+		)
+	})
+
+	return e
+}
+
+func main() {
+	server01 := &http.Server{
+		Addr:         ":8080",
+		Handler:      router01(),
+		ReadTimeout:  5 * time.Second,
+		WriteTimeout: 10 * time.Second,
+	}
+
+	server02 := &http.Server{
+		Addr:         ":8081",
+		Handler:      router02(),
+		ReadTimeout:  5 * time.Second,
+		WriteTimeout: 10 * time.Second,
+	}
+
+	g.Go(func() error {
+		return server01.ListenAndServe()
+	})
+
+	g.Go(func() error {
+		return server02.ListenAndServe()
+	})
+
+	if err := g.Wait(); err != nil {
+		log.Fatal(err)
+	}
+}

From dfb68ce0852d3fe600148f486f67d2327146dfea Mon Sep 17 00:00:00 2001
From: Suhas Karanth <sudo-suhas@users.noreply.github.com>
Date: Mon, 23 Oct 2017 14:44:09 +0530
Subject: [PATCH 110/113] feat(context): ShouldBind counterparts for Bind
 methods (#1047)

* feat(context): ShouldBind counterparts for Bind methods + tests

* docs(readme): Switch examples to use ShouldBind methods

Add section for bind methods types, explain difference in behavior.
Switch all `c.Bind` examples to use `c.ShouldBind`.
---
 README.md       | 62 ++++++++++++++++++++++++++++++++++-----------
 context.go      | 23 +++++++++++++++++
 context_test.go | 67 +++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 138 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index 66c83fb1..7113058d 100644
--- a/README.md
+++ b/README.md
@@ -388,7 +388,7 @@ func main() {
 	// Logger middleware will write the logs to gin.DefaultWriter even you set with GIN_MODE=release.
 	// By default gin.DefaultWriter = os.Stdout
 	r.Use(gin.Logger())
-	
+
 	// Recovery middleware recovers from any panics and writes a 500 if there was one.
 	r.Use(gin.Recovery())
 
@@ -422,11 +422,11 @@ func main() {
 func main() {
     // Disable Console Color, you don't need console color when writing the logs to file.
     gin.DisableConsoleColor()
-    
+
     // Logging to a file.
     f, _ := os.Create("gin.log")
     gin.DefaultWriter = io.MultiWriter(f)
-    
+
     // Use the following code if you need to write the logs to file and console at the same time.
     // gin.DefaultWriter = io.MultiWriter(f, os.Stdout)
 
@@ -447,9 +447,17 @@ Gin uses [**go-playground/validator.v8**](https://github.com/go-playground/valid
 
 Note that you need to set the corresponding binding tag on all fields you want to bind. For example, when binding from JSON, set `json:"fieldname"`.
 
-When using the Bind-method, Gin tries to infer the binder depending on the Content-Type header. If you are sure what you are binding, you can use BindWith.
+Also, Gin provides two sets of methods for binding:
+- **Type** - Must bind
+  - **Methods** - `Bind`, `BindJSON`, `BindQuery`
+  - **Behavior** - These methods use `MustBindWith` under the hood. If there is a binding error, the request is aborted with `c.AbortWithError(400, err).SetType(ErrorTypeBind)`. This sets the response status code to 400 and the `Content-Type` header is set to `text/plain; charset=utf-8`. Note that if you try to set the response code after this, it will result in a warning `[GIN-debug] [WARNING] Headers were already written. Wanted to override status code 400 with 422`. If you wish to have greater control over the behavior, consider using the `ShouldBind` equivalent method.
+- **Type** - Should bind
+  - **Methods** - `ShouldBind`, `ShouldBindJSON`, `ShouldBindQuery`
+  - **Behavior** - These methods use `ShouldBindWith` under the hood. If there is a binding error, the error is returned and it is the developer's responsibility to handle the request and error appropriately.
 
-You can also specify that specific fields are required. If a field is decorated with `binding:"required"` and has a empty value when binding, the current request will fail with an error.
+When using the Bind-method, Gin tries to infer the binder depending on the Content-Type header. If you are sure what you are binding, you can use `MustBindWith` or `ShouldBindWith`.
+
+You can also specify that specific fields are required. If a field is decorated with `binding:"required"` and has a empty value when binding, an error will be returned.
 
 ```go
 // Binding from JSON
@@ -464,12 +472,14 @@ func main() {
 	// Example for binding JSON ({"user": "manu", "password": "123"})
 	router.POST("/loginJSON", func(c *gin.Context) {
 		var json Login
-		if c.BindJSON(&json) == nil {
+		if err = c.ShouldBindJSON(&json); err == nil {
 			if json.User == "manu" && json.Password == "123" {
 				c.JSON(http.StatusOK, gin.H{"status": "you are logged in"})
 			} else {
 				c.JSON(http.StatusUnauthorized, gin.H{"status": "unauthorized"})
 			}
+		} else {
+			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
 		}
 	})
 
@@ -477,12 +487,14 @@ func main() {
 	router.POST("/loginForm", func(c *gin.Context) {
 		var form Login
 		// This will infer what binder to use depending on the content-type header.
-		if c.Bind(&form) == nil {
+		if err := c.ShouldBind(&form); err == nil {
 			if form.User == "manu" && form.Password == "123" {
 				c.JSON(http.StatusOK, gin.H{"status": "you are logged in"})
 			} else {
 				c.JSON(http.StatusUnauthorized, gin.H{"status": "unauthorized"})
 			}
+		} else {
+			c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
 		}
 	})
 
@@ -491,6 +503,28 @@ func main() {
 }
 ```
 
+**Sample request**
+```shell
+$ curl -v -X POST \
+  http://localhost:8080/loginJSON \
+  -H 'content-type: application/json' \
+  -d '{ "user": "manu" }'
+> POST /loginJSON HTTP/1.1
+> Host: localhost:8080
+> User-Agent: curl/7.51.0
+> Accept: */*
+> content-type: application/json
+> Content-Length: 18
+>
+* upload completely sent off: 18 out of 18 bytes
+< HTTP/1.1 400 Bad Request
+< Content-Type: application/json; charset=utf-8
+< Date: Fri, 04 Aug 2017 03:51:31 GMT
+< Content-Length: 100
+<
+{"error":"Key: 'Login.Password' Error:Field validation for 'Password' failed on the 'required' tag"}
+```
+
 ### Custom Validators
 
 It is also possible to register custom validators. See the [example code](examples/custom-validation/server.go).
@@ -554,7 +588,7 @@ $ curl "localhost:8085/bookable?check_in=2017-08-15&check_out=2017-08-16"
 
 ### Only Bind Query String
 
-`BindQuery` function only binds the query params and not the post data. See the [detail information](https://github.com/gin-gonic/gin/issues/742#issuecomment-315953017).
+`ShouldBindQuery` function only binds the query params and not the post data. See the [detail information](https://github.com/gin-gonic/gin/issues/742#issuecomment-315953017).
 
 ```go
 package main
@@ -578,7 +612,7 @@ func main() {
 
 func startPage(c *gin.Context) {
 	var person Person
-	if c.BindQuery(&person) == nil {
+	if c.ShouldBindQuery(&person) == nil {
 		log.Println("====== Only Bind By Query String ======")
 		log.Println(person.Name)
 		log.Println(person.Address)
@@ -616,7 +650,7 @@ func startPage(c *gin.Context) {
 	// If `GET`, only `Form` binding engine (`query`) used.
 	// If `POST`, first checks the `content-type` for `JSON` or `XML`, then uses `Form` (`form-data`).
 	// See more at https://github.com/gin-gonic/gin/blob/master/binding/binding.go#L48
-	if c.Bind(&person) == nil {
+	if c.ShouldBind(&person) == nil {
 		log.Println(person.Name)
 		log.Println(person.Address)
 		log.Println(person.Birthday)
@@ -648,7 +682,7 @@ type myForm struct {
 
 func formHandler(c *gin.Context) {
     var fakeForm myForm
-    c.Bind(&fakeForm)
+    c.ShouldBind(&fakeForm)
     c.JSON(200, gin.H{"color": fakeForm.Colors})
 }
 
@@ -695,11 +729,11 @@ func main() {
 	router := gin.Default()
 	router.POST("/login", func(c *gin.Context) {
 		// you can bind multipart form with explicit binding declaration:
-		// c.MustBindWith(&form, binding.Form)
-		// or you can simply use autobinding with Bind method:
+		// c.ShouldBindWith(&form, binding.Form)
+		// or you can simply use autobinding with ShouldBind method:
 		var form LoginForm
 		// in this case proper binding will be automatically selected
-		if c.Bind(&form) == nil {
+		if c.ShouldBind(&form) == nil {
 			if form.User == "user" && form.Password == "password" {
 				c.JSON(200, gin.H{"status": "you are logged in"})
 			} else {
diff --git a/context.go b/context.go
index 74995e68..5b67dcc0 100644
--- a/context.go
+++ b/context.go
@@ -482,6 +482,29 @@ func (c *Context) MustBindWith(obj interface{}, b binding.Binding) (err error) {
 	return
 }
 
+// ShouldBind checks the Content-Type to select a binding engine automatically,
+// Depending the "Content-Type" header different bindings are used:
+//     "application/json" --> JSON binding
+//     "application/xml"  --> XML binding
+// otherwise --> returns an error
+// It parses the request's body as JSON if Content-Type == "application/json" using JSON or XML as a JSON input.
+// It decodes the json payload into the struct specified as a pointer.
+// Like c.Bind() but this method does not set the response status code to 400 and abort if the json is not valid.
+func (c *Context) ShouldBind(obj interface{}) error {
+	b := binding.Default(c.Request.Method, c.ContentType())
+	return c.ShouldBindWith(obj, b)
+}
+
+// ShouldBindJSON is a shortcut for c.ShouldBindWith(obj, binding.JSON).
+func (c *Context) ShouldBindJSON(obj interface{}) error {
+	return c.ShouldBindWith(obj, binding.JSON)
+}
+
+// ShouldBindQuery is a shortcut for c.ShouldBindWith(obj, binding.Query).
+func (c *Context) ShouldBindQuery(obj interface{}) error {
+	return c.ShouldBindWith(obj, binding.Query)
+}
+
 // ShouldBindWith binds the passed struct pointer using the specified binding engine.
 // See the binding package.
 func (c *Context) ShouldBindWith(obj interface{}, b binding.Binding) error {
diff --git a/context_test.go b/context_test.go
index 4854a8a8..8cd05f6c 100644
--- a/context_test.go
+++ b/context_test.go
@@ -1228,6 +1228,73 @@ func TestContextBadAutoBind(t *testing.T) {
 	assert.True(t, c.IsAborted())
 }
 
+func TestContextAutoShouldBindJSON(t *testing.T) {
+	c, _ := CreateTestContext(httptest.NewRecorder())
+	c.Request, _ = http.NewRequest("POST", "/", bytes.NewBufferString("{\"foo\":\"bar\", \"bar\":\"foo\"}"))
+	c.Request.Header.Add("Content-Type", MIMEJSON)
+
+	var obj struct {
+		Foo string `json:"foo"`
+		Bar string `json:"bar"`
+	}
+	assert.NoError(t, c.ShouldBind(&obj))
+	assert.Equal(t, obj.Bar, "foo")
+	assert.Equal(t, obj.Foo, "bar")
+	assert.Empty(t, c.Errors)
+}
+
+func TestContextShouldBindWithJSON(t *testing.T) {
+	w := httptest.NewRecorder()
+	c, _ := CreateTestContext(w)
+
+	c.Request, _ = http.NewRequest("POST", "/", bytes.NewBufferString("{\"foo\":\"bar\", \"bar\":\"foo\"}"))
+	c.Request.Header.Add("Content-Type", MIMEXML) // set fake content-type
+
+	var obj struct {
+		Foo string `json:"foo"`
+		Bar string `json:"bar"`
+	}
+	assert.NoError(t, c.ShouldBindJSON(&obj))
+	assert.Equal(t, obj.Bar, "foo")
+	assert.Equal(t, obj.Foo, "bar")
+	assert.Equal(t, w.Body.Len(), 0)
+}
+
+func TestContextShouldBindWithQuery(t *testing.T) {
+	w := httptest.NewRecorder()
+	c, _ := CreateTestContext(w)
+
+	c.Request, _ = http.NewRequest("POST", "/?foo=bar&bar=foo", bytes.NewBufferString("foo=unused"))
+
+	var obj struct {
+		Foo string `form:"foo"`
+		Bar string `form:"bar"`
+	}
+	assert.NoError(t, c.ShouldBindQuery(&obj))
+	assert.Equal(t, "foo", obj.Bar)
+	assert.Equal(t, "bar", obj.Foo)
+	assert.Equal(t, 0, w.Body.Len())
+}
+
+func TestContextBadAutoShouldBind(t *testing.T) {
+	w := httptest.NewRecorder()
+	c, _ := CreateTestContext(w)
+
+	c.Request, _ = http.NewRequest("POST", "http://example.com", bytes.NewBufferString("\"foo\":\"bar\", \"bar\":\"foo\"}"))
+	c.Request.Header.Add("Content-Type", MIMEJSON)
+	var obj struct {
+		Foo string `json:"foo"`
+		Bar string `json:"bar"`
+	}
+
+	assert.False(t, c.IsAborted())
+	assert.Error(t, c.ShouldBind(&obj))
+
+	assert.Empty(t, obj.Bar)
+	assert.Empty(t, obj.Foo)
+	assert.False(t, c.IsAborted())
+}
+
 func TestContextGolangContext(t *testing.T) {
 	c, _ := CreateTestContext(httptest.NewRecorder())
 	c.Request, _ = http.NewRequest("POST", "/", bytes.NewBufferString("{\"foo\":\"bar\", \"bar\":\"foo\"}"))

From 1e88466d234a82ce4aeca904bce8a0b93fac3d42 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Thu, 26 Oct 2017 10:25:25 +0800
Subject: [PATCH 111/113] Update the comment of Version (#1141)

---
 gin.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gin.go b/gin.go
index 8cfb1f13..4857f3ae 100644
--- a/gin.go
+++ b/gin.go
@@ -14,8 +14,8 @@ import (
 	"github.com/gin-gonic/gin/render"
 )
 
-// Version is Framework's version.
 const (
+	// Version is Framework's version.
 	Version                = "v1.2"
 	defaultMultipartMemory = 32 << 20 // 32 MB
 )

From b7e8a6b9b062473c7f3f4f5c16d0a28b6244de48 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Sun, 29 Oct 2017 20:12:22 +0800
Subject: [PATCH 112/113] style(import): not use aliase when import package
 (#1146)

---
 binding/binding.go       | 2 +-
 binding/json.go          | 4 +---
 binding/query.go         | 4 +---
 binding/validate_test.go | 3 +--
 4 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/binding/binding.go b/binding/binding.go
index a09cc221..dc32d538 100644
--- a/binding/binding.go
+++ b/binding/binding.go
@@ -7,7 +7,7 @@ package binding
 import (
 	"net/http"
 
-	validator "gopkg.in/go-playground/validator.v8"
+	"gopkg.in/go-playground/validator.v8"
 )
 
 const (
diff --git a/binding/json.go b/binding/json.go
index f600a5f4..b7c856af 100644
--- a/binding/json.go
+++ b/binding/json.go
@@ -10,9 +10,7 @@ import (
 	"github.com/gin-gonic/gin/json"
 )
 
-var (
-	EnableDecoderUseNumber = false
-)
+var EnableDecoderUseNumber = false
 
 type jsonBinding struct{}
 
diff --git a/binding/query.go b/binding/query.go
index a789f798..219743f2 100644
--- a/binding/query.go
+++ b/binding/query.go
@@ -4,9 +4,7 @@
 
 package binding
 
-import (
-	"net/http"
-)
+import "net/http"
 
 type queryBinding struct{}
 
diff --git a/binding/validate_test.go b/binding/validate_test.go
index 523e1298..8ca79989 100644
--- a/binding/validate_test.go
+++ b/binding/validate_test.go
@@ -10,9 +10,8 @@ import (
 	"testing"
 	"time"
 
-	validator "gopkg.in/go-playground/validator.v8"
-
 	"github.com/stretchr/testify/assert"
+	"gopkg.in/go-playground/validator.v8"
 )
 
 type testInterface interface {

From 6653d5d588740eb73d2245ef04d5a407d3c3f034 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=94=B0=E6=AC=A7?= <thinkerou@gmail.com>
Date: Mon, 30 Oct 2017 10:38:38 +0800
Subject: [PATCH 113/113] fix markdown render (#1149)

---
 README.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 7113058d..b7181036 100644
--- a/README.md
+++ b/README.md
@@ -74,10 +74,10 @@ BenchmarkTigerTonic_GithubAll               |    1000    |  1439483    |  239104
 BenchmarkTraffic_GithubAll                  |     100    | 11383067    | 2659329    | 21848
 BenchmarkVulcan_GithubAll                   |    5000    |   394253    |   19894    |   609
 
-(1): Total Repetitions achieved in constant time, higher means more confident result
-(2): Single Repetition Duration (ns/op), lower is better
-(3): Heap Memory (B/op), lower is better
-(4): Average Allocations per Repetition (allocs/op), lower is better
+- (1): Total Repetitions achieved in constant time, higher means more confident result
+- (2): Single Repetition Duration (ns/op), lower is better
+- (3): Heap Memory (B/op), lower is better
+- (4): Average Allocations per Repetition (allocs/op), lower is better
 
 ## Gin v1. stable