deprecate UseMiddlewarWithContainer and remove it from tests and docs

docs/advanced-guide/middlewares/page.md

@@ -67,56 +67,3 @@ func main() {
 }
 ```
 
-### Using UseMiddlewareWithContainer for Custom Middleware with Container Access
-
-The UseMiddlewareWithContainer method allows middleware to access the application's container, providing access to
-services like logging, configuration, and databases. This method is especially useful for middleware that needs access 
-to resources in the container to modify request processing flow.
-
-#### Example:
-
-```go
-import (
-    "fmt"
-    "net/http"
-
-    "gofr.dev/pkg/gofr"
-    "gofr.dev/pkg/gofr/container"
-)
-
-func main() {
-    // Create a new GoFr application instance
-    a := gofr.New()
-
-    // Add custom middleware with container access
-    a.UseMiddlewareWithContainer(customMiddleware)
-
-    // Define the application's routes
-    a.GET("/hello", HelloHandler)
-
-    // Run the application
-    a.Run()
-}
-
-// Define middleware with container access
-func customMiddleware(c *container.Container, handler http.Handler) http.Handler {
-    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-        c.Logger.Log("Hey! Welcome to GoFr")
-
-        // Continue with the request processing
-        handler.ServeHTTP(w, r)
-    })
-}
-
-// Sample handler function
-func HelloHandler(c *gofr.Context) (interface{}, error) {
-    name := c.Param("name")
-    if name == "" {
-        c.Log("Name came empty")
-        name = "World"
-    }
-
-    return fmt.Sprintf("Hello %s!", name), nil
-}
-```
-

pkg/gofr/gofr.go

@@ -648,6 +648,8 @@ func (a *App) UseMiddleware(middlewares ...gofrHTTP.Middleware) {
 //
 // The `middleware` function receives the container and the handler, allowing
 // the middleware to modify the request processing flow.
+// Deprecated: UseMiddlewareWithContainer will be removed in a future release.
+// Please use the UseMiddleware method that does not depend on the container.
 func (a *App) UseMiddlewareWithContainer(middlewareHandler func(c *container.Container, handler http.Handler) http.Handler) {
 	a.httpServer.router.Use(func(h http.Handler) http.Handler {
 		// Wrap the provided handler `h` with the middleware function `middlewareHandler`

pkg/gofr/gofr_test.go

@@ -620,57 +620,6 @@ func Test_UseMiddleware(t *testing.T) {
 	assert.Equal(t, "applied", testHeaderValue, "Test_UseMiddleware Failed! header value mismatch.")
 }
 
-// Test the UseMiddlewareWithContainer function.
-func TestUseMiddlewareWithContainer(t *testing.T) {
-	// Initialize the mock container
-	mockContainer := container.NewContainer(config.NewMockConfig(nil))
-
-	// Create a simple handler to test middleware functionality
-	handler := http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
-		w.WriteHeader(http.StatusOK)
-		_, _ = w.Write([]byte("Hello, world!"))
-	})
-
-	// Middleware to modify response and test container access
-	middleware := func(c *container.Container, handler http.Handler) http.Handler {
-		return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-			// Ensure the container is passed correctly (for this test, we are just logging)
-			assert.NotNil(t, c, "Container should not be nil in the middleware")
-
-			// Continue with the handler execution
-			handler.ServeHTTP(w, r)
-		})
-	}
-
-	// Create a new App with a mock server
-	app := &App{
-		httpServer: &httpServer{
-			router: gofrHTTP.NewRouter(),
-			port:   8001,
-		},
-		container: mockContainer,
-		Config:    config.NewMockConfig(map[string]string{"REQUEST_TIMEOUT": "5"}),
-	}
-
-	// Use the middleware with the container
-	app.UseMiddlewareWithContainer(middleware)
-
-	// Register the handler to a route for testing
-	app.httpServer.router.Handle("/test", handler)
-
-	// Create a test request
-	req := httptest.NewRequest(http.MethodGet, "/test", http.NoBody)
-	// Create a test response recorder
-	rr := httptest.NewRecorder()
-
-	// Call the handler with the request and recorder
-	app.httpServer.router.ServeHTTP(rr, req)
-
-	// Assert the status code and response body
-	assert.Equal(t, http.StatusOK, rr.Code)
-	assert.Equal(t, "Hello, world!", rr.Body.String())
-}
-
 func Test_APIKeyAuthMiddleware(t *testing.T) {
 	c, _ := container.NewMockContainer(t)