- [Resource Manager] (#testing-code-that-uses-resource-manager)

- [BigQuery] (#testing-code-that-uses-bigquery)

Currently, there isn't an emulator for Google Cloud Storage, so an alternative is to create a test project. `RemoteStorageHelper` contains convenience methods to make setting up and cleaning up the test project easier. To use this class, follow the steps below:

1. Create a test Google Cloud project.

3. Create a `RemoteStorageHelper` object using your project ID and JSON key.

Here is an example that uses the `RemoteStorageHelper` to create a bucket.

RemoteStorageHelper helper =

RemoteStorageHelper.create(PROJECT_ID, new FileInputStream("/path/to/my/JSON/key.json"));

Storage storage = helper.options().service();

String bucket = RemoteStorageHelper.generateBucketName();

storage.create(BucketInfo.of(bucket));

4. Run your tests.

5. Clean up the test project by using `forceDelete` to clear any buckets used.

Here is an example that clears the bucket created in Step 3 with a timeout of 5 seconds.

RemoteStorageHelper.forceDelete(storage, bucket, 5, TimeUnit.SECONDS);

Currently, there isn't an emulator for Google BigQuery, so an alternative is to create a test

project. `RemoteBigQueryHelper` contains convenience methods to make setting up and cleaning up the

test project easier. To use this class, follow the steps below:

2. Download a [JSON service account credentials file][create-service-account] from the Google

Developer's Console.

3. Create a `RemoteBigQueryHelper` object using your project ID and JSON key.

Here is an example that uses the `RemoteBigQueryHelper` to create a dataset.

RemoteBigQueryHelper bigqueryHelper =

RemoteBigQueryHelper.create(PROJECT_ID, new FileInputStream("/path/to/my/JSON/key.json"));

BigQuery bigquery = bigqueryHelper.options().service();

String dataset = RemoteBigQueryHelper.generateDatasetName();

bigquery.create(DatasetInfo.builder(dataset).build());

5. Clean up the test project by using `forceDelete` to clear any datasets used.

Here is an example that clears the dataset created in Step 3.

RemoteBigQueryHelper.forceDelete(bigquery, dataset);

```

You can test against a temporary local Pub/Sub by following these steps:

1. Start the local Pub/Sub emulator before running your tests using `LocalPubSubHelper`'s `create`

and `start` methods. This will bind a port for communication with the local Pub/Sub emulator.

```java

LocalPubSubHelper helper = LocalPubSubHelper.create();

helper.start(); // Starts the local Pub/Sub emulator in a separate process

```

2. Create and use a `PubSub` object with the options given by the `LocalPubSubHelper` instance. For

example:

```java

PubSub localPubsub = helper.options().service();

```

3. Run your tests.

4. Stop the local Pub/Sub emulator by calling the `stop()` method, like so:

```java

helper.stop();

```

You can test against a remote Pub/Sub emulator as well. To do this, set the `PubSubOptions` project

endpoint to the hostname of the remote machine, like the example below.

```java

PubSubOptions options = PubSubOptions.builder()

.projectId("my-project-id") // must match project ID specified on remote machine

.host("<hostname of machine>:<port>")

.authCredentials(AuthCredentials.noAuth())

.build();

PubSub localPubsub= options.service();

<?xml version="1.0"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

<modelVersion>4.0.0</modelVersion>

<groupId>com.google.gcloud</groupId>

<artifactId>gcloud-java-nio</artifactId>

<packaging>jar</packaging>

<name>GCloud Java NIO</name>

<description>

FileSystemProvider for Java NIO to access GCS transparently.

</description>

<parent>

<groupId>com.google.gcloud</groupId>

<artifactId>gcloud-java-contrib</artifactId>

<version>0.1.4-SNAPSHOT</version>

</parent>

<properties>

<site.installationModule>nio</site.installationModule>

</properties>

<dependencies>

<dependency>

<groupId>${project.groupId}</groupId>

<artifactId>gcloud-java</artifactId>

<version>${project.version}</version>

</dependency>

<dependency>

<groupId>com.google.guava</groupId>

<artifactId>guava</artifactId>

<version>19.0</version>

</dependency>

<dependency>

<groupId>com.google.code.findbugs</groupId>

<artifactId>jsr305</artifactId>

<version>2.0.1</version>

</dependency>

<dependency>

<groupId>javax.inject</groupId>

<artifactId>javax.inject</artifactId>

<version>1</version>

</dependency>

<dependency>

<groupId>com.google.auto.service</groupId>

<artifactId>auto-service</artifactId>

<version>1.0-rc2</version>

<scope>provided</scope> <!-- to leave out of the all-deps jar -->

</dependency>

<dependency>

<groupId>com.google.auto.value</groupId>

<artifactId>auto-value</artifactId>

<version>1.1</version>

<scope>provided</scope> <!-- to leave out of the all-deps jar -->

</dependency>

<dependency>

<groupId>com.google.appengine.tools</groupId>

<artifactId>appengine-gcs-client</artifactId>

<version>0.5</version>

</dependency>

<dependency>

<groupId>junit</groupId>

<artifactId>junit</artifactId>

<version>4.12</version>

<scope>test</scope>

</dependency>

<dependency>

<groupId>com.google.guava</groupId>

<artifactId>guava-testlib</artifactId>

<version>19.0</version>

<scope>test</scope>

</dependency>

<dependency>

<groupId>com.google.truth</groupId>

<artifactId>truth</artifactId>

<version>0.27</version>

<scope>test</scope>

</dependency>

<dependency>

<groupId>org.mockito</groupId>

<artifactId>mockito-core</artifactId>

<version>1.9.5</version>

</dependency>

<dependency>

<groupId>com.google.appengine</groupId>

<artifactId>appengine-testing</artifactId>

<version>1.9.30</version>

<scope>test</scope>

</dependency>

<dependency>

<groupId>com.google.appengine</groupId>

<artifactId>appengine-api-stubs</artifactId>

<version>1.9.30</version>

<scope>test</scope>

</dependency>

<dependency>

<groupId>com.google.appengine</groupId>

<artifactId>appengine-local-endpoints</artifactId>

<version>1.9.30</version>

<scope>test</scope>

</dependency>

</dependencies>

<build>

<plugins>

<plugin>

<groupId>org.codehaus.mojo</groupId>

<artifactId>exec-maven-plugin</artifactId>

<configuration>

<skip>false</skip>

</configuration>

</plugin>

<plugin>

<artifactId>maven-compiler-plugin</artifactId>

<version>3.1</version>

<configuration>

<source>1.7</source>

<target>1.7</target>

<encoding>UTF-8</encoding>

<compilerArgument>-Xlint:unchecked</compilerArgument>

</configuration>

</plugin>

<plugin>

<artifactId>maven-jar-plugin</artifactId>

<version>2.6</version>

<configuration>

<archive>

<addMavenDescriptor>true</addMavenDescriptor>

<index>true</index>

<manifest>

<addDefaultImplementationEntries>true</addDefaultImplementationEntries>

<addDefaultSpecificationEntries>true</addDefaultSpecificationEntries>

</manifest>

<manifestEntries>

<artifactId>${project.artifactId}</artifactId>

<groupId>${project.groupId}</groupId>

<version>${project.version}</version>

<buildNumber>${buildNumber}</buildNumber>

</manifestEntries>

</archive>

</configuration>

</plugin>

</plugins>

</build>

</project>