Merge branch 'main' into fix-faulty-duplicate-detection

Author: wolveix

.github/workflows/benchmark.yml

@@ -0,0 +1,36 @@
+name: Benchmark
+permissions:
+  contents: read
+on:
+  workflow_dispatch:
+jobs:
+  benchmark:
+    name: Performance regression check
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.25"
+      - name: Run benchmark
+        run: go test -bench=. -count=5 -benchmem ./... | tee output.txt
+      - name: Download previous benchmark data
+        uses: actions/cache@v4
+        with:
+          path: ./cache
+          key: ${{ runner.os }}-benchmark-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-benchmark
+      - name: Store benchmark result
+        uses: benchmark-action/github-action-benchmark@v1
+        with:
+          tool: 'go'
+          output-file-path: output.txt
+          external-data-json-path: ./cache/benchmark-data.json
+          fail-on-alert: true
+          comment-on-alert: true
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          alert-threshold: '130%'
+          comment-always: false

.github/workflows/ci.yaml

@@ -3,14 +3,14 @@ permissions:
   contents: read
 on:
   push:
-    branches: [main]
-  pull_request: {}
+    branches: [ main ]
+  pull_request: { }
 jobs:
   build:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        go: [1.24, 1.25]
+        go: [ 1.25, 1.26 ]
     name: Build & Test
     steps:
       - uses: actions/checkout@v4
@@ -25,4 +25,4 @@ jobs:
       - run: go test -race -coverprofile=coverage.txt -covermode=atomic ./...
       - uses: codecov/codecov-action@v4
         with:
-          token: ${{ secrets.CODECOV_TOKEN }}
+          token: ${{ secrets.CODECOV_TOKEN }}

README.md

@@ -109,7 +109,7 @@ A big thank you to our current & former sponsors!
 
 # Install
 
-Install via `go get`. Note that Go 1.24 or newer is required.
+Install via `go get`. Note that Go 1.25 or newer is required.
 
 ```sh
 # After: go mod init ...
@@ -210,6 +210,10 @@ Official Go package documentation can always be found at https://pkg.go.dev/gith
 - [Bump.sh Deploying Docs from Huma](https://docs.bump.sh/guides/bump-sh-tutorials/huma/)
 - Mentioned in [Composable HTTP Handlers Using Generics](https://www.willem.dev/articles/generic-http-handlers/)
 
+# Who is using Huma?
+
+Huma is used by many companies and open-source projects. See the [Who is using Huma?](https://huma.rocks/why/#who-is-using-huma) page for a list!
+
 Be sure to star the project if you find it useful!
 
 <a href="https://star-history.com/#danielgtaylor/huma&Date">

README_CN.md

@@ -19,7 +19,7 @@
 一个现代、简单、快速且灵活的微框架，用于在 OpenAPI 3 和 JSON Schema 支持的 Go 中构建 HTTP REST/RPC API。国际音标发音：[/'hjuːmɑ/](https://en.wiktionary.org/wiki/Wiktionary:International_Phonetic_Alphabet)。该项目的目标是提供：
 
 - 拥有现有服务的团队逐步采用
-  - 带上您自己的路由器（包括 Go 1.24+）、中间件和日志记录/指标
+  - 带上您自己的路由器（包括 Go 1.22+）、中间件和日志记录/指标
   - 可扩展的 OpenAPI 和 JSON Schema 层来记录现有路由
 - 适合 Go 开发人员的现代 REST 或 HTTP RPC API 后端框架
   - [由OpenAPI 3.1](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md)和[JSON Schema](https://json-schema.org/)描述
@@ -83,7 +83,7 @@
 
 # 安装
 
-通过安装`go get`。请注意，需要 Go 1.24 或更高版本。
+通过安装`go get`。请注意，需要 Go 1.25 或更高版本。
 
 ```sh
 # After: go mod init ...
@@ -150,7 +150,7 @@ func main() {
 ```
 
 > [!TIP]
-> 替换`chi.NewMux()`→`http.NewServeMux()`和`humachi.New`→`humago.New`以使用 Go 1.24+ 中的标准库路由器。只需确保其中列出了您的或更新的`go.mod`版本即可。`go 1.22`其他一切都保持不变！当你准备好时就切换。
+> 替换`chi.NewMux()`→`http.NewServeMux()`和`humachi.New`→`humago.New`以使用 Go 1.22+ 中的标准库路由器。只需确保其中列出了您的或更新的`go.mod`版本即可。`go 1.22`其他一切都保持不变！当你准备好时就切换。
 
 你可以用 `go run greet.go` 测试它（可选地传递 '--port' 来更改默认值），并使用 [Restish](https://rest.sh/)（或 `curl`） 发出示例请求：
 
@@ -184,6 +184,10 @@ HTTP/1.1 200 OK
 - [Bump.sh 从 Huma 部署文档](https://docs.bump.sh/guides/bump-sh-tutorials/huma/)
 - [使用泛型的可组合 HTTP 处理程序](https://www.willem.dev/articles/generic-http-handlers/)中提到
 
+# 谁在使用 Huma？
+
+Huma 被许多公司和开源项目所使用。请参阅 [谁在使用 Huma？](https://huma.rocks/why/#who-is-using-huma) 页面查看列表！
+
 如果您觉得该项目有用，请务必为该项目加注星标！
 
 <a href="https://star-history.com/#danielgtaylor/huma&Date">

README_JA.md

@@ -29,7 +29,7 @@
 本プロジェクトの主な目的は以下の通りです：
 
 - 既存サービスを持つチーム向けの段階的な導入
-  - 好きなルーター（Go 1.24+対応含む）、ミドルウェア、ロギング/メトリクスを利用可能
+  - 好きなルーター（Go 1.22+対応含む）、ミドルウェア、ロギング/メトリクスを利用可能
   - 既存ルートをドキュメント化できる拡張性の高いOpenAPI & JSON Schemaレイヤ
 - Go開発者のためのモダンなREST/HTTP RPC APIバックエンドフレームワーク
   - [OpenAPI 3.1](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md) & [JSON Schema](https://json-schema.org/)によるAPI記述
@@ -129,7 +129,7 @@
 
 ## インストール方法
 
-`go get`でインストールできます。Go 1.24以降が必要です。
+`go get`でインストールできます。Go 1.25以降が必要です。
 
 ```sh
 # 事前に: go mod init ...
@@ -193,7 +193,7 @@ func main() {
 ```
 
 > **TIP:**
-> Go 1.24以降の標準ライブラリルーターを使う場合は、`chi.NewMux()` → `http.NewServeMux()`、`humachi.New` → `humago.New`に変更してください。`go.mod`の`go`バージョンも1.22以上にする必要があります。それ以外は同じです。
+> Go 1.22 以降の標準ライブラリルーターを使う場合は、`chi.NewMux()` → `http.NewServeMux()`、`humachi.New` → `humago.New`に変更してください。`go.mod`の`go`バージョンも1.22以上にする必要があります。それ以外は同じです。
 
 サーバー起動例:
 `go run greet.go`（ポート指定は`--port`でも可）
@@ -235,6 +235,12 @@ HTTP/1.1 200 OK
 
 ---
 
+## Humaを使用しているプロジェクト
+
+Humaは多くの企業やオープンソースプロジェクトで使用されています。リストについては、[Humaを使用しているプロジェクト](https://huma.rocks/why/#who-is-using-huma)のページをご覧ください！
+
+---
+
 プロジェクトが役に立った場合はぜひスターをお願いします！
 
 <a href="https://star-history.com/#danielgtaylor/huma&Date">

adapters/humafiber/humafiber.go

@@ -107,7 +107,7 @@ func (c *fiberWrapper) BodyReader() io.Reader {
 		// Streaming is enabled, so send the reader.
 		return orig.Request().BodyStream()
 	}
-	return bytes.NewReader(orig.BodyRaw())
+	return bytes.NewReader(orig.Body())
 }
 
 func (c *fiberWrapper) GetMultipartForm() (*multipart.Form, error) {

adapters/humafiber/humafiber_context_test.go

@@ -118,9 +118,7 @@ func SimulateAccessToContextOutsideHandler(
 	retries int,
 ) func(ctx context.Context) {
 	return func(ctx context.Context) {
-		wait.Add(1)
-		go func() {
-			defer wait.Done()
+		wait.Go(func() {
 			global, cancel := context.WithTimeout(global, timeout*time.Duration(retries))
 			defer cancel()
 			for {
@@ -136,7 +134,7 @@ func SimulateAccessToContextOutsideHandler(
 				case <-time.After(timeout / 10):
 				}
 			}
-		}()
+		})
 	}
 }
 
@@ -250,12 +248,10 @@ func TestHumaFiber(t *testing.T) {
 	api.UseMiddleware(HumaMiddleware)
 	huma.Register(api, HelloOperation(), HelloHandler(simulator))
 
-	wait.Add(1)
-	go func() {
-		defer wait.Done()
+	wait.Go(func() {
 		err := app.Listener(ln)
 		assert.NoError(t, err)
-	}()
+	})
 	defer wait.Wait()
 
 	err = WaitPing(ctx, server, timeout)
@@ -297,19 +293,17 @@ func TestHumaFiber(t *testing.T) {
 
 	// check that delay works
 	doneFirst := make(chan bool)
-	wait.Add(1)
-	go func() {
-		defer wait.Done()
+	wait.Go(func() {
 		defer close(doneFirst)
 		response, err := http.DefaultClient.Do(request)
 		if response != nil && response.Body != nil {
 			defer func() {
 				_ = response.Body.Close()
 			}()
 		}
-		assert.NoError(t, err)
+		require.NoError(t, err)
 		HelloResponseValidate(t, expected, response)
-	}()
+	})
 	select {
 	case <-ctx.Done():
 		return
@@ -329,31 +323,27 @@ func TestHumaFiber(t *testing.T) {
 
 	// check graceful shutdown
 	doneSecond := make(chan bool)
-	wait.Add(1)
-	go func() {
-		defer wait.Done()
+	wait.Go(func() {
 		defer close(doneSecond)
 		response, err := http.DefaultClient.Do(request)
 		if response != nil && response.Body != nil {
 			defer func() {
 				_ = response.Body.Close()
 			}()
 		}
-		assert.NoError(t, err)
+		require.NoError(t, err)
 		HelloResponseValidate(t, expected, response)
-	}()
+	})
 
 	// perform shutdown
 	doneShutdown := make(chan bool)
-	wait.Add(1)
-	go func() {
-		defer wait.Done()
+	wait.Go(func() {
 		defer close(doneShutdown)
 		time.Sleep(timeout) // delay before shutdown to start request processing
 		err := app.ShutdownWithContext(ctx)
-		assert.NoError(t, err)
+		require.NoError(t, err)
 		time.Sleep(timeout) // delay after shutdown to catch request processing
-	}()
+	})
 
 	// request should be handled
 	select {

adapters/humamux/humamux.go

@@ -138,6 +138,11 @@ func (c *gmuxContext) BodyWriter() io.Writer {
 	return c.w
 }
 
+// NewContext creates a new Huma context from an HTTP request and response.
+func NewContext(op *huma.Operation, r *http.Request, w http.ResponseWriter) huma.Context {
+	return &gmuxContext{op: op, r: r, w: w}
+}
+
 type gMux struct {
 	options
 	router *mux.Router
@@ -149,7 +154,7 @@ func (a *gMux) Handle(op *huma.Operation, handler func(huma.Context)) {
 		Path(op.Path).
 		Methods(op.Method).
 		HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-			handler(&gmuxContext{op: op, r: r, w: w})
+			handler(NewContext(op, r, w))
 		})
 	if a.routeCustomizer != nil {
 		a.routeCustomizer(op, route)
@@ -160,6 +165,11 @@ func (a *gMux) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 	a.router.ServeHTTP(w, r)
 }
 
+// NewAdapter creates a new adapter for the given Gorilla mux.
+func NewAdapter(r *mux.Router, options ...Option) huma.Adapter {
+	return &gMux{router: r, options: parseOptions(options)}
+}
+
 func New(r *mux.Router, config huma.Config, options ...Option) huma.API {
-	return huma.NewAPI(config, &gMux{router: r, options: parseOptions(options)})
+	return huma.NewAPI(config, NewAdapter(r, options...))
 }