chore: replace vendored gorilla/schema package

bind_test.go

@@ -61,6 +61,8 @@ func Test_Bind_Query(t *testing.T) {
 		No              []int64
 		ID              int
 		Bool            bool
+		Default         string   `query:"default,default:hello"`
+		Defaults        []string `query:"defaults,default:hello|world"`
 	}
 
 	c.Request().URI().SetQueryString("id=1&name=tom&hobby=basketball,football&favouriteDrinks=milo,coke,pepsi&alloc=&no=1")
@@ -76,6 +78,8 @@ func Test_Bind_Query(t *testing.T) {
 	require.Equal(t, nilSlice, q2.Empty)
 	require.Equal(t, []string{""}, q2.Alloc)
 	require.Equal(t, []int64{1}, q2.No)
+	require.Equal(t, "hello", q2.Default)
+	require.Equal(t, []string{"hello", "world"}, q2.Defaults)
 
 	type RequiredQuery struct {
 		Name string `query:"name,required"`
@@ -648,7 +652,39 @@ func Benchmark_Bind_Query(b *testing.B) {
 	for n := 0; n < b.N; n++ {
 		err = c.Bind().Query(q)
 	}
+
+	require.NoError(b, err)
+	require.Equal(b, "tom", q.Name)
+	require.Equal(b, 1, q.ID)
+	require.Len(b, q.Hobby, 2)
+}
+
+// go test -v  -run=^$ -bench=Benchmark_Bind_Query_Default -benchmem -count=4
+func Benchmark_Bind_Query_Default(b *testing.B) {
+	var err error
+
+	app := New()
+	c := app.AcquireCtx(&fasthttp.RequestCtx{})
+
+	type Query struct {
+		Name  string   `query:"name,default:tom"`
+		Hobby []string `query:"hobby,default:football|basketball"`
+		ID    int      `query:"id,default:1"`
+	}
+	c.Request().SetBody([]byte(``))
+	c.Request().Header.SetContentType("")
+	c.Request().URI().SetQueryString("")
+	q := new(Query)
+	b.ReportAllocs()
+	b.ResetTimer()
+	for n := 0; n < b.N; n++ {
+		err = c.Bind().Query(q)
+	}
+
 	require.NoError(b, err)
+	require.Equal(b, "tom", q.Name)
+	require.Equal(b, 1, q.ID)
+	require.Len(b, q.Hobby, 2)
 }
 
 // go test -v  -run=^$ -bench=Benchmark_Bind_Query_Map -benchmem -count=4

binder/mapping.go

@@ -9,7 +9,7 @@ import (
 	"github.com/gofiber/utils/v2"
 	"github.com/valyala/bytebufferpool"
 
-	"github.com/gofiber/fiber/v3/internal/schema"
+	"github.com/gofiber/schema"
 )
 
 // ParserConfig form decoder config for SetParserDecoder

docs/api/bind.md

@@ -573,3 +573,40 @@ app.Post("/", func(c fiber.Ctx) error {
     }
 })
 ```
+
+## Default Fields
+
+You can set default values for fields in the struct by using the `default` struct tag. Supported types:
+- bool
+- float variants (float32, float64)
+- int variants (int, int8, int16, int32, int64)
+- uint variants (uint, uint8, uint16, uint32, uint64)
+- string
+- a slice of the above types. As shown in the example above, **| should be used to separate between slice items**.
+- a pointer to one of the above types **(pointer to slice and slice of pointers are not supported)**.
+
+
+```go title="Example"
+type Person struct {
+    Name     string     `query:"name,default:john"`
+    Pass     string     `query:"pass"`
+    Products []string   `query:"products,default:shoe|hat"`
+}
+
+app.Get("/", func(c fiber.Ctx) error {
+    p := new(Person)
+
+    if err := c.Bind().Query(p); err != nil {
+        return err
+    }
+
+    log.Println(p.Name)        // john
+    log.Println(p.Pass)        // doe
+    log.Println(p.Products)    // ["shoe,hat"]    
+
+    // ...
+})
+// Run tests with the following curl command
+
+// curl "http://localhost:3000/?pass=doe"
+```

error.go

@@ -4,7 +4,7 @@ import (
 	"encoding/json"
 	"errors"
 
-	"github.com/gofiber/fiber/v3/internal/schema"
+	"github.com/gofiber/schema"
 )
 
 // Wrap and return this for unreachable code if panicking is undesirable (i.e., in a handler).

error_test.go

@@ -5,7 +5,7 @@ import (
 	"errors"
 	"testing"
 
-	"github.com/gofiber/fiber/v3/internal/schema"
+	"github.com/gofiber/schema"
 	"github.com/stretchr/testify/require"
 )
 

go.mod

@@ -16,6 +16,7 @@ require (
 require (
 	github.com/andybalholm/brotli v1.1.0 // indirect
 	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/gofiber/schema v0.0.0-20240930192558-a38168951d4b // indirect
 	github.com/klauspost/compress v1.17.9 // indirect
 	github.com/philhofer/fwd v1.1.3-0.20240612014219-fbbf4953d986 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect

go.sum

@@ -2,6 +2,8 @@ github.com/andybalholm/brotli v1.1.0 h1:eLKJA0d02Lf0mVpIDgYnqXcUn0GqVmEFny3VuID1
 github.com/andybalholm/brotli v1.1.0/go.mod h1:sms7XGricyQI9K10gOSf56VKKWS4oLer58Q+mhRPtnY=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/gofiber/schema v0.0.0-20240930192558-a38168951d4b h1:V18jx4lrq1QwBHKfQpiEAezWxlMLwBA5WRuwx7A1Mjo=
+github.com/gofiber/schema v0.0.0-20240930192558-a38168951d4b/go.mod h1:YYwj01w3hVfaNjhtJzaqetymL56VW642YS3qZPhuE6c=
 github.com/gofiber/utils/v2 v2.0.0-beta.6 h1:ED62bOmpRXdgviPlfTmf0Q+AXzhaTUAFtdWjgx+XkYI=
 github.com/gofiber/utils/v2 v2.0.0-beta.6/go.mod h1:3Kz8Px3jInKFvqxDzDeoSygwEOO+3uyubTmUa6PqY+0=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=