123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648 |
- // Copyright 2014 Google Inc. All Rights Reserved.
- //
- // Licensed under the Apache License, Version 2.0 (the "License");
- // you may not use this file except in compliance with the License.
- // You may obtain a copy of the License at
- //
- // http://www.apache.org/licenses/LICENSE-2.0
- //
- // Unless required by applicable law or agreed to in writing, software
- // distributed under the License is distributed on an "AS IS" BASIS,
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- // See the License for the specific language governing permissions and
- // limitations under the License.
- package storage
- import (
- "bytes"
- "crypto/md5"
- "fmt"
- "io"
- "io/ioutil"
- "log"
- "math/rand"
- "net/http"
- "os"
- "regexp"
- "strconv"
- "strings"
- "testing"
- "time"
- "golang.org/x/net/context"
- "google.golang.org/cloud"
- "google.golang.org/cloud/internal/testutil"
- )
- // suffix is a timestamp-based suffix which is added, where possible, to all
- // buckets and objects created by tests. This reduces flakiness when the tests
- // are run in parallel and allows automatic cleaning up of artifacts left when
- // tests fail.
- var suffix = fmt.Sprintf("-t%d", time.Now().UnixNano())
- var ranIntegrationTest bool
- func TestMain(m *testing.M) {
- // Run the tests, then follow by running any cleanup required.
- exit := m.Run()
- if ranIntegrationTest {
- if err := cleanup(); err != nil {
- log.Fatalf("Post-test cleanup failed: %v", err)
- }
- }
- os.Exit(exit)
- }
- // testConfig returns the Client used to access GCS and the default bucket
- // name to use. testConfig skips the current test if credentials are not
- // available or when being run in Short mode.
- func testConfig(ctx context.Context, t *testing.T) (*Client, string) {
- if testing.Short() {
- t.Skip("Integration tests skipped in short mode")
- }
- client, bucket := config(ctx)
- if client == nil {
- t.Skip("Integration tests skipped. See CONTRIBUTING.md for details")
- }
- ranIntegrationTest = true
- return client, bucket
- }
- // config is like testConfig, but it doesn't need a *testing.T.
- func config(ctx context.Context) (*Client, string) {
- ts := testutil.TokenSource(ctx, ScopeFullControl)
- if ts == nil {
- return nil, ""
- }
- p := testutil.ProjID()
- if p == "" {
- log.Fatal("The project ID must be set. See CONTRIBUTING.md for details")
- }
- client, err := NewClient(ctx, cloud.WithTokenSource(ts))
- if err != nil {
- log.Fatalf("NewClient: %v", err)
- }
- return client, p
- }
- func TestAdminClient(t *testing.T) {
- if testing.Short() {
- t.Skip("Integration tests skipped in short mode")
- }
- ctx := context.Background()
- ts := testutil.TokenSource(ctx, ScopeFullControl)
- if ts == nil {
- t.Skip("Integration tests skipped. See CONTRIBUTING.md for details")
- }
- projectID := testutil.ProjID()
- newBucket := projectID + suffix
- t.Logf("Testing admin with Bucket %q", newBucket)
- client, err := NewAdminClient(ctx, projectID, cloud.WithTokenSource(ts))
- if err != nil {
- t.Fatalf("Could not create client: %v", err)
- }
- defer client.Close()
- if err := client.CreateBucket(ctx, newBucket, nil); err != nil {
- t.Errorf("CreateBucket(%v, %v) failed %v", newBucket, nil, err)
- }
- if err := client.DeleteBucket(ctx, newBucket); err != nil {
- t.Errorf("DeleteBucket(%v) failed %v", newBucket, err)
- t.Logf("TODO: Warning this test left a new bucket in the cloud project, it must be deleted manually")
- }
- attrs := BucketAttrs{
- DefaultObjectACL: []ACLRule{{Entity: "domain-google.com", Role: RoleReader}},
- }
- if err := client.CreateBucket(ctx, newBucket, &attrs); err != nil {
- t.Errorf("CreateBucket(%v, %v) failed %v", newBucket, attrs, err)
- }
- if err := client.DeleteBucket(ctx, newBucket); err != nil {
- t.Errorf("DeleteBucket(%v) failed %v", newBucket, err)
- t.Logf("TODO: Warning this test left a new bucket in the cloud project, it must be deleted manually")
- }
- }
- func TestIntegration_ConditionalDelete(t *testing.T) {
- ctx := context.Background()
- client, bucket := testConfig(ctx, t)
- defer client.Close()
- o := client.Bucket(bucket).Object("conddel" + suffix)
- wc := o.NewWriter(ctx)
- wc.ContentType = "text/plain"
- if _, err := wc.Write([]byte("foo")); err != nil {
- t.Fatal(err)
- }
- if err := wc.Close(); err != nil {
- t.Fatal(err)
- }
- gen := wc.Attrs().Generation
- metaGen := wc.Attrs().MetaGeneration
- if err := o.WithConditions(Generation(gen - 1)).Delete(ctx); err == nil {
- t.Fatalf("Unexpected successful delete with Generation")
- }
- if err := o.WithConditions(IfMetaGenerationMatch(metaGen + 1)).Delete(ctx); err == nil {
- t.Fatalf("Unexpected successful delete with IfMetaGenerationMatch")
- }
- if err := o.WithConditions(IfMetaGenerationNotMatch(metaGen)).Delete(ctx); err == nil {
- t.Fatalf("Unexpected successful delete with IfMetaGenerationNotMatch")
- }
- if err := o.WithConditions(Generation(gen)).Delete(ctx); err != nil {
- t.Fatalf("final delete failed: %v", err)
- }
- }
- func TestObjects(t *testing.T) {
- ctx := context.Background()
- client, bucket := testConfig(ctx, t)
- defer client.Close()
- bkt := client.Bucket(bucket)
- const defaultType = "text/plain"
- // Populate object names and make a map for their contents.
- objects := []string{
- "obj1" + suffix,
- "obj2" + suffix,
- "obj/with/slashes" + suffix,
- }
- contents := make(map[string][]byte)
- // Test Writer.
- for _, obj := range objects {
- t.Logf("Writing %q", obj)
- wc := bkt.Object(obj).NewWriter(ctx)
- wc.ContentType = defaultType
- c := randomContents()
- if _, err := wc.Write(c); err != nil {
- t.Errorf("Write for %v failed with %v", obj, err)
- }
- if err := wc.Close(); err != nil {
- t.Errorf("Close for %v failed with %v", obj, err)
- }
- contents[obj] = c
- }
- // Test Reader.
- for _, obj := range objects {
- t.Logf("Creating a reader to read %v", obj)
- rc, err := bkt.Object(obj).NewReader(ctx)
- if err != nil {
- t.Errorf("Can't create a reader for %v, errored with %v", obj, err)
- }
- slurp, err := ioutil.ReadAll(rc)
- if err != nil {
- t.Errorf("Can't ReadAll object %v, errored with %v", obj, err)
- }
- if got, want := slurp, contents[obj]; !bytes.Equal(got, want) {
- t.Errorf("Contents (%q) = %q; want %q", obj, got, want)
- }
- if got, want := rc.Size(), len(contents[obj]); got != int64(want) {
- t.Errorf("Size (%q) = %d; want %d", obj, got, want)
- }
- if got, want := rc.ContentType(), "text/plain"; got != want {
- t.Errorf("ContentType (%q) = %q; want %q", obj, got, want)
- }
- rc.Close()
- // Test SignedURL
- opts := &SignedURLOptions{
- GoogleAccessID: "xxx@clientid",
- PrivateKey: dummyKey("rsa"),
- Method: "GET",
- MD5: []byte("202cb962ac59075b964b07152d234b70"),
- Expires: time.Date(2020, time.October, 2, 10, 0, 0, 0, time.UTC),
- ContentType: "application/json",
- Headers: []string{"x-header1", "x-header2"},
- }
- u, err := SignedURL(bucket, obj, opts)
- if err != nil {
- t.Fatalf("SignedURL(%q, %q) errored with %v", bucket, obj, err)
- }
- res, err := client.hc.Get(u)
- if err != nil {
- t.Fatalf("Can't get URL %q: %v", u, err)
- }
- slurp, err = ioutil.ReadAll(res.Body)
- if err != nil {
- t.Fatalf("Can't ReadAll signed object %v, errored with %v", obj, err)
- }
- if got, want := slurp, contents[obj]; !bytes.Equal(got, want) {
- t.Errorf("Contents (%v) = %q; want %q", obj, got, want)
- }
- res.Body.Close()
- }
- obj := objects[0]
- objlen := int64(len(contents[obj]))
- // Test Range Reader.
- for i, r := range []struct {
- offset, length, want int64
- }{
- {0, objlen, objlen},
- {0, objlen / 2, objlen / 2},
- {objlen / 2, objlen, objlen / 2},
- {0, 0, 0},
- {objlen / 2, 0, 0},
- {objlen / 2, -1, objlen / 2},
- {0, objlen * 2, objlen},
- } {
- t.Logf("%d: bkt.Object(%v).NewRangeReader(ctx, %d, %d)", i, obj, r.offset, r.length)
- rc, err := bkt.Object(obj).NewRangeReader(ctx, r.offset, r.length)
- if err != nil {
- t.Errorf("%d: Can't create a range reader for %v, errored with %v", i, obj, err)
- continue
- }
- if rc.Size() != objlen {
- t.Errorf("%d: Reader has a content-size of %d, want %d", i, rc.Size(), objlen)
- }
- if rc.Remain() != r.want {
- t.Errorf("%d: Reader's available bytes reported as %d, want %d", i, rc.Remain(), r.want)
- }
- slurp, err := ioutil.ReadAll(rc)
- if err != nil {
- t.Errorf("%d:Can't ReadAll object %v, errored with %v", i, obj, err)
- continue
- }
- if len(slurp) != int(r.want) {
- t.Errorf("%d:RangeReader (%d, %d): Read %d bytes, wanted %d bytes", i, r.offset, r.length, len(slurp), r.want)
- continue
- }
- if got, want := slurp, contents[obj][r.offset:r.offset+r.want]; !bytes.Equal(got, want) {
- t.Errorf("RangeReader (%d, %d) = %q; want %q", r.offset, r.length, got, want)
- }
- rc.Close()
- }
- // Test NotFound.
- _, err := bkt.Object("obj-not-exists").NewReader(ctx)
- if err != ErrObjectNotExist {
- t.Errorf("Object should not exist, err found to be %v", err)
- }
- objName := objects[0]
- // Test StatObject.
- o, err := bkt.Object(objName).Attrs(ctx)
- if err != nil {
- t.Error(err)
- }
- if got, want := o.Name, objName; got != want {
- t.Errorf("Name (%v) = %q; want %q", objName, got, want)
- }
- if got, want := o.ContentType, defaultType; got != want {
- t.Errorf("ContentType (%v) = %q; want %q", objName, got, want)
- }
- created := o.Created
- // Check that the object is newer than its containing bucket.
- bAttrs, err := bkt.Attrs(ctx)
- if err != nil {
- t.Error(err)
- }
- if o.Created.Before(bAttrs.Created) {
- t.Errorf("Object %v is older than its containing bucket, %v", o, bAttrs)
- }
- // Test object copy.
- copyName := "copy-" + objName
- copyObj, err := bkt.Object(objName).CopyTo(ctx, bkt.Object(copyName), nil)
- if err != nil {
- t.Errorf("CopyTo failed with %v", err)
- }
- if copyObj.Name != copyName {
- t.Errorf("Copy object's name = %q; want %q", copyObj.Name, copyName)
- }
- if copyObj.Bucket != bucket {
- t.Errorf("Copy object's bucket = %q; want %q", copyObj.Bucket, bucket)
- }
- // Test UpdateAttrs.
- updated, err := bkt.Object(objName).Update(ctx, ObjectAttrs{
- ContentType: "text/html",
- ACL: []ACLRule{{Entity: "domain-google.com", Role: RoleReader}},
- })
- if err != nil {
- t.Errorf("UpdateAttrs failed with %v", err)
- }
- if want := "text/html"; updated.ContentType != want {
- t.Errorf("updated.ContentType == %q; want %q", updated.ContentType, want)
- }
- if want := created; updated.Created != want {
- t.Errorf("updated.Created == %q; want %q", updated.Created, want)
- }
- if !updated.Created.Before(updated.Updated) {
- t.Errorf("updated.Updated should be newer than update.Created")
- }
- // Test checksums.
- checksumCases := []struct {
- name string
- contents [][]byte
- size int64
- md5 string
- crc32c uint32
- }{
- {
- name: "checksum-object",
- contents: [][]byte{[]byte("hello"), []byte("world")},
- size: 10,
- md5: "fc5e038d38a57032085441e7fe7010b0",
- crc32c: 1456190592,
- },
- {
- name: "zero-object",
- contents: [][]byte{},
- size: 0,
- md5: "d41d8cd98f00b204e9800998ecf8427e",
- crc32c: 0,
- },
- }
- for _, c := range checksumCases {
- wc := bkt.Object(c.name).NewWriter(ctx)
- for _, data := range c.contents {
- if _, err := wc.Write(data); err != nil {
- t.Errorf("Write(%q) failed with %q", data, err)
- }
- }
- if err = wc.Close(); err != nil {
- t.Errorf("%q: close failed with %q", c.name, err)
- }
- obj := wc.Attrs()
- if got, want := obj.Size, c.size; got != want {
- t.Errorf("Object (%q) Size = %v; want %v", c.name, got, want)
- }
- if got, want := fmt.Sprintf("%x", obj.MD5), c.md5; got != want {
- t.Errorf("Object (%q) MD5 = %q; want %q", c.name, got, want)
- }
- if got, want := obj.CRC32C, c.crc32c; got != want {
- t.Errorf("Object (%q) CRC32C = %v; want %v", c.name, got, want)
- }
- }
- // Test public ACL.
- publicObj := objects[0]
- if err = bkt.Object(publicObj).ACL().Set(ctx, AllUsers, RoleReader); err != nil {
- t.Errorf("PutACLEntry failed with %v", err)
- }
- publicClient, err := NewClient(ctx, cloud.WithBaseHTTP(http.DefaultClient))
- if err != nil {
- t.Fatal(err)
- }
- rc, err := publicClient.Bucket(bucket).Object(publicObj).NewReader(ctx)
- if err != nil {
- t.Error(err)
- }
- slurp, err := ioutil.ReadAll(rc)
- if err != nil {
- t.Errorf("ReadAll failed with %v", err)
- }
- if !bytes.Equal(slurp, contents[publicObj]) {
- t.Errorf("Public object's content: got %q, want %q", slurp, contents[publicObj])
- }
- rc.Close()
- // Test writer error handling.
- wc := publicClient.Bucket(bucket).Object(publicObj).NewWriter(ctx)
- if _, err := wc.Write([]byte("hello")); err != nil {
- t.Errorf("Write unexpectedly failed with %v", err)
- }
- if err = wc.Close(); err == nil {
- t.Error("Close expected an error, found none")
- }
- // Test deleting the copy object.
- if err := bkt.Object(copyName).Delete(ctx); err != nil {
- t.Errorf("Deletion of %v failed with %v", copyName, err)
- }
- _, err = bkt.Object(copyName).Attrs(ctx)
- if err != ErrObjectNotExist {
- t.Errorf("Copy is expected to be deleted, stat errored with %v", err)
- }
- }
- func TestACL(t *testing.T) {
- ctx := context.Background()
- client, bucket := testConfig(ctx, t)
- defer client.Close()
- bkt := client.Bucket(bucket)
- entity := ACLEntity("domain-google.com")
- if err := client.Bucket(bucket).DefaultObjectACL().Set(ctx, entity, RoleReader); err != nil {
- t.Errorf("Can't put default ACL rule for the bucket, errored with %v", err)
- }
- aclObjects := []string{"acl1" + suffix, "acl2" + suffix}
- for _, obj := range aclObjects {
- t.Logf("Writing %v", obj)
- wc := bkt.Object(obj).NewWriter(ctx)
- c := randomContents()
- if _, err := wc.Write(c); err != nil {
- t.Errorf("Write for %v failed with %v", obj, err)
- }
- if err := wc.Close(); err != nil {
- t.Errorf("Close for %v failed with %v", obj, err)
- }
- }
- name := aclObjects[0]
- o := bkt.Object(name)
- acl, err := o.ACL().List(ctx)
- if err != nil {
- t.Errorf("Can't retrieve ACL of %v", name)
- }
- aclFound := false
- for _, rule := range acl {
- if rule.Entity == entity && rule.Role == RoleReader {
- aclFound = true
- }
- }
- if !aclFound {
- t.Error("Expected to find an ACL rule for google.com domain users, but not found")
- }
- if err := o.ACL().Delete(ctx, entity); err != nil {
- t.Errorf("Can't delete the ACL rule for the entity: %v", entity)
- }
- if err := bkt.ACL().Set(ctx, "user-jbd@google.com", RoleReader); err != nil {
- t.Errorf("Error while putting bucket ACL rule: %v", err)
- }
- bACL, err := bkt.ACL().List(ctx)
- if err != nil {
- t.Errorf("Error while getting the ACL of the bucket: %v", err)
- }
- bACLFound := false
- for _, rule := range bACL {
- if rule.Entity == "user-jbd@google.com" && rule.Role == RoleReader {
- bACLFound = true
- }
- }
- if !bACLFound {
- t.Error("Expected to find an ACL rule for jbd@google.com user, but not found")
- }
- if err := bkt.ACL().Delete(ctx, "user-jbd@google.com"); err != nil {
- t.Errorf("Error while deleting bucket ACL rule: %v", err)
- }
- }
- func TestValidObjectNames(t *testing.T) {
- ctx := context.Background()
- client, bucket := testConfig(ctx, t)
- defer client.Close()
- bkt := client.Bucket(bucket)
- // NOTE(djd): This test can't append suffix to each name, since we're checking the validity
- // of these exact names. This test will still pass if the objects are not deleted between
- // test runs, but we attempt deletion to keep the bucket clean.
- validNames := []string{
- "gopher",
- "Гоферови",
- "a",
- strings.Repeat("a", 1024),
- }
- for _, name := range validNames {
- w := bkt.Object(name).NewWriter(ctx)
- if _, err := w.Write([]byte("data")); err != nil {
- t.Errorf("Object %q write failed: %v. Want success", name, err)
- continue
- }
- if err := w.Close(); err != nil {
- t.Errorf("Object %q close failed: %v. Want success", name, err)
- continue
- }
- defer bkt.Object(name).Delete(ctx)
- }
- invalidNames := []string{
- "", // Too short.
- strings.Repeat("a", 1025), // Too long.
- "new\nlines",
- "bad\xffunicode",
- }
- for _, name := range invalidNames {
- w := bkt.Object(name).NewWriter(ctx)
- // Invalid object names will either cause failure during Write or Close.
- if _, err := w.Write([]byte("data")); err != nil {
- continue
- }
- if err := w.Close(); err != nil {
- continue
- }
- defer bkt.Object(name).Delete(ctx)
- t.Errorf("%q should have failed. Didn't", name)
- }
- }
- func TestWriterContentType(t *testing.T) {
- ctx := context.Background()
- client, bucket := testConfig(ctx, t)
- defer client.Close()
- obj := client.Bucket(bucket).Object("content" + suffix)
- testCases := []struct {
- content string
- setType, wantType string
- }{
- {
- content: "It was the best of times, it was the worst of times.",
- wantType: "text/plain; charset=utf-8",
- },
- {
- content: "<html><head><title>My first page</title></head></html>",
- wantType: "text/html; charset=utf-8",
- },
- {
- content: "<html><head><title>My first page</title></head></html>",
- setType: "text/html",
- wantType: "text/html",
- },
- {
- content: "<html><head><title>My first page</title></head></html>",
- setType: "image/jpeg",
- wantType: "image/jpeg",
- },
- }
- for _, tt := range testCases {
- w := obj.NewWriter(ctx)
- w.ContentType = tt.setType
- if _, err := w.Write([]byte(tt.content)); err != nil {
- t.Errorf("w.Write: %v", err)
- }
- if err := w.Close(); err != nil {
- t.Errorf("w.Close: %v", err)
- }
- attrs, err := obj.Attrs(ctx)
- if err != nil {
- t.Errorf("obj.Attrs: %v", err)
- continue
- }
- if got := attrs.ContentType; got != tt.wantType {
- t.Errorf("Content-Type = %q; want %q\nContent: %q\nSet Content-Type: %q", got, tt.wantType, tt.content, tt.setType)
- }
- }
- }
- // cleanup deletes any objects in the default bucket which were created
- // during this test run (those with the designated suffix), and any
- // objects whose suffix indicates they were created over an hour ago.
- func cleanup() error {
- if testing.Short() {
- return nil // Don't clean up in short mode.
- }
- ctx := context.Background()
- client, bucket := config(ctx)
- if client == nil {
- return nil // Don't cleanup if we're not configured correctly.
- }
- defer client.Close()
- suffixRE := regexp.MustCompile(`-t(\d+)$`)
- deadline := time.Now().Add(-1 * time.Hour)
- var q *Query
- for {
- o, err := client.Bucket(bucket).List(ctx, q)
- if err != nil {
- return fmt.Errorf("cleanup list failed: %v", err)
- }
- for _, obj := range o.Results {
- // Delete the object if it matches the suffix exactly,
- // or has a suffix marked before the deadline.
- del := strings.HasSuffix(obj.Name, suffix)
- if m := suffixRE.FindStringSubmatch(obj.Name); m != nil {
- if ns, err := strconv.ParseInt(m[1], 10, 64); err == nil && time.Unix(0, ns).Before(deadline) {
- del = true
- }
- }
- if !del {
- continue
- }
- log.Printf("Cleanup deletion of %q", obj.Name)
- if err := client.Bucket(bucket).Object(obj.Name).Delete(ctx); err != nil {
- // Print the error out, but keep going.
- log.Printf("Cleanup deletion of %q failed: %v", obj.Name, err)
- }
- }
- if o.Next == nil {
- break
- }
- q = o.Next
- }
- // TODO(djd): Similarly list and clean up buckets.
- return nil
- }
- func randomContents() []byte {
- h := md5.New()
- io.WriteString(h, fmt.Sprintf("hello world%d", rand.Intn(100000)))
- return h.Sum(nil)
- }
|