docs: Add compression middleware examples and improve README organization

- Added example using `quick.Handler` for GZIP compression
- Added example using `quick.HandlerFunc` for alternative middleware syntax
- Added example using native `net/http` middleware for GZIP compression
- Improved README structure to clarify middleware options
- Added cURL examples for testing compressed and uncompressed responses
- Ensured consistency in formatting and documentation across examples

Author: jaquelineabreu

example/middleware/compress/README.md

@@ -15,8 +15,9 @@ When a client sends a request with the header Accept-Encoding: gzip, the middlew
 - ✅ Saves bandwidth and enhances user experience
 - ✅ Works seamlessly with Quick’s request-handling flow
 
-#### Example Usage
-🔹 Enabling GZIP Compression in Quick
+
+
+#### 🔹 Using Quick Default Middleware (quick.Handler)
 ```go
 package main
 
@@ -53,6 +54,66 @@ func main() {
 }
 
 ```
+#### 🔹 Using Quick HandlerFunc Middleware (quick.HandlerFunc)
+```go
+package main
+
+import (
+	"log"
+	"github.com/jeffotoni/quick"
+	"github.com/jeffotoni/quick/middleware/compress"
+)
+
+func main() {
+	q := quick.New()
+
+	// Enable GZIP middleware using HandlerFunc version
+	q.Use(compress.Gzip())
+
+	// Define a compressed response route
+	q.Get("/v1/compress", func(c *quick.Ctx) error {
+		c.Set("Content-Type", "application/json")
+
+		type response struct {
+			Msg     string              `json:"msg"`
+			Headers map[string][]string `json:"headers"`
+		}
+
+		return c.Status(200).JSON(&response{
+			Msg:     "Quick ❤️",
+			Headers: c.Headers,
+		})
+	})
+
+	log.Fatal(q.Listen(":8080"))
+}
+```
+#### 🔹 Using Pure net/http Middleware
+```go
+package main
+
+import (
+	"log"
+	"net/http"
+	"github.com/jeffotoni/quick/middleware/compress"
+)
+
+func main() {
+	mux := http.NewServeMux()
+
+	// Route with compression enabled using the middleware
+	mux.Handle("/v1/compress", compress.Gzip()(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		w.Header().Set("Content-Type", "application/json")
+		w.WriteHeader(http.StatusOK)
+		w.Write([]byte(`{"message": "Hello, net/http with Gzip!"}`))
+	})))
+
+	log.Println("Server running at http://localhost:8080")
+	log.Fatal(http.ListenAndServe(":8080", mux))
+}
+```
+
+
 #### 📌 Testing with cURL
 
 ##### 🔹Request Without GZIP (Uncompressed Response):

example/middleware/compress/compress.gzip.HandlerFunc/main.go

@@ -0,0 +1,41 @@
+package main
+
+import (
+	"log"
+
+	"github.com/jeffotoni/quick"
+	"github.com/jeffotoni/quick/middleware/compress"
+)
+
+func main() {
+	q := quick.New()
+
+	// Enable Gzip middleware
+	// This will automatically compress responses for clients that support Gzip
+	q.Use(compress.Gzip())
+
+	// Define a route that returns a compressed JSON response
+	q.Get("/v1/compress", func(c *quick.Ctx) error {
+		// Setting response headers
+		c.Set("Content-Type", "application/json")
+		c.Set("Accept-Encoding", "gzip") // Enabling Gzip compression
+
+		// Defining the response structure
+		type my struct {
+			Msg     string              `json:"msg"`
+			Headers map[string][]string `json:"headers"`
+		}
+
+		// Returning a JSON response with headers
+		return c.Status(200).JSON(&my{
+			Msg:     "Quick ❤️",
+			Headers: c.Headers,
+		})
+	})
+
+	// Start the HTTP server on port 8080
+	// The server will listen for incoming requests at http://localhost:8080
+	log.Fatal(q.Listen("0.0.0.0:8080"))
+}
+
+// $ curl -X GET http://localhost:8080/v1/compress -H "Accept-Encoding: gzip" --compressed -i

example/middleware/compress/compress.gzip.net.http/main.go

@@ -0,0 +1,24 @@
+package main
+
+import (
+	"log"
+	"net/http"
+	//"github.com/jeffotoni/quick/middleware/compress"
+)
+
+func main() {
+	mux := http.NewServeMux()
+
+	// Route with compression enabled using the Gzip middleware
+	// mux.Handle("/v1/compress", compress.Gzip()(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+	// 	w.Header().Set("Content-Type", "application/json")
+	// 	w.WriteHeader(http.StatusOK)
+	// 	w.Write([]byte(`{"message": "Hello, net/http with Gzip!"}`))
+	// })))
+
+	// Starting the HTTP server on port 8080
+	log.Println("Server running at http://localhost:8080")
+	log.Fatal(http.ListenAndServe(":8080", mux))
+}
+
+// $ curl -X GET http://localhost:8080/v1/compress -H "Accept-Encoding: gzip" --compressed -i

example/middleware/compress/compress.gzip/compress_gzip.go

@@ -7,25 +7,35 @@ import (
 	"github.com/jeffotoni/quick/middleware/compress"
 )
 
-// curl -i -H 'Accept-Encoding: gzip' -GET localhost:8080/v1/compress
 func main() {
 	q := quick.New()
+
+	// Enable Gzip middleware
+	// This will automatically compress responses for clients that support Gzip
 	q.Use(compress.Gzip())
+
+	// Define a route that returns a compressed JSON response
 	q.Get("/v1/compress", func(c *quick.Ctx) error {
+		// Setting response headers
 		c.Set("Content-Type", "application/json")
-		c.Set("Accept-Encoding", "gzip")
+		c.Set("Accept-Encoding", "gzip") // Enabling Gzip compression
 
+		// Defining the response structure
 		type my struct {
 			Msg     string              `json:"msg"`
 			Headers map[string][]string `json:"headers"`
 		}
 
+		// Returning a JSON response with headers
 		return c.Status(200).JSON(&my{
 			Msg:     "Quick ❤️",
 			Headers: c.Headers,
 		})
 	})
 
+	// Start the HTTP server on port 8080
+	// The server will listen for incoming requests at http://localhost:8080
 	log.Fatal(q.Listen("0.0.0.0:8080"))
-
 }
+
+//$ curl -X GET http://localhost:8080/v1/compress -H "Accept-Encoding: gzip" --compressed -i