google.golang.org/api v0.287.1: bundler.ErrOverflow

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/api/support/bundler.ErrOverflow in pkg:golang/google.golang.org/api@v0.287.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:golang/google.golang.org/api@v0.287.1
Demonstrate these symbols/APIs:
  - google.golang.org/api/support/bundler.ErrOverflow

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 (
	"errors"
	"time"

	"google.golang.org/api/support/bundler"
)

// NewLimitedBundler creates a Bundler with a specified buffered byte limit.
func NewLimitedBundler(byteLimit int, handler func([]string)) *bundler.Bundler {
	b := bundler.NewBundler("", func(items interface{}) {
		if handler != nil {
			handler(items.([]string))
		}
	})
	b.BufferedByteLimit = byteLimit
	b.DelayThreshold = 10 * time.Minute
	return b
}

// AddString attempts to add an item with the given size in bytes to the bundler.
// Returns bundler.ErrOverflow if the bundler's buffered byte limit is exceeded.
func AddString(b *bundler.Bundler, item string, size int) error {
	return b.Add(item, size)
}

// IsErrOverflow returns true if err is bundler.ErrOverflow.
func IsErrOverflow(err error) bool {
	return errors.Is(err, bundler.ErrOverflow)
}

{"case":{"caseId":"case:sha256:1eb4ec64f3418d6c81c38cc035378404037d375b8cb33e04f15f8b09c5a0f961","contract":["bundler.ErrOverflow indicates that Bundler stored bytes exceeds BufferedByteLimit","Bundler.Add succeeds when item size is within BufferedByteLimit","Bundler.Add returns bundler.ErrOverflow when cumulative buffered bytes exceed BufferedByteLimit","Bundler.Add returns bundler.ErrOverflow when item size exceeds BufferedByteLimit"],"goal":"verify google.golang.org/api/support/bundler.ErrOverflow in pkg:golang/google.golang.org/api@v0.287.1","kind":"HOW","packages":["pkg:golang/google.golang.org/api@v0.287.1"],"schemaVersion":1,"symbols":["google.golang.org/api/support/bundler.ErrOverflow"]},"contractCommand":["go","run","-p","1","./test"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"golang","language":"go","libc":"glibc","libcVersion":"2.39","moduleSystem":"go.mod","os":"linux","osVersionBucket":"24","packageManager":"go","runtime":"go","runtimeVersion":"1.26","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/google.golang.org/api@v0.287.1"],"schemaVersion":1,"subject":"pkg:golang/google.golang.org/api@v0.287.1","symbols":["google.golang.org/api/support/bundler.ErrOverflow"],"verifierAdapter":"golang@1"}

module example.com/sample

go 1.26.6

require google.golang.org/api v0.287.1

require golang.org/x/sync v0.21.0 // indirect

golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
google.golang.org/api v0.287.1 h1:LiyJx32VU3cwQfLchn/513qKhc25hq0pEANYJoWNnnI=
google.golang.org/api v0.287.1/go.mod h1:lM2kYRzYUCBY91P9h6VF1PYmvhxii3O5hji37qRvIcY=

{
  "schemaVersion": 1,
  "goal": "verify google.golang.org/api/support/bundler.ErrOverflow in pkg:golang/google.golang.org/api@v0.287.1",
  "kind": "HOW",
  "packages": [
    "pkg:golang/google.golang.org/api@v0.287.1"
  ],
  "symbols": [
    "google.golang.org/api/support/bundler.ErrOverflow"
  ]
}

package main

import (
	"errors"
	"fmt"
	"os"

	sample "example.com/sample"
	"google.golang.org/api/support/bundler"
)

func main() {
	// 1. bundler.ErrOverflow indicates that Bundler stored bytes exceeds BufferedByteLimit
	if bundler.ErrOverflow == nil {
		fmt.Fprintln(os.Stderr, "FAIL: expected non-nil bundler.ErrOverflow")
		os.Exit(1)
	}
	expectedErrMsg := "bundler reached buffered byte limit"
	if bundler.ErrOverflow.Error() != expectedErrMsg {
		fmt.Fprintf(os.Stderr, "FAIL: expected %q, got %q\n", expectedErrMsg, bundler.ErrOverflow.Error())
		os.Exit(1)
	}

	// 2. Bundler.Add succeeds when item size is within BufferedByteLimit
	b := sample.NewLimitedBundler(100, nil)
	if err := sample.AddString(b, "item-1", 40); err != nil {
		fmt.Fprintf(os.Stderr, "FAIL: expected AddString within limit to succeed, got %v\n", err)
		os.Exit(1)
	}

	// 3. Bundler.Add returns bundler.ErrOverflow when cumulative buffered bytes exceed BufferedByteLimit
	errOverflow := sample.AddString(b, "item-2", 70)
	if errOverflow == nil {
		fmt.Fprintln(os.Stderr, "FAIL: expected ErrOverflow when exceeding cumulative BufferedByteLimit, got nil")
		os.Exit(1)
	}
	if !errors.Is(errOverflow, bundler.ErrOverflow) {
		fmt.Fprintf(os.Stderr, "FAIL: expected error to match bundler.ErrOverflow, got %v\n", errOverflow)
		os.Exit(1)
	}
	if !sample.IsErrOverflow(errOverflow) {
		fmt.Fprintf(os.Stderr, "FAIL: IsErrOverflow returned false for %v\n", errOverflow)
		os.Exit(1)
	}

	// 4. Bundler.Add returns bundler.ErrOverflow when item size exceeds BufferedByteLimit
	b2 := sample.NewLimitedBundler(50, nil)
	errSingleOverflow := sample.AddString(b2, "item-oversized", 60)
	if errSingleOverflow == nil {
		fmt.Fprintln(os.Stderr, "FAIL: expected ErrOverflow for single oversized item, got nil")
		os.Exit(1)
	}
	if !errors.Is(errSingleOverflow, bundler.ErrOverflow) {
		fmt.Fprintf(os.Stderr, "FAIL: expected bundler.ErrOverflow, got %v\n", errSingleOverflow)
		os.Exit(1)
	}

	fmt.Println("PASS: google.golang.org/api/support/bundler.ErrOverflow contract passed")
}