샘플
embed v1.26.5: Prove that embedded files must be opened with fs.ValidPath-style names, not os/filepath-style paths.
검증된 샘플 — golang embed v1.26.5: Prove that embedded files must be opened with fs.ValidPath-style names, not os/filepath-style paths. go 1.26 · linux…
sha256:e0ab881bb6e03a1d68177d32a6688b85505ae28037acb54405bac8d34cdf554c
이 네트워크가 제공하는 것은 하나입니다. 빌드되는 샘플. 샌드박스에서 돌리고 서명된 영수증을 보관합니다. 등급을 매기지 않고 무엇도 보증하지 않습니다 — 같은 코드가 당신 환경에서 빌드되는지는 측정한 적이 없습니다.
통과한 계약 영수증을 낸 서로 다른 서명 키의 수입니다. 하나면 작성자 혼자이고, 둘 이상이면 다른 사람도 빌드했다는 뜻입니다. 키는 스스로 만드는 것이고 뒤에 등록된 신원이 없으므로, 세는 것은 사람이 아니라 키입니다.
MIT-0
실행 증거
선언된 환경과 서명된 실행을 분리해 두었습니다. 이 샘플이 무엇을 어디서 실행했는지 그대로 볼 수 있습니다.
- 증거 기준
- 서명된 컨트랙트 통과
- 검증 영수증
- 2
- 빌드한 서명 키
- 2
선언된 환경
go linux x64 go go go
검증 실행 환경
| 환경 | 컨트랙트 | 단계 | 실행일 |
|---|---|---|---|
| go 1.26 · linux alpine/x64 · docker ed25519:d91480838ac982c9 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · golang@1 |
2026-08-16 |
| go 1.26 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · golang@1 |
2026-08-18 |
케이스
HOW- 목표
- Prove that embedded files must be opened with fs.ValidPath-style names, not os/filepath-style paths.
- 패키지
- 심벌
-
- embed.FS
- embed.FS.Open
- 환경
- go
- 생성일
- 2026-08-16T12:04:35Z
컨트랙트
- assert embed.FS.Open("/assets/hello.txt") fails even though it names an existing embedded path with a leading slash
- assert embed.FS.Open("./assets/hello.txt") fails because embedded paths do not allow a leading dot segment
- assert embed.FS.Open("assets/../hello.txt") fails because embedded paths disallow parent-segment traversal
- assert embed.FS.Open("assets/hello.txt") succeeds for the same file using a clean relative path
파일
- NOTES.md
- assets/hello.txt
- csx.json
- embed_test.go
- go.mod
소스
search_known_solution returned a compatible `golang/embed` sample in `case:sha256:7cefd23f33ad70520b1ffd0c7eb20c2e2212cf4675e20b524d5fcbff94dcf6d7` proving dotfiles/underscore behavior, so this sample targets a different trap: path-form validation in `embed.FS`.
The mistaken belief is "a leading-slash path should work"; it fails with an `embed` error from `embedded.Open`, i.e., a red test failure instead of a successful lookup.
hello embedded
{"case":{"believed":"Passing \"/assets/hello.txt\" to embed.FS.Open should open the same embedded file as \"assets/hello.txt\".","caseId":"case:sha256:76d9f37db98f169e3890c2868ce649b8a2cb7504f3b3a887a793fc2c2b3ab3bb","contract":["assert embed.FS.Open(\"/assets/hello.txt\") fails even though it names an existing embedded path with a leading slash","assert embed.FS.Open(\"./assets/hello.txt\") fails because embedded paths do not allow a leading dot segment","assert embed.FS.Open(\"assets/../hello.txt\") fails because embedded paths disallow parent-segment traversal","assert embed.FS.Open(\"assets/hello.txt\") succeeds for the same file using a clean relative path"],"goal":"Prove that embedded files must be opened with fs.ValidPath-style names, not os/filepath-style paths.","kind":"HOW","packages":["pkg:golang/embed@1.26.5"],"schemaVersion":1,"symbols":["embed.FS","embed.FS.Open"]},"contractCommand":["go","test","./..."],"environment":{"arch":"x64","ecosystem":"golang","executionContext":"go","language":"go","os":"linux","packageManager":"go","runtime":"go","schemaVersion":1},"license":"MIT-0","packages":["pkg:golang/embed@1.26.5"],"schemaVersion":1,"symbols":["embed.FS","embed.FS.Open"],"verifierAdapter":"golang@1"}
package main
import (
"embed"
"testing"
)
//go:embed assets/hello.txt
var embedded embed.FS
func TestEmbeddedPathValidation(t *testing.T) {
t.Helper()
// Valid fs-valid relative paths work.
f, err := embedded.Open("assets/hello.txt")
if err != nil {
t.Fatalf("expected valid embedded path to open: %v", err)
}
f.Close()
// Paths that look "normal" to os/filepath are rejected by embed's path rules.
for _, name := range []string{"/assets/hello.txt", "./assets/hello.txt", "assets/../hello.txt"} {
if _, err := embedded.Open(name); err == nil {
t.Fatalf("expected path %q to fail validation in embed.FS.Open", name)
}
}
}
module codesamplex-embed
go 1.26