github.com/cncf/xds/go v0.0.0-20250501225837-2ac532fd4443: v3.ResourceLocator_XDSTP

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 github.com/cncf/xds/go/xds/core/v3.ResourceLocator_XDSTP in pkg:golang/github.com/cncf/xds/go@v0.0.0-20250501225837-2ac532fd4443
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/cncf/xds/go@v0.0.0-20250501225837-2ac532fd4443
Demonstrate these symbols/APIs:
  - github.com/cncf/xds/go/xds/core/v3.ResourceLocator_XDSTP
Required runtime conditions:
  - ecosystem: golang
  - language: go
  - packageManager: go@1.26.6
  - runtime: go@1.26.6

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:8de4158ac84f811e5de7173d564da6d3a3710baaaf4f19defe9b145c3590e628","contract":["ResourceLocator_XDSTP identifies the xdstp protocol scheme with numeric value zero and string representation XDSTP","ResourceLocator with ResourceLocator_XDSTP scheme initializes with authority, resource type, and id","ResourceLocator getters safely return values and handle nil receivers without panic","ResourceLocator validation succeeds for ResourceLocator_XDSTP scheme and non-empty resource type","ResourceLocator validation fails when resource type is empty or scheme is invalid enum value","ResourceLocator serializes to and deserializes from binary Protobuf format satisfying proto.Equal","proto.Clone produces an isolated deep copy of ResourceLocator where mutating fields does not affect the original"],"goal":"verify github.com/cncf/xds/go/xds/core/v3.ResourceLocator_XDSTP in pkg:golang/github.com/cncf/xds/go@v0.0.0-20250501225837-2ac532fd4443","kind":"HOW","packages":["pkg:golang/github.com/cncf/xds/go@v0.0.0-20250501225837-2ac532fd4443"],"schemaVersion":1,"symbols":["github.com/cncf/xds/go/xds/core/v3.ResourceLocator_XDSTP"]},"contractCommand":["go","run","./test"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"golang","language":"go","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"go","packageManagerVersion":"1.26.6","runtime":"go","runtimeVersion":"1.26.6","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/github.com/cncf/xds/go@v0.0.0-20250501225837-2ac532fd4443"],"schemaVersion":1,"subject":"pkg:golang/github.com/cncf/xds/go@v0.0.0-20250501225837-2ac532fd4443","symbols":["github.com/cncf/xds/go/xds/core/v3.ResourceLocator_XDSTP"],"verifierAdapter":"golang@1"}

module example.com/resourcelocatorxdstp

go 1.23.0

require (
	github.com/cncf/xds/go v0.0.0-20250501225837-2ac532fd4443
	google.golang.org/protobuf v1.33.0
)

require github.com/envoyproxy/protoc-gen-validate v1.0.4 // indirect

github.com/cncf/xds/go v0.0.0-20250501225837-2ac532fd4443 h1:aQ3y1lwWyqYPiWZThqv1aFbZMiM9vblcSArJRf2Irls=
github.com/cncf/xds/go v0.0.0-20250501225837-2ac532fd4443/go.mod h1:W+zGtBO5Y1IgJhy4+A9GOqVhqLpfZi+vwmdNXUehLA8=
github.com/envoyproxy/protoc-gen-validate v1.0.4 h1:gVPz/FMfvh57HdSJQyvBtF00j8JU4zdyUgIUNhlgg0A=
github.com/envoyproxy/protoc-gen-validate v1.0.4/go.mod h1:qys6tmnRsYrQqIhm2bvKZH4Blx/1gTIZ2UKVY1M+Yew=
github.com/google/go-cmp v0.5.5 h1:Khx7svrCpmxxtHBq5j2mp/xVjsi8hQMfNLvJFAlrGgU=
github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
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=
google.golang.org/protobuf v1.33.0 h1:uNO2rsAINq/JlFpSdYEKIZ0uKD/R9cpdv0T+yoGwGmI=
google.golang.org/protobuf v1.33.0/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos=

{
  "schemaVersion": 1,
  "goal": "verify github.com/cncf/xds/go/xds/core/v3.ResourceLocator_XDSTP in pkg:golang/github.com/cncf/xds/go@v0.0.0-20250501225837-2ac532fd4443",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/cncf/xds/go@v0.0.0-20250501225837-2ac532fd4443"
  ],
  "symbols": [
    "github.com/cncf/xds/go/xds/core/v3.ResourceLocator_XDSTP"
  ],
  "runtimeConditions": {
    "ecosystem": "golang",
    "language": "go",
    "packageManager": "go@1.26.6",
    "runtime": "go@1.26.6"
  }
}

package main

import (
	"fmt"
	"os"

	corev3 "github.com/cncf/xds/go/xds/core/v3"
	"google.golang.org/protobuf/proto"
)

func assert(condition bool, message string) {
	if !condition {
		fmt.Fprintf(os.Stderr, "assertion failed: %s\n", message)
		os.Exit(1)
	}
}

func main() {
	// Assertion 1: ResourceLocator_XDSTP identifies the xdstp protocol scheme with numeric value zero and string representation XDSTP
	{
		assert(corev3.ResourceLocator_XDSTP == 0, "expected ResourceLocator_XDSTP numeric value 0")
		assert(corev3.ResourceLocator_XDSTP.String() == "XDSTP", "expected ResourceLocator_XDSTP string representation XDSTP")
		assert(corev3.ResourceLocator_Scheme_name[int32(corev3.ResourceLocator_XDSTP)] == "XDSTP", "expected Scheme_name map to have XDSTP")
		assert(corev3.ResourceLocator_Scheme_value["XDSTP"] == int32(corev3.ResourceLocator_XDSTP), "expected Scheme_value map to map XDSTP to 0")
		assert(corev3.ResourceLocator_XDSTP.Number() == 0, "expected Number() to be 0")
		assert(*corev3.ResourceLocator_XDSTP.Enum() == corev3.ResourceLocator_XDSTP, "expected Enum() pointer value to match")
	}

	// Assertion 2: ResourceLocator with ResourceLocator_XDSTP scheme initializes with authority, resource type, and id
	{
		locator := &corev3.ResourceLocator{
			Scheme:       corev3.ResourceLocator_XDSTP,
			Authority:    "example.com",
			ResourceType: "envoy.config.listener.v3.Listener",
			Id:           "listener-service-1",
		}
		assert(locator.GetScheme() == corev3.ResourceLocator_XDSTP, "expected scheme ResourceLocator_XDSTP")
		assert(locator.GetAuthority() == "example.com", "expected authority example.com")
		assert(locator.GetResourceType() == "envoy.config.listener.v3.Listener", "expected resource type envoy.config.listener.v3.Listener")
		assert(locator.GetId() == "listener-service-1", "expected id listener-service-1")
	}

	// Assertion 3: ResourceLocator getters safely return values and handle nil receivers without panic
	{
		var nilLocator *corev3.ResourceLocator
		assert(nilLocator.GetScheme() == corev3.ResourceLocator_XDSTP, "nil ResourceLocator GetScheme must return default enum 0 (XDSTP)")
		assert(nilLocator.GetAuthority() == "", "nil ResourceLocator GetAuthority must return empty string")
		assert(nilLocator.GetResourceType() == "", "nil ResourceLocator GetResourceType must return empty string")
		assert(nilLocator.GetId() == "", "nil ResourceLocator GetId must return empty string")
		assert(nilLocator.GetExactContext() == nil, "nil ResourceLocator GetExactContext must return nil")
		assert(nilLocator.GetDirectives() == nil, "nil ResourceLocator GetDirectives must return nil")
		assert(nilLocator.Validate() == nil, "nil ResourceLocator Validate must return nil")
		assert(nilLocator.ValidateAll() == nil, "nil ResourceLocator ValidateAll must return nil")

		emptyLocator := &corev3.ResourceLocator{}
		assert(emptyLocator.GetScheme() == corev3.ResourceLocator_XDSTP, "empty ResourceLocator GetScheme must return default enum 0 (XDSTP)")
		assert(emptyLocator.GetAuthority() == "", "empty ResourceLocator GetAuthority must return empty string")
		assert(emptyLocator.GetResourceType() == "", "empty ResourceLocator GetResourceType must return empty string")
		assert(emptyLocator.GetId() == "", "empty ResourceLocator GetId must return empty string")
	}

	// Assertion 4: ResourceLocator validation succeeds for ResourceLocator_XDSTP scheme and non-empty resource type
	{
		validLocator := &corev3.ResourceLocator{
			Scheme:       corev3.ResourceLocator_XDSTP,
			Authority:    "example.com",
			ResourceType: "envoy.config.cluster.v3.Cluster",
			Id:           "cluster_0",
		}
		assert(validLocator.Validate() == nil, "expected valid ResourceLocator Validate() to return nil")
		assert(validLocator.ValidateAll() == nil, "expected valid ResourceLocator ValidateAll() to return nil")
	}

	// Assertion 5: ResourceLocator validation fails when resource type is empty or scheme is invalid enum value
	{
		invalidType := &corev3.ResourceLocator{
			Scheme:       corev3.ResourceLocator_XDSTP,
			ResourceType: "",
		}
		assert(invalidType.Validate() != nil, "expected Validate() error for empty ResourceType")
		assert(invalidType.ValidateAll() != nil, "expected ValidateAll() error for empty ResourceType")

		invalidScheme := &corev3.ResourceLocator{
			Scheme:       corev3.ResourceLocator_Scheme(999),
			ResourceType: "envoy.config.cluster.v3.Cluster",
		}
		assert(invalidScheme.Validate() != nil, "expected Validate() error for invalid Scheme")
		assert(invalidScheme.ValidateAll() != nil, "expected ValidateAll() error for invalid Scheme")
	}

	// Assertion 6: ResourceLocator serializes to and deserializes from binary Protobuf format satisfying proto.Equal
	{
		orig := &corev3.ResourceLocator{
			Scheme:       corev3.ResourceLocator_XDSTP,
			Authority:    "example.com",
			ResourceType: "envoy.config.route.v3.RouteConfiguration",
			Id:           "route_config_0",
		}
		wire, err := proto.Marshal(orig)
		assert(err == nil, "proto.Marshal failed")
		assert(len(wire) > 0, "marshaled wire length is 0")

		unmarshaled := &corev3.ResourceLocator{}
		err = proto.Unmarshal(wire, unmarshaled)
		assert(err == nil, "proto.Unmarshal failed")
		assert(proto.Equal(orig, unmarshaled), "proto.Equal returned false after unmarshal")
		assert(unmarshaled.GetScheme() == corev3.ResourceLocator_XDSTP, "deserialized scheme mismatch")
	}

	// Assertion 7: proto.Clone produces an isolated deep copy of ResourceLocator where mutating fields does not affect the original
	{
		orig := &corev3.ResourceLocator{
			Scheme:       corev3.ResourceLocator_XDSTP,
			Authority:    "example.com",
			ResourceType: "envoy.config.endpoint.v3.ClusterLoadAssignment",
			Id:           "endpoint_0",
		}
		cloned := proto.Clone(orig).(*corev3.ResourceLocator)
		assert(proto.Equal(orig, cloned), "cloned ResourceLocator must equal original")

		cloned.Authority = "other.com"
		cloned.Id = "endpoint_1"
		cloned.Scheme = corev3.ResourceLocator_HTTP

		assert(orig.GetAuthority() == "example.com", "original Authority was mutated")
		assert(orig.GetId() == "endpoint_0", "original Id was mutated")
		assert(orig.GetScheme() == corev3.ResourceLocator_XDSTP, "original Scheme was mutated")
	}

	fmt.Println("PASS: all github.com/cncf/xds/go/xds/core/v3.ResourceLocator_XDSTP contract assertions verified")
}