golang.org/x/tools v0.48.0: imports.Options

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.Options in pkg:golang/golang.org/x/tools@v0.48.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/golang.org/x/tools@v0.48.0
Demonstrate these symbols/APIs:
  - golang.org/x/tools/imports.Options

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:030d5f8449bca74d5d2309bf1cfffd516d8a5f4bc67b960bf1562a098ff098d9","contract":["imports.Options struct initializes with zero values for all configuration fields","imports.Options with FormatOnly true suppresses adding missing imports and removing unused imports","imports.Options with FormatOnly false allows automatic addition of missing imports and removal of unused imports","imports.Options with Fragment true permits processing declaration fragments while Fragment false rejects them","imports.Options with Comments false strips comments from formatted output while nil Options preserves comments"],"goal":"verify golang.org/x/tools/imports.Options in pkg:golang/golang.org/x/tools@v0.48.0","kind":"HOW","packages":["pkg:golang/golang.org/x/tools@v0.48.0"],"schemaVersion":1,"symbols":["golang.org/x/tools/imports.Options"]},"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.48.0"],"schemaVersion":1,"subject":"pkg:golang/golang.org/x/tools@v0.48.0","symbols":["golang.org/x/tools/imports.Options"],"verifierAdapter":"golang@1"}

module sample

go 1.26.6

require golang.org/x/tools v0.48.0

require (
	golang.org/x/mod v0.38.0 // indirect
	golang.org/x/sync v0.22.0 // indirect
)

github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
golang.org/x/mod v0.38.0 h1:MECBjubtXD7yj4HrhIUcywNaGeNVUdfVnxmPajOk4yk=
golang.org/x/mod v0.38.0/go.mod h1:V6Xz0pq8TQ3dGqVQ1FVHuelZpAL0uNhSkk9ogYP3c40=
golang.org/x/sync v0.22.0 h1:SZjpbeLmrCk4xhRSZFNZW5gFUeCeFgjekvI/+gfScek=
golang.org/x/sync v0.22.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
golang.org/x/tools v0.48.0 h1:3+hClM1aLL5mjMKm5ovokw9epgRXPuu2tILgismM6RE=
golang.org/x/tools v0.48.0/go.mod h1:08xX0orndb/F7jJxGDicx061tyd5pcMto75YMAXr6lk=

package main

import (
	"fmt"
	"os"

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

func main() {
	src := []byte("package main\n\nfunc main() {\n\tfmt.Println(\"sample demonstration\")\n}\n")
	opt := &imports.Options{
		FormatOnly: false,
		Comments:   true,
		TabIndent:  true,
		TabWidth:   8,
	}

	res, err := imports.Process("main.go", src, opt)
	if err != nil {
		fmt.Fprintf(os.Stderr, "failed to process: %v\n", err)
		os.Exit(1)
	}

	fmt.Print(string(res))
}

{
  "schemaVersion": 1,
  "goal": "verify golang.org/x/tools/imports.Options in pkg:golang/golang.org/x/tools@v0.48.0",
  "kind": "HOW",
  "packages": [
    "pkg:golang/golang.org/x/tools@v0.48.0"
  ],
  "symbols": [
    "golang.org/x/tools/imports.Options"
  ]
}

package main

import (
	"fmt"
	"os"
	"strings"

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

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

func runTests() error {
	// 1. imports.Options struct initializes with zero values for all configuration fields
	{
		var opt imports.Options
		if opt.Fragment != false || opt.AllErrors != false || opt.Comments != false ||
			opt.TabIndent != false || opt.TabWidth != 0 || opt.FormatOnly != false {
			return fmt.Errorf("test 1: expected zero-value Options fields, got %+v", opt)
		}
	}

	// 2. imports.Options with FormatOnly true suppresses adding missing imports and removing unused imports
	{
		src := []byte("package main\n\nimport \"os\"\n\nfunc main() {\n\tfmt.Println(\"test\")\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("test 2 failed: %w", err)
		}
		out := string(res)
		if !strings.Contains(out, `import "os"`) {
			return fmt.Errorf("test 2: expected unused import 'os' to be retained with FormatOnly=true, got:\n%s", out)
		}
		if strings.Contains(out, `"fmt"`) {
			return fmt.Errorf("test 2: expected missing import 'fmt' not to be added with FormatOnly=true, got:\n%s", out)
		}
	}

	// 3. imports.Options with FormatOnly false allows automatic addition of missing imports and removal of unused imports
	{
		src := []byte("package main\n\nimport \"os\"\n\nfunc main() {\n\tfmt.Println(\"test\")\n}\n")
		opt := &imports.Options{
			FormatOnly: false,
			Comments:   true,
			TabIndent:  true,
			TabWidth:   8,
		}
		res, err := imports.Process("main.go", src, opt)
		if err != nil {
			return fmt.Errorf("test 3 failed: %w", err)
		}
		out := string(res)
		if strings.Contains(out, `"os"`) {
			return fmt.Errorf("test 3: expected unused import 'os' to be removed with FormatOnly=false, got:\n%s", out)
		}
		if !strings.Contains(out, `"fmt"`) {
			return fmt.Errorf("test 3: expected missing import 'fmt' to be added with FormatOnly=false, got:\n%s", out)
		}
	}

	// 4. imports.Options with Fragment true permits processing declaration fragments while Fragment false rejects them
	{
		frag := []byte("func helper() {\n\t_ = fmt.Sprintf(\"\")\n}\n")

		// Fragment: false should fail because there is no package declaration
		_, errFalse := imports.Process("fragment.go", frag, &imports.Options{Fragment: false})
		if errFalse == nil {
			return fmt.Errorf("test 4: expected error for fragment when Fragment=false, got nil")
		}

		// Fragment: true should succeed and parse the snippet
		resTrue, errTrue := imports.Process("fragment.go", frag, &imports.Options{
			Fragment:  true,
			Comments:  true,
			TabIndent: true,
			TabWidth:  8,
		})
		if errTrue != nil {
			return fmt.Errorf("test 4: expected success for fragment when Fragment=true, got error: %w", errTrue)
		}
		if !strings.Contains(string(resTrue), "func helper()") {
			return fmt.Errorf("test 4: expected formatted helper function, got:\n%s", string(resTrue))
		}
	}

	// 5. imports.Options with Comments false strips comments from formatted output while nil Options preserves comments
	{
		src := []byte("package main\n\n// Important comment explaining logic\nfunc main() {\n}\n")

		// Comments: false strips the comment
		resNoComment, err := imports.Process("main.go", src, &imports.Options{
			Comments:  false,
			TabIndent: true,
			TabWidth:  8,
		})
		if err != nil {
			return fmt.Errorf("test 5 (Comments=false) failed: %w", err)
		}
		if strings.Contains(string(resNoComment), "Important comment explaining logic") {
			return fmt.Errorf("test 5: expected comment to be stripped with Comments=false, got:\n%s", string(resNoComment))
		}

		// nil Options preserves the comment
		resWithComment, err := imports.Process("main.go", src, nil)
		if err != nil {
			return fmt.Errorf("test 5 (nil Options) failed: %w", err)
		}
		if !strings.Contains(string(resWithComment), "Important comment explaining logic") {
			return fmt.Errorf("test 5: expected comment to be preserved with nil Options, got:\n%s", string(resWithComment))
		}
	}

	return nil
}