2026-07-18 04:57:50 +00:00
|
|
|
package debugbundle
|
|
|
|
|
|
|
|
|
|
import (
|
2026-09-13 16:43:32 +00:00
|
|
|
"errors"
|
2026-07-18 04:57:50 +00:00
|
|
|
"os"
|
|
|
|
|
"path/filepath"
|
2026-11-22 02:49:48 +00:00
|
|
|
"sync"
|
2026-07-18 04:57:50 +00:00
|
|
|
"testing"
|
|
|
|
|
"time"
|
|
|
|
|
)
|
|
|
|
|
|
2026-11-22 02:49:48 +00:00
|
|
|
func TestAllocateStartsOneDirectoryWithRelativeLatest(t *testing.T) {
|
|
|
|
|
t.Chdir(t.TempDir())
|
|
|
|
|
started := time.Unix(42, 0).UTC()
|
|
|
|
|
bundle, err := Allocate("debug root ", "run-first", started)
|
2026-07-18 04:57:50 +00:00
|
|
|
if err != nil {
|
|
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
if !filepath.IsAbs(bundle.Path()) || bundle.RunID() != "run-first" || bundle.CreatedAt() != started {
|
2026-07-18 04:57:50 +00:00
|
|
|
t.Fatalf("bundle=%#v", bundle)
|
|
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
names, err := os.ReadDir(bundle.Path())
|
|
|
|
|
if err != nil || len(names) != 0 {
|
|
|
|
|
t.Fatalf("unexpected summary/trace hierarchy: %v %v", names, err)
|
2026-07-18 04:57:50 +00:00
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
target, err := os.Readlink(filepath.Join(filepath.Dir(bundle.Path()), "latest"))
|
|
|
|
|
if err != nil || target != bundle.RunID() || filepath.IsAbs(target) {
|
|
|
|
|
t.Fatalf("latest=%q %v", target, err)
|
2026-07-18 04:57:50 +00:00
|
|
|
}
|
|
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
|
|
|
|
|
func TestAllocateRetainsExistingBundleOnCollision(t *testing.T) {
|
2026-07-18 04:57:50 +00:00
|
|
|
parent := t.TempDir()
|
2026-11-22 02:49:48 +00:00
|
|
|
bundle, err := Allocate(parent, "first", time.Now())
|
|
|
|
|
if err != nil {
|
2026-07-18 04:57:50 +00:00
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
sentinel := filepath.Join(bundle.Path(), "sentinel")
|
|
|
|
|
if err := os.WriteFile(sentinel, []byte("existing evidence"), 0o600); err != nil {
|
2026-07-18 04:57:50 +00:00
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
if _, err := Allocate(parent, "first", time.Now()); !errors.Is(err, os.ErrExist) {
|
|
|
|
|
t.Fatalf("collision=%v", err)
|
|
|
|
|
}
|
|
|
|
|
got, err := os.ReadFile(sentinel)
|
|
|
|
|
if err != nil || string(got) != "existing evidence" {
|
|
|
|
|
t.Fatalf("evidence=%q %v", got, err)
|
2026-07-18 04:57:50 +00:00
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
target, err := os.Readlink(filepath.Join(parent, "latest"))
|
|
|
|
|
if err != nil || target != "first" {
|
|
|
|
|
t.Fatalf("collision changed latest: %q %v", target, err)
|
2026-07-18 04:57:50 +00:00
|
|
|
}
|
|
|
|
|
}
|
2026-07-18 13:42:17 +00:00
|
|
|
|
2026-07-18 14:21:26 +00:00
|
|
|
func TestAllocateRejectsUnsafeRunIDsBeforeCreatingParent(t *testing.T) {
|
2026-11-22 02:49:48 +00:00
|
|
|
for _, id := range []string{"", ".", "..", "../escape", "/absolute", " spaced ", string([]byte{'a', 92, 'b'})} {
|
|
|
|
|
t.Run(id, func(t *testing.T) {
|
2026-07-18 14:21:26 +00:00
|
|
|
parent := filepath.Join(t.TempDir(), "debug")
|
2026-11-22 02:49:48 +00:00
|
|
|
if _, err := Allocate(parent, id, time.Now()); err == nil {
|
|
|
|
|
t.Fatal("unsafe run ID accepted")
|
2026-07-18 14:21:26 +00:00
|
|
|
}
|
|
|
|
|
if _, err := os.Stat(parent); !os.IsNotExist(err) {
|
2026-11-22 02:49:48 +00:00
|
|
|
t.Fatalf("parent exists: %v", err)
|
2026-07-18 14:21:26 +00:00
|
|
|
}
|
|
|
|
|
})
|
2026-07-18 13:42:17 +00:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-11-22 02:49:48 +00:00
|
|
|
func TestAllocateFailureLeavesAvailableDataWithoutFallbackOrDeletion(t *testing.T) {
|
|
|
|
|
t.Run("parent is a file", func(t *testing.T) {
|
|
|
|
|
parent := filepath.Join(t.TempDir(), "debug")
|
|
|
|
|
if err := os.WriteFile(parent, []byte("existing"), 0o600); err != nil {
|
|
|
|
|
t.Fatal(err)
|
2026-07-18 13:42:17 +00:00
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
if bundle, err := Allocate(parent, "run", time.Now()); err == nil || bundle != nil {
|
|
|
|
|
t.Fatalf("bundle=%#v error=%v", bundle, err)
|
2026-07-18 13:42:17 +00:00
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
got, err := os.ReadFile(parent)
|
|
|
|
|
if err != nil || string(got) != "existing" {
|
|
|
|
|
t.Fatalf("parent changed: %q %v", got, err)
|
2026-08-03 19:09:49 +00:00
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
})
|
|
|
|
|
t.Run("latest cannot be replaced", func(t *testing.T) {
|
|
|
|
|
parent := t.TempDir()
|
|
|
|
|
latest := filepath.Join(parent, "latest")
|
|
|
|
|
if err := os.Mkdir(latest, 0o700); err != nil {
|
2026-08-03 19:09:49 +00:00
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
if err := os.WriteFile(filepath.Join(latest, "sentinel"), []byte("existing"), 0o600); err != nil {
|
2026-08-03 19:09:49 +00:00
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
bundle, err := Allocate(parent, "run", time.Now())
|
|
|
|
|
if err == nil || bundle == nil {
|
|
|
|
|
t.Fatalf("available bundle lost: %#v %v", bundle, err)
|
|
|
|
|
}
|
|
|
|
|
if _, err := os.Stat(bundle.Path()); err != nil {
|
2026-08-03 19:09:49 +00:00
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
if got, err := os.ReadFile(filepath.Join(latest, "sentinel")); err != nil || string(got) != "existing" {
|
|
|
|
|
t.Fatalf("latest directory changed: %q %v", got, err)
|
2026-08-03 19:09:49 +00:00
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
names, err := os.ReadDir(parent)
|
|
|
|
|
if err != nil || len(names) != 2 {
|
|
|
|
|
t.Fatalf("temporary link left behind: %v %v", names, err)
|
|
|
|
|
}
|
|
|
|
|
})
|
2026-08-03 19:09:49 +00:00
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
|
|
|
|
|
func TestConcurrentAllocationLeavesAllSessionsAndAValidLatestLink(t *testing.T) {
|
|
|
|
|
parent := t.TempDir()
|
|
|
|
|
const sessions = 8
|
|
|
|
|
var wg sync.WaitGroup
|
|
|
|
|
failures := make(chan error, sessions)
|
|
|
|
|
for i := range sessions {
|
|
|
|
|
wg.Add(1)
|
|
|
|
|
go func(i int) {
|
|
|
|
|
defer wg.Done()
|
|
|
|
|
_, err := Allocate(parent, time.Unix(int64(i), 0).Format("150405"), time.Now())
|
|
|
|
|
failures <- err
|
|
|
|
|
}(i)
|
|
|
|
|
}
|
|
|
|
|
wg.Wait()
|
|
|
|
|
close(failures)
|
|
|
|
|
for err := range failures {
|
|
|
|
|
if err != nil {
|
|
|
|
|
t.Fatal(err)
|
|
|
|
|
}
|
2026-07-18 04:57:50 +00:00
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
names, err := os.ReadDir(parent)
|
|
|
|
|
if err != nil || len(names) != sessions+1 {
|
|
|
|
|
t.Fatalf("sessions=%v %v", names, err)
|
2026-07-18 04:57:50 +00:00
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
target, err := os.Readlink(filepath.Join(parent, "latest"))
|
|
|
|
|
if err != nil || filepath.IsAbs(target) {
|
|
|
|
|
t.Fatalf("latest=%q %v", target, err)
|
2026-07-18 04:57:50 +00:00
|
|
|
}
|
2026-11-22 02:49:48 +00:00
|
|
|
if info, err := os.Stat(filepath.Join(parent, target)); err != nil || !info.IsDir() {
|
|
|
|
|
t.Fatalf("latest target unavailable: %v", err)
|
2026-09-13 16:43:32 +00:00
|
|
|
}
|
2026-07-18 14:13:27 +00:00
|
|
|
}
|