feat: add tags to the Server (i.e Group) level

mux.go

@@ -82,6 +82,7 @@ func Register[T any, B any, Contexted ctx[B]](s *Server, method string, path str
 	route.operation.Summary = name
 	route.operation.Description = "controller: " + nameWithPath
 	route.operation.OperationID = fullPath + ":" + name
+	route.operation.Tags = append(route.operation.Tags, s.tags...)
 	return route
 }
 

options.go

@@ -8,6 +8,7 @@ import (
 	"log/slog"
 	"net/http"
 	"os"
+	"slices"
 	"time"
 
 	"github.com/getkin/kin-openapi/openapi3"
@@ -45,6 +46,8 @@ type Server struct {
 	// For example, it allows OPTIONS /foo even if it is not declared (only GET /foo is declared).
 	corsMiddleware func(http.Handler) http.Handler
 
+	tags []string
+
 	middlewares []func(http.Handler) http.Handler
 
 	basePath string
@@ -329,3 +332,31 @@ func WithValidator(newValidator *validator.Validate) func(*Server) {
 		v = newValidator
 	}
 }
+
+// Replaces Tags for the Server (i.e Group)
+// By default, the tag is the type of the response body.
+func (s *Server) Tags(tags ...string) *Server {
+	s.tags = tags
+	return s
+}
+
+// AddTags adds tags from the Server (i.e Group)
+// Tags from the parent Groups will be respected
+func (s *Server) AddTags(tags ...string) *Server {
+	s.tags = append(s.tags, tags...)
+	return s
+}
+
+// RemoveTags removes tags from the Server (i.e Group)
+// if matching tags from the parent Group will be removed
+func (s *Server) RemoveTags(tags ...string) *Server {
+	for _, tag := range tags {
+		for i, t := range s.tags {
+			if t == tag {
+				s.tags = slices.Delete(s.tags, i, i+1)
+				break
+			}
+		}
+	}
+	return s
+}

options_test.go

@@ -271,3 +271,27 @@ func TestWithPort(t *testing.T) {
 		require.Equal(t, "localhost:9999", s.Server.Addr)
 	})
 }
+
+func TestServerTags(t *testing.T) {
+	s := NewServer().
+		Tags("my-server-tag")
+
+	require.Equal(t, s.tags, []string{"my-server-tag"})
+}
+
+func TestServerAddTags(t *testing.T) {
+	s := NewServer().
+		AddTags("my-server-tag").
+		AddTags("my-other-server-tag")
+
+	require.Equal(t, s.tags, []string{"my-server-tag", "my-other-server-tag"})
+}
+
+func TestServerRemoveTags(t *testing.T) {
+	s := NewServer().
+		Tags("my-server-tag").
+		AddTags("my-other-server-tag").
+		RemoveTags("my-other-server-tag")
+
+	require.Equal(t, s.tags, []string{"my-server-tag"})
+}