From 72f42b88a45e5069ff251e881c6170dde5347c5f Mon Sep 17 00:00:00 2001
From: iliya <dozheiny@gmail.com>
Date: Sat, 4 Feb 2023 12:06:00 +0330
Subject: [PATCH] feature: add ShouldBindForm function

---
 context.go      |  5 +++++
 context_test.go | 27 +++++++++++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/context.go b/context.go
index 85b3ef30..5e3050fe 100644
--- a/context.go
+++ b/context.go
@@ -740,6 +740,11 @@ func (c *Context) ShouldBindUri(obj any) error {
 	return binding.Uri.BindUri(m, obj)
 }
 
+// ShouldBindForm is shortcut for c.ShouldBindWith(obj, binding.Form).
+func (c *Context) ShouldBindForm(obj any) error {
+	return c.ShouldBindWith(obj, binding.Form)
+}
+
 // ShouldBindWith binds the passed struct pointer using the specified binding engine.
 // See the binding package.
 func (c *Context) ShouldBindWith(obj any, b binding.Binding) error {
diff --git a/context_test.go b/context_test.go
index c6e88a95..4913a637 100644
--- a/context_test.go
+++ b/context_test.go
@@ -1655,6 +1655,33 @@ func TestContextBindForm(t *testing.T) {
 	assert.Equal(t, 0, w.Body.Len())
 }
 
+func TestContextShouldBindForm(t *testing.T) {
+	w := httptest.NewRecorder()
+	c, _ := CreateTestContext(w)
+
+	c.Request, _ = http.NewRequest("POST", "/", nil)
+
+	c.Request.ParseForm()
+
+	c.Request.Form.Add("rate", "8000")
+	c.Request.Form.Add("domain", "music")
+	c.Request.Form.Add("limit", "1000")
+
+	var testHeader struct {
+		Rate   int    `form:"rate"`
+		Domain string `form:"domain"`
+		Limit  int    `form:"limit"`
+		Fake   string `form:"fake"`
+	}
+
+	assert.NoError(t, c.ShouldBindForm(&testHeader))
+	assert.Equal(t, 8000, testHeader.Rate)
+	assert.Equal(t, "music", testHeader.Domain)
+	assert.Equal(t, 1000, testHeader.Limit)
+	assert.Equal(t, "", testHeader.Fake)
+	assert.Equal(t, 0, w.Body.Len())
+}
+
 func TestContextBindHeader(t *testing.T) {
 	w := httptest.NewRecorder()
 	c, _ := CreateTestContext(w)