golang.org/x/tools v0.0.0-20200825202427-b303f430e36d: imports.Process

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify golang.org/x/tools/imports.Process in pkg:golang/golang.org/x/tools@v0.0.0-20200825202427-b303f430e36d
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/golang.org/x/tools@v0.0.0-20200825202427-b303f430e36d
Demonstrate these symbols/APIs:
  - golang.org/x/tools/imports.Process

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:b6e612b23610f83a76b4dc90b16e8ef46186cca85aecb7546bafb0f5daa2dc61","contract":["imports.Process automatically inserts missing standard library imports for referenced symbols","imports.Process automatically removes unused imports from Go source code","imports.Process formats and canonicalizes Go code when nil Options is provided","imports.Process with Options.FormatOnly true formats source code without adding or removing imports","imports.Process with Options.Fragment true processes declaration fragments without requiring package declaration","imports.Process returns an error when given invalid Go syntax that cannot be parsed"],"goal":"verify golang.org/x/tools/imports.Process in pkg:golang/golang.org/x/tools@v0.0.0-20200825202427-b303f430e36d","kind":"HOW","packages":["pkg:golang/golang.org/x/tools@v0.0.0-20200825202427-b303f430e36d"],"schemaVersion":1,"symbols":["golang.org/x/tools/imports.Process"]},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"golang","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/golang.org/x/tools@v0.0.0-20200825202427-b303f430e36d"],"schemaVersion":1,"subject":"pkg:golang/golang.org/x/tools@v0.0.0-20200825202427-b303f430e36d","symbols":["golang.org/x/tools/imports.Process"],"verifierAdapter":"golang@1"}

module sample

go 1.24

require golang.org/x/tools v0.0.0-20200825202427-b303f430e36d

require (
	golang.org/x/mod v0.3.0 // indirect
	golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 // indirect
)

github.com/yuin/goldmark v1.1.32/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
golang.org/x/mod v0.3.0 h1:RM4zey1++hCTbCVQfnWeKs9/IEsaBLA8vTkd0WVtmH4=
golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
golang.org/x/net v0.0.0-20200625001655-4c5254603344/go.mod h1:/O7V0waA8r7cgGh81Ro3o1hOxt32SMVPicZroKQ2sZA=
golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20200625203802-6e8e738ad208/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200323222414-85ca7c5b95cd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
golang.org/x/tools v0.0.0-20200825202427-b303f430e36d h1:W07d4xkoAUSNOkOzdzXCdFGxT7o2rW4q8M34tB2i//k=
golang.org/x/tools v0.0.0-20200825202427-b303f430e36d/go.mod h1:njjCfa9FT2d7l9Bc6FUM5FLjQPp3cFF28FI3qnDFljA=
golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4=
golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=

package sample

import (
	"golang.org/x/tools/imports"
)

// ProcessSource formats Go source code and updates import declarations using imports.Process.
func ProcessSource(filename string, src []byte, opt *imports.Options) ([]byte, error) {
	return imports.Process(filename, src, opt)
}

{
  "schemaVersion": 1,
  "goal": "verify golang.org/x/tools/imports.Process in pkg:golang/golang.org/x/tools@v0.0.0-20200825202427-b303f430e36d",
  "kind": "HOW",
  "packages": [
    "pkg:golang/golang.org/x/tools@v0.0.0-20200825202427-b303f430e36d"
  ],
  "symbols": [
    "golang.org/x/tools/imports.Process"
  ]
}

package main

import (
	"fmt"
	"os"
	"strings"

	"golang.org/x/tools/imports"
)

func main() {
	if err := runContractTests(); err != nil {
		fmt.Fprintf(os.Stderr, "Contract test failed: %v\n", err)
		os.Exit(1)
	}
	fmt.Println("All contract tests passed.")
}

func runContractTests() error {
	// 1. imports.Process automatically inserts missing standard library imports for referenced symbols
	{
		src := []byte("package main\n\nfunc main() {\n\tfmt.Println(\"hello\")\n}\n")
		res, err := imports.Process("main.go", src, nil)
		if err != nil {
			return fmt.Errorf("assertion 1 failed: %w", err)
		}
		out := string(res)
		if !strings.Contains(out, `"fmt"`) {
			return fmt.Errorf("assertion 1: expected 'fmt' import to be added, got:\n%s", out)
		}
	}

	// 2. imports.Process automatically removes unused imports from Go source code
	{
		src := []byte("package main\n\nimport (\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\t_ = strings.ToUpper(\"abc\")\n}\n")
		res, err := imports.Process("main.go", src, nil)
		if err != nil {
			return fmt.Errorf("assertion 2 failed: %w", err)
		}
		out := string(res)
		if strings.Contains(out, `"os"`) {
			return fmt.Errorf("assertion 2: expected unused 'os' import to be removed, got:\n%s", out)
		}
		if !strings.Contains(out, `"strings"`) {
			return fmt.Errorf("assertion 2: expected used 'strings' import to remain, got:\n%s", out)
		}
	}

	// 3. imports.Process formats and canonicalizes Go code when nil Options is provided
	{
		src := []byte("package main\n\nfunc  add( x,y  int )int{return   x+y}\n")
		res, err := imports.Process("main.go", src, nil)
		if err != nil {
			return fmt.Errorf("assertion 3 failed: %w", err)
		}
		expected := "package main\n\nfunc add(x, y int) int { return x + y }\n"
		if string(res) != expected {
			return fmt.Errorf("assertion 3: expected:\n%q\ngot:\n%q", expected, string(res))
		}
	}

	// 4. imports.Process with Options.FormatOnly true formats source code without adding or removing imports
	{
		src := []byte("package main\n\nimport \"os\"\n\nfunc  main() {\n\tfmt.Println( \"unimported\" )\n}\n")
		opt := &imports.Options{
			FormatOnly: true,
			Comments:   true,
			TabIndent:  true,
			TabWidth:   8,
		}
		res, err := imports.Process("main.go", src, opt)
		if err != nil {
			return fmt.Errorf("assertion 4 failed: %w", err)
		}
		out := string(res)
		if !strings.Contains(out, `import "os"`) {
			return fmt.Errorf("assertion 4: expected unused 'os' import not to be removed with FormatOnly=true, got:\n%s", out)
		}
		if strings.Contains(out, `"fmt"`) {
			return fmt.Errorf("assertion 4: expected missing 'fmt' import not to be added with FormatOnly=true, got:\n%s", out)
		}
		if !strings.Contains(out, `fmt.Println("unimported")`) {
			return fmt.Errorf("assertion 4: expected formatting to be applied, got:\n%s", out)
		}
	}

	// 5. imports.Process with Options.Fragment true processes declaration fragments without requiring package declaration
	{
		src := []byte("func greet() {\nfmt.Println(\"fragment\")\n}\n")
		opt := &imports.Options{
			Fragment:  true,
			Comments:  true,
			TabIndent: true,
			TabWidth:  8,
		}
		res, err := imports.Process("fragment.go", src, opt)
		if err != nil {
			return fmt.Errorf("assertion 5 failed: %w", err)
		}
		out := string(res)
		if !strings.Contains(out, `import "fmt"`) {
			return fmt.Errorf("assertion 5: expected import to be added for fragment, got:\n%s", out)
		}
		if !strings.Contains(out, "func greet() {\n\tfmt.Println(\"fragment\")\n}") {
			return fmt.Errorf("assertion 5: unexpected fragment output:\n%s", out)
		}
	}

	// 6. imports.Process returns an error when given invalid Go syntax that cannot be parsed
	{
		src := []byte("package main\n\nfunc broken( {\n")
		_, err := imports.Process("broken.go", src, nil)
		if err == nil {
			return fmt.Errorf("assertion 6: expected error for invalid syntax, got nil")
		}
	}

	return nil
}