package librarysnapshot import ( "archive/tar" "bytes" "io" "os" "path/filepath" "testing" ) func newTransferArchive(t *testing.T) (*Archive, string) { t.Helper() root := t.TempDir() if err := os.Chmod(root, 0700); err != nil { t.Fatal(err) } archive, err := Open(root, 1024*1024) if err != nil { t.Fatal(err) } t.Cleanup(func() { archive.Close() }) return archive, root } func sealFixture(t *testing.T, archive *Archive) (string, Manifest) { t.Helper() part, err := archive.Put(bytes.NewBufferString("[]")) if err != nil { t.Fatal(err) } manifest := testManifest(part) id, err := archive.Seal(manifest) if err != nil { t.Fatal(err) } return id, manifest } // 一份验证过的快照搬过去必须字节一致、身份不变,重复导入幂等。 func TestPackUnpackRoundTripKeepsIdentityAndBytes(t *testing.T) { source, _ := newTransferArchive(t) id, manifest := sealFixture(t, source) bundle := filepath.Join(t.TempDir(), "snapshot.tar") info, err := source.Pack(id, bundle) if err != nil { t.Fatalf("Pack() error = %v", err) } if info.Snapshot != id || info.Parts != len(manifest.Parts) || info.Bytes <= 0 || len(info.Blobs) == 0 { t.Fatalf("bundle info = %#v", info) } destination, _ := newTransferArchive(t) got, err := destination.Unpack(bundle, id) if err != nil { t.Fatalf("Unpack() error = %v", err) } if got.KnowledgeBaseID != manifest.KnowledgeBaseID || len(got.Parts) != len(manifest.Parts) { t.Fatal("imported manifest identity changed") } if _, err := destination.Load(id); err != nil { t.Fatalf("imported snapshot does not load: %v", err) } if _, err := destination.Unpack(bundle, id); err != nil { t.Fatalf("repeated import is not idempotent: %v", err) } } // 包不覆盖已有文件:导出和导入都不能"顺手替换"一份已存在的产物。 func TestPackRefusesToOverwriteExistingBundle(t *testing.T) { source, _ := newTransferArchive(t) id, _ := sealFixture(t, source) bundle := filepath.Join(t.TempDir(), "snapshot.tar") if err := os.WriteFile(bundle, []byte("occupied"), 0600); err != nil { t.Fatal(err) } if _, err := source.Pack(id, bundle); err == nil { t.Fatal("Pack() overwrote an existing bundle") } } // 身份对不上就不许导入:调用方点错快照时,宁可失败。 func TestUnpackRejectsUnexpectedSnapshotIdentity(t *testing.T) { source, _ := newTransferArchive(t) id, _ := sealFixture(t, source) bundle := filepath.Join(t.TempDir(), "snapshot.tar") if _, err := source.Pack(id, bundle); err != nil { t.Fatal(err) } destination, _ := newTransferArchive(t) if _, err := destination.Unpack(bundle, digest([]byte("another snapshot"))); err == nil { t.Fatal("Unpack() accepted a bundle whose ID does not match the expectation") } } // 包里的字节必须与名字(sha256)一致:篡改一个 blob 就整体拒绝,且不留下版本。 func TestUnpackRejectsTamperedBlobAndLeavesNoVersion(t *testing.T) { source, _ := newTransferArchive(t) id, manifest := sealFixture(t, source) bundle := filepath.Join(t.TempDir(), "snapshot.tar") info, err := source.Pack(id, bundle) if err != nil { t.Fatal(err) } tampered := filepath.Join(t.TempDir(), "tampered.tar") rewriteBundle(t, bundle, tampered, func(name string, body []byte) (string, []byte) { if name == bundleBlobPrefix+info.Blobs[0] && len(body) > 0 { body = append([]byte(nil), body...) body[0] ^= 0xff } return name, body }) destination, root := newTransferArchive(t) if _, err := destination.Unpack(tampered, id); err == nil { t.Fatal("Unpack() accepted a tampered blob") } if _, err := os.Stat(filepath.Join(root, "versions", id+".json")); !os.IsNotExist(err) { t.Fatal("a failed import left a version behind") } _ = manifest } // 包里出现快照不声明的 blob / 缺 blob / 非普通文件,一律拒绝。 func TestUnpackRejectsIncompleteAndForeignBundles(t *testing.T) { source, _ := newTransferArchive(t) id, manifest := sealFixture(t, source) bundle := filepath.Join(t.TempDir(), "snapshot.tar") if _, err := source.Pack(id, bundle); err != nil { t.Fatal(err) } missing := filepath.Join(t.TempDir(), "missing.tar") first := manifest.Parts[0].SHA256 rewriteBundle(t, bundle, missing, func(name string, body []byte) (string, []byte) { if name == bundleBlobPrefix+first { return "", nil } return name, body }) destination, _ := newTransferArchive(t) if _, err := destination.Unpack(missing, id); err == nil { t.Fatal("Unpack() accepted a bundle missing a declared blob") } foreign := filepath.Join(t.TempDir(), "foreign.tar") extra := digest([]byte("extra blob")) rewriteBundle(t, bundle, foreign, func(name string, body []byte) (string, []byte) { if name == bundleBlobPrefix+first { return bundleBlobPrefix + extra, []byte("x") } return name, body }) other, _ := newTransferArchive(t) if _, err := other.Unpack(foreign, id); err == nil { t.Fatal("Unpack() accepted a bundle carrying a blob the snapshot does not declare") } traversal := filepath.Join(t.TempDir(), "traversal.tar") rewriteBundle(t, bundle, traversal, func(name string, body []byte) (string, []byte) { if name == bundleBlobPrefix+first { return "../escape", body } return name, body }) third, _ := newTransferArchive(t) if _, err := third.Unpack(traversal, id); err == nil { t.Fatal("Unpack() accepted an entry outside the bundle layout") } } // 目标机已经存在同名不同内容的 blob:那是身份冲突,必须拒绝而不是覆盖。 func TestUnpackRejectsConflictingExistingBlob(t *testing.T) { source, _ := newTransferArchive(t) id, manifest := sealFixture(t, source) bundle := filepath.Join(t.TempDir(), "snapshot.tar") if _, err := source.Pack(id, bundle); err != nil { t.Fatal(err) } destination, root := newTransferArchive(t) victim := manifest.Parts[0].SHA256 if err := os.WriteFile(filepath.Join(root, "blobs", victim), []byte("[]different"), 0600); err != nil { t.Fatal(err) } if _, err := destination.Unpack(bundle, id); err == nil { t.Fatal("Unpack() overwrote a blob whose bytes differ") } } // rewriteBundle 逐条重放一个包,按 mutate 改名字/内容;返回空名字表示删掉该条。 func rewriteBundle(t *testing.T, source, target string, mutate func(name string, body []byte) (string, []byte)) { t.Helper() in, err := os.Open(source) if err != nil { t.Fatal(err) } defer in.Close() out, err := os.OpenFile(target, os.O_CREATE|os.O_EXCL|os.O_WRONLY, 0600) if err != nil { t.Fatal(err) } writer := tar.NewWriter(out) reader := tar.NewReader(in) for { header, err := reader.Next() if err != nil { break } body := make([]byte, header.Size) if _, err := io.ReadFull(reader, body); err != nil { t.Fatal(err) } name, rewritten := mutate(header.Name, body) if name == "" { continue } if err := writer.WriteHeader(&tar.Header{Name: name, Mode: 0600, Size: int64(len(rewritten)), Typeflag: tar.TypeReg}); err != nil { t.Fatal(err) } if _, err := writer.Write(rewritten); err != nil { t.Fatal(err) } } if err := writer.Close(); err != nil { t.Fatal(err) } if err := out.Close(); err != nil { t.Fatal(err) } }