google.golang.org/genproto/googleapis/rpc v0.0.0-20251029180050-ab9386a59fda

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-20251029180050-ab9386a59fda
Kind: HOW

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

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:02e3ab960277664b5e87d3d15459826c1acff851d990cac3dcc31ca79528333d","contract":["status.Status initializes with Code, Message, and Details containing packed errdetails.ErrorInfo, accessible via GetCode, GetMessage, and GetDetails getters.","status.Status getters return safe zero values when called on nil or zero-initialized Status receivers.","status.Status serializes and deserializes accurately with proto.Marshal and proto.Unmarshal, preserving all fields and Any details.","status.Status messages support deep copying with proto.Clone and semantic equality checks with proto.Equal.","status.Status.Reset clears all fields back to zero state."],"goal":"verify pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20251029180050-ab9386a59fda","kind":"HOW","packages":["pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20251029180050-ab9386a59fda"],"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-20251029180050-ab9386a59fda"],"schemaVersion":1,"subject":"pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20251029180050-ab9386a59fda","verifierAdapter":"golang@1"}

module sample

go 1.26.6

require (
	google.golang.org/genproto/googleapis/rpc v0.0.0-20251029180050-ab9386a59fda
	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-20251029180050-ab9386a59fda h1:i/Q+bfisr7gq6feoJnS/DlpdwEL4ihp41fvRiM3Ork0=
google.golang.org/genproto/googleapis/rpc v0.0.0-20251029180050-ab9386a59fda/go.mod h1:7i2o+ce6H/6BluujYR+kqX3GKH+dChPTQU19wjRPiGk=
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/errdetails"
	"google.golang.org/genproto/googleapis/rpc/status"
	"google.golang.org/protobuf/proto"
	"google.golang.org/protobuf/types/known/anypb"
)

func main() {
	errInfo := &errdetails.ErrorInfo{
		Reason: "RESOURCE_EXHAUSTED",
		Domain: "example.com",
		Metadata: map[string]string{
			"quota_limit": "100",
			"quota_used":  "105",
		},
	}

	anyDetail, err := anypb.New(errInfo)
	if err != nil {
		panic(err)
	}

	st := &status.Status{
		Code:    int32(code.Code_RESOURCE_EXHAUSTED),
		Message: "Quota exceeded for request",
		Details: []*anypb.Any{anyDetail},
	}

	fmt.Printf("Status Code: %d\n", st.GetCode())
	fmt.Printf("Status Message: %s\n", st.GetMessage())
	fmt.Printf("Details count: %d\n", len(st.GetDetails()))

	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-20251029180050-ab9386a59fda",
  "kind": "HOW",
  "packages": [
    "pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20251029180050-ab9386a59fda"
  ]
}

package main

import (
	"fmt"
	"os"
	"reflect"

	"google.golang.org/genproto/googleapis/rpc/code"
	"google.golang.org/genproto/googleapis/rpc/errdetails"
	"google.golang.org/genproto/googleapis/rpc/status"
	"google.golang.org/protobuf/proto"
	"google.golang.org/protobuf/types/known/anypb"
)

func main() {
	// Assertion 1: status.Status initializes with Code, Message, and Details containing packed errdetails.ErrorInfo, accessible via GetCode, GetMessage, and GetDetails getters.
	{
		errInfo := &errdetails.ErrorInfo{
			Reason: "RATE_LIMIT_EXCEEDED",
			Domain: "example.com",
			Metadata: map[string]string{
				"quota": "requests_per_minute",
			},
		}

		anyDetail, err := anypb.New(errInfo)
		if err != nil {
			fmt.Fprintf(os.Stderr, "FAIL: anypb.New failed: %v\n", err)
			os.Exit(1)
		}

		st := &status.Status{
			Code:    int32(code.Code_RESOURCE_EXHAUSTED),
			Message: "Rate limit reached",
			Details: []*anypb.Any{anyDetail},
		}

		if got := st.GetCode(); got != int32(code.Code_RESOURCE_EXHAUSTED) {
			fmt.Fprintf(os.Stderr, "FAIL: GetCode() = %d, want %d\n", got, int32(code.Code_RESOURCE_EXHAUSTED))
			os.Exit(1)
		}
		if got := st.GetMessage(); got != "Rate limit reached" {
			fmt.Fprintf(os.Stderr, "FAIL: GetMessage() = %q, want Rate limit reached\n", got)
			os.Exit(1)
		}
		details := st.GetDetails()
		if len(details) != 1 {
			fmt.Fprintf(os.Stderr, "FAIL: len(GetDetails()) = %d, want 1\n", len(details))
			os.Exit(1)
		}

		var unpacked errdetails.ErrorInfo
		if err := details[0].UnmarshalTo(&unpacked); err != nil {
			fmt.Fprintf(os.Stderr, "FAIL: UnmarshalTo failed: %v\n", err)
			os.Exit(1)
		}
		if !proto.Equal(errInfo, &unpacked) {
			fmt.Fprintf(os.Stderr, "FAIL: unpacked ErrorInfo %+v != original %+v\n", &unpacked, errInfo)
			os.Exit(1)
		}
	}

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

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

	// Assertion 3: status.Status serializes and deserializes accurately with proto.Marshal and proto.Unmarshal, preserving all fields and Any details.
	{
		errInfo := &errdetails.ErrorInfo{
			Reason: "INVALID_CREDENTIAL",
			Domain: "auth.example.com",
			Metadata: map[string]string{
				"client_id": "client-123",
			},
		}
		anyDetail, err := anypb.New(errInfo)
		if err != nil {
			fmt.Fprintf(os.Stderr, "FAIL: anypb.New failed: %v\n", err)
			os.Exit(1)
		}

		original := &status.Status{
			Code:    int32(code.Code_UNAUTHENTICATED),
			Message: "Authentication failed",
			Details: []*anypb.Any{anyDetail},
		}

		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: decoded proto 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)
		}
		if len(decoded.GetDetails()) != len(original.GetDetails()) {
			fmt.Fprintf(os.Stderr, "FAIL: decoded Details count = %d, want %d\n", len(decoded.GetDetails()), len(original.GetDetails()))
			os.Exit(1)
		}
	}

	// Assertion 4: status.Status messages support deep copying with proto.Clone and semantic equality checks with proto.Equal.
	{
		original := &status.Status{
			Code:    int32(code.Code_PERMISSION_DENIED),
			Message: "Access forbidden",
		}

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

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

	// Assertion 5: status.Status.Reset clears all fields back to zero state.
	{
		st := &status.Status{
			Code:    int32(code.Code_INTERNAL),
			Message: "Internal server error",
		}

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

	// Suppress unused reflect import if needed
	_ = reflect.TypeOf(int(0))

	fmt.Println("PASS: pkg:golang/google.golang.org/genproto/googleapis/rpc@v0.0.0-20251029180050-ab9386a59fda contract passed")
}