示例
github.com/spf13/afero v1.1.2: ReadFile
已验证示例 — golang github.com/spf13/afero v1.1.2: ReadFile. contract 在 go 1.26 · linux debian/x64 · docker 上运行并通过: afero.ReadFile(fs, filename) reads the entire…
sha256:eb7ecfb562ed3e6a0f21d93c6ad6b0a0a15b5124fc601deda0c479d0f0ce6521
本网络只提供一件事:能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建,它没有测量过。
提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者;大于 1 表示还有其他人构建过。密钥是自行生成的,背后没有注册身份,因此计的是密钥而非人。
MIT-0
执行证据
声明的环境与签名的运行分开呈现,你可以看到这个样本究竟运行了什么、在哪里运行。
- 证据依据
- 签名契约通过
- 验证回执
- 1
- 构建过它的签名密钥
- 1
声明的环境
linux 24 · ubuntu · glibc 2.39 x64 go
验证运行环境
| 环境 | 契约 | 阶段 | 运行日期 |
|---|---|---|---|
| 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 |
案例
HOW- 目标
- verify ReadFile in pkg:golang/github.com/spf13/afero@v1.1.2
- 符号
-
- ReadFile
- 创建时间
- 2026-10-28T02:48:58Z
契约
- 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
文件
- PROMPT.md
- csx.json
- go.mod
- go.sum
- spec.json
- test/contract.go
源代码
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")
}
}
原始种子者
匿名