testing/synctest: remove Run in Go 1.26

[neild]

The experimental synctest package in Go 1.24 included a Run function. This package is only available when GOEXPERIMENT=synctest.

The non-experimental package in Go 1.25 replaces Run with Test. When GOEXPERIMENT=synctest, Run is still available to give early adopters a chance to migrate to the new API.

We will remove the Run function in Go 1.26. Creating an issue so we don't forget.

[gabyhelp]

Related Documentation

• Testing concurrent code with testing/synctest > Status of the experiment

_{(Emoji vote if this was helpful or unhelpful; more detailed feedback welcome in this discussion.)}

[Deleplace]

The new documentation of synctest:

• says for Run: Deprecated: Use Test instead.
• does not say anymore experimental, and not subject to the Go 1 compatibility promise.

This makes it look as if, like many deprecated functions, Run will stay forever, for compat.

Can we please say explicitly in the doc "The Run function will be removed in Go 1.26."?

Shall I do a CL for this?

[neild]

Sure, feel free to send me a CL.

[gopherbot]

Change https://go.dev/cl/684875 mentions this issue: testing/synctest: explicitly state Run will be removed in Go 1.26