The -retracted flag causes list to report information about retracted
module versions. When -retracted is used with -f or -json, the Retracted
field will be set to a string explaining why the version was retracted.
The string is taken from comments on the retract directive in the
module's go.mod file. When -retracted is used with -versions, retracted
versions are listed together with unretracted versions. The -retracted
flag may be used with or without -m.

! go get example.com/retract/ambiguous/other
stderr 'ambiguous import: found package example.com/retract/ambiguous/nested in multiple modules:'
stderr '^go: warning: example.com/retract/ambiguous/nested@v1.9.0-bad: retracted by module author: nested modules are bad$'

-- go.mod --
module example.com/use

go 1.16

See example.com_retract_self_pseudo_v1.9.0.txt.

This version is retracted.

-- .mod --
module example.com/retract/self/pseudo

go 1.15

-- .info --
{"Version":"v1.0.0-bad"}

-- p.go --

	GoMod      string           `json:",omitempty"` // path to go.mod file describing module, if any
	GoVersion  string           `json:",omitempty"` // go version used in module
	Retracted  []string         `json:",omitempty"` // retraction information, if any (with -retracted or -u)
	Deprecated string           `json:",omitempty"` // deprecation message, if any (with -u)
	Error      *ModuleError     `json:",omitempty"` // error loading module

This version should be retracted, but the go.mod file for the version that would
contain the retraction is not available.
-- .mod --
module example.com/retract/missingmod

go 1.14
-- .info --
{"Version":"v1.0.0"}
-- missingmod.go --

See example.com_retract_self_pref_v1.9.0.txt.

This version is the latest (only) non-retracted version.

-- .mod --
module example.com/retract/self/prev

go 1.15

-- .info --
{"Version":"v1.1.0"}

-- p.go --

See example.com_retract_self_prev_v1.9.0.txt.

This version is retracted.

-- .mod --
module example.com/retract/self/prev

go 1.15

-- .info --
{"Version":"v1.0.0-bad"}

-- p.go --

go list -m -u example.com/retract/noupgrade
stdout '^example.com/retract/noupgrade v1.0.0 \(retracted\)$'

-- go.mod --
module use

go 1.19

require example.com/retract/noupgrade v1.0.0
-- go.sum --

# retract must not be used without a module directive.
! go list -m all
stderr 'go.mod:3: no module directive found, so retract cannot be used$'

# Commands that update go.mod should fix non-canonical versions in
# retract directives.
# Verifies #44494.
go mod edit -module=rsc.io/quote/v2
! go list -m all
stderr '^go: updates to go.mod needed; to update it:\n\tgo mod tidy$'
go mod tidy
go list -m all
cmp go.mod go.mod.want

# the main module).

cp go.mod go.mod.orig

go mod graph
cp stdout graph-1.17.txt
stdout '^example\.com/m example\.com/retract/incompatible@v1\.0\.0$'
stdout '^example\.net/lazy@v0\.1\.0 example\.com/retract/incompatible@v1\.0\.0$'
! stdout 'example\.com/retract/incompatible@v2\.0\.0\+incompatible'

go mod graph -go=1.17
cmp stdout graph-1.17.txt

cmp go.mod go.mod.orig