Merge pull request #1504 from gofr-dev/release/v1.34.0

Release/v1.34.0

Author: aryanmehrotra

Diff for: CONTRIBUTING.md

@@ -81,6 +81,7 @@ docker run --name kafka-1 -p 9092:9092 \
 bitnami/kafka:3.4
 docker pull scylladb/scylla
 docker run --name scylla -d -p 2025:9042 scylladb/scylla
+docker run -d --name nats-server -p 4222:4222 -p 8222:8222 nats:latest -js
 docker pull surrealdb/surrealdb:latest
 docker run --name surrealdb -d -p 8000:8000 surrealdb/surrealdb:latest start --bind 0.0.0.0:8000
 docker run -d --name arangodb \

Diff for: docs/Dockerfile

@@ -8,6 +8,7 @@ COPY  docs/advanced-guide /app/src/app/docs/advanced-guide
 COPY  docs/references /app/src/app/docs/references
 COPY  docs/page.md /app/src/app/docs
 COPY  docs/navigation.js /app/src/lib
+COPY  docs/events.json /app/src/app/events
 
 ENV NODE_ENV production
 

Diff for: docs/advanced-guide/injecting-databases-drivers/page.md

@@ -958,6 +958,21 @@ added using the `app.AddArangoDB()` method, and users can use ArangoDB across th
 
 ```go
 type ArangoDB interface {
+    // CreateDB creates a new database in ArangoDB.
+	CreateDB(ctx context.Context, database string) error
+	// DropDB deletes an existing database in ArangoDB.
+	DropDB(ctx context.Context, database string) error
+
+	// CreateCollection creates a new collection in a database with specified type.
+	CreateCollection(ctx context.Context, database, collection string, isEdge bool) error
+	// DropCollection deletes an existing collection from a database.
+	DropCollection(ctx context.Context, database, collection string) error
+
+	// CreateGraph creates a new graph in a database.
+	CreateGraph(ctx context.Context, database, graph string, edgeDefinitions any) error
+	// DropGraph deletes an existing graph from a database.
+	DropGraph(ctx context.Context, database, graph string) error
+
     // CreateDocument creates a new document in the specified collection.
 	CreateDocument(ctx context.Context, dbName, collectionName string, document any) (string, error)
 	// GetDocument retrieves a document by its ID from the specified collection.

Diff for: docs/advanced-guide/key-value-store/page.md

@@ -85,3 +85,133 @@ func Delete(ctx *gofr.Context) (any, error) {
 	return fmt.Sprintf("Deleted Successfully key %v from Key-Value Store", "name"), nil
 }
 ```
+## NATS-KV
+GoFr supports injecting NATS-KV that supports the above KVStore interface. Any driver that implements the interface can be added
+using `app.AddKVStore()` method, and user's can use NATS-KV across application with `gofr.Context`.
+
+User's can easily inject a driver that supports this interface, this provides usability without
+compromising the extensibility to use multiple databases.
+
+Import the gofr's external driver for NATS-KV:
+
+```go
+go get gofr.dev/pkg/gofr/datasource/kv-store/nats
+```
+### Example
+```go
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+
+	"github.com/google/uuid"
+
+	"gofr.dev/pkg/gofr"
+	"gofr.dev/pkg/gofr/datasource/kv-store/nats"
+	"gofr.dev/pkg/gofr/http"
+)
+
+type Person struct {
+	ID    string `json:"id,omitempty"`
+	Name  string `json:"name"`
+	Age   int    `json:"age"`
+	Email string `json:"email,omitempty"`
+}
+
+func main() {
+	app := gofr.New()
+
+	app.AddKVStore(nats.New(nats.Configs{
+		Server: "nats://localhost:4222",
+		Bucket: "persons",
+	}))
+
+	app.POST("/person", CreatePerson)
+	app.GET("/person/{id}", GetPerson)
+	app.PUT("/person/{id}", UpdatePerson)
+	app.DELETE("/person/{id}", DeletePerson)
+
+	app.Run()
+}
+
+func CreatePerson(ctx *gofr.Context) (any, error) {
+	var person Person
+	if err := ctx.Bind(&person); err != nil {
+		return nil, http.ErrorInvalidParam{Params: []string{"body"}}
+	}
+
+	person.ID = uuid.New().String()
+	personData, err := json.Marshal(person)
+	if err != nil {
+		return nil, fmt.Errorf("failed to serialize person")
+	}
+
+	if err := ctx.KVStore.Set(ctx, person.ID, string(personData)); err != nil {
+		return nil, err
+	}
+
+	return person, nil
+}
+
+func GetPerson(ctx *gofr.Context) (any, error) {
+	id := ctx.PathParam("id")
+	if id == "" {
+		return nil, http.ErrorInvalidParam{Params: []string{"id"}}
+	}
+
+	value, err := ctx.KVStore.Get(ctx, id)
+	if err != nil {
+		return nil, fmt.Errorf("person not found")
+	}
+
+	var person Person
+	if err := json.Unmarshal([]byte(value), &person); err != nil {
+		return nil, fmt.Errorf("failed to parse person data")
+	}
+
+	return person, nil
+}
+
+func UpdatePerson(ctx *gofr.Context) (any, error) {
+	id := ctx.PathParam("id")
+	if id == "" {
+		return nil, http.ErrorInvalidParam{Params: []string{"id"}}
+	}
+
+	var person Person
+	if err := ctx.Bind(&person); err != nil {
+		return nil, http.ErrorInvalidParam{Params: []string{"body"}}
+	}
+
+	person.ID = id
+	personData, err := json.Marshal(person)
+	if err != nil {
+		return nil, fmt.Errorf("failed to serialize person")
+	}
+
+	if err := ctx.KVStore.Set(ctx, id, string(personData)); err != nil {
+		return nil, err
+	}
+
+	return person, nil
+}
+
+func DeletePerson(ctx *gofr.Context) (any, error) {
+	id := ctx.PathParam("id")
+	if id == "" {
+		return nil, http.ErrorInvalidParam{Params: []string{"id"}}
+	}
+
+	if err := ctx.KVStore.Delete(ctx, id); err != nil {
+		return nil, fmt.Errorf("person not found")
+	}
+
+	return map[string]string{"message": "Person deleted successfully"}, nil
+}
+```
+
+
+
+
+

Diff for: docs/events.json

@@ -0,0 +1,26 @@
+[
+    {
+        "date": "23-24th November, 2024",
+        "title": "GoFr Hackathon",
+        "description": "GoFr Hackathon was a major success with participants building innovative solutions using the GoFr framework. It was an exciting two-day event where developers and tech enthusiasts came together to collaborate and create.",
+        "imageSrc": "/events/hackathon.jpg"
+    },
+    {
+        "date": "23-24th October, 2024",
+        "title": "Open Source India",
+        "description": "At Open Source India, we had an amazing experience connecting with the open-source community. The event featured various sessions, demos, and showcases on GoFr, highlighting its role in simplifying backend development and its microservice approach.",
+        "imageSrc": "/events/OpenSourceIndia.jpeg"
+    },
+    {
+        "date": "18-19th October, 2024",
+        "title": "GopherCon Africa",
+        "description": "At GopherCon Africa, GoFr stood out with its cutting-edge tools and integration features, making backend development easier. We showcased GoFr's capabilities in working with databases, observability tools, and its seamless HTTP/gRPC support.",
+        "imageSrc": "/events/gopherconAfrica.jpeg"
+    },
+    {
+        "date": "September 2024",
+        "title": "GoFr Workshops",
+        "description": "GoFr workshops are held regularly to engage with developers and tech enthusiasts. We’ve conducted workshops across multiple cities such as IIT BHU, IIIT Sri City, Thapar University, JIIT Noida, NIT Jalandhar, and NIT Nagpur offering hands-on experiences and deep dives into GoFr’s powerful features.",
+        "imageSrc": "/events/WorkShop.jpeg"
+    }
+]