Adds 6 quickstart examples (#218)

* Add some simple "quickstart" samples.

* Add quickstart tests (#215)

* First draft of new tests

* Fix failing tests

* Fix comments

* Add comments.

* Update comments.

* Add another comment.

* Cleanup.

* Fix region tags.

* Fix comments.

Author: jmdobry

handwritten/pubsub/samples/quickstart.js

@@ -0,0 +1,29 @@
+// 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.
+
+'use strict';
+
+// [START pubsub_quickstart]
+// Imports and instantiates the Google Cloud client library
+// for Google Cloud Pub/Sub
+const pubsub = require('@google-cloud/pubsub')({
+  projectId: 'YOUR_PROJECT_ID'
+});
+
+// Creates a new topic
+pubsub.createTopic('my-new-topic', (err, topic) => {
+  if (!err) {
+    // The topic was created successfully
+  }
+});
+// [END pubsub_quickstart]

handwritten/pubsub/samples/system-test/quickstart.test.js

@@ -0,0 +1,56 @@
+// Copyright 2015-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.
+
+'use strict';
+
+const proxyquire = require(`proxyquire`).noPreserveCache();
+const pubsub = proxyquire(`@google-cloud/pubsub`, {})();
+const uuid = require(`node-uuid`);
+
+const topicName = `nodejs-docs-samples-test-${uuid.v4()}`;
+const projectId = process.env.GCLOUD_PROJECT;
+const fullTopicName = `projects/${projectId}/topics/${topicName}`;
+
+describe(`pubsub:quickstart`, () => {
+  let pubsubMock, PubSubMock;
+
+  after((done) => {
+    pubsub.topic(topicName).delete(() => {
+      // Ignore any error, the topic might not have been created
+      done();
+    });
+  });
+
+  it(`should create a topic`, (done) => {
+    const expectedTopicName = `my-new-topic`;
+
+    pubsubMock = {
+      createTopic: (_topicName) => {
+        assert.equal(_topicName, expectedTopicName);
+
+        pubsub.createTopic(topicName, (err, topic, apiResponse) => {
+          assert.ifError(err);
+          assert.notEqual(topic, undefined);
+          assert.equal(topic.name, fullTopicName);
+          assert.notEqual(apiResponse, undefined);
+          done();
+        });
+      }
+    };
+    PubSubMock = sinon.stub().returns(pubsubMock);
+
+    proxyquire(`../quickstart`, {
+      '@google-cloud/pubsub': PubSubMock
+    });
+  });
+});

handwritten/pubsub/samples/test/quickstart.test.js

@@ -0,0 +1,40 @@
+// 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.
+
+'use strict';
+
+const proxyquire = require(`proxyquire`).noCallThru();
+
+describe(`pubsub:quickstart`, () => {
+  let pubsubMock, PubSubMock;
+
+  const expectedTopicName = `my-new-topic`;
+
+  before(() => {
+    pubsubMock = {
+      createTopic: sinon.stub().yields(null, {}, {})
+    };
+    PubSubMock = sinon.stub().returns(pubsubMock);
+  });
+
+  it(`should create a topic`, () => {
+    proxyquire(`../quickstart`, {
+      '@google-cloud/pubsub': PubSubMock
+    });
+
+    assert.equal(PubSubMock.calledOnce, true);
+    assert.deepEqual(PubSubMock.firstCall.args, [{ projectId: 'YOUR_PROJECT_ID' }]);
+    assert.equal(pubsubMock.createTopic.calledOnce, true);
+    assert.deepEqual(pubsubMock.createTopic.firstCall.args.slice(0, -1), [expectedTopicName]);
+  });
+});