Merge pull request #807 from Serjlee/main

Allow empty path in group operations

Author: danielgtaylor

group_test.go

@@ -26,6 +26,24 @@ func TestGroupNoPrefix(t *testing.T) {
 	assert.Equal(t, http.StatusNoContent, resp.Result().StatusCode)
 }
 
+func TestGroupEmptyPath(t *testing.T) {
+	_, api := humatest.New(t)
+
+	grp := huma.NewGroup(api, "/users")
+
+	huma.Get(grp, "", func(ctx context.Context, input *struct{}) (*struct{}, error) {
+		return nil, nil
+	})
+
+	assert.Nil(t, api.OpenAPI().Paths["/"])
+	assert.Nil(t, api.OpenAPI().Paths[""])
+	assert.NotNil(t, api.OpenAPI().Paths["/users"])
+
+	resp := api.Get("/users")
+	assert.Equal(t, http.StatusNoContent, resp.Result().StatusCode)
+
+}
+
 func TestGroupMultiPrefix(t *testing.T) {
 	_, api := humatest.New(t)
 

huma.go

@@ -622,8 +622,13 @@ func Register[I, O any](api API, op Operation, handler func(context.Context, *I)
 	oapi := api.OpenAPI()
 	registry := oapi.Components.Schemas
 
-	if op.Method == "" || op.Path == "" {
-		panic("method and path must be specified in operation")
+	if op.Method == "" {
+		panic("method must be specified in operation")
+	}
+	if op.Path == "" {
+		if grp, ok := api.(*Group); !ok || len(grp.prefixes) == 0 {
+			panic("path must be specified in operation")
+		}
 	}
 	initResponses(&op)