New quickstarts. (#226)

* New quickstarts.

* Address comments.

Author: jmdobry

vision/samples/package.json

@@ -15,9 +15,12 @@
     "redis": "^2.6.0-2"
   },
   "devDependencies": {
-    "mocha": "^2.5.3"
+    "mocha": "^3.1.0"
   },
   "optionalDependencies": {
     "canvas": "^1.3.15"
+  },
+  "engines": {
+    "node": ">=4.3.2"
   }
 }

vision/samples/quickstart.js

@@ -0,0 +1,43 @@
+/**
+ * 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 vision_quickstart]
+// Imports the Google Cloud client library
+const Vision = require('@google-cloud/vision');
+
+// Your Google Cloud Platform project ID
+const projectId = 'YOUR_PROJECT_ID';
+
+// Instantiates a client
+const visionClient = Vision({
+  projectId: projectId
+});
+
+// The name of the image file to annotate
+const fileName = './resources/wakeupcat.jpg';
+
+// Performs label detection on the image file
+visionClient.detectLabels(fileName, (err, labels) => {
+  if (err) {
+    console.error(err);
+    return;
+  }
+
+  console.log('Labels:');
+  labels.forEach((label) => console.log(label));
+});
+// [END vision_quickstart]

vision/samples/system-test/quickstart.test.js

@@ -0,0 +1,54 @@
+/**
+ * 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`).noPreserveCache();
+const vision = proxyquire(`@google-cloud/vision`, {})();
+const path = require(`path`);
+
+describe(`vision:quickstart`, () => {
+  let visionMock, VisionMock;
+
+  it(`should detect labels`, (done) => {
+    const filePath = path.join(__dirname, `../resources/wakeupcat.jpg`);
+    const expectedFileName = `./resources/wakeupcat.jpg`;
+
+    visionMock = {
+      detectLabels: (_fileName, _callback) => {
+        assert.equal(_fileName, expectedFileName);
+        assert.equal(typeof _callback, 'function');
+
+        vision.detectLabels(filePath, (err, labels, apiResponse) => {
+          _callback(err, labels, apiResponse);
+          assert.ifError(err);
+          assert.equal(Array.isArray(labels), true);
+          assert.notEqual(apiResponse, undefined);
+          assert.equal(console.log.called, true);
+          assert.deepEqual(console.log.firstCall.args, [`Labels:`]);
+          labels.forEach((label, i) => {
+            assert.deepEqual(console.log.getCall(i + 1).args, [label]);
+          });
+          done();
+        });
+      }
+    };
+    VisionMock = sinon.stub().returns(visionMock);
+
+    proxyquire(`../quickstart`, {
+      '@google-cloud/vision': VisionMock
+    });
+  });
+});

vision/samples/test/quickstart.test.js

@@ -0,0 +1,44 @@
+/**
+ * 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(`vision:quickstart`, () => {
+  let visionMock, VisionMock;
+  const error = new Error(`error`);
+  const fileName = `./resources/wakeupcat.jpg`;
+
+  before(() => {
+    visionMock = {
+      detectLabels: sinon.stub().yields(error)
+    };
+    VisionMock = sinon.stub().returns(visionMock);
+  });
+
+  it(`should handle error`, () => {
+    proxyquire(`../quickstart`, {
+      '@google-cloud/vision': VisionMock
+    });
+
+    assert.equal(VisionMock.calledOnce, true);
+    assert.deepEqual(VisionMock.firstCall.args, [{ projectId: 'YOUR_PROJECT_ID' }]);
+    assert.equal(visionMock.detectLabels.calledOnce, true);
+    assert.deepEqual(visionMock.detectLabels.firstCall.args.slice(0, -1), [fileName]);
+    assert.equal(console.error.calledOnce, true);
+    assert.deepEqual(console.error.firstCall.args, [error]);
+  });
+});