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 93.00%. Comparing base (169da69) to head (4f96e3c).
Report is 18 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #728      +/-   ##
==========================================
+ Coverage   92.78%   93.00%   +0.21%     
==========================================
  Files          22       23       +1     
  Lines        5062     5248     +186     
==========================================
+ Hits         4697     4881     +184     
- Misses        314      315       +1     
- Partials       51       52       +1     

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

[nutgood]

This is exactly what we needed ! Thanks @danielgtaylor.