Merge pull request #1022 from gofr-dev/release/v1.20.0

Release v1.20.0

docs/advanced-guide/injecting-databases-drivers/page.md

@@ -260,3 +260,89 @@ func main() {
 	app.Run()
 }
 ```
+
+## Solr
+GoFr supports injecting Solr database that supports the following interface. Any driver that implements the interface can be added
+using `app.AddSolr()` method, and user's can use Solr DB across application with `gofr.Context`.
+
+```go
+type Solr interface {
+    Search(ctx context.Context, collection string, params map[string]any) (any, error)
+    Create(ctx context.Context, collection string, document *bytes.Buffer, params map[string]any) (any, error)
+    Update(ctx context.Context, collection string, document *bytes.Buffer, params map[string]any) (any, error)
+    Delete(ctx context.Context, collection string, document *bytes.Buffer, params map[string]any) (any, error)
+
+    Retrieve(ctx context.Context, collection string, params map[string]any) (any, error)
+    ListFields(ctx context.Context, collection string, params map[string]any) (any, error)
+    AddField(ctx context.Context, collection string, document *bytes.Buffer) (any, error)
+    UpdateField(ctx context.Context, collection string, document *bytes.Buffer) (any, error)
+    DeleteField(ctx context.Context, collection string, document *bytes.Buffer) (any, error)
+}
+```
+
+User's can easily inject a driver that supports this interface, this provides usability
+without compromising the extensibility to use multiple databases.
+
+```go
+package main
+
+import (
+	"bytes"
+	"encoding/json"
+	"errors"
+
+	"gofr.dev/pkg/gofr"
+	"gofr.dev/pkg/gofr/datasource/solr"
+)
+
+func main() {
+	app := gofr.New()
+
+	app.AddSolr(solr.New(solr.Config{
+		Host: "localhost",
+		Port: "2020",
+	}))
+
+	app.POST("/solr", post)
+	app.GET("/solr", get)
+
+	app.Run()
+}
+
+type Person struct {
+	Name string
+	Age  int
+}
+
+func post(c *gofr.Context) (interface{}, error) {
+	p := Person{Name: "Srijan", Age: 24}
+	body, _ := json.Marshal(p)
+
+	resp, err := c.Solr.Create(c, "test", bytes.NewBuffer(body), nil)
+	if err != nil {
+		return nil, err
+	}
+
+	return resp, nil
+}
+
+func get(c *gofr.Context) (interface{}, error) {
+	resp, err := c.Solr.Search(c, "test", nil)
+	if err != nil {
+		return nil, err
+	}
+
+	res, ok := resp.(solr.Response)
+	if !ok {
+		return nil, errors.New("invalid response type")
+	}
+
+	b, _ := json.Marshal(res.Data)
+	err = json.Unmarshal(b, &Person{})
+	if err != nil {
+		return nil, err
+	}
+
+	return resp, nil
+}
+```

go.mod

@@ -19,7 +19,7 @@ require (
 	github.com/joho/godotenv v1.5.1
 	github.com/lib/pq v1.10.9
 	github.com/pkg/errors v0.9.1
-	github.com/prometheus/client_golang v1.20.2
+	github.com/prometheus/client_golang v1.20.3
 	github.com/redis/go-redis/extra/redisotel/v9 v9.0.5
 	github.com/redis/go-redis/v9 v9.6.1
 	github.com/segmentio/kafka-go v0.4.47
@@ -35,22 +35,22 @@ require (
 	go.opentelemetry.io/otel/sdk/metric v1.29.0
 	go.opentelemetry.io/otel/trace v1.29.0
 	go.uber.org/mock v0.4.0
-	golang.org/x/oauth2 v0.22.0
+	golang.org/x/oauth2 v0.23.0
 	golang.org/x/sync v0.8.0
-	golang.org/x/term v0.23.0
-	golang.org/x/text v0.17.0
+	golang.org/x/term v0.24.0
+	golang.org/x/text v0.18.0
 	google.golang.org/api v0.195.0
-	google.golang.org/grpc v1.66.0
+	google.golang.org/grpc v1.66.1
 	google.golang.org/protobuf v1.34.2
-	modernc.org/sqlite v1.32.0
+	modernc.org/sqlite v1.33.0
 )
 
 require (
 	cloud.google.com/go v0.115.1 // indirect
-	cloud.google.com/go/auth v0.9.1 // indirect
+	cloud.google.com/go/auth v0.9.3 // indirect
 	cloud.google.com/go/auth/oauth2adapt v0.2.4 // indirect
 	cloud.google.com/go/compute/metadata v0.5.0 // indirect
-	cloud.google.com/go/iam v1.1.13 // indirect
+	cloud.google.com/go/iam v1.2.0 // indirect
 	filippo.io/edwards25519 v1.1.0 // indirect
 	github.com/alicebob/gopher-json v0.0.0-20200520072559-a9ecdc9d1d3a // indirect
 	github.com/beorn7/perks v1.0.1 // indirect
@@ -65,7 +65,7 @@ require (
 	github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da // indirect
 	github.com/google/go-cmp v0.6.0 // indirect
 	github.com/google/s2a-go v0.1.8 // indirect
-	github.com/googleapis/enterprise-certificate-proxy v0.3.2 // indirect
+	github.com/googleapis/enterprise-certificate-proxy v0.3.3 // indirect
 	github.com/googleapis/gax-go/v2 v2.13.0 // indirect
 	github.com/grpc-ecosystem/grpc-gateway/v2 v2.22.0 // indirect
 	github.com/hashicorp/golang-lru/v2 v2.0.7 // indirect
@@ -85,19 +85,18 @@ require (
 	github.com/yuin/gopher-lua v1.1.1 // indirect
 	go.einride.tech/aip v0.67.1 // indirect
 	go.opencensus.io v0.24.0 // indirect
-	go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.49.0 // indirect
+	go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.54.0 // indirect
 	go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.29.0 // indirect
 	go.opentelemetry.io/proto/otlp v1.3.1 // indirect
 	golang.org/x/crypto v0.26.0 // indirect
 	golang.org/x/net v0.28.0 // indirect
-	golang.org/x/sys v0.24.0 // indirect
+	golang.org/x/sys v0.25.0 // indirect
 	golang.org/x/time v0.6.0 // indirect
-	google.golang.org/genproto v0.0.0-20240823204242-4ba0660f739c // indirect
-	google.golang.org/genproto/googleapis/api v0.0.0-20240822170219-fc7c04adadcd // indirect
-	google.golang.org/genproto/googleapis/rpc v0.0.0-20240823204242-4ba0660f739c // indirect
+	google.golang.org/genproto v0.0.0-20240903143218-8af14fe29dc1 // indirect
+	google.golang.org/genproto/googleapis/api v0.0.0-20240827150818-7e3bb234dfed // indirect
+	google.golang.org/genproto/googleapis/rpc v0.0.0-20240903143218-8af14fe29dc1 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 	modernc.org/gc/v3 v3.0.0-20240107210532-573471604cb6 // indirect
-	modernc.org/libc v1.55.3 // indirect
 	modernc.org/mathutil v1.6.0 // indirect
 	modernc.org/memory v1.8.0 // indirect
 	modernc.org/strutil v1.2.0 // indirect