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

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/udpa/go/udpa/data/orca/v1.OrcaLoadReport in 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
Demonstrate these symbols/APIs:
  - github.com/cncf/udpa/go/udpa/data/orca/v1.OrcaLoadReport

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:f0588c4383220e89a8f865d4449a645f8818494b528703cff3927c45bdf8a8e5","contract":["OrcaLoadReport instantiation and getters accurately reflect configured CpuUtilization, MemUtilization, Rps, RequestCost, and Utilization values","OrcaLoadReport.Validate succeeds when CpuUtilization, MemUtilization, and Utilization values are within the valid range [0, 1]","OrcaLoadReport.Validate returns an OrcaLoadReportValidationError when CpuUtilization exceeds 1.0","OrcaLoadReport.Validate returns an OrcaLoadReportValidationError when MemUtilization exceeds 1.0","OrcaLoadReport.Validate returns an OrcaLoadReportValidationError when any Utilization map value exceeds 1.0","OrcaLoadReport serializes to protobuf binary and unmarshals back preserving all field values"],"goal":"verify github.com/cncf/udpa/go/udpa/data/orca/v1.OrcaLoadReport in 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,"symbols":["github.com/cncf/udpa/go/udpa/data/orca/v1.OrcaLoadReport"]},"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","symbols":["github.com/cncf/udpa/go/udpa/data/orca/v1.OrcaLoadReport"],"verifierAdapter":"golang@1"}

module example.com/orcaloadreport

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 main

import (
	"fmt"
	"os"

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

func main() {
	report := &orcapb.OrcaLoadReport{
		CpuUtilization: 0.75,
		MemUtilization: 0.50,
		Rps:            1200,
		RequestCost: map[string]float64{
			"db_query": 0.04,
		},
		Utilization: map[string]float64{
			"custom_resource": 0.85,
		},
	}

	if err := report.Validate(); err != nil {
		fmt.Fprintf(os.Stderr, "validation failed: %v\n", err)
		os.Exit(1)
	}

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

	var parsed orcapb.OrcaLoadReport
	if err := proto.Unmarshal(data, &parsed); err != nil {
		fmt.Fprintf(os.Stderr, "unmarshal failed: %v\n", err)
		os.Exit(1)
	}

	fmt.Printf("OrcaLoadReport valid: CPU=%.2f Mem=%.2f RPS=%d\n",
		parsed.GetCpuUtilization(), parsed.GetMemUtilization(), parsed.GetRps())
}

{
  "schemaVersion": 1,
  "goal": "verify github.com/cncf/udpa/go/udpa/data/orca/v1.OrcaLoadReport in 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"
  ],
  "symbols": [
    "github.com/cncf/udpa/go/udpa/data/orca/v1.OrcaLoadReport"
  ]
}

package main

import (
	"errors"
	"fmt"
	"math"
	"os"

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

func main() {
	if err := runContractTests(); err != nil {
		fmt.Fprintf(os.Stderr, "Contract test failure: %v\n", err)
		os.Exit(1)
	}
	fmt.Println("All contract assertions passed.")
}

func runContractTests() error {
	// 1. OrcaLoadReport instantiation and getters accurately reflect configured CpuUtilization, MemUtilization, Rps, RequestCost, and Utilization values
	report := &orcapb.OrcaLoadReport{
		CpuUtilization: 0.65,
		MemUtilization: 0.45,
		Rps:            5000,
		RequestCost: map[string]float64{
			"compute_ms": 12.5,
		},
		Utilization: map[string]float64{
			"gpu": 0.80,
		},
	}

	if math.Abs(report.GetCpuUtilization()-0.65) > 1e-6 {
		return fmt.Errorf("unexpected CpuUtilization: got %f, want 0.65", report.GetCpuUtilization())
	}
	if math.Abs(report.GetMemUtilization()-0.45) > 1e-6 {
		return fmt.Errorf("unexpected MemUtilization: got %f, want 0.45", report.GetMemUtilization())
	}
	if report.GetRps() != 5000 {
		return fmt.Errorf("unexpected Rps: got %d, want 5000", report.GetRps())
	}
	if cost, ok := report.GetRequestCost()["compute_ms"]; !ok || math.Abs(cost-12.5) > 1e-6 {
		return fmt.Errorf("unexpected RequestCost[compute_ms]: got %v, want 12.5", cost)
	}
	if util, ok := report.GetUtilization()["gpu"]; !ok || math.Abs(util-0.80) > 1e-6 {
		return fmt.Errorf("unexpected Utilization[gpu]: got %v, want 0.80", util)
	}

	// Nil receiver safety for getters
	var nilReport *orcapb.OrcaLoadReport
	if nilReport.GetCpuUtilization() != 0 || nilReport.GetMemUtilization() != 0 || nilReport.GetRps() != 0 {
		return errors.New("nil OrcaLoadReport getters should return zero values")
	}
	if nilReport.GetRequestCost() != nil || nilReport.GetUtilization() != nil {
		return errors.New("nil OrcaLoadReport map getters should return nil")
	}

	// 2. OrcaLoadReport.Validate succeeds when CpuUtilization, MemUtilization, and Utilization values are within the valid range [0, 1]
	if err := report.Validate(); err != nil {
		return fmt.Errorf("expected valid report to pass validation, got: %w", err)
	}

	// Boundary test: exactly 1.0 should pass
	boundaryReport := &orcapb.OrcaLoadReport{
		CpuUtilization: 1.0,
		MemUtilization: 1.0,
		Utilization: map[string]float64{
			"disk": 1.0,
		},
	}
	if err := boundaryReport.Validate(); err != nil {
		return fmt.Errorf("expected boundary values 1.0 to pass validation, got: %w", err)
	}

	// 3. OrcaLoadReport.Validate returns an OrcaLoadReportValidationError when CpuUtilization exceeds 1.0
	invalidCpu := &orcapb.OrcaLoadReport{
		CpuUtilization: 1.0001,
	}
	if err := invalidCpu.Validate(); err == nil {
		return errors.New("expected CpuUtilization > 1.0 to fail validation")
	} else {
		valErr, ok := err.(orcapb.OrcaLoadReportValidationError)
		if !ok || valErr.Field() != "CpuUtilization" {
			return fmt.Errorf("expected OrcaLoadReportValidationError for field CpuUtilization, got %T: %v", err, err)
		}
	}

	// 4. OrcaLoadReport.Validate returns an OrcaLoadReportValidationError when MemUtilization exceeds 1.0
	invalidMem := &orcapb.OrcaLoadReport{
		MemUtilization: 1.5,
	}
	if err := invalidMem.Validate(); err == nil {
		return errors.New("expected MemUtilization > 1.0 to fail validation")
	} else {
		valErr, ok := err.(orcapb.OrcaLoadReportValidationError)
		if !ok || valErr.Field() != "MemUtilization" {
			return fmt.Errorf("expected OrcaLoadReportValidationError for field MemUtilization, got %T: %v", err, err)
		}
	}

	// 5. OrcaLoadReport.Validate returns an OrcaLoadReportValidationError when any Utilization map value exceeds 1.0
	invalidUtil := &orcapb.OrcaLoadReport{
		Utilization: map[string]float64{
			"gpu_mem": 1.1,
		},
	}
	if err := invalidUtil.Validate(); err == nil {
		return errors.New("expected Utilization > 1.0 to fail validation")
	} else {
		valErr, ok := err.(orcapb.OrcaLoadReportValidationError)
		if !ok || valErr.Field() != "Utilization[gpu_mem]" {
			return fmt.Errorf("expected OrcaLoadReportValidationError for field Utilization[gpu_mem], got %T: %v", err, err)
		}
	}

	// 6. OrcaLoadReport serializes to protobuf binary and unmarshals back preserving all field values
	data, err := proto.Marshal(report)
	if err != nil {
		return fmt.Errorf("failed to marshal OrcaLoadReport: %w", err)
	}

	var roundtrip orcapb.OrcaLoadReport
	if err := proto.Unmarshal(data, &roundtrip); err != nil {
		return fmt.Errorf("failed to unmarshal OrcaLoadReport: %w", err)
	}

	if math.Abs(roundtrip.GetCpuUtilization()-report.GetCpuUtilization()) > 1e-6 {
		return fmt.Errorf("roundtrip CpuUtilization mismatch: got %f, want %f", roundtrip.GetCpuUtilization(), report.GetCpuUtilization())
	}
	if math.Abs(roundtrip.GetMemUtilization()-report.GetMemUtilization()) > 1e-6 {
		return fmt.Errorf("roundtrip MemUtilization mismatch: got %f, want %f", roundtrip.GetMemUtilization(), report.GetMemUtilization())
	}
	if roundtrip.GetRps() != report.GetRps() {
		return fmt.Errorf("roundtrip Rps mismatch: got %d, want %d", roundtrip.GetRps(), report.GetRps())
	}
	if math.Abs(roundtrip.GetRequestCost()["compute_ms"]-12.5) > 1e-6 {
		return fmt.Errorf("roundtrip RequestCost mismatch")
	}
	if math.Abs(roundtrip.GetUtilization()["gpu"]-0.80) > 1e-6 {
		return fmt.Errorf("roundtrip Utilization mismatch")
	}

	return nil
}