google.golang.org/genproto/googleapis/rpc v0.0.0-20250728155136-f173205681a0

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/google.golang.org/genproto/googleapis/rpc@v0.0.0-20250728155136-f173205681a0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20250728155136-f173205681a0

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:123262bc17efaf911a6ab57b8f8f756e096fa06f8a94b730b0975f8fa0c44d3b","contract":["status.Status stores Code, Message, and Details, accessible via GetCode, GetMessage, and GetDetails getters.","status.Status getters return safe zero values when called on nil or zero-initialized Status receivers.","code.Code enum constants match standard gRPC status codes and provide string representations.","status.Status serializes and deserializes accurately with proto.Marshal and proto.Unmarshal, preserving all message fields.","status.Status messages support deep copying with proto.Clone, semantic equality with proto.Equal, and field clearing via Reset."],"goal":"verify pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20250728155136-f173205681a0","kind":"HOW","packages":["pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20250728155136-f173205681a0"],"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/google.golang.org/genproto/googleapis/rpc@v0.0.0-20250728155136-f173205681a0"],"schemaVersion":1,"subject":"pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20250728155136-f173205681a0","verifierAdapter":"golang@1"}

module sample

go 1.26.6

require (
	google.golang.org/genproto/googleapis/rpc v0.0.0-20250728155136-f173205681a0
	google.golang.org/protobuf v1.36.12
)

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-20250728155136-f173205681a0 h1:MAKi5q709QWfnkkpNQ0M12hYJ1+e8qYVDyowc4U1XZM=
google.golang.org/genproto/googleapis/rpc v0.0.0-20250728155136-f173205681a0/go.mod h1:qQ0YXyHHx3XkvlzUtpXDkS29lDSafHMZBAZDc03LQ3A=
google.golang.org/protobuf v1.36.12 h1:pJOKDDOyeXErUroCihFAd5LQuwXBSpVnKGrj5o/fwxc=
google.golang.org/protobuf v1.36.12/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=

package main

import (
	"fmt"

	"google.golang.org/genproto/googleapis/rpc/code"
	"google.golang.org/genproto/googleapis/rpc/status"
	"google.golang.org/protobuf/proto"
)

func main() {
	st := &status.Status{
		Code:    int32(code.Code_NOT_FOUND),
		Message: "entity does not exist",
	}

	fmt.Printf("Status Code: %d (%s)\n", st.GetCode(), code.Code(st.GetCode()).String())
	fmt.Printf("Status Message: %s\n", st.GetMessage())

	data, err := proto.Marshal(st)
	if err != nil {
		panic(err)
	}

	var decoded status.Status
	if err := proto.Unmarshal(data, &decoded); err != nil {
		panic(err)
	}

	fmt.Printf("Decoded Status Code: %d, Message: %s\n", decoded.GetCode(), decoded.GetMessage())
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20250728155136-f173205681a0",
  "kind": "HOW",
  "packages": [
    "pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20250728155136-f173205681a0"
  ]
}

package main

import (
	"fmt"
	"os"

	"google.golang.org/genproto/googleapis/rpc/code"
	"google.golang.org/genproto/googleapis/rpc/status"
	"google.golang.org/protobuf/proto"
)

func main() {
	// Assertion 1: status.Status stores Code, Message, and Details, accessible via GetCode, GetMessage, and GetDetails getters.
	{
		st := &status.Status{
			Code:    int32(code.Code_INVALID_ARGUMENT),
			Message: "invalid argument provided",
		}
		if got := st.GetCode(); got != int32(code.Code_INVALID_ARGUMENT) {
			fmt.Fprintf(os.Stderr, "FAIL: GetCode() = %d, want %d\n", got, int32(code.Code_INVALID_ARGUMENT))
			os.Exit(1)
		}
		if got := st.GetMessage(); got != "invalid argument provided" {
			fmt.Fprintf(os.Stderr, "FAIL: GetMessage() = %q, want %q\n", got, "invalid argument provided")
			os.Exit(1)
		}
		if got := st.GetDetails(); len(got) != 0 {
			fmt.Fprintf(os.Stderr, "FAIL: GetDetails() length = %d, want 0\n", len(got))
			os.Exit(1)
		}
	}

	// Assertion 2: status.Status getters return safe zero values when called on nil or zero-initialized Status receivers.
	{
		var nilStatus *status.Status
		if got := nilStatus.GetCode(); got != 0 {
			fmt.Fprintf(os.Stderr, "FAIL: nil.GetCode() = %d, want 0\n", got)
			os.Exit(1)
		}
		if got := nilStatus.GetMessage(); got != "" {
			fmt.Fprintf(os.Stderr, "FAIL: nil.GetMessage() = %q, want empty string\n", got)
			os.Exit(1)
		}
		if got := nilStatus.GetDetails(); got != nil {
			fmt.Fprintf(os.Stderr, "FAIL: nil.GetDetails() = %v, want nil\n", got)
			os.Exit(1)
		}

		zeroStatus := &status.Status{}
		if got := zeroStatus.GetCode(); got != 0 {
			fmt.Fprintf(os.Stderr, "FAIL: zero.GetCode() = %d, want 0\n", got)
			os.Exit(1)
		}
		if got := zeroStatus.GetMessage(); got != "" {
			fmt.Fprintf(os.Stderr, "FAIL: zero.GetMessage() = %q, want empty string\n", got)
			os.Exit(1)
		}
		if got := zeroStatus.GetDetails(); got != nil {
			fmt.Fprintf(os.Stderr, "FAIL: zero.GetDetails() = %v, want nil\n", got)
			os.Exit(1)
		}
	}

	// Assertion 3: code.Code enum constants match standard gRPC status codes and provide string representations.
	{
		if code.Code_OK != 0 {
			fmt.Fprintf(os.Stderr, "FAIL: Code_OK = %d, want 0\n", code.Code_OK)
			os.Exit(1)
		}
		if code.Code_INVALID_ARGUMENT != 3 {
			fmt.Fprintf(os.Stderr, "FAIL: Code_INVALID_ARGUMENT = %d, want 3\n", code.Code_INVALID_ARGUMENT)
			os.Exit(1)
		}
		if code.Code_NOT_FOUND != 5 {
			fmt.Fprintf(os.Stderr, "FAIL: Code_NOT_FOUND = %d, want 5\n", code.Code_NOT_FOUND)
			os.Exit(1)
		}
		if got := code.Code_NOT_FOUND.String(); got != "NOT_FOUND" {
			fmt.Fprintf(os.Stderr, "FAIL: Code_NOT_FOUND.String() = %q, want NOT_FOUND\n", got)
			os.Exit(1)
		}
		if got := code.Code_name[int32(code.Code_OK)]; got != "OK" {
			fmt.Fprintf(os.Stderr, "FAIL: Code_name[0] = %q, want OK\n", got)
			os.Exit(1)
		}
	}

	// Assertion 4: status.Status serializes and deserializes accurately with proto.Marshal and proto.Unmarshal, preserving all message fields.
	{
		original := &status.Status{
			Code:    int32(code.Code_NOT_FOUND),
			Message: "item was not found in storage",
		}

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

		var decoded status.Status
		if err := proto.Unmarshal(data, &decoded); err != nil {
			fmt.Fprintf(os.Stderr, "FAIL: proto.Unmarshal failed: %v\n", err)
			os.Exit(1)
		}

		if !proto.Equal(original, &decoded) {
			fmt.Fprintf(os.Stderr, "FAIL: unmarshaled status does not match original: got %+v, want %+v\n", &decoded, original)
			os.Exit(1)
		}
		if decoded.GetCode() != original.GetCode() {
			fmt.Fprintf(os.Stderr, "FAIL: decoded Code = %d, want %d\n", decoded.GetCode(), original.GetCode())
			os.Exit(1)
		}
		if decoded.GetMessage() != original.GetMessage() {
			fmt.Fprintf(os.Stderr, "FAIL: decoded Message = %q, want %q\n", decoded.GetMessage(), original.GetMessage())
			os.Exit(1)
		}
	}

	// Assertion 5: status.Status messages support deep copying with proto.Clone, semantic equality with proto.Equal, and field clearing via Reset.
	{
		original := &status.Status{
			Code:    int32(code.Code_PERMISSION_DENIED),
			Message: "access denied to resource",
		}

		cloned, ok := proto.Clone(original).(*status.Status)
		if !ok || !proto.Equal(original, cloned) {
			fmt.Fprintf(os.Stderr, "FAIL: cloned status not equal to original\n")
			os.Exit(1)
		}

		cloned.Message = "modified message"
		if proto.Equal(original, cloned) {
			fmt.Fprintf(os.Stderr, "FAIL: expected statuses to differ after modifying clone\n")
			os.Exit(1)
		}

		original.Reset()
		if original.GetCode() != 0 {
			fmt.Fprintf(os.Stderr, "FAIL: after Reset, GetCode() = %d, want 0\n", original.GetCode())
			os.Exit(1)
		}
		if original.GetMessage() != "" {
			fmt.Fprintf(os.Stderr, "FAIL: after Reset, GetMessage() = %q, want empty string\n", original.GetMessage())
			os.Exit(1)
		}
	}

	fmt.Println("PASS: google.golang.org/genproto/googleapis/rpc contract passed")
}