diff --git a/appengine/analytics/package.json b/appengine/analytics/package.json index ffbff2d52a..167f7df61a 100644 --- a/appengine/analytics/package.json +++ b/appengine/analytics/package.json @@ -26,7 +26,7 @@ "got": "6.7.1" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7" + "@google-cloud/nodejs-repo-tools": "1.4.13" }, "cloud-repo-tools": { "test": { diff --git a/appengine/cloudsql/package.json b/appengine/cloudsql/package.json index d0d0cbc7cb..8e5adba0d8 100644 --- a/appengine/cloudsql/package.json +++ b/appengine/cloudsql/package.json @@ -28,7 +28,7 @@ "prompt": "1.0.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1" }, "cloud-repo-tools": { diff --git a/appengine/datastore/package.json b/appengine/datastore/package.json index 9cb8f5424c..269e956fbd 100644 --- a/appengine/datastore/package.json +++ b/appengine/datastore/package.json @@ -26,7 +26,7 @@ "express": "4.15.2" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7" + "@google-cloud/nodejs-repo-tools": "1.4.13" }, "cloud-repo-tools": { "test": { diff --git a/appengine/endpoints/package.json b/appengine/endpoints/package.json index f3cdaac2b4..b7db632acc 100644 --- a/appengine/endpoints/package.json +++ b/appengine/endpoints/package.json @@ -28,7 +28,7 @@ "safe-buffer": "5.0.1" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1" }, "cloud-repo-tools": { diff --git a/appengine/errorreporting/package.json b/appengine/errorreporting/package.json index d59ae628f5..eab370b512 100644 --- a/appengine/errorreporting/package.json +++ b/appengine/errorreporting/package.json @@ -27,7 +27,7 @@ "winston": "2.3.1" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/appengine/hello-world/package.json b/appengine/hello-world/package.json index 6813f68ffa..3826113e3a 100644 --- a/appengine/hello-world/package.json +++ b/appengine/hello-world/package.json @@ -25,7 +25,7 @@ "express": "4.15.2" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7" + "@google-cloud/nodejs-repo-tools": "1.4.13" }, "cloud-repo-tools": { "test": { diff --git a/appengine/mailjet/package.json b/appengine/mailjet/package.json index 8b831b98c5..f3e49e0bdd 100644 --- a/appengine/mailjet/package.json +++ b/appengine/mailjet/package.json @@ -28,7 +28,7 @@ "node-mailjet": "1.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7" + "@google-cloud/nodejs-repo-tools": "1.4.13" }, "cloud-repo-tools": { "test": { diff --git a/bigquery/README.md b/bigquery/README.md index aef33625be..49f1625929 100644 --- a/bigquery/README.md +++ b/bigquery/README.md @@ -1,10 +1,10 @@ Google Cloud Platform logo -# BigQuery Node.js Samples +# Google BigQuery Node.js Samples [![Build](https://storage.googleapis.com/cloud-docs-samples-badges/GoogleCloudPlatform/nodejs-docs-samples/nodejs-docs-samples-bigquery.svg)]() -[BigQuery](https://cloud.google.com/bigquery/docs) is Google's fully managed, petabyte scale, low cost analytics data warehouse. +[BigQuery](https://cloud.google.com/bigquery/docs) is Google's fully managed, petabyte scale, low cost analytics data warehouse. BigQuery is NoOps—there is no infrastructure to manage and you don't need a database administrator—so you can focus on analyzing data to find meaningful insights, use familiar SQL, and take advantage of our pay-as-you-go model. ## Table of Contents @@ -20,11 +20,11 @@ 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -35,7 +35,6 @@ ### Datasets - View the [documentation][datasets_0_docs] or the [source code][datasets_0_code]. __Usage:__ `node datasets.js --help` @@ -66,7 +65,6 @@ For more information, see https://cloud.google.com/bigquery/docs ### Tables - View the [documentation][tables_1_docs] or the [source code][tables_1_code]. __Usage:__ `node tables.js --help` @@ -119,7 +117,6 @@ For more information, see https://cloud.google.com/bigquery/docs ### Queries - View the [documentation][queries_2_docs] or the [source code][queries_2_code]. __Usage:__ `node queries.js --help` @@ -150,15 +147,14 @@ For more information, see https://cloud.google.com/bigquery/docs ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/bigquery/package.json b/bigquery/package.json index 2a54cbe9bd..fc7ed2d4d8 100644 --- a/bigquery/package.json +++ b/bigquery/package.json @@ -23,7 +23,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0", diff --git a/computeengine/package.json b/computeengine/package.json index e68c50c14f..3fa7fe0fe6 100644 --- a/computeengine/package.json +++ b/computeengine/package.json @@ -26,7 +26,7 @@ "sendgrid": "5.0.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11" }, diff --git a/containerengine/hello-world/package.json b/containerengine/hello-world/package.json index 746f2bae7d..3601a47076 100644 --- a/containerengine/hello-world/package.json +++ b/containerengine/hello-world/package.json @@ -21,7 +21,7 @@ }, "dependencies": {}, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7" + "@google-cloud/nodejs-repo-tools": "1.4.13" }, "cloud-repo-tools": { "test": { diff --git a/datastore/README.md b/datastore/README.md index 62fd5d0228..9b929ca195 100644 --- a/datastore/README.md +++ b/datastore/README.md @@ -1,10 +1,10 @@ Google Cloud Platform logo -# Datastore Node.js Samples +# Google Cloud Datastore Node.js Samples [![Build](https://storage.googleapis.com/cloud-docs-samples-badges/GoogleCloudPlatform/nodejs-docs-samples/nodejs-docs-samples-datastore.svg)]() -[Cloud Datastore](https://cloud.google.com/datastore/docs) is a NoSQL document database built for automatic scaling, high performance, and ease of application development. +[Cloud Datastore](https://cloud.google.com/datastore/docs) is a NoSQL document database built for automatic scaling, high performance, and ease of application development. While the Cloud Datastore interface has many of the same features as traditional databases, as a NoSQL database it differs from them in the way it describes relationships between data objects. ## Table of Contents @@ -20,11 +20,11 @@ 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -35,7 +35,6 @@ ### Tasks - View the [documentation][tasks_0_docs] or the [source code][tasks_0_code]. __Usage:__ `node tasks.js --help` @@ -64,13 +63,11 @@ For more information, see https://cloud.google.com/datastore/docs ### Concepts - View the [documentation][concepts_1_docs] or the [source code][concepts_1_code].[concepts_1_docs]: https://cloud.google.com/datastore/docs/concepts/entities [concepts_1_code]: concepts.js ### Errors and Error Handling - View the [documentation][error_2_docs] or the [source code][error_2_code]. __Usage:__ `node error.js` @@ -79,15 +76,14 @@ __Usage:__ `node error.js` ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/datastore/package.json b/datastore/package.json index 06c40c5f3a..fcf454293b 100644 --- a/datastore/package.json +++ b/datastore/package.json @@ -22,7 +22,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/debugger/package.json b/debugger/package.json index 0154a3f964..fbc173d4e1 100644 --- a/debugger/package.json +++ b/debugger/package.json @@ -26,7 +26,7 @@ "express": "4.15.2" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7" + "@google-cloud/nodejs-repo-tools": "1.4.13" }, "cloud-repo-tools": { "test": { diff --git a/dlp/package.json b/dlp/package.json index 4d52139beb..c77347be8e 100644 --- a/dlp/package.json +++ b/dlp/package.json @@ -28,7 +28,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1" }, "cloud-repo-tools": { diff --git a/dns/README.md b/dns/README.md index 206b7ea9d2..e367942adf 100644 --- a/dns/README.md +++ b/dns/README.md @@ -2,12 +2,9 @@ # Google Cloud DNS Node.js Samples -Publish your domain names using Google's infrastructure for production-quality, -high-volume DNS services. Google's global network of anycast name servers -provide reliable, low-latency authoritative name lookups for your domains from -anywhere in the world. Read more about [Google Cloud DNS][dns_docs]. +[![Build](https://storage.googleapis.com/cloud-docs-samples-badges/GoogleCloudPlatform/nodejs-docs-samples/nodejs-docs-samples-dns.svg)]() -[dns_docs]: https://cloud.google.com/dns/docs +[Cloud DNS](https://cloud.google.com/dns/docs/) allows you to publish your domain names using Google's infrastructure for production-quality, high-volume DNS services. Google's global network of anycast name servers provide reliable, low-latency authoritative name lookups for your domains from anywhere in the world. ## Table of Contents @@ -21,11 +18,11 @@ anywhere in the world. Read more about [Google Cloud DNS][dns_docs]. 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -36,9 +33,9 @@ anywhere in the world. Read more about [Google Cloud DNS][dns_docs]. ### Zones -View the [documentation][zones_docs] or the [source code][zones_code]. +View the [documentation][zones_0_docs] or the [source code][zones_0_code]. -__Usage:__ `node zones --help` +__Usage:__ `node zones.js --help` ``` Commands: @@ -53,20 +50,19 @@ Examples: For more information, see https://cloud.google.com/dns/docs ``` -[zones_docs]: https://cloud.google.com/dns/docs -[zones_code]: zones.js +[zones_0_docs]: https://cloud.google.com/dns/docs +[zones_0_code]: zones.js ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/dns/package.json b/dns/package.json index 10651e1014..c77f10cfc4 100644 --- a/dns/package.json +++ b/dns/package.json @@ -22,13 +22,23 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" }, "cloud-repo-tools": { "requiresKeyFile": true, - "requiresProjectId": true + "requiresProjectId": true, + "product": "dns", + "samples": [ + { + "id": "zones", + "name": "Zones", + "file": "zones.js", + "docs_link": "https://cloud.google.com/dns/docs", + "usage": "node zones.js --help" + } + ] } } diff --git a/endpoints/getting-started-grpc/package.json b/endpoints/getting-started-grpc/package.json index 5b75dd466a..afe90c6ec3 100644 --- a/endpoints/getting-started-grpc/package.json +++ b/endpoints/getting-started-grpc/package.json @@ -24,7 +24,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1" }, "cloud-repo-tools": { diff --git a/endpoints/getting-started/package.json b/endpoints/getting-started/package.json index dbba3e2ddf..5a445b62ca 100644 --- a/endpoints/getting-started/package.json +++ b/endpoints/getting-started/package.json @@ -25,7 +25,7 @@ "safe-buffer": "5.0.1" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0", diff --git a/functions/background/package.json b/functions/background/package.json index e0713e39ae..4f5dcc9ee7 100644 --- a/functions/background/package.json +++ b/functions/background/package.json @@ -21,7 +21,7 @@ "request-promise": "4.2.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/datastore/package.json b/functions/datastore/package.json index 77429e4986..eea70ebddd 100644 --- a/functions/datastore/package.json +++ b/functions/datastore/package.json @@ -20,7 +20,7 @@ "@google-cloud/datastore": "1.0.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/gcs/package.json b/functions/gcs/package.json index b0e1661460..ebbdd3b54a 100644 --- a/functions/gcs/package.json +++ b/functions/gcs/package.json @@ -21,7 +21,7 @@ "request": "2.81.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/http/package.json b/functions/http/package.json index 5209f8b5ee..386e11cacb 100644 --- a/functions/http/package.json +++ b/functions/http/package.json @@ -17,7 +17,7 @@ "test": "ava -T 20s --verbose test/*.test.js" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/imagemagick/package.json b/functions/imagemagick/package.json index 4a04b47659..c1cf37ba8a 100644 --- a/functions/imagemagick/package.json +++ b/functions/imagemagick/package.json @@ -21,7 +21,7 @@ "@google-cloud/vision": "0.11.2" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/log/package.json b/functions/log/package.json index 7cb2c238dc..a8f4740d65 100644 --- a/functions/log/package.json +++ b/functions/log/package.json @@ -21,7 +21,7 @@ "@google-cloud/monitoring": "0.2.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/ocr/app/package.json b/functions/ocr/app/package.json index 733aeb05e3..7af7361b07 100644 --- a/functions/ocr/app/package.json +++ b/functions/ocr/app/package.json @@ -24,7 +24,7 @@ "safe-buffer": "5.0.1" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/pubsub/package.json b/functions/pubsub/package.json index 77100f7827..f6b56d8412 100644 --- a/functions/pubsub/package.json +++ b/functions/pubsub/package.json @@ -21,7 +21,7 @@ "safe-buffer": "5.0.1" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/sendgrid/package.json b/functions/sendgrid/package.json index 26e8cc1cef..1e592e4997 100644 --- a/functions/sendgrid/package.json +++ b/functions/sendgrid/package.json @@ -24,7 +24,7 @@ "uuid": "3.0.1" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/slack/package.json b/functions/slack/package.json index 0fbbc57616..e9d08bef97 100644 --- a/functions/slack/package.json +++ b/functions/slack/package.json @@ -20,7 +20,7 @@ "googleapis": "19.0.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/spanner/package.json b/functions/spanner/package.json index 587f035ed7..88eaea8142 100644 --- a/functions/spanner/package.json +++ b/functions/spanner/package.json @@ -20,7 +20,7 @@ "@google-cloud/spanner": "0.4.2" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/functions/uuid/package.json b/functions/uuid/package.json index 4b78fa0501..4f8237b865 100644 --- a/functions/uuid/package.json +++ b/functions/uuid/package.json @@ -20,7 +20,7 @@ "uuid": "3.0.1" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "sinon": "2.1.0" }, diff --git a/kms/README.md b/kms/README.md index 2091470c7e..1d124a7d6c 100644 --- a/kms/README.md +++ b/kms/README.md @@ -1,17 +1,16 @@ Google Cloud Platform logo -# Google Cloud KMS API Node.js Samples +# Google Cloud Key Management Service Node.js Samples -The [Cloud KMS API][kms_docs] is a service that allows you to keep encryption -keys centrally in the cloud, for direct use by cloud services. +[![Build](https://storage.googleapis.com/cloud-docs-samples-badges/GoogleCloudPlatform/nodejs-docs-samples/nodejs-docs-samples-kms.svg)]() -[kms_docs]: https://cloud.google.com/kms/docs/ +[Cloud KMS](https://cloud.google.com/kms/docs/) allows you to keep encryption keys in one central cloud service, for direct use by other cloud resources and applications. With Cloud KMS you are the ultimate custodian of your data, you can manage encryption in the cloud the same way you do on-premises, and you have a provable and monitorable root of trust over your data. ## Table of Contents * [Setup](#setup) * [Samples](#samples) - * [Quickstart](#quickstart) + * [KMS](#kms) * [Running the tests](#running-the-tests) ## Setup @@ -19,11 +18,11 @@ keys centrally in the cloud, for direct use by cloud services. 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -32,20 +31,9 @@ keys centrally in the cloud, for direct use by cloud services. ## Samples -### Quickstart +### KMS -View the [documentation][quickstart_docs] or the [source code][quickstart_code]. - -Run the sample: - - node quickstart.js - -[quickstart_docs]: https://cloud.google.com/kms/docs -[quickstart_code]: hostedmodels.js - -### Keys - -View the [documentation][keys_docs] or the [source code][keys_code]. +View the [documentation][kms_0_docs] or the [source code][kms_0_code]. __Usage:__ `node keys.js --help` @@ -66,7 +54,7 @@ Commands: Options: --help Show help [boolean] --location, -l [string] [default: "global"] - --projectId, -p [string] [default: "nodejs-docs-samples"] + --projectId, -p [string] Examples: node keys.js keyrings create "my-key-ring" @@ -92,20 +80,19 @@ Examples: For more information, see https://cloud.google.com/kms/docs ``` -[keys_docs]: https://cloud.google.com/kms/docs -[keys_code]: keys.js +[kms_0_docs]: https://cloud.google.com/kms/docs +[kms_0_code]: keys.js ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/kms/package.json b/kms/package.json index 840ff071f6..da1d0ec32c 100644 --- a/kms/package.json +++ b/kms/package.json @@ -23,12 +23,22 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11" }, "cloud-repo-tools": { "requiresKeyFile": true, - "requiresProjectId": true + "requiresProjectId": true, + "product": "kms", + "samples": [ + { + "id": "kms", + "name": "KMS", + "file": "keys.js", + "docs_link": "https://cloud.google.com/kms/docs", + "usage": "node keys.js --help" + } + ] } } diff --git a/language/README.md b/language/README.md index a15b3c89e1..9f93d1cc70 100644 --- a/language/README.md +++ b/language/README.md @@ -4,7 +4,7 @@ [![Build](https://storage.googleapis.com/cloud-docs-samples-badges/GoogleCloudPlatform/nodejs-docs-samples/nodejs-docs-samples-language.svg)]() -[Cloud Natural Language API](https://cloud.google.com/natural-language/docs) provides natural language understanding technologies to developers, including sentiment analysis, entity recognition, and syntax analysis. This API is part of the larger Cloud Machine Learning API. +[Cloud Natural Language API](https://cloud.google.com/natural-language/docs) provides natural language understanding technologies to developers, including sentiment analysis, entity analysis, and syntax analysis. This API is part of the larger Cloud Machine Learning API family. ## Table of Contents @@ -20,11 +20,11 @@ 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -35,7 +35,6 @@ ### Analyze v1 - View the [documentation][analyze-v1_0_docs] or the [source code][analyze-v1_0_code]. __Usage:__ `node analyze.v1.js --help` @@ -68,7 +67,6 @@ For more information, see https://cloud.google.com/natural-language/docs ### Analyze v1beta2 - View the [documentation][analyze-v1beta2_1_docs] or the [source code][analyze-v1beta2_1_code]. __Usage:__ `node analyze.v1beta2.js --help` @@ -110,17 +108,17 @@ For more information, see https://cloud.google.com/natural-language/docs View the [README](slackbot/README.md). + ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/language/package.json b/language/package.json index 16bd919350..08e2b3093d 100644 --- a/language/package.json +++ b/language/package.json @@ -28,7 +28,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/logging/package.json b/logging/package.json index 291459c22d..ff1ad6da47 100644 --- a/logging/package.json +++ b/logging/package.json @@ -26,7 +26,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0", diff --git a/monitoring/README.md b/monitoring/README.md index e0784bbc9f..b8a64bcf54 100644 --- a/monitoring/README.md +++ b/monitoring/README.md @@ -20,11 +20,11 @@ 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -35,7 +35,6 @@ ### Metrics - View the [documentation][metrics_0_docs] or the [source code][metrics_0_code]. __Usage:__ `node metrics.js --help` @@ -84,7 +83,6 @@ For more information, see https://cloud.google.com/monitoring/docs ### Listing resources - View the [documentation][list_1_docs] or the [source code][list_1_code]. `list_resources.js` is a command-line program to demonstrate connecting to the @@ -101,7 +99,6 @@ node list_resources my-cool-project ### Custom metrics - View the [documentation][metrics_2_docs] or the [source code][metrics_2_code]. `create_custom_metric.js` demonstrates how to create a custom metric, write a @@ -118,15 +115,14 @@ node create_custom_metric my-cool-project ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/monitoring/package.json b/monitoring/package.json index 32c9d40422..d5ab478a9a 100644 --- a/monitoring/package.json +++ b/monitoring/package.json @@ -24,7 +24,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/package.json b/package.json index 8f1565e6f4..7541c1885d 100644 --- a/package.json +++ b/package.json @@ -44,6 +44,7 @@ "scripts": { "check": "yarn check --strict-semver --integrity", "lint": "samples lint", + "generate": "node ./scripts/generate", "pretest": "npm run lint && ./scripts/clean", "unit-test": "ava --verbose -T 30s functions/**/test/**/*.test.js", "unit-cover": "nyc --cache npm test && nyc report --reporter=html", @@ -53,9 +54,9 @@ "cover": "nyc --cache npm run test && nyc report --reporter=html" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.4", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", - "nyc": "10.2.0", + "nyc": "10.3.2", "shelljs": "0.7.7" } } diff --git a/prediction/README.md b/prediction/README.md index 1f1eaeb6f2..f14563b9fe 100644 --- a/prediction/README.md +++ b/prediction/README.md @@ -18,11 +18,11 @@ The [Cloud Prediction API](https://cloud.google.com/prediction/docs) provides a 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -33,7 +33,6 @@ The [Cloud Prediction API](https://cloud.google.com/prediction/docs) provides a ### Hosted Models - View the [documentation][hostedmodels_0_docs] or the [source code][hostedmodels_0_code]. __Usage:__ `node hostedmodels ` @@ -47,15 +46,14 @@ node hostedmodels "Hello world" ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/prediction/package.json b/prediction/package.json index 681db6aed3..27afb18b87 100644 --- a/prediction/package.json +++ b/prediction/package.json @@ -21,7 +21,7 @@ "googleapis": "19.0.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1" }, "cloud-repo-tools": { diff --git a/pubsub/README.md b/pubsub/README.md index 3579897e68..983fb1b978 100644 --- a/pubsub/README.md +++ b/pubsub/README.md @@ -19,11 +19,11 @@ 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -34,7 +34,6 @@ ### Topics - View the [documentation][topics_0_docs] or the [source code][topics_0_code]. __Usage:__ `node topics.js --help` @@ -71,7 +70,6 @@ For more information, see https://cloud.google.com/pubsub/docs ### Subscriptions - View the [documentation][subscriptions_1_docs] or the [source code][subscriptions_1_code]. __Usage:__ `node subscriptions.js --help` @@ -112,15 +110,14 @@ For more information, see https://cloud.google.com/pubsub/docs ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/pubsub/package.json b/pubsub/package.json index 3290548ad7..cdfeeb59b2 100644 --- a/pubsub/package.json +++ b/pubsub/package.json @@ -22,7 +22,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/resource/README.md b/resource/README.md index 0409babe3e..888527cba2 100644 --- a/resource/README.md +++ b/resource/README.md @@ -4,7 +4,7 @@ [![Build](https://storage.googleapis.com/cloud-docs-samples-badges/GoogleCloudPlatform/nodejs-docs-samples/nodejs-docs-samples-resource-manager.svg)]() -Google Cloud Platform provides container resources such as Organizations and Projects, that allow you to group and hierarchically organize other Cloud Platform resources. This hierarchical organization lets you easily manage common aspects of your resources such as access control and configuration settings. The [Google Cloud Resource Manager API](https://cloud.google.com/resource-manager/docs) enables you to programmatically manage these container resources. +Google Cloud Platform provides container resources such as Organizations and Projects, that allow you to group and hierarchically organize other Cloud Platform resources. This hierarchical organization lets you easily manage common aspects of your resources such as access control and configuration settings. The [Cloud Resource Manager API](https://cloud.google.com/resource-manager/docs/) enables you to programmatically manage these container resources. ## Table of Contents @@ -18,11 +18,11 @@ Google Cloud Platform provides container resources such as Organizations and Pro 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -33,7 +33,6 @@ Google Cloud Platform provides container resources such as Organizations and Pro ### Projects - View the [documentation][projects_0_docs] or the [source code][projects_0_code]. __Usage:__ `node projects.js --help` @@ -56,15 +55,14 @@ For more information, see https://cloud.google.com/resource-manager/docs ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/resource/package.json b/resource/package.json index 2a5c9df5f6..b83974d823 100644 --- a/resource/package.json +++ b/resource/package.json @@ -22,7 +22,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/scripts/generate b/scripts/generate new file mode 100755 index 0000000000..ec44cf9fe3 --- /dev/null +++ b/scripts/generate @@ -0,0 +1,66 @@ +#!/usr/bin/env node + +/** + * Copyright 2017, 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 childProcess = require('child_process'); +const fs = require(`fs`); +const path = require(`path`); + +const PROJECT_ROOT = path.join(__dirname, `..`); + +function findSamples (directory, depth) { + // Limit recursion depth + if (depth < 0) { + return; + } + + // Skip module directories + if (directory.includes('node_modules')) { + return; + } + + // Get subdirectories + const dirs = fs.readdirSync(directory); + + // Record subdirectories that contain a package.json file + dirs + .filter((dir) => fs.existsSync(path.join(directory, dir, `package.json`))) + .forEach((dir) => { + const _path = path.join(directory, dir); + const pkg = JSON.parse(fs.readFileSync(path.join(_path, `package.json`))); + if (pkg['cloud-repo-tools'] && pkg['cloud-repo-tools'].samples && pkg['cloud-repo-tools'].samples.length > 0) { + const result = childProcess.spawnSync('node', ['./node_modules/@google-cloud/nodejs-repo-tools/bin/samples', 'generate', '--local-path', _path, '--build-pack', 'nodejs'], { + cwd: PROJECT_ROOT, + stdio: 'inherit' + }); + + if (result.error) { + throw result.error; + } + } + }); + + // Recurse + dirs + .filter((dir) => fs.statSync(path.join(directory, dir)).isDirectory()) + .forEach((dir) => { + findSamples(path.join(directory, dir), depth - 1); + }); +} + +findSamples(PROJECT_ROOT, 3); diff --git a/spanner/README.md b/spanner/README.md index 7c1aceacf7..e7864a6741 100644 --- a/spanner/README.md +++ b/spanner/README.md @@ -1,17 +1,19 @@ Google Cloud Platform logo -# Cloud Spanner Node.js Samples +# Google Cloud Spanner Node.js Samples -[Cloud Spanner][spanner_docs] is a managed, mission-critical, globally -consistent and scalable relational database service. Cloud Spanner solves the -need for a horizontally-scaling database with consistent global transaction and -SQL semantics. +[![Build](https://storage.googleapis.com/cloud-docs-samples-badges/GoogleCloudPlatform/nodejs-docs-samples/nodejs-docs-samples-spanner.svg)]() + +[Cloud Spanner](https://cloud.google.com/spanner/docs/) is a fully managed, mission-critical, relational database service that offers transactional consistency at global scale, schemas, SQL (ANSI 2011 with extensions), and automatic, synchronous replication for high availability. ## Table of Contents * [Setup](#setup) * [Samples](#samples) - * [Getting started with Google Cloud Spanner API](#getting-started-with-google-cloud-spanner-api) + * [Schema](#schema) + * [CRUD](#crud) + * [Indexing](#indexing) + * [Transactions](#transactions) * [Running the tests](#running-the-tests) ## Setup @@ -19,11 +21,11 @@ SQL semantics. 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -32,15 +34,11 @@ SQL semantics. ## Samples -### Getting started with Google Cloud Spanner API - -View the [Spanner documentation][spanner_docs] or the [samples][spanner_samples]. +### Schema -__Run the samples:__ +View the [documentation][schema_0_docs] or the [source code][schema_0_code]. -```sh -node schema.js --help -``` +__Usage:__ `node schema.js --help` ``` Commands: @@ -61,9 +59,14 @@ Examples: For more information, see https://cloud.google.com/spanner/docs ``` -```sh -node crud.js --help -``` +[schema_0_docs]: https://cloud.google.com/spanner/docs +[schema_0_code]: schema.js + +### CRUD + +View the [documentation][crud_1_docs] or the [source code][crud_1_code]. + +__Usage:__ `node crud.js --help` ``` Commands: @@ -84,9 +87,14 @@ Examples: For more information, see https://cloud.google.com/spanner/docs ``` -```sh -node indexing.js --help -``` +[crud_1_docs]: https://cloud.google.com/spanner/docs +[crud_1_code]: crud.js + +### Indexing + +View the [documentation][indexing_2_docs] or the [source code][indexing_2_code]. + +__Usage:__ `node indexing.js --help` ``` Commands: @@ -112,9 +120,14 @@ Examples: For more information, see https://cloud.google.com/spanner/docs ``` -```sh -node transaction.js --help -``` +[indexing_2_docs]: https://cloud.google.com/spanner/docs +[indexing_2_code]: indexing.js + +### Transactions + +View the [documentation][transaction_3_docs] or the [source code][transaction_3_code]. + +__Usage:__ `node transaction.js --help` ``` Commands: @@ -131,22 +144,19 @@ Examples: For more information, see https://cloud.google.com/spanner/docs ``` -For more information, see [the docs][spanner_docs]. - -[spanner_samples]: ../ -[spanner_docs]: https://cloud.google.com/spanner/docs/ +[transaction_3_docs]: https://cloud.google.com/spanner/docs +[transaction_3_code]: transaction.js ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/spanner/package.json b/spanner/package.json index c541bf4111..f4abc3eec7 100644 --- a/spanner/package.json +++ b/spanner/package.json @@ -22,13 +22,44 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" }, "cloud-repo-tools": { "requiresKeyFile": true, - "requiresProjectId": true + "requiresProjectId": true, + "product": "spanner", + "samples": [ + { + "id": "schema", + "name": "Schema", + "file": "schema.js", + "docs_link": "https://cloud.google.com/spanner/docs", + "usage": "node schema.js --help" + }, + { + "id": "crud", + "name": "CRUD", + "file": "crud.js", + "docs_link": "https://cloud.google.com/spanner/docs", + "usage": "node crud.js --help" + }, + { + "id": "indexing", + "name": "Indexing", + "file": "indexing.js", + "docs_link": "https://cloud.google.com/spanner/docs", + "usage": "node indexing.js --help" + }, + { + "id": "transaction", + "name": "Transactions", + "file": "transaction.js", + "docs_link": "https://cloud.google.com/spanner/docs", + "usage": "node transaction.js --help" + } + ] } } diff --git a/speech/README.md b/speech/README.md index 2b968cc121..81486e4dd8 100644 --- a/speech/README.md +++ b/speech/README.md @@ -4,7 +4,7 @@ [![Build](https://storage.googleapis.com/cloud-docs-samples-badges/GoogleCloudPlatform/nodejs-docs-samples/nodejs-docs-samples-speech.svg)]() -The [Cloud Speech API](https://cloud.google.com/speech/docs) enables easy integration of Google speech recognition technologies into developer applications. +The [Cloud Speech API](https://cloud.google.com/speech/docs) enables easy integration of Google speech recognition technologies into developer applications. Send audio and receive a text transcription from the Cloud Speech API service. ## Table of Contents @@ -18,22 +18,21 @@ The [Cloud Speech API](https://cloud.google.com/speech/docs) enables easy integr 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install -[prereq]: ../README.md#prerequisites +[prereq]: ../README.md#prerequisities [run]: ../README.md#how-to-run-a-sample ## Samples ### Speech Recognition - View the [documentation][recognize_0_docs] or the [source code][recognize_0_code]. __Usage:__ `node recognize.js --help` @@ -69,15 +68,14 @@ For more information, see https://cloud.google.com/speech/docs ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/speech/package.json b/speech/package.json index a02d45c1c7..bc3e1d45fa 100644 --- a/speech/package.json +++ b/speech/package.json @@ -24,7 +24,7 @@ "yargs": "7.0.2" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/storage/README.md b/storage/README.md index 7d41d98dde..9356a2f812 100644 --- a/storage/README.md +++ b/storage/README.md @@ -4,7 +4,7 @@ [![Build](https://storage.googleapis.com/cloud-docs-samples-badges/GoogleCloudPlatform/nodejs-docs-samples/nodejs-docs-samples-storage.svg)]() -[Cloud Storage](https://cloud.google.com/storage/docs) allows world-wide storage and retrieval of any amount of data at any time. +[Cloud Storage](https://cloud.google.com/storage/docs) allows world-wide storage and retrieval of any amount of data at any time. You can use Google Cloud Storage for a range of scenarios including serving website content, storing data for archival and disaster recovery, or distributing large data objects to users via direct download. ## Table of Contents @@ -22,11 +22,11 @@ 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -37,7 +37,6 @@ ### ACL (Access Control Lists) - View the [documentation][acl_0_docs] or the [source code][acl_0_code]. __Usage:__ `node acl.js --help` @@ -78,7 +77,6 @@ For more information, see https://cloud.google.com/storage/docs/access-control/c ### Buckets - View the [documentation][buckets_1_docs] or the [source code][buckets_1_code]. __Usage:__ `node buckets.js --help` @@ -105,7 +103,6 @@ For more information, see https://cloud.google.com/storage/docs ### Encryption - View the [documentation][encryption_2_docs] or the [source code][encryption_2_code]. __Usage:__ `node encryption.js --help` @@ -137,7 +134,6 @@ For more information, see https://cloud.google.com/storage/docs ### Files - View the [documentation][files_3_docs] or the [source code][files_3_code]. __Usage:__ `node files.js --help` @@ -181,7 +177,6 @@ For more information, see https://cloud.google.com/storage/docs ### Storage Transfer API - View the [documentation][transfer_4_docs] or the [source code][transfer_4_code]. __Usage:__ `node transfer.js --help` @@ -206,15 +201,14 @@ For more information, see https://cloud.google.com/storage/transfer ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/storage/package.json b/storage/package.json index a2ec116dec..98eb07634e 100644 --- a/storage/package.json +++ b/storage/package.json @@ -26,7 +26,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0", diff --git a/trace/package.json b/trace/package.json index 00b0b6d13e..184e8fa174 100644 --- a/trace/package.json +++ b/trace/package.json @@ -26,7 +26,7 @@ "got": "6.7.1" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7" + "@google-cloud/nodejs-repo-tools": "1.4.13" }, "cloud-repo-tools": { "test": { diff --git a/translate/README.md b/translate/README.md index 121b9f23cf..663b88310e 100644 --- a/translate/README.md +++ b/translate/README.md @@ -1,10 +1,10 @@ Google Cloud Platform logo -# Google Translate API Node.js Samples +# Google Cloud Translation API Node.js Samples [![Build](https://storage.googleapis.com/cloud-docs-samples-badges/GoogleCloudPlatform/nodejs-docs-samples/nodejs-docs-samples-translate.svg)]() -With the [Google Translate API](https://cloud.google.com/translate/docs), you can dynamically translate text between thousands of language pairs. +The [Cloud Translation API](https://cloud.google.com/translate/docs), can dynamically translate text between thousands of language pairs. The Cloud Translation API lets websites and programs integrate with the translation service programmatically. The Cloud Translation API is part of the larger Cloud Machine Learning API family. ## Table of Contents @@ -18,11 +18,11 @@ With the [Google Translate API](https://cloud.google.com/translate/docs), you ca 1. Read [Prerequisites][prereq] and [How to run a sample][run] first. 1. Install dependencies: - With `npm`: + With **npm**: npm install - With `yarn`: + With **yarn**: yarn install @@ -33,7 +33,6 @@ With the [Google Translate API](https://cloud.google.com/translate/docs), you ca ### Translate - View the [documentation][translate_0_docs] or the [source code][translate_0_code]. __Usage:__ `node translate.js --help` @@ -70,15 +69,14 @@ For more information, see https://cloud.google.com/translate/docs ## Running the tests -1. Set the `GCLOUD_PROJECT` and `GOOGLE_APPLICATION_CREDENTIALS` environment - variables. +1. Set the **GCLOUD_PROJECT** and **GOOGLE_APPLICATION_CREDENTIALS** environment variables. 1. Run the tests: - With `npm`: + With **npm**: npm test - With `yarn`: + With **yarn**: yarn test diff --git a/translate/package.json b/translate/package.json index c2a8c3395e..75d1daf1b2 100644 --- a/translate/package.json +++ b/translate/package.json @@ -22,7 +22,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/vision/package.json b/vision/package.json index cf6161932a..daaddac9db 100644 --- a/vision/package.json +++ b/vision/package.json @@ -26,7 +26,7 @@ "yargs": "7.1.0" }, "devDependencies": { - "@google-cloud/nodejs-repo-tools": "1.4.7", + "@google-cloud/nodejs-repo-tools": "1.4.13", "ava": "0.19.1", "proxyquire": "1.7.11", "sinon": "2.1.0" diff --git a/yarn.lock b/yarn.lock index 9838308fb4..bb22c1db27 100644 --- a/yarn.lock +++ b/yarn.lock @@ -37,21 +37,21 @@ ansi-styles "^2.2.1" esutils "^2.0.2" -"@google-cloud/nodejs-repo-tools@1.4.4": - version "1.4.4" - resolved "https://registry.yarnpkg.com/@google-cloud/nodejs-repo-tools/-/nodejs-repo-tools-1.4.4.tgz#699f8557a495c037bfd486ef9fbf7c6a28f37797" +"@google-cloud/nodejs-repo-tools@1.4.13": + version "1.4.13" + resolved "https://registry.yarnpkg.com/@google-cloud/nodejs-repo-tools/-/nodejs-repo-tools-1.4.13.tgz#005556d8b93cb29f16018988e466cf0f9dc6d91f" dependencies: ava "0.19.1" colors "1.1.2" - fs-extra "3.0.0" + fs-extra "3.0.1" got "6.7.1" - handlebars "4.0.6" + handlebars "4.0.8" lodash "4.17.4" proxyquire "1.7.11" - sinon "2.1.0" + sinon "2.2.0" string "3.3.3" supertest "3.0.0" - yargs "7.1.0" + yargs "8.0.1" abbrev@1: version "1.1.0" @@ -702,7 +702,7 @@ camelcase@^3.0.0: version "3.0.0" resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-3.0.0.tgz#32fc4b9fcdaf845fcdf7e73bb97cac2261f0ab0a" -camelcase@^4.0.0: +camelcase@^4.0.0, camelcase@^4.1.0: version "4.1.0" resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-4.1.0.tgz#d545635be1e33c542649c69173e5de6acfae34dd" @@ -957,6 +957,12 @@ debug@^2.1.1, debug@^2.2.0: dependencies: ms "0.7.2" +debug@^2.6.3: + version "2.6.6" + resolved "https://registry.yarnpkg.com/debug/-/debug-2.6.6.tgz#a9fa6fbe9ca43cf1e79f73b75c0189cbb7d6db5a" + dependencies: + ms "0.7.3" + decamelize@^1.0.0, decamelize@^1.1.1, decamelize@^1.1.2: version "1.2.0" resolved "https://registry.yarnpkg.com/decamelize/-/decamelize-1.2.0.tgz#f6534d15148269b20352e7bee26f501f9a191290" @@ -1209,9 +1215,9 @@ formidable@^1.1.1: version "1.1.1" resolved "https://registry.yarnpkg.com/formidable/-/formidable-1.1.1.tgz#96b8886f7c3c3508b932d6bd70c4d3a88f35f1a9" -fs-extra@3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-3.0.0.tgz#244e0c4b0b8818f54040ec049d8a2bddc1202861" +fs-extra@3.0.1: + version "3.0.1" + resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-3.0.1.tgz#3794f378c58b342ea7dbbb23095109c4b3b62291" dependencies: graceful-fs "^4.1.2" jsonfile "^3.0.0" @@ -1345,9 +1351,9 @@ graceful-fs@^4.1.11, graceful-fs@^4.1.2, graceful-fs@^4.1.6: version "4.1.11" resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.1.11.tgz#0e8bdfe4d1ddb8854d64e04ea7c00e2a026e5658" -handlebars@4.0.6, handlebars@^4.0.3: - version "4.0.6" - resolved "https://registry.yarnpkg.com/handlebars/-/handlebars-4.0.6.tgz#2ce4484850537f9c97a8026d5399b935c4ed4ed7" +handlebars@4.0.8, handlebars@^4.0.3: + version "4.0.8" + resolved "https://registry.yarnpkg.com/handlebars/-/handlebars-4.0.8.tgz#22b875cd3f0e6cbea30314f144e82bc7a72ff420" dependencies: async "^1.4.0" optimist "^0.6.1" @@ -1653,49 +1659,50 @@ isstream@~0.1.2: version "0.1.2" resolved "https://registry.yarnpkg.com/isstream/-/isstream-0.1.2.tgz#47e63f7af55afa6f92e1500e690eb8b8529c099a" -istanbul-lib-coverage@^1.0.2: - version "1.0.2" - resolved "https://registry.yarnpkg.com/istanbul-lib-coverage/-/istanbul-lib-coverage-1.0.2.tgz#87a0c015b6910651cb3b184814dfb339337e25e1" +istanbul-lib-coverage@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/istanbul-lib-coverage/-/istanbul-lib-coverage-1.1.0.tgz#caca19decaef3525b5d6331d701f3f3b7ad48528" -istanbul-lib-hook@^1.0.5: - version "1.0.5" - resolved "https://registry.yarnpkg.com/istanbul-lib-hook/-/istanbul-lib-hook-1.0.5.tgz#6ca3d16d60c5f4082da39f7c5cd38ea8a772b88e" +istanbul-lib-hook@^1.0.6: + version "1.0.6" + resolved "https://registry.yarnpkg.com/istanbul-lib-hook/-/istanbul-lib-hook-1.0.6.tgz#c0866d1e81cf2d5319249510131fc16dee49231f" dependencies: append-transform "^0.4.0" -istanbul-lib-instrument@^1.7.0: - version "1.7.0" - resolved "https://registry.yarnpkg.com/istanbul-lib-instrument/-/istanbul-lib-instrument-1.7.0.tgz#b8e0dc25709bb44e17336ab47b7bb5c97c23f659" +istanbul-lib-instrument@^1.7.1: + version "1.7.1" + resolved "https://registry.yarnpkg.com/istanbul-lib-instrument/-/istanbul-lib-instrument-1.7.1.tgz#169e31bc62c778851a99439dd99c3cc12184d360" dependencies: babel-generator "^6.18.0" babel-template "^6.16.0" babel-traverse "^6.18.0" babel-types "^6.18.0" babylon "^6.13.0" - istanbul-lib-coverage "^1.0.2" + istanbul-lib-coverage "^1.1.0" semver "^5.3.0" -istanbul-lib-report@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/istanbul-lib-report/-/istanbul-lib-report-1.0.0.tgz#d83dac7f26566b521585569367fe84ccfc7aaecb" +istanbul-lib-report@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/istanbul-lib-report/-/istanbul-lib-report-1.1.0.tgz#444c4ecca9afa93cf584f56b10f195bf768c0770" dependencies: - istanbul-lib-coverage "^1.0.2" + istanbul-lib-coverage "^1.1.0" mkdirp "^0.5.1" path-parse "^1.0.5" supports-color "^3.1.2" -istanbul-lib-source-maps@^1.1.1: - version "1.1.1" - resolved "https://registry.yarnpkg.com/istanbul-lib-source-maps/-/istanbul-lib-source-maps-1.1.1.tgz#f8c8c2e8f2160d1d91526d97e5bd63b2079af71c" +istanbul-lib-source-maps@^1.2.0: + version "1.2.0" + resolved "https://registry.yarnpkg.com/istanbul-lib-source-maps/-/istanbul-lib-source-maps-1.2.0.tgz#8c7706d497e26feeb6af3e0c28fd5b0669598d0e" dependencies: - istanbul-lib-coverage "^1.0.2" + debug "^2.6.3" + istanbul-lib-coverage "^1.1.0" mkdirp "^0.5.1" - rimraf "^2.4.4" + rimraf "^2.6.1" source-map "^0.5.3" -istanbul-reports@^1.0.2: - version "1.0.2" - resolved "https://registry.yarnpkg.com/istanbul-reports/-/istanbul-reports-1.0.2.tgz#4e8366abe6fa746cc1cd6633f108de12cc6ac6fa" +istanbul-reports@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/istanbul-reports/-/istanbul-reports-1.1.0.tgz#1ef3b795889219cfb5fad16365f6ce108d5f8c66" dependencies: handlebars "^4.0.3" @@ -1986,6 +1993,12 @@ md5-o-matic@^0.1.1: version "0.1.1" resolved "https://registry.yarnpkg.com/md5-o-matic/-/md5-o-matic-0.1.1.tgz#822bccd65e117c514fab176b25945d54100a03c3" +mem@^1.1.0: + version "1.1.0" + resolved "https://registry.yarnpkg.com/mem/-/mem-1.1.0.tgz#5edd52b485ca1d900fe64895505399a0dfa45f76" + dependencies: + mimic-fn "^1.0.0" + meow@^3.7.0: version "3.7.0" resolved "https://registry.yarnpkg.com/meow/-/meow-3.7.0.tgz#72cb668b425228290abbfa856892587308a801fb" @@ -2079,7 +2092,7 @@ ms@0.7.2: version "0.7.2" resolved "https://registry.yarnpkg.com/ms/-/ms-0.7.2.tgz#ae25cf2512b3885a1d95d7f037868d8431124765" -ms@^0.7.1: +ms@0.7.3, ms@^0.7.1: version "0.7.3" resolved "https://registry.yarnpkg.com/ms/-/ms-0.7.3.tgz#708155a5e44e33f5fd0fc53e81d0d40a91be1fff" @@ -2165,9 +2178,9 @@ number-is-nan@^1.0.0: version "1.0.1" resolved "https://registry.yarnpkg.com/number-is-nan/-/number-is-nan-1.0.1.tgz#097b602b53422a522c1afb8790318336941a011d" -nyc@10.2.0: - version "10.2.0" - resolved "https://registry.yarnpkg.com/nyc/-/nyc-10.2.0.tgz#facd90240600c9aa4dd81ea99c2fb6a85c53de0c" +nyc@10.3.2: + version "10.3.2" + resolved "https://registry.yarnpkg.com/nyc/-/nyc-10.3.2.tgz#f27f4d91f2a9db36c24f574ff5c6efff0233de46" dependencies: archy "^1.0.0" arrify "^1.0.1" @@ -2179,12 +2192,12 @@ nyc@10.2.0: find-up "^1.1.2" foreground-child "^1.5.3" glob "^7.0.6" - istanbul-lib-coverage "^1.0.2" - istanbul-lib-hook "^1.0.5" - istanbul-lib-instrument "^1.7.0" - istanbul-lib-report "^1.0.0" - istanbul-lib-source-maps "^1.1.1" - istanbul-reports "^1.0.2" + istanbul-lib-coverage "^1.1.0" + istanbul-lib-hook "^1.0.6" + istanbul-lib-instrument "^1.7.1" + istanbul-lib-report "^1.1.0" + istanbul-lib-source-maps "^1.2.0" + istanbul-reports "^1.1.0" md5-hex "^1.2.0" merge-source-map "^1.0.2" micromatch "^2.3.11" @@ -2193,9 +2206,9 @@ nyc@10.2.0: rimraf "^2.5.4" signal-exit "^3.0.1" spawn-wrap "1.2.4" - test-exclude "^4.0.0" - yargs "^7.0.2" - yargs-parser "^4.0.2" + test-exclude "^4.1.0" + yargs "^7.1.0" + yargs-parser "^5.0.0" oauth-sign@~0.8.1: version "0.8.2" @@ -2254,6 +2267,14 @@ os-locale@^1.4.0: dependencies: lcid "^1.0.0" +os-locale@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/os-locale/-/os-locale-2.0.0.tgz#15918ded510522b81ee7ae5a309d54f639fc39a4" + dependencies: + execa "^0.5.0" + lcid "^1.0.0" + mem "^1.1.0" + os-tmpdir@^1.0.0, os-tmpdir@^1.0.1: version "1.0.2" resolved "https://registry.yarnpkg.com/os-tmpdir/-/os-tmpdir-1.0.2.tgz#bbe67406c79aa85c5cfec766fe5734555dfa1274" @@ -2694,7 +2715,7 @@ right-align@^0.1.1: dependencies: align-text "^0.1.1" -rimraf@2, rimraf@^2.3.3, rimraf@^2.4.4, rimraf@^2.5.1, rimraf@^2.5.4, rimraf@^2.6.1: +rimraf@2, rimraf@^2.3.3, rimraf@^2.5.1, rimraf@^2.5.4, rimraf@^2.6.1: version "2.6.1" resolved "https://registry.yarnpkg.com/rimraf/-/rimraf-2.6.1.tgz#c2338ec643df7a1b7fe5c54fa86f57428a55f33d" dependencies: @@ -2742,9 +2763,9 @@ signal-exit@^3.0.0, signal-exit@^3.0.1, signal-exit@^3.0.2: version "3.0.2" resolved "https://registry.yarnpkg.com/signal-exit/-/signal-exit-3.0.2.tgz#b5fdc08f1287ea1178628e415e25132b73646c6d" -sinon@2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/sinon/-/sinon-2.1.0.tgz#e057a9d2bf1b32f5d6dd62628ca9ee3961b0cafb" +sinon@2.2.0: + version "2.2.0" + resolved "https://registry.yarnpkg.com/sinon/-/sinon-2.2.0.tgz#3b1b42ff5defcbf51a52a62aca6d61171b9fd262" dependencies: diff "^3.1.0" formatio "1.2.0" @@ -2977,9 +2998,9 @@ term-size@^0.1.0: dependencies: execa "^0.4.0" -test-exclude@^4.0.0: - version "4.0.3" - resolved "https://registry.yarnpkg.com/test-exclude/-/test-exclude-4.0.3.tgz#86a13ce3effcc60e6c90403cf31a27a60ac6c4e7" +test-exclude@^4.1.0: + version "4.1.0" + resolved "https://registry.yarnpkg.com/test-exclude/-/test-exclude-4.1.0.tgz#04ca70b7390dd38c98d4a003a173806ca7991c91" dependencies: arrify "^1.0.1" micromatch "^2.3.11" @@ -3134,6 +3155,10 @@ which-module@^1.0.0: version "1.0.0" resolved "https://registry.yarnpkg.com/which-module/-/which-module-1.0.0.tgz#bba63ca861948994ff307736089e3b96026c2a4f" +which-module@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/which-module/-/which-module-2.0.0.tgz#d9ef07dce77b9902b8a3a8fa4b31c3e3f7e6e87a" + which@^1.2.4, which@^1.2.8, which@^1.2.9: version "1.2.14" resolved "https://registry.yarnpkg.com/which/-/which-1.2.14.tgz#9a87c4378f03e827cecaf1acdf56c736c01c14e5" @@ -3212,19 +3237,37 @@ yallist@^2.0.0: version "2.1.2" resolved "https://registry.yarnpkg.com/yallist/-/yallist-2.1.2.tgz#1c11f9218f076089a47dd512f93c6699a6a81d52" -yargs-parser@^4.0.2: - version "4.2.1" - resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-4.2.1.tgz#29cceac0dc4f03c6c87b4a9f217dd18c9f74871c" - dependencies: - camelcase "^3.0.0" - yargs-parser@^5.0.0: version "5.0.0" resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-5.0.0.tgz#275ecf0d7ffe05c77e64e7c86e4cd94bf0e1228a" dependencies: camelcase "^3.0.0" -yargs@7.1.0, yargs@^7.0.2: +yargs-parser@^7.0.0: + version "7.0.0" + resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-7.0.0.tgz#8d0ac42f16ea55debd332caf4c4038b3e3f5dfd9" + dependencies: + camelcase "^4.1.0" + +yargs@8.0.1: + version "8.0.1" + resolved "https://registry.yarnpkg.com/yargs/-/yargs-8.0.1.tgz#420ef75e840c1457a80adcca9bc6fa3849de51aa" + dependencies: + camelcase "^4.1.0" + cliui "^3.2.0" + decamelize "^1.1.1" + get-caller-file "^1.0.1" + os-locale "^2.0.0" + read-pkg-up "^2.0.0" + require-directory "^2.1.1" + require-main-filename "^1.0.1" + set-blocking "^2.0.0" + string-width "^2.0.0" + which-module "^2.0.0" + y18n "^3.2.1" + yargs-parser "^7.0.0" + +yargs@^7.1.0: version "7.1.0" resolved "https://registry.yarnpkg.com/yargs/-/yargs-7.1.0.tgz#6ba318eb16961727f5d284f8ea003e8d6154d0c8" dependencies: