google.golang.org/genproto/googleapis/rpc v0.0.0-20260904194346-d0f1323225a4: code.Code_name

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 google.golang.org/genproto/googleapis/rpc/code.Code_name in pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20260904194346-d0f1323225a4
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20260904194346-d0f1323225a4
Demonstrate these symbols/APIs:
  - google.golang.org/genproto/googleapis/rpc/code.Code_name

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.

package sample

import (
	"google.golang.org/genproto/googleapis/rpc/code"
)

// CodeName returns the canonical protobuf string representation for a given RPC code.
func CodeName(c code.Code) (string, bool) {
	name, ok := code.Code_name[int32(c)]
	return name, ok
}

// AllCodeNames returns a copy of the Code_name map.
func AllCodeNames() map[int32]string {
	result := make(map[int32]string, len(code.Code_name))
	for k, v := range code.Code_name {
		result[k] = v
	}
	return result
}

{"case":{"caseId":"case:sha256:82e437233792dbfa740a5c7033289665e005729927fe1db78fd7add0fc2a4a2f","contract":["code.Code_name is a non-nil map from int32 to string","code.Code_name maps Code_OK (0) to \"OK\"","code.Code_name maps Code_INVALID_ARGUMENT (3) to \"INVALID_ARGUMENT\"","code.Code_name maps Code_UNAUTHENTICATED (16) to \"UNAUTHENTICATED\"","code.Code_name contains 17 canonical RPC code entries","code.Code_name does not contain unassigned code values","sample.CodeName returns the correct name for valid Code values","sample.CodeName returns false for invalid Code values","sample.AllCodeNames returns a map copy matching Code_name"],"goal":"verify google.golang.org/genproto/googleapis/rpc/code.Code_name in pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20260904194346-d0f1323225a4","kind":"HOW","packages":["pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20260904194346-d0f1323225a4"],"schemaVersion":1,"symbols":["google.golang.org/genproto/googleapis/rpc/code.Code_name"]},"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/google.golang.org/genproto/googleapis/rpc@v0.0.0-20260904194346-d0f1323225a4"],"schemaVersion":1,"subject":"pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20260904194346-d0f1323225a4","symbols":["google.golang.org/genproto/googleapis/rpc/code.Code_name"],"verifierAdapter":"golang@1"}

module sample

go 1.26.6

require google.golang.org/genproto/googleapis/rpc v0.0.0-20260904194346-d0f1323225a4

require google.golang.org/protobuf v1.36.12 // indirect

github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
google.golang.org/genproto/googleapis/rpc v0.0.0-20260904194346-d0f1323225a4 h1:5t+ZydAFj5kGVLrgCvLmpmCf9ylGRd64hpEronfRaws=
google.golang.org/genproto/googleapis/rpc v0.0.0-20260904194346-d0f1323225a4/go.mod h1:DjtHYE8FKJLivXcBEjGwndXfIC23G0VpXiXKqG179uA=
google.golang.org/protobuf v1.36.12 h1:pJOKDDOyeXErUroCihFAd5LQuwXBSpVnKGrj5o/fwxc=
google.golang.org/protobuf v1.36.12/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=

{
  "schemaVersion": 1,
  "goal": "verify google.golang.org/genproto/googleapis/rpc/code.Code_name in pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20260904194346-d0f1323225a4",
  "kind": "HOW",
  "packages": [
    "pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20260904194346-d0f1323225a4"
  ],
  "symbols": [
    "google.golang.org/genproto/googleapis/rpc/code.Code_name"
  ]
}

package main

import (
	"fmt"
	"os"

	"google.golang.org/genproto/googleapis/rpc/code"
	"sample"
)

func main() {
	// Assertion 1: Code_name is a non-nil map from int32 to string
	if code.Code_name == nil {
		fmt.Fprintf(os.Stderr, "expected code.Code_name to be non-nil\n")
		os.Exit(1)
	}

	// Assertion 2: Code_name maps Code_OK (0) to "OK"
	if name, ok := code.Code_name[int32(code.Code_OK)]; !ok || name != "OK" {
		fmt.Fprintf(os.Stderr, "expected Code_name[0] to be \"OK\", got %q (ok=%v)\n", name, ok)
		os.Exit(1)
	}

	// Assertion 3: Code_name maps Code_INVALID_ARGUMENT (3) to "INVALID_ARGUMENT"
	if name, ok := code.Code_name[int32(code.Code_INVALID_ARGUMENT)]; !ok || name != "INVALID_ARGUMENT" {
		fmt.Fprintf(os.Stderr, "expected Code_name[3] to be \"INVALID_ARGUMENT\", got %q (ok=%v)\n", name, ok)
		os.Exit(1)
	}

	// Assertion 4: Code_name maps Code_UNAUTHENTICATED (16) to "UNAUTHENTICATED"
	if name, ok := code.Code_name[int32(code.Code_UNAUTHENTICATED)]; !ok || name != "UNAUTHENTICATED" {
		fmt.Fprintf(os.Stderr, "expected Code_name[16] to be \"UNAUTHENTICATED\", got %q (ok=%v)\n", name, ok)
		os.Exit(1)
	}

	// Assertion 5: Code_name contains 17 canonical RPC code entries
	if len(code.Code_name) != 17 {
		fmt.Fprintf(os.Stderr, "expected Code_name to contain 17 entries, got %d\n", len(code.Code_name))
		os.Exit(1)
	}

	// Assertion 6: Code_name does not contain unassigned code values
	if _, ok := code.Code_name[-1]; ok {
		fmt.Fprintf(os.Stderr, "expected Code_name[-1] to be absent\n")
		os.Exit(1)
	}
	if _, ok := code.Code_name[999]; ok {
		fmt.Fprintf(os.Stderr, "expected Code_name[999] to be absent\n")
		os.Exit(1)
	}

	// Assertion 7: sample.CodeName returns the correct name for valid Code values
	if name, ok := sample.CodeName(code.Code_NOT_FOUND); !ok || name != "NOT_FOUND" {
		fmt.Fprintf(os.Stderr, "expected sample.CodeName(Code_NOT_FOUND) to be (\"NOT_FOUND\", true), got (%q, %v)\n", name, ok)
		os.Exit(1)
	}

	// Assertion 8: sample.CodeName returns false for invalid Code values
	if _, ok := sample.CodeName(code.Code(999)); ok {
		fmt.Fprintf(os.Stderr, "expected sample.CodeName(999) to return ok=false\n")
		os.Exit(1)
	}

	// Assertion 9: sample.AllCodeNames returns a map copy matching Code_name
	all := sample.AllCodeNames()
	if len(all) != len(code.Code_name) {
		fmt.Fprintf(os.Stderr, "expected sample.AllCodeNames() length %d, got %d\n", len(code.Code_name), len(all))
		os.Exit(1)
	}
	for k, v := range code.Code_name {
		if all[k] != v {
			fmt.Fprintf(os.Stderr, "mismatch in AllCodeNames for key %d: expected %q, got %q\n", k, v, all[k])
			os.Exit(1)
		}
	}

	fmt.Println("All google.golang.org/genproto/googleapis/rpc/code.Code_name contract assertions passed.")
}