github.com/cncf/udpa/go v0.0.0-20201120205902-5459f2c99403

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-20201120205902-5459f2c99403
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/github.com/cncf/udpa/go@v0.0.0-20201120205902-5459f2c99403

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:4d38ea1f6ccc97dc5aa5c9e854d1c36e804eb5d9191c48703f91701666b4ecc5","contract":["NewOrcaReport returns a validated OrcaLoadReport preserving CPU, memory, RPS, request cost, and utilization maps","MarshalOrcaReport and UnmarshalOrcaReport round-trip OrcaLoadReport fields through protobuf wire bytes","OrcaLoadReport.Validate accepts boundary utilization values of 0.0 and 1.0","OrcaLoadReport.Validate returns OrcaLoadReportValidationError on CpuUtilization \u003e 1.0","OrcaLoadReport.Validate returns OrcaLoadReportValidationError on MemUtilization \u003e 1.0 or Utilization entry \u003e 1.0"],"goal":"verify pkg:golang/github.com/cncf/udpa/go@v0.0.0-20201120205902-5459f2c99403","kind":"HOW","packages":["pkg:golang/github.com/cncf/udpa/go@v0.0.0-20201120205902-5459f2c99403"],"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-20201120205902-5459f2c99403"],"schemaVersion":1,"subject":"pkg:golang/github.com/cncf/udpa/go@v0.0.0-20201120205902-5459f2c99403","verifierAdapter":"golang@1"}

module sample

go 1.26.6

require github.com/cncf/udpa/go v0.0.0-20201120205902-5459f2c99403

require (
	github.com/envoyproxy/protoc-gen-validate v0.1.0 // indirect
	github.com/golang/protobuf v1.3.2 // 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-20201120205902-5459f2c99403 h1:cqQfy1jclcSy/FwLjemeg3SR1yaINm74aQyupQ0Bl8M=
github.com/cncf/udpa/go v0.0.0-20201120205902-5459f2c99403/go.mod h1:WmhPx2Nbnhtbo57+VJT5O0JRkEi1Wbu0z5j0R8u5Hbk=
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"
)

// NewOrcaReport creates and validates an OrcaLoadReport with CPU, memory, RPS, request cost, and named utilization metrics.
func NewOrcaReport(cpu, mem float64, rps uint64, requestCost, utilization map[string]float64) (*orca.OrcaLoadReport, error) {
	report := &orca.OrcaLoadReport{
		CpuUtilization: cpu,
		MemUtilization: mem,
		Rps:            rps,
		RequestCost:    requestCost,
		Utilization:    utilization,
	}
	if err := report.Validate(); err != nil {
		return nil, fmt.Errorf("invalid load report: %w", err)
	}
	return report, nil
}

// MarshalOrcaReport validates and serializes an OrcaLoadReport into deterministic protobuf wire bytes.
func MarshalOrcaReport(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 report.XXX_Marshal(nil, true)
}

// UnmarshalOrcaReport deserializes protobuf wire bytes into an OrcaLoadReport and validates its constraints.
func UnmarshalOrcaReport(wire []byte) (*orca.OrcaLoadReport, error) {
	var report orca.OrcaLoadReport
	if err := report.XXX_Unmarshal(wire); 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-20201120205902-5459f2c99403",
  "kind": "HOW",
  "packages": [
    "pkg:golang/github.com/cncf/udpa/go@v0.0.0-20201120205902-5459f2c99403"
  ]
}

package main

import (
	"errors"
	"fmt"
	"os"

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

func main() {
	// 1. NewOrcaReport returns a validated OrcaLoadReport preserving CPU, memory, RPS, request cost, and utilization maps
	reqCost := map[string]float64{"db_query": 0.012}
	util := map[string]float64{"gpu": 0.75}
	report, err := sample.NewOrcaReport(0.65, 0.45, 1500, reqCost, util)
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL assertion 1: unexpected error: %v\n", err)
		os.Exit(1)
	}
	if report.GetCpuUtilization() != 0.65 ||
		report.GetMemUtilization() != 0.45 ||
		report.GetRps() != 1500 ||
		report.GetRequestCost()["db_query"] != 0.012 ||
		report.GetUtilization()["gpu"] != 0.75 {
		fmt.Fprintf(os.Stderr, "FAIL assertion 1: getters did not match input values\n")
		os.Exit(1)
	}

	// 2. MarshalOrcaReport and UnmarshalOrcaReport round-trip OrcaLoadReport fields through protobuf wire bytes
	wire, err := sample.MarshalOrcaReport(report)
	if err != nil || len(wire) == 0 {
		fmt.Fprintf(os.Stderr, "FAIL assertion 2: marshal failed: %v\n", err)
		os.Exit(1)
	}
	decoded, err := sample.UnmarshalOrcaReport(wire)
	if err != nil {
		fmt.Fprintf(os.Stderr, "FAIL assertion 2: unmarshal failed: %v\n", err)
		os.Exit(1)
	}
	if decoded.GetCpuUtilization() != 0.65 ||
		decoded.GetMemUtilization() != 0.45 ||
		decoded.GetRps() != 1500 ||
		decoded.GetRequestCost()["db_query"] != 0.012 ||
		decoded.GetUtilization()["gpu"] != 0.75 {
		fmt.Fprintf(os.Stderr, "FAIL assertion 2: round-trip fields mismatch\n")
		os.Exit(1)
	}

	// 3. OrcaLoadReport.Validate accepts boundary utilization values of 0.0 and 1.0
	boundary, err := sample.NewOrcaReport(1.0, 0.0, 0, nil, map[string]float64{"disk": 1.0, "net": 0.0})
	if err != nil || boundary == nil {
		fmt.Fprintf(os.Stderr, "FAIL assertion 3: expected boundary 0.0 and 1.0 to pass: %v\n", err)
		os.Exit(1)
	}

	// 4. OrcaLoadReport.Validate returns OrcaLoadReportValidationError on CpuUtilization > 1.0
	_, err = sample.NewOrcaReport(1.05, 0.5, 100, nil, nil)
	var valErr orca.OrcaLoadReportValidationError
	if err == nil || !errors.As(err, &valErr) || valErr.Field() != "CpuUtilization" {
		fmt.Fprintf(os.Stderr, "FAIL assertion 4: expected OrcaLoadReportValidationError on CpuUtilization, got: %v\n", err)
		os.Exit(1)
	}

	// 5. OrcaLoadReport.Validate returns OrcaLoadReportValidationError on MemUtilization > 1.0 or Utilization entry > 1.0
	_, err = sample.NewOrcaReport(0.5, 1.2, 100, nil, nil)
	if err == nil || !errors.As(err, &valErr) || valErr.Field() != "MemUtilization" {
		fmt.Fprintf(os.Stderr, "FAIL assertion 5a: expected OrcaLoadReportValidationError on MemUtilization, got: %v\n", err)
		os.Exit(1)
	}
	_, err = sample.NewOrcaReport(0.5, 0.5, 100, nil, map[string]float64{"gpu": 1.1})
	if err == nil || !errors.As(err, &valErr) || valErr.Field() != "Utilization[gpu]" {
		fmt.Fprintf(os.Stderr, "FAIL assertion 5b: expected OrcaLoadReportValidationError on Utilization[gpu], got: %v\n", err)
		os.Exit(1)
	}

	fmt.Println("PASS")
}