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

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.ResourceName 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.ResourceName

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:1c1df90cd764337d92e5efab0edec1d7db6c5f8f986c9f1ba1150e8876071db3","contract":["ResourceName stores and retrieves Id, Authority, ResourceType, and ContextParams via its getter methods","ResourceName getter methods safely return default zero values when called on a nil ResourceName pointer","ResourceName.Validate requires ResourceType to have at least one character and returns a validation error when empty","ResourceName serializes and deserializes accurately with protobuf binary wire format preserving all fields and context parameters","ResourceName.Reset clears all fields back to their zero values"],"goal":"verify github.com/cncf/xds/go/xds/core/v3.ResourceName 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.ResourceName"]},"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/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.ResourceName"],"verifierAdapter":"golang@1"}

module sample

go 1.26.6

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=

package main

import (
	"fmt"

	corev3 "github.com/cncf/xds/go/xds/core/v3"
)

func main() {
	rn := &corev3.ResourceName{
		Id:           "service-cluster-1",
		Authority:    "traffic.example.com",
		ResourceType: "envoy.config.cluster.v3.Cluster",
		Context: &corev3.ContextParams{
			Params: map[string]string{
				"region": "us-east-1",
				"env":    "production",
			},
		},
	}

	if err := rn.Validate(); err != nil {
		fmt.Printf("Validation failed: %v\n", err)
		return
	}

	fmt.Printf("Resource ID: %s\n", rn.GetId())
	fmt.Printf("Authority: %s\n", rn.GetAuthority())
	fmt.Printf("Resource Type: %s\n", rn.GetResourceType())
	fmt.Printf("Context params: %v\n", rn.GetContext().GetParams())
}

{
  "schemaVersion": 1,
  "goal": "verify github.com/cncf/xds/go/xds/core/v3.ResourceName 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.ResourceName"
  ]
}

package main

import (
	"fmt"
	"os"

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

func main() {
	// Assertion 1: ResourceName stores and retrieves Id, Authority, ResourceType, and ContextParams via its getter methods
	{
		params := map[string]string{
			"version": "v1",
			"stage":   "canary",
		}
		rn := &corev3.ResourceName{
			Id:           "listener-http-8080",
			Authority:    "example.com",
			ResourceType: "envoy.config.listener.v3.Listener",
			Context: &corev3.ContextParams{
				Params: params,
			},
		}

		if rn.GetId() != "listener-http-8080" {
			fmt.Fprintf(os.Stderr, "Assertion 1 failed: expected id %q, got %q\n", "listener-http-8080", rn.GetId())
			os.Exit(1)
		}
		if rn.GetAuthority() != "example.com" {
			fmt.Fprintf(os.Stderr, "Assertion 1 failed: expected authority %q, got %q\n", "example.com", rn.GetAuthority())
			os.Exit(1)
		}
		if rn.GetResourceType() != "envoy.config.listener.v3.Listener" {
			fmt.Fprintf(os.Stderr, "Assertion 1 failed: expected resource_type %q, got %q\n", "envoy.config.listener.v3.Listener", rn.GetResourceType())
			os.Exit(1)
		}
		if rn.GetContext() == nil {
			fmt.Fprintf(os.Stderr, "Assertion 1 failed: expected non-nil Context\n")
			os.Exit(1)
		}
		gotParams := rn.GetContext().GetParams()
		if gotParams["version"] != "v1" || gotParams["stage"] != "canary" {
			fmt.Fprintf(os.Stderr, "Assertion 1 failed: context params mismatch: %v\n", gotParams)
			os.Exit(1)
		}
	}

	// Assertion 2: ResourceName getter methods safely return default zero values when called on a nil ResourceName pointer
	{
		var nilRn *corev3.ResourceName
		if nilRn.GetId() != "" {
			fmt.Fprintf(os.Stderr, "Assertion 2 failed: nil pointer GetId() did not return empty string\n")
			os.Exit(1)
		}
		if nilRn.GetAuthority() != "" {
			fmt.Fprintf(os.Stderr, "Assertion 2 failed: nil pointer GetAuthority() did not return empty string\n")
			os.Exit(1)
		}
		if nilRn.GetResourceType() != "" {
			fmt.Fprintf(os.Stderr, "Assertion 2 failed: nil pointer GetResourceType() did not return empty string\n")
			os.Exit(1)
		}
		if nilRn.GetContext() != nil {
			fmt.Fprintf(os.Stderr, "Assertion 2 failed: nil pointer GetContext() did not return nil\n")
			os.Exit(1)
		}
	}

	// Assertion 3: ResourceName.Validate requires ResourceType to have at least one character and returns a validation error when empty
	{
		invalidRn := &corev3.ResourceName{
			Id:           "resource-without-type",
			Authority:    "example.com",
			ResourceType: "",
		}
		if err := invalidRn.Validate(); err == nil {
			fmt.Fprintf(os.Stderr, "Assertion 3 failed: expected validation error when ResourceType is empty, got nil\n")
			os.Exit(1)
		}

		validRn := &corev3.ResourceName{
			Id:           "valid-resource",
			Authority:    "example.com",
			ResourceType: "type.example.com/ResourceType",
		}
		if err := validRn.Validate(); err != nil {
			fmt.Fprintf(os.Stderr, "Assertion 3 failed: unexpected error for valid ResourceName: %v\n", err)
			os.Exit(1)
		}
	}

	// Assertion 4: ResourceName serializes and deserializes accurately with protobuf binary wire format preserving all fields and context parameters
	{
		orig := &corev3.ResourceName{
			Id:           "route-config-42",
			Authority:    "controlplane.example.com",
			ResourceType: "envoy.config.route.v3.RouteConfiguration",
			Context: &corev3.ContextParams{
				Params: map[string]string{
					"zone": "zone-a",
					"role": "gateway",
				},
			},
		}

		data, err := proto.Marshal(orig)
		if err != nil {
			fmt.Fprintf(os.Stderr, "Assertion 4 failed: proto.Marshal error: %v\n", err)
			os.Exit(1)
		}

		cloned := &corev3.ResourceName{}
		if err := proto.Unmarshal(data, cloned); err != nil {
			fmt.Fprintf(os.Stderr, "Assertion 4 failed: proto.Unmarshal error: %v\n", err)
			os.Exit(1)
		}

		if !proto.Equal(orig, cloned) {
			fmt.Fprintf(os.Stderr, "Assertion 4 failed: unmarshaled message does not match original\n")
			os.Exit(1)
		}
	}

	// Assertion 5: ResourceName.Reset clears all fields back to their zero values
	{
		rn := &corev3.ResourceName{
			Id:           "temp-id",
			Authority:    "temp-authority",
			ResourceType: "temp-type",
			Context: &corev3.ContextParams{
				Params: map[string]string{"k": "v"},
			},
		}
		rn.Reset()
		if rn.GetId() != "" || rn.GetAuthority() != "" || rn.GetResourceType() != "" || rn.GetContext() != nil {
			fmt.Fprintf(os.Stderr, "Assertion 5 failed: Reset did not restore fields to zero values\n")
			os.Exit(1)
		}
	}

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