feat: groups

[danielgtaylor]

This PR adds a new Group struct & feature that takes the functionality of the excellent https://github.com/cardinalby/hureg library and ports it into Huma's core. Basic functionality looks like this:

grp := huma.NewGroup(api, "/v1")
grp.UseMiddleware(authMiddleware)

huma.Get(grp, "/users", func(ctx context.Context, input *struct{}) ([]User, error) {
	// ...
})

Check out the included docs for more info!

Related to #719.
Fixes #489.

[Copilot]

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

docs/docs/features/middleware.md:204

• The phrase 'the API instance' should be corrected to 'list of middleware'.

-   [`huma.Middlewares`](https://pkg.go.dev/github.com/danielgtaylor/huma/v2#Middlewares) the API instance

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.87%. Comparing base (169da69) to head (cce8262).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #728      +/-   ##
==========================================
+ Coverage   92.78%   92.87%   +0.08%     
==========================================
  Files          22       23       +1     
  Lines        5062     5124      +62     
==========================================
+ Hits         4697     4759      +62     
  Misses        314      314              
  Partials       51       51              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[nutgood]

This is exactly what we needed ! Thanks @danielgtaylor.