Exemple
google.golang.org/api v0.13.0: iterator.PageInfo
Échantillon vérifié pour golang google.golang.org/api v0.13.0: iterator.PageInfo. Le contrat s'est exécuté sur go 1.26 · linux debian/x64 · docker et a…
sha256:02a13c196c199fbb36e14c2149d4f4d6b4fcd9da598e6653d336a3f313489a7a
Ce réseau offre une seule chose : un échantillon qui compile. Il l'a exécuté dans un bac à sable et conservé le reçu signé. Il ne note rien et ne garantit rien : si le même code compile chez vous, il ne l'a pas mesuré.
Combien de clés de signature distinctes ont déposé un reçu de contrat réussi. Une seule, c'est l'auteur ; plus d'une signifie que quelqu'un d'autre l'a compilé aussi. Une clé est auto-générée sans identité enregistrée derrière, donc on compte des clés, pas des personnes.
MIT-0
Preuves d'exécution
L'environnement déclaré et les exécutions signées sont séparés, pour que vous voyiez exactement ce que cet échantillon a exécuté et où.
- Base de preuve
- Contrat signé réussi
- Reçus de vérification
- 1
- Clés de signature qui l’ont compilé
- 1
Environnement déclaré
linux 24 · ubuntu · glibc 2.39 x64 go
Environnements des exécutions de vérification
| Environnement | Contrat | Étapes | Exécution |
|---|---|---|---|
| go 1.26 · linux debian/x64 · docker ed25519:c1973797be207ac4 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · golang@1golang:1.26@sha256:e30143be198a… |
2026-10-20 |
Cas
HOW- Objectif
- verify google.golang.org/api/iterator.PageInfo in pkg:golang/google.golang.org/api@v0.13.0
- Paquets
- Symboles
-
- google.golang.org/api/iterator.PageInfo
- Créé
- 2026-10-20T18:38:38Z
Contrat
- PageInfo tracks pagination token and max page size for pageable iterators
- PageInfo.Remaining reports the number of buffered items remaining before next fetch
- Pager retrieves items page by page using PageInfo token and buffer
- PageInfo detects and prevents mixed calls to Next and NextPage on the same iterator
Fichiers
- PROMPT.md
- csx.json
- go.mod
- go.sum
- sample.go
- spec.json
- test/contract.go
Code source
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/iterator.PageInfo in pkg:golang/google.golang.org/api@v0.13.0
Kind: HOW
Use EXACTLY these public packages and versions:
- pkg:golang/google.golang.org/api@v0.13.0
Demonstrate these symbols/APIs:
- google.golang.org/api/iterator.PageInfo
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:7887c59a87256d195a02eb61f771dd66fcc800b7bcc8e34a3d0a327849759dd1","contract":["PageInfo tracks pagination token and max page size for pageable iterators","PageInfo.Remaining reports the number of buffered items remaining before next fetch","Pager retrieves items page by page using PageInfo token and buffer","PageInfo detects and prevents mixed calls to Next and NextPage on the same iterator"],"goal":"verify google.golang.org/api/iterator.PageInfo in pkg:golang/google.golang.org/api@v0.13.0","kind":"HOW","packages":["pkg:golang/google.golang.org/api@v0.13.0"],"schemaVersion":1,"symbols":["google.golang.org/api/iterator.PageInfo"]},"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/api@v0.13.0"],"schemaVersion":1,"subject":"pkg:golang/google.golang.org/api@v0.13.0","symbols":["google.golang.org/api/iterator.PageInfo"],"verifierAdapter":"golang@1"}
module example.com/iterator-sample
go 1.24
require google.golang.org/api v0.13.0
cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw=
cloud.google.com/go v0.34.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw=
cloud.google.com/go v0.38.0/go.mod h1:990N+gfupTy94rShfmMCWGDn0LpTmnzTp2qbd1dvSRU=
github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU=
github.com/client9/misspell v0.3.4/go.mod h1:qj6jICC3Q7zFZvVWo7KLAzC3yx5G7kyvSDkc90ppPyw=
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/mock v1.2.0/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.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
github.com/google/btree v0.0.0-20180813153112-4030bb1f1f0c/go.mod h1:lNA+9X1NB3Zf8V7Ke586lFgjr2dZNuvo3lPJSGZ5JPQ=
github.com/google/go-cmp v0.2.0/go.mod h1:oXzfMopK8JAjlY9xF4vHSVASa0yLyX7SntLO5aqRK0M=
github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU=
github.com/google/martian v2.1.0+incompatible/go.mod h1:9I4somxYTbIHy5NJKHRl3wXiIaQGbYVAs8BPL6v8lEs=
github.com/google/pprof v0.0.0-20181206194817-3ea8567a2e57/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc=
github.com/googleapis/gax-go/v2 v2.0.4/go.mod h1:0Wqv26UfaUD9n4G6kQubkQ+KchISgw+vpHVxEJEs9eg=
github.com/googleapis/gax-go/v2 v2.0.5/go.mod h1:DWXyrwAJ9X0FpwwEdw+IPEYBICEFu5mhpdKc/us6bOk=
github.com/hashicorp/golang-lru v0.5.0/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8=
github.com/hashicorp/golang-lru v0.5.1/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8=
github.com/jstemmer/go-junit-report v0.0.0-20190106144839-af01ea7f8024/go.mod h1:6v2b51hI/fHJwM22ozAgKL4VKDeJcHhJFhtBdhmNjmU=
go.opencensus.io v0.21.0/go.mod h1:mSImk1erAIZhrmZN+AvHh14ztQfjbGwt4TtuofqLduU=
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-20190301231843-5614ed5bae6f/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE=
golang.org/x/lint v0.0.0-20190313153728-d0100b6bd8b3/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc=
golang.org/x/lint v0.0.0-20190409202823-959b441ac422/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-20190108225652-1e06a53dbb7e/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/net v0.0.0-20190503192946-f4e77d36d62c/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U=
golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
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-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20190227155943-e225da77a7e6/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/sys v0.0.0-20190507160741-ecd444e8653b/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
golang.org/x/text v0.3.1-0.20180807135948-17ff2d5776d2/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk=
golang.org/x/time v0.0.0-20181108054448-85acf8d2951c/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
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-20190312170243-e65039ee4138/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs=
golang.org/x/tools v0.0.0-20190506145303-2d16b83fe98c/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q=
google.golang.org/api v0.4.0/go.mod h1:8k5glujaEP+g9n7WNsDg8QP6cUVNI86fCNMcbazEtwE=
google.golang.org/api v0.13.0 h1:Q3Ui3V3/CVinFWFiW39Iw0kMuVrRzYX0wN6OPFp0lTA=
google.golang.org/api v0.13.0/go.mod h1:iLdEw5Ide6rF15KTC1Kkl0iskquN2gFfn9o9XIsbkAI=
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/appengine v1.5.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-20190307195333-5fe7a883aa19/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE=
google.golang.org/genproto v0.0.0-20190418145605-e7d98fc518a7/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE=
google.golang.org/genproto v0.0.0-20190502173448-54afdca5d873/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE=
google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c=
google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38=
honnef.co/go/tools v0.0.0-20190102054323-c2f93a96b099/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=
honnef.co/go/tools v0.0.0-20190106161140-3f1c8253044a/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=
honnef.co/go/tools v0.0.0-20190418001031-e561f6794a2a/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=
package sample
import (
"google.golang.org/api/iterator"
)
// ItemIterator demonstrates paging using iterator.PageInfo.
type ItemIterator struct {
pageInfo *iterator.PageInfo
next func() error
items []string
}
// NewItemIterator creates a new ItemIterator over pages of string items.
func NewItemIterator(pages map[string][]string, initialToken string) *ItemIterator {
it := &ItemIterator{
items: make([]string, 0),
}
it.pageInfo, it.next = iterator.NewPageInfo(
func(pageSize int, pageToken string) (string, error) {
items, ok := pages[pageToken]
if !ok {
return "", nil
}
it.items = append(it.items, items...)
var nextTok string
if pageToken == "" && len(pages) > 1 {
nextTok = "token-page-2"
}
return nextTok, nil
},
func() int {
return len(it.items)
},
func() interface{} {
b := it.items
it.items = nil
if b == nil {
return []string{}
}
return b
},
)
it.pageInfo.Token = initialToken
return it
}
// PageInfo returns the iterator's PageInfo.
func (it *ItemIterator) PageInfo() *iterator.PageInfo {
return it.pageInfo
}
// Next returns the next item in the iterator.
func (it *ItemIterator) Next() (string, error) {
if err := it.next(); err != nil {
return "", err
}
item := it.items[0]
it.items = it.items[1:]
return item, nil
}
{
"schemaVersion": 1,
"goal": "verify google.golang.org/api/iterator.PageInfo in pkg:golang/google.golang.org/api@v0.13.0",
"kind": "HOW",
"packages": [
"pkg:golang/google.golang.org/api@v0.13.0"
],
"symbols": [
"google.golang.org/api/iterator.PageInfo"
]
}
package main
import (
"fmt"
"os"
"strings"
sample "example.com/iterator-sample"
"google.golang.org/api/iterator"
)
func main() {
// Assertion 1: PageInfo tracks pagination token and max page size for pageable iterators
{
pages := map[string][]string{
"": {"alpha", "beta"},
"token-page-2": {"gamma"},
}
it := sample.NewItemIterator(pages, "custom-start-token")
pi := it.PageInfo()
if pi == nil {
fmt.Fprintf(os.Stderr, "Assertion 1 failed: expected non-nil PageInfo\n")
os.Exit(1)
}
if pi.Token != "custom-start-token" {
fmt.Fprintf(os.Stderr, "Assertion 1 failed: expected token 'custom-start-token', got %q\n", pi.Token)
os.Exit(1)
}
pi.MaxSize = 50
if pi.MaxSize != 50 {
fmt.Fprintf(os.Stderr, "Assertion 1 failed: expected MaxSize 50, got %d\n", pi.MaxSize)
os.Exit(1)
}
}
// Assertion 2: PageInfo.Remaining reports the number of buffered items remaining before next fetch
{
pages := map[string][]string{
"": {"item1", "item2", "item3"},
}
it := sample.NewItemIterator(pages, "")
pi := it.PageInfo()
if rem := pi.Remaining(); rem != 0 {
fmt.Fprintf(os.Stderr, "Assertion 2 failed: expected 0 remaining before first Next, got %d\n", rem)
os.Exit(1)
}
item1, err := it.Next()
if err != nil || item1 != "item1" {
fmt.Fprintf(os.Stderr, "Assertion 2 failed: unexpected first item: %s, err: %v\n", item1, err)
os.Exit(1)
}
if rem := pi.Remaining(); rem != 2 {
fmt.Fprintf(os.Stderr, "Assertion 2 failed: expected 2 remaining after first Next, got %d\n", rem)
os.Exit(1)
}
item2, err := it.Next()
if err != nil || item2 != "item2" {
fmt.Fprintf(os.Stderr, "Assertion 2 failed: unexpected second item: %s, err: %v\n", item2, err)
os.Exit(1)
}
if rem := pi.Remaining(); rem != 1 {
fmt.Fprintf(os.Stderr, "Assertion 2 failed: expected 1 remaining after second Next, got %d\n", rem)
os.Exit(1)
}
item3, err := it.Next()
if err != nil || item3 != "item3" {
fmt.Fprintf(os.Stderr, "Assertion 2 failed: unexpected third item: %s, err: %v\n", item3, err)
os.Exit(1)
}
if rem := pi.Remaining(); rem != 0 {
fmt.Fprintf(os.Stderr, "Assertion 2 failed: expected 0 remaining after third Next, got %d\n", rem)
os.Exit(1)
}
_, err = it.Next()
if err != iterator.Done {
fmt.Fprintf(os.Stderr, "Assertion 2 failed: expected iterator.Done, got %v\n", err)
os.Exit(1)
}
}
// Assertion 3: Pager retrieves items page by page using PageInfo token and buffer
{
pages := map[string][]string{
"": {"page1-a", "page1-b"},
"token-page-2": {"page2-a"},
}
it := sample.NewItemIterator(pages, "")
pager := iterator.NewPager(it, 2, "")
var page1 []string
nextTok, err := pager.NextPage(&page1)
if err != nil {
fmt.Fprintf(os.Stderr, "Assertion 3 failed: unexpected error on page 1: %v\n", err)
os.Exit(1)
}
if len(page1) != 2 || page1[0] != "page1-a" || page1[1] != "page1-b" {
fmt.Fprintf(os.Stderr, "Assertion 3 failed: unexpected page 1 items: %v\n", page1)
os.Exit(1)
}
if nextTok != "token-page-2" {
fmt.Fprintf(os.Stderr, "Assertion 3 failed: expected next token 'token-page-2', got %q\n", nextTok)
os.Exit(1)
}
var page2 []string
nextTok2, err := pager.NextPage(&page2)
if err != nil {
fmt.Fprintf(os.Stderr, "Assertion 3 failed: unexpected error on page 2: %v\n", err)
os.Exit(1)
}
if len(page2) != 1 || page2[0] != "page2-a" {
fmt.Fprintf(os.Stderr, "Assertion 3 failed: unexpected page 2 items: %v\n", page2)
os.Exit(1)
}
if nextTok2 != "" {
fmt.Fprintf(os.Stderr, "Assertion 3 failed: expected empty next token, got %q\n", nextTok2)
os.Exit(1)
}
}
// Assertion 4: PageInfo detects and prevents mixed calls to Next and NextPage on the same iterator
{
pages := map[string][]string{
"": {"item1", "item2"},
}
it := sample.NewItemIterator(pages, "")
_, err := it.Next()
if err != nil {
fmt.Fprintf(os.Stderr, "Assertion 4 failed: unexpected error on Next: %v\n", err)
os.Exit(1)
}
pager := iterator.NewPager(it, 1, "")
var items []string
_, err = pager.NextPage(&items)
if err == nil {
fmt.Fprintf(os.Stderr, "Assertion 4 failed: expected error on mixed NextPage call, got nil\n")
os.Exit(1)
}
if !strings.Contains(err.Error(), "Next and NextPage called on same iterator") {
fmt.Fprintf(os.Stderr, "Assertion 4 failed: unexpected error message: %v\n", err)
os.Exit(1)
}
}
fmt.Println("PASS: google.golang.org/api/iterator.PageInfo contract passed")
}
Seeder d'origine
anonyme