How to have a root path on a huma group

[bbedward]

I have a huma group like:

teamsGroup := huma.NewGroup(api, "/teams")
teamsGroup.UseModifier(func(op *huma.Operation, next func(*huma.Operation)) {
	op.Tags = []string{"Teams"}
	next(op)
})
teamHandlers := teams_handler.NewHandlerGroup(srvImpl)
huma.Register(
	teamsGroup,
	huma.Operation{
		OperationID: "list-teams",
		Summary:     "List Teams",
		Description: "List all teams the current user is a member of",
		Path:        "/",
		Method:      http.MethodGet,
	},
	teamHandlers.ListTeams,
)

This generates a route like /teams/, but I would prefer it to generate the route /teams

Is this possible with any path syntax? When path is blank there is a panic at startup.

[danielgtaylor]

@bbedward good question! The group operation modifier you already have can be updated to do this, for example:

https://go.dev/play/p/LBsSwTxOn8I

teamsGroup := huma.NewGroup(api, "/teams")
teamsGroup.UseModifier(func(op *huma.Operation, next func(*huma.Operation)) {
	op.Tags = []string{"Teams"}

	// Trim any trailing `/` characters from the path before registration!
	op.Path = strings.TrimSuffix(op.Path, "/")
	
	next(op)
})

[VelorumS]

Not strictly related, but what's the preferred way to translate the root_path (--root-path) FastAPI/uvicorn parameter to huma?

It's not a real prefix, it's the prefix that an external traefik/HAProxy strips, but the API doc pages inside the application must use it to call the right routes.

You're supposed to add it with a http handler and then strip it with a huma group?

Edit: ok, it's humaConfig.Servers = []*huma.Server{{URL: "/" + rootPath}}