refact: moved assert/enable to enable/stubs (usage is symmetric)

Signed-off-by: Frederic BIDON <fredbi@yahoo.com>

Author: fredbi

.claude/CLAUDE.md

@@ -97,10 +97,12 @@ With 76 assertion functions, this generates 608 functions automatically.
 ### Dependency Isolation Strategy
 - **internal/spew**: Internalized copy of go-spew for pretty-printing values
 - **internal/difflib**: Internalized copy of go-difflib for generating diffs
-- **assert/yaml**: Stub package that panics by default if YAML assertions are used
+- **internal/assertions/enable**: Internal stubs that panic by default if YAML/color assertions are used
+- **enable/stubs**: Public API for enabling optional features (yaml, colors)
 - **enable/yaml**: Optional module that activates YAML support via init() when imported
+- **enable/colors**: Optional module that activates colorized output via init() when imported
 
-The "enable" pattern allows YAML functionality to be opt-in: import `_ "github.com/go-openapi/testify/v2/enable/yaml"` to activate YAML assertions without forcing a dependency on all users.
+The "enable" pattern allows optional functionality to be opt-in: import `_ "github.com/go-openapi/testify/v2/enable/yaml"` to activate YAML assertions, or `_ "github.com/go-openapi/testify/v2/enable/colors"` to enable colorized output, without forcing dependencies on all users.
 
 ## Development Commands
 

assert/doc.go

@@ -1 +1,55 @@
+// Package assert provides a set of testing tools for use with the standard Go testing system.
+//
+// # Note
+//
+// All functions in this package return a bool value indicating whether the assertion has passed.
+//
+// # Example usage
+//
+// The following is a complete example using assert in a standard test function:
+//
+//	import (
+//	  "testing"
+//	  "github.com/go-openapi/testify/v2/assert"
+//	)
+//
+//	func TestSomething(t *testing.T) {
+//
+//	  var a string = "Hello"
+//	  var b string = "Hello"
+//
+//	  assert.Equal(t, a, b, "The two words should be the same.")
+//
+//	}
+//
+// if you assert many times, use the format below:
+//
+//	import (
+//	  "testing"
+//	  "github.com/go-openapi/testify/v2/assert"
+//	)
+//
+//	func TestSomething(t *testing.T) {
+//	  assert := assert.New(t)
+//
+//	  var a string = "Hello"
+//	  var b string = "Hello"
+//
+//	  assert.Equal(a, b, "The two words should be the same.")
+//	}
+//
+// # Assertions
+//
+// Assertions allow you to easily write test code.
+//
+// All assertion functions take as the first argument, the [*testing.T] object provided by the
+// standard testing framework.
+//
+// This allows the assertion functions to write the failings and other details to the correct place.
+//
+// Every assertion function also takes an optional string message as the final argument,
+// allowing custom error messages to be appended to the message the assertion method outputs.
+//
+// See [our doc site](https://go-openapi.github.io/testify/) for usage and examples and
+// [go docs](https://pkg.go/dev/go-openapi/testify) for complete reference.
 package assert

docs/doc-site/project/maintainers/ARCHITECTURE.md

@@ -48,4 +48,12 @@ Everything in these packages is generated. Never edit generated files directly.
 Exceptions:
 * `doc.go` is not generated
 * ad'hoc testable examples are not generated
-* the `assert` package contains an `enable` package to enable features. This is not generated.
+
+**Optional Feature Packages: `enable/`**
+
+The `enable/` package provides optional features that users can activate via blank imports:
+- `enable/stubs/` - Public stub APIs for enabling features (yaml, colors)
+- `enable/yaml/` - Activates YAML support via `import _ "github.com/go-openapi/testify/v2/enable/yaml"`
+- `enable/colors/` - Activates colorized output via `import _ "github.com/go-openapi/testify/v2/enable/colors"`
+
+These packages are not generated and allow optional dependencies to be isolated from the core library.

docs/doc-site/project/maintainers/CODEGEN.md

@@ -56,7 +56,6 @@ This repository uses code generation extensively to maintain consistency across
         direction LR
         docgo_assert@{ shape: document, label: "doc.go" }
         adhoc_assert@{ shape: document, label: "*_adhoc*_test.go" }
-        enable_assert@{ shape: lin-doc, label: "enable" }
       end
     end
 

enable/colors/assertions_test.go

@@ -10,7 +10,7 @@ import (
 	"testing"
 
 	target "github.com/go-openapi/testify/v2/assert"
-	colorstub "github.com/go-openapi/testify/v2/assert/enable/colors"
+	colorstub "github.com/go-openapi/testify/v2/enable/stubs/colors"
 )
 
 func TestMain(m *testing.M) {

enable/colors/enable.go

@@ -11,7 +11,7 @@ import (
 
 	"golang.org/x/term"
 
-	colorstub "github.com/go-openapi/testify/v2/assert/enable/colors"
+	colorstub "github.com/go-openapi/testify/v2/enable/stubs/colors"
 )
 
 const (

assert/enable/colors/enable_colors.go enable/stubs/colors/enable_colors.goassert/enable/colors/enable_colors.go renamed to enable/stubs/colors/enable_colors.go

@@ -0,0 +1,14 @@
+// SPDX-FileCopyrightText: Copyright 2025 go-swagger maintainers
+// SPDX-License-Identifier: Apache-2.0
+
+// Package stubs provides public APIs for enabling optional features in testify.
+//
+// This package exports stub implementations that delegate to internal packages,
+// maintaining a clean separation between internal implementation and public API.
+//
+// Subpackages:
+//   - yaml: API for enabling YAML assertions
+//   - colors: API for enabling colorized output
+//
+// These stubs are used by the enable/{yaml,colors} modules to activate optional features.
+package stubs

enable/stubs/doc.go

@@ -5,7 +5,7 @@
 package yaml
 
 import (
-	yamlstub "github.com/go-openapi/testify/v2/assert/enable/yaml"
+	yamlstub "github.com/go-openapi/testify/v2/enable/stubs/yaml"
 
 	yaml "go.yaml.in/yaml/v3"
 )