Text-to-Speech Code Samples for Listing Voices and Synthesizing Speech

.circleci/config.yml

@@ -37,10 +37,18 @@ workflows:
           filters:
             tags:
               only: /.*/
-      - publish_npm:
+      - sample_tests:
           requires:
             - lint
             - docs
+          filters:
+            branches:
+              only: master
+            tags:
+              only: '/^v[\d.]+$/'
+      - publish_npm:
+          requires:
+            - sample_tests
           filters:
             branches:
               ignore: /.*/
@@ -112,6 +120,15 @@ jobs:
             npm link
           environment:
             NPM_CONFIG_PREFIX: /home/node/.npm-global
+      - run:
+          name: Link the module being tested to the samples.
+          command: |
+            cd samples/
+            npm link @google-cloud/text-to-speech
+            npm install
+            cd ..
+          environment:
+            NPM_CONFIG_PREFIX: /home/node/.npm-global
       - run:
           name: Run linting.
           command: npm run lint
@@ -130,6 +147,48 @@ jobs:
       - run:
           name: Build documentation.
           command: npm run docs
+  sample_tests:
+    docker:
+      - image: 'node:8'
+        user: node
+    steps:
+      - checkout
+      - run: *remove_package_lock
+      - run:
+          name: Decrypt credentials.
+          command: |
+            openssl aes-256-cbc -d -in .circleci/key.json.enc \
+                -out .circleci/key.json \
+                -k "${SYSTEM_TESTS_ENCRYPTION_KEY}"
+      - run:
+          name: Install and link the module.
+          command: |
+            mkdir -p /home/node/.npm-global
+            npm install
+            npm link
+          environment:
+            NPM_CONFIG_PREFIX: /home/node/.npm-global
+      - run:
+          name: Link the module being tested to the samples.
+          command: |
+            cd samples/
+            npm link @google-cloud/text-to-speech
+            npm install
+            cd ..
+          environment:
+            NPM_CONFIG_PREFIX: /home/node/.npm-global
+      - run:
+          name: Run sample tests.
+          command: npm run samples-test
+          environment:
+            GCLOUD_PROJECT: long-door-651
+            GOOGLE_APPLICATION_CREDENTIALS: /home/node/text-to-speech-samples/.circleci/key.json
+            NPM_CONFIG_PREFIX: /home/node/.npm-global
+      - run:
+          name: Remove unencrypted key.
+          command: rm .circleci/key.json
+          when: always
+    working_directory: /home/node/text-to-speech-samples
   publish_npm:
     docker:
       - image: 'node:8'
@@ -141,4 +200,4 @@ jobs:
           command: 'echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > ~/.npmrc'
       - run:
           name: Publish the module to npm.
-          command: npm publish --access=public
+          command: npm publish

.cloud-repo-tools.json

@@ -9,5 +9,21 @@
   "requiresKeyFile": true,
   "requiresProjectId": true,
   "client_reference_url": "https://cloud.google.com/nodejs/docs/reference/text-to-speech/latest/",
-  "release_quality": "alpha"
+  "release_quality": "alpha",
+  "samples": [
+    {
+      "id": "synthesize_speech",
+      "name": "Synthesize Speech",
+      "file": "synthesize.js",
+      "docs_link": "https://cloud.google.com/text-to-speech/docs",
+      "usage": "node synthesize.js --help"
+    },
+    {
+      "id": "list_voices",
+      "name": "List supported voices",
+      "file": "listVoices.js",
+      "docs_link": "https://cloud.google.com/text-to-speech/docs",
+      "usage": "node listVoices.js --help"
+    }
+  ]
 }

.github/ISSUE_TEMPLATE.md

@@ -15,7 +15,7 @@ possible:
   - OS:
   - Node.js version:
   - npm version:
-  - `text-to-speech` version:
+  - `@google-cloud/text-to-speech` version:
 
 #### Steps to reproduce
 

.gitignore

@@ -4,6 +4,10 @@
 .nyc_output
 docs/
 out/
+build/
 system-test/secrets.js
 system-test/*key.json
 *.lock
+.DS_Store
+google-cloud-logging-winston-*.tgz
+google-cloud-logging-bunyan-*.tgz

.jsdoc.js

@@ -39,7 +39,7 @@ module.exports = {
     copyright: 'Copyright 2017 Google, Inc.',
     includeDate: false,
     sourceFiles: false,
-    systemName: 'text-to-speech',
+    systemName: '@google-cloud/text-to-speech',
     theme: 'lumen'
   }
 };

CONTRIBUTORS

@@ -4,3 +4,4 @@
 #   name <email>
 #
 Alexander Fenster <[email protected]>
+Rebecca Taylor <[email protected]>

README.md

@@ -1,3 +1,5 @@
+[//]: # "This README.md file is auto-generated, all changes to this file will be lost."
+[//]: # "To regenerate it, use `npm run generate-scaffolding`."
 <img src="https://avatars2.githubusercontent.com/u/2810941?v=3&s=96" alt="Google Cloud Platform logo" title="Google Cloud Platform" align="right" height="96" width="96"/>
 
 # [Google Cloud Text-To-Speech: Node.js Client](https://github.com/googleapis/nodejs-text-to-speech)
@@ -27,6 +29,7 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
   * [Before you begin](#before-you-begin)
   * [Installing the client library](#installing-the-client-library)
   * [Using the client library](#using-the-client-library)
+* [Samples](#samples)
 * [Versioning](#versioning)
 * [Contributing](#contributing)
 * [License](#license)
@@ -57,9 +60,58 @@ Google APIs Client Libraries, in [Client Libraries Explained][explained].
 
 ### Installing the client library
 
-    npm install --save text-to-speech
-
-
+    npm install --save @google-cloud/text-to-speech
+
+### Using the client library
+
+```javascript
+const fs = require('fs');
+
+// Imports the Google Cloud client library
+const textToSpeech = require('@google-cloud/text-to-speech');
+
+// Creates a client
+const client = new textToSpeech.TextToSpeechClient();
+
+// The text to synthesize
+const text = 'Hello, world!';
+
+// Construct the request
+const request = {
+  input: {text: text},
+  // Select the language and SSML Voice Gender (optional)
+  voice: {languageCode: 'en-US', ssmlGender: 'NEUTRAL'},
+  // Select the type of audio encoding
+  audioConfig: {audioEncoding: 'MP3'},
+};
+
+// Performs the Text-to-Speech request
+client.synthesizeSpeech(request, (err, response) => {
+  if (err) {
+    console.error('ERROR:', err);
+    return;
+  }
+
+  // Write the binary audio content to a local file
+  fs.writeFile('output.mp3', response.audioContent, 'binary', err => {
+    if (err) {
+      console.error('ERROR:', err);
+      return;
+    }
+    console.log('Audio content written to file: output.mp3');
+  });
+});
+```
+
+## Samples
+
+Samples are in the [`samples/`](https://github.com/googleapis/nodejs-text-to-speech/tree/master/samples) directory. The samples' `README.md`
+has instructions for running the samples.
+
+| Sample                      | Source Code                       | Try it |
+| --------------------------- | --------------------------------- | ------ |
+| Synthesize Speech | [source code](https://github.com/googleapis/nodejs-text-to-speech/blob/master/samples/synthesize.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-text-to-speech&page=editor&open_in_editor=samples/synthesize.js,samples/README.md) |
+| List supported voices | [source code](https://github.com/googleapis/nodejs-text-to-speech/blob/master/samples/listVoices.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-text-to-speech&page=editor&open_in_editor=samples/listVoices.js,samples/README.md) |
 
 The [Text-To-Speech Node.js Client API Reference][client-docs] documentation
 also contains samples.