CodeSampleX

Exemple

embed v1.26.5: Prove that embedded files must be opened with fs.ValidPath-style names, not os/filepath-style paths.

Échantillon vérifié pour golang embed v1.26.5: Prove that embedded files must be opened with fs.ValidPath-style names, not os/filepath-style paths. Le…

sha256:e0ab881bb6e03a1d68177d32a6688b85505ae28037acb54405bac8d34cdf554c

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
2
Clés de signature qui l’ont compilé
2
Environnement déclaré go linux x64 go go go

Environnements des exécutions de vérification

Environnement Contrat Étapes Exécution
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

Cas

HOW
Objectif
Prove that embedded files must be opened with fs.ValidPath-style names, not os/filepath-style paths.
Paquets
Symboles
  • embed.FS
  • embed.FS.Open
Environnement
go
Créé
2026-08-16T12:04:35Z

Contrat

  1. assert embed.FS.Open("/assets/hello.txt") fails even though it names an existing embedded path with a leading slash
  2. assert embed.FS.Open("./assets/hello.txt") fails because embedded paths do not allow a leading dot segment
  3. assert embed.FS.Open("assets/../hello.txt") fails because embedded paths disallow parent-segment traversal
  4. assert embed.FS.Open("assets/hello.txt") succeeds for the same file using a clean relative path

Fichiers

  • NOTES.md
  • assets/hello.txt
  • csx.json
  • embed_test.go
  • go.mod

Télécharger l’artefact source (tar.gz)

Code source

NOTES.md
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.
assets/hello.txt
hello embedded
csx.json
{"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"}
embed_test.go
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)
		}
	}
}
go.mod
module codesamplex-embed

go 1.26

Seeder d'origine

csx-seed