go.opentelemetry.io/otel/trace v1.37.0: SpanEndOption

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 go.opentelemetry.io/otel/trace.SpanEndOption in pkg:golang/go.opentelemetry.io/otel/trace@v1.37.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/go.opentelemetry.io/otel/trace@v1.37.0
Demonstrate these symbols/APIs:
  - go.opentelemetry.io/otel/trace.SpanEndOption

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:4e917cbb66c010576c76b8d46c9557a3ab85e98ddd924ea4fc981284f67ae91d","contract":["NewSpanEndConfig with no options creates an empty SpanConfig with zero timestamp and false stack trace.","trace.WithTimestamp satisfies the SpanEndOption interface and sets the end timestamp in SpanConfig.","trace.WithStackTrace satisfies the SpanEndOption interface and configures stack trace capturing in SpanConfig.","Multiple SpanEndOption instances can be combined in NewSpanEndConfig, applying all configured options.","trace.SpanEndOption can be passed to Span.End without panicking on a valid tracer span."],"goal":"verify go.opentelemetry.io/otel/trace.SpanEndOption in pkg:golang/go.opentelemetry.io/otel/trace@v1.37.0","kind":"HOW","packages":["pkg:golang/go.opentelemetry.io/otel/trace@v1.37.0"],"schemaVersion":1,"symbols":["go.opentelemetry.io/otel/trace.SpanEndOption"]},"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/go.opentelemetry.io/otel/trace@v1.37.0"],"schemaVersion":1,"subject":"pkg:golang/go.opentelemetry.io/otel/trace@v1.37.0","symbols":["go.opentelemetry.io/otel/trace.SpanEndOption"],"verifierAdapter":"golang@1"}

module sample

go 1.26.6

require go.opentelemetry.io/otel/trace v1.37.0

require go.opentelemetry.io/otel v1.37.0 // indirect

github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
go.opentelemetry.io/otel v1.37.0 h1:9zhNfelUvx0KBfu/gb+ZgeAfAgtWrfHJZcAqFC228wQ=
go.opentelemetry.io/otel v1.37.0/go.mod h1:ehE/umFRLnuLa/vSccNq9oS1ErUlkkK71gMcN34UG8I=
go.opentelemetry.io/otel/trace v1.37.0 h1:HLdcFNbRQBE2imdSEgm/kwqmQj1Or1l/7bW6mxVK7z4=
go.opentelemetry.io/otel/trace v1.37.0/go.mod h1:TlgrlQ+PtQO5XFerSPUYG0JSgGyryXewPGyayAWSBS0=
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

package main

import (
	"context"
	"fmt"
	"time"

	"go.opentelemetry.io/otel/trace"
	"go.opentelemetry.io/otel/trace/noop"
)

func main() {
	// Demonstrate SpanEndOption usage with WithTimestamp
	endTime := time.Now()
	timestampOpt := trace.WithTimestamp(endTime)

	// Demonstrate SpanEndOption usage with WithStackTrace
	stackTraceOpt := trace.WithStackTrace(true)

	// Demonstrate NewSpanEndConfig applying SpanEndOption
	cfg := trace.NewSpanEndConfig(timestampOpt, stackTraceOpt)
	fmt.Printf("Configured timestamp: %v\n", cfg.Timestamp())
	fmt.Printf("Configured stackTrace: %v\n", cfg.StackTrace())

	// Demonstrate passing SpanEndOption directly to span.End
	tracer := noop.NewTracerProvider().Tracer("sample-tracer")
	ctx := context.Background()
	_, span := tracer.Start(ctx, "sample-span")
	span.End(timestampOpt, stackTraceOpt)
	fmt.Println("Span successfully ended with SpanEndOption")
}

{
  "schemaVersion": 1,
  "goal": "verify go.opentelemetry.io/otel/trace.SpanEndOption in pkg:golang/go.opentelemetry.io/otel/trace@v1.37.0",
  "kind": "HOW",
  "packages": [
    "pkg:golang/go.opentelemetry.io/otel/trace@v1.37.0"
  ],
  "symbols": [
    "go.opentelemetry.io/otel/trace.SpanEndOption"
  ]
}

package main

import (
	"context"
	"fmt"
	"os"
	"time"

	"go.opentelemetry.io/otel/trace"
	"go.opentelemetry.io/otel/trace/noop"
)

func main() {
	// Assertion 1: NewSpanEndConfig with no options creates an empty SpanConfig with zero timestamp and false stack trace.
	defaultCfg := trace.NewSpanEndConfig()
	if !defaultCfg.Timestamp().IsZero() {
		fmt.Fprintf(os.Stderr, "FAIL: expected zero timestamp for default config, got %v\n", defaultCfg.Timestamp())
		os.Exit(1)
	}
	if defaultCfg.StackTrace() != false {
		fmt.Fprintf(os.Stderr, "FAIL: expected false stackTrace for default config, got %v\n", defaultCfg.StackTrace())
		os.Exit(1)
	}

	// Assertion 2: trace.WithTimestamp satisfies the SpanEndOption interface and sets the end timestamp in SpanConfig.
	customTime := time.Date(2026, time.September, 17, 12, 0, 0, 0, time.UTC)
	var tsOpt trace.SpanEndOption = trace.WithTimestamp(customTime)
	tsCfg := trace.NewSpanEndConfig(tsOpt)
	if !tsCfg.Timestamp().Equal(customTime) {
		fmt.Fprintf(os.Stderr, "FAIL: expected timestamp %v, got %v\n", customTime, tsCfg.Timestamp())
		os.Exit(1)
	}

	// Assertion 3: trace.WithStackTrace satisfies the SpanEndOption interface and configures stack trace capturing in SpanConfig.
	var stOpt trace.SpanEndOption = trace.WithStackTrace(true)
	stCfg := trace.NewSpanEndConfig(stOpt)
	if !stCfg.StackTrace() {
		fmt.Fprintf(os.Stderr, "FAIL: expected stackTrace true, got %v\n", stCfg.StackTrace())
		os.Exit(1)
	}

	var stOptFalse trace.SpanEndOption = trace.WithStackTrace(false)
	stCfgFalse := trace.NewSpanEndConfig(stOptFalse)
	if stCfgFalse.StackTrace() {
		fmt.Fprintf(os.Stderr, "FAIL: expected stackTrace false, got %v\n", stCfgFalse.StackTrace())
		os.Exit(1)
	}

	// Assertion 4: Multiple SpanEndOption instances can be combined in NewSpanEndConfig, applying all configured options.
	combinedCfg := trace.NewSpanEndConfig(tsOpt, stOpt)
	if !combinedCfg.Timestamp().Equal(customTime) {
		fmt.Fprintf(os.Stderr, "FAIL: combined expected timestamp %v, got %v\n", customTime, combinedCfg.Timestamp())
		os.Exit(1)
	}
	if !combinedCfg.StackTrace() {
		fmt.Fprintf(os.Stderr, "FAIL: combined expected stackTrace true, got %v\n", combinedCfg.StackTrace())
		os.Exit(1)
	}

	// Assertion 5: trace.SpanEndOption can be passed to Span.End without panicking on a valid tracer span.
	tracer := noop.NewTracerProvider().Tracer("contract-tracer")
	ctx := context.Background()
	_, span := tracer.Start(ctx, "contract-span")
	span.End(tsOpt, stOpt)

	fmt.Println("PASS: all trace.SpanEndOption contract assertions passed.")
}