Add Translate API samples. Fixes #176. (#184)

* Add Translate API samples. Fixes #176.

* Fix build.

* Add comment.

* Address comments

translate/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "nodejs-docs-samples-translate",
+  "version": "0.0.1",
+  "private": true,
+  "license": "Apache Version 2.0",
+  "author": "Google Inc.",
+  "scripts": {
+    "test": "mocha -R spec -t 120000 --require intelli-espower-loader ../test/_setup.js test/*.test.js",
+    "system-test": "mocha -R spec -t 120000 --require intelli-espower-loader ../system-test/_setup.js system-test/*.test.js"
+  },
+  "dependencies": {
+    "@google-cloud/translate": "^0.1.1",
+    "iso-639-1": "^1.2.1",
+    "yargs": "^5.0.0"
+  },
+  "devDependencies": {
+    "mocha": "^3.0.2"
+  }
+}

translate/system-test/translate.test.js

@@ -0,0 +1,66 @@
+// 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';
+
+var program = require('../translate');
+var apiKey = process.env.TRANSLATE_API_KEY;
+var text = 'Hello world!';
+
+describe('translate:translate', function () {
+  if (!process.env.TRANSLATE_API_KEY) {
+    process.stdout.write('Skipping Translate API tests...\n');
+    return;
+  }
+  describe('detectLanguage', function () {
+    it('should detect language', function (done) {
+      program.detectLanguage(text, apiKey, function (err, result) {
+        assert.ifError(err);
+        assert(result, 'should have received a result');
+        assert.equal(result.language, 'en', 'should have detected english');
+        assert(console.log.calledWith('Detected %s with confidence %d', 'English', result.confidence));
+        done();
+      });
+    });
+  });
+
+  describe('listLanguages', function () {
+    it('should list languages', function (done) {
+      program.listLanguages(apiKey, function (err, languages) {
+        assert.ifError(err);
+        assert(Array.isArray(languages));
+        assert(languages.length > 0);
+        assert(console.log.calledWith('Found %d language(s)!', languages.length));
+        done();
+      });
+    });
+  });
+
+  describe('translateText', function () {
+    it('should translate text', function (done) {
+      var options = {
+        text: text,
+        apiKey: apiKey,
+        to: 'ru'
+      };
+      var expected = 'Привет мир!';
+
+      program.translateText(options, function (err, translation) {
+        assert.ifError(err);
+        assert.equal(translation, expected);
+        assert(console.log.calledWith('Translated text to %s', 'Russian'));
+        done();
+      });
+    });
+  });
+});

translate/test/translate.test.js

@@ -0,0 +1,188 @@
+// 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';
+
+var proxyquire = require('proxyquire').noCallThru();
+var text = 'Hello world!';
+var apiKey = 'key';
+
+function getSample () {
+  var languagesMock = [
+    'en',
+    'ru'
+  ];
+  var resultMock = {
+    language: 'en',
+    confidence: 0.75,
+    input: text
+  };
+  var translationMock = 'Привет мир!';
+  var translateMock = {
+    getLanguages: sinon.stub().callsArgWith(0, null, languagesMock),
+    detect: sinon.stub().callsArgWith(1, null, resultMock),
+    translate: sinon.stub().callsArgWith(2, null, translationMock)
+  };
+  var TranslateMock = sinon.stub().returns(translateMock);
+
+  return {
+    program: proxyquire('../translate', {
+      '@google-cloud/translate': TranslateMock,
+      yargs: proxyquire('yargs', {})
+    }),
+    mocks: {
+      Translate: TranslateMock,
+      translate: translateMock,
+      languages: languagesMock,
+      result: resultMock,
+      translation: translationMock
+    }
+  };
+}
+
+describe('translate:translate', function () {
+  describe('detectLanguage', function () {
+    it('should detect language', function () {
+      var sample = getSample();
+      var callback = sinon.stub();
+
+      sample.program.detectLanguage(text, apiKey, callback);
+
+      assert(sample.mocks.translate.detect.calledOnce, 'method called once');
+      assert.equal(sample.mocks.translate.detect.firstCall.args.length, 2, 'method received 2 arguments');
+      assert.equal(sample.mocks.translate.detect.firstCall.args[0], text, 'method received correct argument');
+      assert(callback.calledOnce, 'callback called once');
+      assert.equal(callback.firstCall.args.length, 2, 'callback received 2 arguments');
+      assert.ifError(callback.firstCall.args[0], 'callback did not receive error');
+      assert.strictEqual(callback.firstCall.args[1], sample.mocks.result, 'callback received result');
+      assert(console.log.calledWith('Detected %s with confidence %d', 'English', sample.mocks.result.confidence));
+    });
+
+    it('should handle error', function () {
+      var error = 'error';
+      var sample = getSample();
+      var callback = sinon.stub();
+      sample.mocks.translate.detect = sinon.stub().callsArgWith(1, error);
+
+      sample.program.detectLanguage(text, apiKey, callback);
+
+      assert(callback.calledOnce, 'callback called once');
+      assert.equal(callback.firstCall.args.length, 1, 'callback received 1 argument');
+      assert(callback.firstCall.args[0], 'callback received error');
+      assert.equal(callback.firstCall.args[0].message, error.message, 'error has correct message');
+    });
+  });
+
+  describe('listLanguages', function () {
+    it('should list languages', function () {
+      var sample = getSample();
+      var callback = sinon.stub();
+
+      sample.program.listLanguages(apiKey, callback);
+
+      assert(sample.mocks.translate.getLanguages.calledOnce, 'method called once');
+      assert.equal(sample.mocks.translate.getLanguages.firstCall.args.length, 1, 'method received 1 argument');
+      assert(callback.calledOnce, 'callback called once');
+      assert.equal(callback.firstCall.args.length, 2, 'callback received 2 arguments');
+      assert.ifError(callback.firstCall.args[0], 'callback did not receive error');
+      assert.strictEqual(callback.firstCall.args[1], sample.mocks.languages, 'callback received result');
+      assert(console.log.calledWith('Found %d language(s)!', sample.mocks.languages.length));
+    });
+
+    it('should handle error', function () {
+      var error = 'error';
+      var sample = getSample();
+      var callback = sinon.stub();
+      sample.mocks.translate.getLanguages = sinon.stub().callsArgWith(0, error);
+
+      sample.program.listLanguages(apiKey, callback);
+
+      assert(callback.calledOnce, 'callback called once');
+      assert.equal(callback.firstCall.args.length, 1, 'callback received 1 argument');
+      assert(callback.firstCall.args[0], 'callback received error');
+      assert.equal(callback.firstCall.args[0].message, error.message, 'error has correct message');
+    });
+  });
+
+  describe('translateText', function () {
+    it('should translate text', function () {
+      var sample = getSample();
+      var callback = sinon.stub();
+      var options = {
+        text: text,
+        to: 'ru',
+        apiKey: apiKey
+      };
+
+      sample.program.translateText(options, callback);
+
+      assert(sample.mocks.translate.translate.calledOnce, 'method called once');
+      assert.equal(sample.mocks.translate.translate.firstCall.args.length, 3, 'method received 3 arguments');
+      assert.equal(sample.mocks.translate.translate.firstCall.args[0], text, 'method received correct first argument');
+      assert.deepEqual(sample.mocks.translate.translate.firstCall.args[1], {
+        to: 'ru',
+        from: undefined
+      }, 'method received correct second argument');
+      assert(callback.calledOnce, 'callback called once');
+      assert.equal(callback.firstCall.args.length, 2, 'callback received 2 arguments');
+      assert.ifError(callback.firstCall.args[0], 'callback did not receive error');
+      assert.strictEqual(callback.firstCall.args[1], sample.mocks.translation, 'callback received result');
+      assert(console.log.calledWith('Translated text to %s', 'Russian'));
+    });
+
+    it('should handle error', function () {
+      var error = 'error';
+      var sample = getSample();
+      var callback = sinon.stub();
+      var options = {
+        text: text,
+        to: 'ru',
+        apiKey: apiKey
+      };
+      sample.mocks.translate.translate = sinon.stub().callsArgWith(2, error);
+
+      sample.program.translateText(options, callback);
+
+      assert(callback.calledOnce, 'callback called once');
+      assert.equal(callback.firstCall.args.length, 1, 'callback received 1 argument');
+      assert(callback.firstCall.args[0], 'callback received error');
+      assert.equal(callback.firstCall.args[0].message, error.message, 'error has correct message');
+    });
+  });
+
+  describe('main', function () {
+    it('should call detectLanguage', function () {
+      var program = getSample().program;
+
+      sinon.stub(program, 'detectLanguage');
+      program.main(['detect', text, '-k', apiKey]);
+      assert(program.detectLanguage.calledOnce);
+    });
+
+    it('should call listLanguages', function () {
+      var program = getSample().program;
+
+      sinon.stub(program, 'listLanguages');
+      program.main(['list', '-k', apiKey]);
+      assert(program.listLanguages.calledOnce);
+    });
+
+    it('should call translateText', function () {
+      var program = getSample().program;
+
+      sinon.stub(program, 'translateText');
+      program.main(['translate', text, '-k', apiKey, '-t', 'ru']);
+      assert(program.translateText.calledOnce);
+    });
+  });
+});