Merge pull request #54 from fredbi/prepare/release-v2.3

Prepare/release v2.3

Author: fredbi

.github/workflows/auto-merge.yml

@@ -11,5 +11,5 @@ jobs:
     permissions:
       contents: write
       pull-requests: write
-    uses: go-openapi/ci-workflows/.github/workflows/auto-merge.yml@ea0dfc9a8f78335f47355d842b76bcf95d29c846 # v0.2.5
+    uses: go-openapi/ci-workflows/.github/workflows/auto-merge.yml@a94fc68a7e32794bbdc77ae00db80bd6567cb6f0 # v0.2.7
     secrets: inherit

.github/workflows/bump-release.yml

@@ -32,7 +32,7 @@ jobs:
     permissions:
       contents: write
       pull-requests: write
-    uses: go-openapi/ci-workflows/.github/workflows/bump-release-monorepo.yml@ea0dfc9a8f78335f47355d842b76bcf95d29c846 # v0.2.5
+    uses: go-openapi/ci-workflows/.github/workflows/bump-release-monorepo.yml@a94fc68a7e32794bbdc77ae00db80bd6567cb6f0 # v0.2.7
     with:
       bump-type: ${{ inputs.bump-type }}
       tag-message-title: ${{ inputs.tag-message-title }}

.github/workflows/codeql.yml

@@ -18,5 +18,5 @@ jobs:
     permissions:
       contents: read
       security-events: write
-    uses: go-openapi/ci-workflows/.github/workflows/codeql.yml@ea0dfc9a8f78335f47355d842b76bcf95d29c846 # v0.2.5
+    uses: go-openapi/ci-workflows/.github/workflows/codeql.yml@a94fc68a7e32794bbdc77ae00db80bd6567cb6f0 # v0.2.7
     secrets: inherit

.github/workflows/contributors.yml

@@ -14,5 +14,5 @@ jobs:
     permissions:
       pull-requests: write
       contents: write
-    uses: go-openapi/ci-workflows/.github/workflows/contributors.yml@ea0dfc9a8f78335f47355d842b76bcf95d29c846 # v0.2.5
+    uses: go-openapi/ci-workflows/.github/workflows/contributors.yml@a94fc68a7e32794bbdc77ae00db80bd6567cb6f0 # v0.2.7
     secrets: inherit

.github/workflows/go-test.yml

@@ -13,7 +13,7 @@ on:
 
 jobs:
   test:
-    uses: go-openapi/ci-workflows/.github/workflows/go-test-monorepo.yml@ea0dfc9a8f78335f47355d842b76bcf95d29c846 # v0.2.5
+    uses: go-openapi/ci-workflows/.github/workflows/go-test-monorepo.yml@a94fc68a7e32794bbdc77ae00db80bd6567cb6f0 # v0.2.7
     with:
-      extra-flags: '-tags testcgo' # this is to trigger extra tests in spew
+      extra-flags: '-tags testcgo,testcolorized' # (1) this is to trigger extra tests in spew, (2) this is to enable integration test for colorized output
     secrets: inherit

.github/workflows/scanner.yml

@@ -15,5 +15,5 @@ jobs:
     permissions:
       contents: read
       security-events: write
-    uses: go-openapi/ci-workflows/.github/workflows/scanner.yml@ea0dfc9a8f78335f47355d842b76bcf95d29c846 # V0.2.4
+    uses: go-openapi/ci-workflows/.github/workflows/scanner.yml@a94fc68a7e32794bbdc77ae00db80bd6567cb6f0 # V0.2.7
     secrets: inherit

.github/workflows/tag-release.yml

@@ -13,7 +13,7 @@ jobs:
     name: Create release
     permissions:
       contents: write
-    uses: go-openapi/ci-workflows/.github/workflows/release.yml@ea0dfc9a8f78335f47355d842b76bcf95d29c846 # v0.2.5
+    uses: go-openapi/ci-workflows/.github/workflows/release.yml@a94fc68a7e32794bbdc77ae00db80bd6567cb6f0 # v0.2.7
     with:
       tag: ${{ github.ref_name }}
       is-monorepo: true

.golangci.yml

@@ -14,6 +14,7 @@ linters:
     - paralleltest
     - recvcheck
     - testpackage
+    - thelper
     - tparallel
     - varnamelen
     - whitespace

assert/assert_adhoc_example_6_test.go

@@ -0,0 +1,35 @@
+// SPDX-FileCopyrightText: Copyright 2025 go-swagger maintainers
+// SPDX-License-Identifier: Apache-2.0
+
+package assert_test
+
+import (
+	"fmt"
+	"testing"
+
+	"github.com/go-openapi/testify/v2/assert"
+)
+
+func ExampleAssertions_with_generics() {
+	t := new(testing.T) // normally provided by test
+
+	a := assert.New(t)
+
+	const expected = "hello"
+	goodValue := "hello"
+	wrongValue := "world"
+
+	r0 := a.Equal(expected, goodValue) // classic reflect-based assertion
+	fmt.Printf("good value is %t\n", r0)
+
+	r1 := assert.EqualT(a.T, expected, goodValue) // usage with generic assertion
+	fmt.Printf("good value is %t\n", r1)
+
+	r2 := assert.EqualT(a.T, expected, wrongValue)
+	fmt.Printf("wrong value is %t\n", r2)
+
+	// Output:
+	// good value is true
+	// good value is true
+	// wrong value is false
+}

assert/assert_adhoc_example_7_test.go

@@ -0,0 +1,40 @@
+// SPDX-FileCopyrightText: Copyright 2025 go-swagger maintainers
+// SPDX-License-Identifier: Apache-2.0
+
+package assert_test
+
+import (
+	"fmt"
+	"sync"
+	"testing"
+
+	"github.com/go-openapi/testify/v2/assert"
+)
+
+func ExampleNoGoRoutineLeak_fail() {
+	t := new(testing.T) // normally provided by test
+
+	blocker := make(chan struct{})
+	var wg sync.WaitGroup
+
+	defer func() {
+		// clean resources _after_ the test
+		close(blocker)
+		wg.Wait()
+	}()
+
+	wg.Add(1)
+	// This examplifies how a function that leaks a goroutine is detected.
+	result := assert.NoGoRoutineLeak(t, func() { // true when there is no leak
+		go func() {
+			defer wg.Done()
+			<-blocker // leaked: blocks until cleanup
+		}()
+	})
+
+	// Error message from test would typically return the leaked goroutine, e.g.:
+	// #	0x69c8e8	github.com/go-openapi/testify/v2/assert_test.ExampleNoGoRoutineLeak.func2.1+0x48	.../assert_adhoc_example_7_test.go:30
+	fmt.Printf("has leak: %t", !result)
+	// Output:
+	// has leak: true
+}