github.com/inconshreveable/mousetrap v1.1.0: StartedByExplorer

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 pkg:golang/github.com/inconshreveable/mousetrap@v1.1.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/inconshreveable/mousetrap@v1.1.0

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:12ed9878f2ed6da8a63180382e7d0b8b3ca295739fae2a2bc9cb8fba6337c23e","contract":["mousetrap.StartedByExplorer executes without panic","mousetrap.StartedByExplorer returns false when executed from command-line environment","mousetrap.StartedByExplorer returns a boolean"],"goal":"verify pkg:golang/github.com/inconshreveable/mousetrap@v1.1.0","kind":"HOW","packages":["pkg:golang/github.com/inconshreveable/mousetrap@v1.1.0"],"schemaVersion":1,"symbols":["github.com/inconshreveable/mousetrap.StartedByExplorer"]},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","ecosystem":"golang","os":"windows","osVersionBucket":"11","packageManager":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/inconshreveable/mousetrap@v1.1.0"],"schemaVersion":1,"symbols":["github.com/inconshreveable/mousetrap.StartedByExplorer"],"verifierAdapter":"golang@1"}

module sample

go 1.26.5

require github.com/inconshreveable/mousetrap v1.1.0 // indirect

github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=

package main

import (
	"fmt"

	"github.com/inconshreveable/mousetrap"
)

// IsStartedByExplorer returns true if the process was launched directly from Windows Explorer.
func IsStartedByExplorer() bool {
	return mousetrap.StartedByExplorer()
}

func main() {
	if IsStartedByExplorer() {
		fmt.Println("Launched from Windows Explorer")
	} else {
		fmt.Println("Launched from command line or non-interactive process")
	}
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:golang/github.com/inconshreveable/mousetrap@v1.1.0",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/inconshreveable/mousetrap@v1.1.0"
  ],
  "symbols": [
    "github.com/inconshreveable/mousetrap.StartedByExplorer"
  ]
}

package main

import (
	"fmt"
	"os"

	"github.com/inconshreveable/mousetrap"
)

func main() {
	// Contract: mousetrap.StartedByExplorer executes without panic
	result := mousetrap.StartedByExplorer()

	// Contract: mousetrap.StartedByExplorer returns false when executed from command-line environment
	if result {
		fmt.Fprintf(os.Stderr, "Assertion failed: expected false when run from CLI environment, got true\n")
		os.Exit(1)
	}

	// Contract: mousetrap.StartedByExplorer returns a boolean type
	var _ bool = result

	fmt.Println("All contract assertions passed successfully.")
}