Ejemplo
github.com/spf13/afero v1.1.2: ReadFile
Muestra verificada para golang github.com/spf13/afero v1.1.2: ReadFile. El contrato se ejecutó en go 1.26 · linux debian/x64 · docker y pasó.
sha256:eb7ecfb562ed3e6a0f21d93c6ad6b0a0a15b5124fc601deda0c479d0f0ce6521
Esta red ofrece una sola cosa: una muestra que compila. La ejecutó en un sandbox y guardó el recibo firmado. No califica ni garantiza nada: si el mismo código compila donde estás no es algo que haya medido.
Cuántas claves de firma distintas presentaron un recibo de contrato aprobado. Una es solo el autor; más de una significa que alguien más también lo compiló. Una clave se genera sola y no tiene identidad registrada detrás, así que cuenta claves, no personas.
MIT-0
Evidencia de ejecución
El entorno declarado y las ejecuciones firmadas se muestran por separado, para que veas exactamente qué ejecutó esta muestra y dónde.
- Base de evidencia
- Contrato firmado aprobado
- Recibos de verificación
- 1
- Claves de firma que lo compilaron
- 1
Entorno declarado
linux 24 · ubuntu · glibc 2.39 x64 go
Entornos de las ejecuciones de verificación
| Entorno | Contrato | Etapas | Ejecución |
|---|---|---|---|
| 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-28 |
Caso
HOW- Objetivo
- verify ReadFile in pkg:golang/github.com/spf13/afero@v1.1.2
- Paquetes
- Símbolos
-
- ReadFile
- Creado
- 2026-10-28T02:48:58Z
Contrato
- afero.ReadFile(fs, filename) reads the entire contents of an existing file from an afero.Fs and returns the byte slice with a nil error
- afero.ReadFile(fs, filename) returns an empty byte slice and nil error when reading a zero-byte file
- afero.ReadFile(fs, filename) returns an error matching os.ErrNotExist when the target file does not exist
- Afero.ReadFile(filename) delegates to afero.ReadFile on the wrapped Fs and returns the file contents
Archivos
- PROMPT.md
- csx.json
- go.mod
- go.sum
- spec.json
- test/contract.go
Código fuente
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 ReadFile in pkg:golang/github.com/spf13/afero@v1.1.2
Kind: HOW
Use EXACTLY these public packages and versions:
- pkg:golang/github.com/spf13/afero@v1.1.2
Demonstrate these symbols/APIs:
- ReadFile
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:706a209fa9ca226c82362490d88a098c003cc25f458f9523840ef0451bfac518","contract":["afero.ReadFile(fs, filename) reads the entire contents of an existing file from an afero.Fs and returns the byte slice with a nil error","afero.ReadFile(fs, filename) returns an empty byte slice and nil error when reading a zero-byte file","afero.ReadFile(fs, filename) returns an error matching os.ErrNotExist when the target file does not exist","Afero.ReadFile(filename) delegates to afero.ReadFile on the wrapped Fs and returns the file contents"],"goal":"verify ReadFile in pkg:golang/github.com/spf13/afero@v1.1.2","kind":"HOW","packages":["pkg:golang/github.com/spf13/afero@v1.1.2"],"schemaVersion":1,"symbols":["ReadFile"]},"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/github.com/spf13/afero@v1.1.2"],"schemaVersion":1,"subject":"pkg:golang/github.com/spf13/afero@v1.1.2","symbols":["ReadFile"],"verifierAdapter":"golang@1"}
module sample
go 1.26.0
require github.com/spf13/afero v1.1.2
require golang.org/x/text v0.43.0 // indirect
github.com/spf13/afero v1.1.2 h1:m8/z1t7/fwjysjQRYbP0RD+bUIF/8tJwPdEZsI83ACI=
github.com/spf13/afero v1.1.2/go.mod h1:j4pytiNVoe2o6bmDsKpLACNPDBIoEAkihy7loJ1B0CQ=
golang.org/x/text v0.43.0 h1:1QivrlhwAsnMOcqgOdl9my7s9OyZl8O5/UGUTJVXoWc=
golang.org/x/text v0.43.0/go.mod h1:hbSIYA/amXcRXTFSZqh8tWHEoqRvvbKPJ2uz/KU+a+s=
{
"schemaVersion": 1,
"goal": "verify ReadFile in pkg:golang/github.com/spf13/afero@v1.1.2",
"kind": "HOW",
"packages": [
"pkg:golang/github.com/spf13/afero@v1.1.2"
],
"symbols": [
"ReadFile"
]
}
package main
import (
"bytes"
"errors"
"os"
"github.com/spf13/afero"
)
func main() {
memFs := afero.NewMemMapFs()
// 1. Write a file and read it back via package-level afero.ReadFile(fs, filename).
expected := []byte("hello afero ReadFile\nline two")
if err := afero.WriteFile(memFs, "/dir/greeting.txt", expected, 0644); err != nil {
panic(err)
}
got, err := afero.ReadFile(memFs, "/dir/greeting.txt")
if err != nil {
panic(err)
}
if !bytes.Equal(got, expected) {
panic("ReadFile content mismatch")
}
// 2. Reading an empty file returns an empty slice and nil error.
if err := afero.WriteFile(memFs, "/dir/empty.txt", []byte{}, 0644); err != nil {
panic(err)
}
emptyData, err := afero.ReadFile(memFs, "/dir/empty.txt")
if err != nil {
panic(err)
}
if len(emptyData) != 0 {
panic("expected empty slice for empty file")
}
// 3. Reading a non-existent file returns an error matching os.ErrNotExist.
_, err = afero.ReadFile(memFs, "/dir/missing.txt")
if err == nil || !errors.Is(err, os.ErrNotExist) {
panic("expected os.ErrNotExist for missing file")
}
// 4. Verify Afero wrapper struct method Afero.ReadFile(filename).
af := &afero.Afero{Fs: memFs}
gotViaStruct, err := af.ReadFile("/dir/greeting.txt")
if err != nil {
panic(err)
}
if !bytes.Equal(gotViaStruct, expected) {
panic("Afero.ReadFile content mismatch")
}
}
Seeder de origen
anónimo