github.com/cncf/udpa/go v0.0.0-20191209042840-269d4d468f6f

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/cncf/udpa/go@v0.0.0-20191209042840-269d4d468f6f
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/cncf/udpa/go@v0.0.0-20191209042840-269d4d468f6f

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:dfd3d2373aab6d73c5734756400e6796fbf205acf07aa975f3900634748b9a5d","contract":["CreateLoadReport returns a valid OrcaLoadReport when metrics are within normal bounds","EncodeLoadReport encodes to bytes and DecodeLoadReport restores identical fields","OrcaLoadReport Validate succeeds for metric boundaries at 0.0 and 1.0","CreateLoadReport rejects CPU utilization exceeding 1.0","CreateLoadReport rejects memory utilization exceeding 1.0"],"goal":"verify pkg:golang/github.com/cncf/udpa/go@v0.0.0-20191209042840-269d4d468f6f","kind":"HOW","packages":["pkg:golang/github.com/cncf/udpa/go@v0.0.0-20191209042840-269d4d468f6f"],"schemaVersion":1},"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/udpa/go@v0.0.0-20191209042840-269d4d468f6f"],"schemaVersion":1,"subject":"pkg:golang/github.com/cncf/udpa/go@v0.0.0-20191209042840-269d4d468f6f","verifierAdapter":"golang@1"}

module sample

go 1.26.6

require (
	github.com/cncf/udpa/go v0.0.0-20191209042840-269d4d468f6f
	github.com/golang/protobuf v1.3.2
)

require github.com/envoyproxy/protoc-gen-validate v0.1.0 // indirect

cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw=
github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU=
github.com/census-instrumentation/opencensus-proto v0.2.1/go.mod h1:f6KPmirojxKA12rnyqOA5BBL4O983OfeGPqjHWSTneU=
github.com/client9/misspell v0.3.4/go.mod h1:qj6jICC3Q7zFZvVWo7KLAzC3yx5G7kyvSDkc90ppPyw=
github.com/cncf/udpa/go v0.0.0-20191209042840-269d4d468f6f h1:WBZRG4aNOuI15bLRrCgN8fCq8E5Xuty6jGbmSNEvSsU=
github.com/cncf/udpa/go v0.0.0-20191209042840-269d4d468f6f/go.mod h1:M8M6+tZqaGXZJjfX53e64911xZQV5JYwmTeXPW+k8Sc=
github.com/envoyproxy/go-control-plane v0.9.0/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4=
github.com/envoyproxy/protoc-gen-validate v0.1.0 h1:EQciDnbrYxy13PgWoY8AqoxGiPrpgBZ1R8UNe3ddc+A=
github.com/envoyproxy/protoc-gen-validate v0.1.0/go.mod h1:iSmxcyjqTsJpI2R4NaDN7+kN2VEUnK/pcBlmesArF7c=
github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b/go.mod h1:SBH7ygxi8pfUlaOkMMuAQtPIUF8ecWP5IEl/CR7VP2Q=
github.com/golang/mock v1.1.1/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A=
github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
github.com/golang/protobuf v1.3.2 h1:6nsPYzhq5kReh6QImI3k5qWzO4PEbvbIW2cwSfR/6xs=
github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
github.com/google/go-cmp v0.2.0/go.mod h1:oXzfMopK8JAjlY9xF4vHSVASa0yLyX7SntLO5aqRK0M=
github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA=
golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
golang.org/x/lint v0.0.0-20181026193005-c67002cb31c3/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE=
golang.org/x/lint v0.0.0-20190227174305-5b3e6a55c961/go.mod h1:wehouNa3lNwaWXcvxsM5YxQ5yQlVC4a0KAMCusXpPoU=
golang.org/x/lint v0.0.0-20190313153728-d0100b6bd8b3/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc=
golang.org/x/net v0.0.0-20180724234803-3673e40ba225/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
golang.org/x/net v0.0.0-20180826012351-8a410e7b638d/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
golang.org/x/net v0.0.0-20190213061140-3a22650c66bd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U=
golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
golang.org/x/tools v0.0.0-20190114222345-bf090417da8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
golang.org/x/tools v0.0.0-20190226205152-f727befe758c/go.mod h1:9Yl7xja0Znq3iFh3HoIrodX9oNMXvdceNzlUR8zjMvY=
golang.org/x/tools v0.0.0-20190311212946-11955173bddd/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs=
golang.org/x/tools v0.0.0-20190524140312-2c0ae7006135/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q=
google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM=
google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4=
google.golang.org/genproto v0.0.0-20180817151627-c66870c02cf8/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc=
google.golang.org/genproto v0.0.0-20190819201941-24fa4b261c55/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc=
google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c=
google.golang.org/grpc v1.23.0/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg=
google.golang.org/grpc v1.25.1/go.mod h1:c3i+UQWmh7LiEpx4sFZnkU36qjEYZ0imhYfXVyQciAY=
honnef.co/go/tools v0.0.0-20190102054323-c2f93a96b099/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=
honnef.co/go/tools v0.0.0-20190523083050-ea95bdfd59fc/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=

package sample

import (
	"errors"
	"fmt"

	orca "github.com/cncf/udpa/go/udpa/data/orca/v1"
	"github.com/golang/protobuf/proto"
)

// CreateLoadReport creates an OrcaLoadReport and validates its field constraints.
func CreateLoadReport(cpu, mem float64, rps uint64) (*orca.OrcaLoadReport, error) {
	report := &orca.OrcaLoadReport{
		CpuUtilization: cpu,
		MemUtilization: mem,
		Rps:            rps,
	}
	if err := report.Validate(); err != nil {
		return nil, fmt.Errorf("invalid load report: %w", err)
	}
	return report, nil
}

// EncodeLoadReport serializes an OrcaLoadReport to protobuf bytes after validation.
func EncodeLoadReport(report *orca.OrcaLoadReport) ([]byte, error) {
	if report == nil {
		return nil, errors.New("report cannot be nil")
	}
	if err := report.Validate(); err != nil {
		return nil, fmt.Errorf("invalid load report: %w", err)
	}
	return proto.Marshal(report)
}

// DecodeLoadReport deserializes protobuf bytes into an OrcaLoadReport and validates it.
func DecodeLoadReport(data []byte) (*orca.OrcaLoadReport, error) {
	var report orca.OrcaLoadReport
	if err := proto.Unmarshal(data, &report); err != nil {
		return nil, fmt.Errorf("failed to unmarshal load report: %w", err)
	}
	if err := report.Validate(); err != nil {
		return nil, fmt.Errorf("unmarshaled report is invalid: %w", err)
	}
	return &report, nil
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:golang/github.com/cncf/udpa/go@v0.0.0-20191209042840-269d4d468f6f",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/cncf/udpa/go@v0.0.0-20191209042840-269d4d468f6f"
  ]
}

package main

import (
	"fmt"
	"os"

	orca "github.com/cncf/udpa/go/udpa/data/orca/v1"
	"sample"
)

func main() {
	// Assertion 1: CreateLoadReport returns a valid OrcaLoadReport when metrics are within normal bounds
	report, err := sample.CreateLoadReport(0.65, 0.45, 1200)
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL assertion 1: expected valid report, got: %v\n", err)
		os.Exit(1)
	}
	if report.GetCpuUtilization() != 0.65 || report.GetMemUtilization() != 0.45 || report.GetRps() != 1200 {
		fmt.Fprintf(os.Stderr, "FAIL assertion 1: fields do not match expected values\n")
		os.Exit(1)
	}

	// Assertion 2: EncodeLoadReport encodes to bytes and DecodeLoadReport restores identical fields
	encoded, err := sample.EncodeLoadReport(report)
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL assertion 2: encode error: %v\n", err)
		os.Exit(1)
	}
	decoded, err := sample.DecodeLoadReport(encoded)
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL assertion 2: decode error: %v\n", err)
		os.Exit(1)
	}
	if decoded.GetCpuUtilization() != 0.65 || decoded.GetMemUtilization() != 0.45 || decoded.GetRps() != 1200 {
		fmt.Fprintf(os.Stderr, "FAIL assertion 2: decoded fields mismatch\n")
		os.Exit(1)
	}

	// Assertion 3: OrcaLoadReport Validate succeeds for metric boundaries at 0.0 and 1.0
	boundaryReport := &orca.OrcaLoadReport{
		CpuUtilization: 1.0,
		MemUtilization: 0.0,
		Rps:            0,
	}
	if err := boundaryReport.Validate(); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL assertion 3: boundary values should be valid: %v\n", err)
		os.Exit(1)
	}

	// Assertion 4: CreateLoadReport rejects CPU utilization exceeding 1.0
	_, err = sample.CreateLoadReport(1.05, 0.5, 100)
	if err == nil {
		fmt.Fprintf(os.Stderr, "FAIL assertion 4: expected error for CPU utilization > 1.0, got nil\n")
		os.Exit(1)
	}

	// Assertion 5: CreateLoadReport rejects memory utilization exceeding 1.0
	_, err = sample.CreateLoadReport(0.5, 1.1, 100)
	if err == nil {
		fmt.Fprintf(os.Stderr, "FAIL assertion 5: expected error for memory utilization > 1.0, got nil\n")
		os.Exit(1)
	}

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