Add tests to Storage quickstart.

tswast · tswast · commit cf58018daeac · 2016-10-26T09:43:33.000-07:00
Had to update the sample to accept a bucket name argument, since bucket
names must be globally unique. (And we actually want to be able to run
the sample for integration / system tests.)
diff --git a/storage/cloud-client/README.md b/storage/cloud-client/README.md
@@ -0,0 +1,28 @@
+# Getting Started with Cloud Storage and the Google Cloud Client libraries
+
+[Google Cloud Storage][storage]  is unified object storage for developers and enterprises, from live
+data serving to data analytics/ML to data archival.
+These sample Java applications demonstrate how to access the Cloud Storage API using
+the [Google Cloud Client Library for Java][google-cloud-java].
+
+[storage]: https://cloud.google.com/storage/
+[google-cloud-java]: https://github.com/GoogleCloudPlatform/google-cloud-java
+
+## Quickstart
+
+Install [Maven](http://maven.apache.org/).
+
+Build your project with:
+
+	mvn clean package -DskipTests
+
+You can then run a given `ClassName` via:
+
+	mvn exec:java -Dexec.mainClass=com.example.storage.ClassName \
+	    -DpropertyName=propertyValue \
+		-Dexec.args="any arguments to the app"
+
+### Creating a new bucket (using the quickstart sample)
+
+    mvn exec:java -Dexec.mainClass=com.example.storage.QuickstartSample \
+        -Dexec.args="my-bucket-name"
diff --git a/storage/cloud-client/pom.xml b/storage/cloud-client/pom.xml
@@ -39,5 +39,19 @@
       <artifactId>google-cloud-storage</artifactId>
       <version>0.4.0</version>
     </dependency>
+
+    <!-- Test dependencies -->
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>4.12</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.google.truth</groupId>
+      <artifactId>truth</artifactId>
+      <version>0.30</version>
+      <scope>test</scope>
+    </dependency>
   </dependencies>
 </project>
diff --git a/storage/cloud-client/src/main/java/com/example/storage/QuickstartSample.java b/storage/cloud-client/src/main/java/com/example/storage/QuickstartSample.java
@@ -29,7 +29,7 @@ public static void main(String... args) throws Exception {
     Storage storage = StorageOptions.defaultInstance().service();
 
     // The name for the new bucket
-    String bucketName = "my-new-bucket";
+    String bucketName = args[0];
 
     // Creates the new bucket
     Bucket bucket = storage.create(BucketInfo.of(bucketName));
diff --git a/storage/cloud-client/src/test/java/com/example/storage/QuickstartSampleIT.java b/storage/cloud-client/src/test/java/com/example/storage/QuickstartSampleIT.java
@@ -0,0 +1,70 @@
+/*
+  Copyright 2016, Google, Inc.
+
+  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 com.example.storage;
+
+import static com.google.common.truth.Truth.assertThat;
+
+import com.google.cloud.storage.Storage;
+import com.google.cloud.storage.StorageOptions;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.JUnit4;
+
+import java.io.ByteArrayOutputStream;
+import java.io.PrintStream;
+import java.util.UUID;
+
+/**
+ * Tests for quickstart sample.
+ */
+@RunWith(JUnit4.class)
+@SuppressWarnings("checkstyle:abbreviationaswordinname")
+public class QuickstartSampleIT {
+  private String bucketName;
+  private ByteArrayOutputStream bout;
+  private PrintStream out;
+
+  private static final void deleteBucket(String bucketName) {
+    Storage storage = StorageOptions.defaultInstance().service();
+    storage.delete(bucketName);
+  }
+
+  @Before
+  public void setUp() {
+    bucketName = "my-new-bucket-" + UUID.randomUUID().toString();
+
+    bout = new ByteArrayOutputStream();
+    out = new PrintStream(bout);
+    System.setOut(out);
+  }
+
+  @After
+  public void tearDown() {
+    System.setOut(null);
+    deleteBucket(bucketName);
+  }
+
+  @Test
+  public void testQuickstart() throws Exception {
+    QuickstartSample.main(bucketName);
+    String got = bout.toString();
+    assertThat(got).contains(String.format("Bucket %s created.", bucketName));
+  }
+}
+// [END datastore_quickstart]
