Wrap quickstarts in methods. Add language and vision quickstarts.

theacodes · Oct 5, 2016 · Sep 14, 2016 · Oct 5, 2016 · Oct 5, 2016 · Oct 5, 2016
commit 3aa6984cf93680e4140f5960d868f8e0acb3b417
diff --git a/bigquery/cloud-client/quickstart.py b/bigquery/cloud-client/quickstart.py
@@ -14,21 +14,26 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# [START bigquery_quickstart]
-# Imports the Google Cloud client library
-from google.cloud import bigquery
+def run_quickstart():
+  # [START bigquery_quickstart]
+  # Imports the Google Cloud client library
+  from google.cloud import bigquery
 
-# Instantiates a client
-bigquery_client = bigquery.Client()
+  # Instantiates a client
+  bigquery_client = bigquery.Client()
 
-# The name for the new dataset
-dataset_name = 'my_new_dataset'
+  # The name for the new dataset
+  dataset_name = 'my_new_dataset'
 
-# Prepares the new dataset
-dataset = bigquery_client.dataset(dataset_name)
+  # Prepares the new dataset
+  dataset = bigquery_client.dataset(dataset_name)
 
-# Creates the new dataset
-dataset.create()
+  # Creates the new dataset
+  dataset.create()
 
-print('Dataset {} created'.format(dataset.name))
-# [END bigquery_quickstart]
+  print('Dataset {} created.'.format(dataset.name))
+  # [END bigquery_quickstart]
+
+
+if __name__ == '__main__':
+  run_quickstart()
diff --git a/datastore/api/quickstart.py b/datastore/api/quickstart.py
@@ -14,22 +14,27 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# [START datastore_quickstart]
-# Imports the Google Cloud client library
-from google.cloud import datastore
+def run_quickstart():
+  # [START datastore_quickstart]
+  # Imports the Google Cloud client library
+  from google.cloud import datastore
 
-# Instantiates a client
-datastore_client = datastore.Client()
+  # Instantiates a client
+  datastore_client = datastore.Client()
 
-# The kind of the entity to retrieve
-kind = 'Task'
-# The id of the entity to retrieve
-id = 1234567890
-# The Datastore key for the entity
-task_key = datastore_client.key(kind, id)
+  # The kind of the entity to retrieve
+  kind = 'Person'
+  # The name/ID of the entity to retrieve
+  name = 'Bob'
+  # The Datastore key for the entity
+  task_key = datastore_client.key(kind, name)
 
-# Retrieves the entity
-entity = datastore_client.get(task_key)
+  # Retrieves the entity
+  entity = datastore_client.get(task_key)
 
-print('Got entity: {}'.format(entity.key.id))
-# [END datastore_quickstart]
+  print('Fetched entity: {}'.format(entity.key.name))
+  # [END datastore_quickstart]
+
+
+if __name__ == '__main__':
+  run_quickstart()
diff --git a/language/cloud-client/quickstart.py b/language/cloud-client/quickstart.py
@@ -0,0 +1,38 @@
+#!/usr/bin/env python
+
+# Copyright 2016 Google Inc. All Rights Reserved.
+#
+# 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.
+
+def run_quickstart():
+  # [START language_quickstart]
+  # Imports the Google Cloud client library
+  from google.cloud import language
+
+  # Instantiates a client
+  language_client = language.Client()
+
+  # The text to analyze
+  text = 'Hello, world!'
+  document = language_client.document_from_text(text)
+
+  # Detects the sentiment of the text
+  sentiment = document.analyze_sentiment()
+
+  print('Text: {}'.format(text))
+  print('Sentiment: {}, {}'.format(sentiment.polarity, sentiment.magnitude))
+  # [END language_quickstart]
+
+
+if __name__ == '__main__':
+  run_quickstart()
diff --git a/language/cloud-client/requirements.txt b/language/cloud-client/requirements.txt
@@ -0,0 +1 @@
+google-cloud-language==0.20.0
diff --git a/logging/cloud-client/quickstart.py b/logging/cloud-client/quickstart.py
@@ -14,23 +14,28 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# [START logging_quickstart]
-# Imports the Google Cloud client library
-from google.cloud import logging
+def run_quickstart():
+  # [START logging_quickstart]
+  # Imports the Google Cloud client library
+  from google.cloud import logging
 
-# Instantiates a client
-logging_client = logging.Client()
+  # Instantiates a client
+  logging_client = logging.Client()
 
-# The name of the log to write to
-log_name = 'my-log'
-# Selects the log to write to
-logger = logging_client.logger(log_name)
+  # The name of the log to write to
+  log_name = 'my-log'
+  # Selects the log to write to
+  logger = logging_client.logger(log_name)
 
-# The data to log
-text = 'Hello, world!'
+  # The data to log
+  text = 'Hello, world!'
 
-# Writes the log entry
-logger.log_text(text)
+  # Writes the log entry
+  logger.log_text(text)
 
-print('Logged: {}'.format(text))
-# [END logging_quickstart]
+  print('Logged: {}'.format(text))
+  # [END logging_quickstart]
+
+
+if __name__ == '__main__':
+  run_quickstart()
diff --git a/pubsub/cloud-client/quickstart.py b/pubsub/cloud-client/quickstart.py
@@ -14,21 +14,26 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# [START pubsub_quickstart]
-# Imports the Google Cloud client library
-from google.cloud import pubsub
+def run_quickstart():
+  # [START pubsub_quickstart]
+  # Imports the Google Cloud client library
+  from google.cloud import pubsub
 
-# Instantiates a client
-pubsub_client = pubsub.Client()
+  # Instantiates a client
+  pubsub_client = pubsub.Client()
 
-# The name for the new topic
-topic_name = 'my-new-topic'
+  # The name for the new topic
+  topic_name = 'my-new-topic'
 
-# Prepares the new topic
-topic = pubsub_client.topic(topic_name)
+  # Prepares the new topic
+  topic = pubsub_client.topic(topic_name)
 
-# Creates the new topic
-topic.create()
+  # Creates the new topic
+  topic.create()
 
-print('Topic {} created'.format(topic.name))
-# [END pubsub_quickstart]
+  print('Topic {} created.'.format(topic.name))
+  # [END pubsub_quickstart]
+
+
+if __name__ == '__main__':
+  run_quickstart()
diff --git a/storage/cloud-client/quickstart.py b/storage/cloud-client/quickstart.py
@@ -14,18 +14,23 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# [START storage_quickstart]
-# Imports the Google Cloud client library
-from google.cloud import storage
+def run_quickstart():
+  # [START storage_quickstart]
+  # Imports the Google Cloud client library
+  from google.cloud import storage
 
-# Instantiates a client
-storage_client = storage.Client()
+  # Instantiates a client
+  storage_client = storage.Client()
 
-# The name for the new bucket
-bucket_name = 'my-new-bucket'
+  # The name for the new bucket
+  bucket_name = 'my-new-bucket'
 
-# Creates the new bucket
-bucket = storage_client.create_bucket(bucket_name)
+  # Creates the new bucket
+  bucket = storage_client.create_bucket(bucket_name)
 
-print('Bucket {} created'.format(bucket.name))
-# [END storage_quickstart]
+  print('Bucket {} created.'.format(bucket.name))
+  # [END storage_quickstart]
+
+
+if __name__ == '__main__':
+  run_quickstart()
diff --git a/translate/cloud-client/quickstart.py b/translate/cloud-client/quickstart.py
@@ -14,24 +14,29 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# [START translate_quickstart]
-# Imports the Google Cloud client library
-from google.cloud import translate
+def run_quickstart():
+  # [START translate_quickstart]
+  # Imports the Google Cloud client library
+  from google.cloud import translate
 
-# Your Translate API key
-api_key = 'YOUR_API_KEY'
+  # Your Translate API key
+  api_key = 'YOUR_API_KEY'
 
-# Instantiates a client
-translate_client = translate.Client(api_key)
+  # Instantiates a client
+  translate_client = translate.Client(api_key)
 
-# The text to translate
-text = 'Hello, world!'
-# The target language
-target = 'ru'
+  # The text to translate
+  text = 'Hello, world!'
+  # The target language
+  target = 'ru'
 
-# Translates some text into Russian
-translation = translate_client.translate(text, target_language=target)
+  # Translates some text into Russian
+  translation = translate_client.translate(text, target_language=target)
 
-print('Text: {}'.format(text))
-print('Translation: {}'.format(translation['translatedText'].encode('utf-8')))
-# [END translate_quickstart]
+  print('Text: {}'.format(text))
+  print('Translation: {}'.format(translation['translatedText'].encode('utf-8')))
+  # [END translate_quickstart]
+
+
+if __name__ == '__main__':
+  run_quickstart()
diff --git a/vision/cloud-client/quickstart.py b/vision/cloud-client/quickstart.py
@@ -0,0 +1,44 @@
+#!/usr/bin/env python
+
+# Copyright 2016 Google Inc. All Rights Reserved.
+#
+# 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.
+
+def run_quickstart():
+  # [START vision_quickstart]
+  import io
+
+  # Imports the Google Cloud client library
+  from google.cloud import vision
+
+  # Instantiates a client
+  vision_client = vision.Client()
+
+  # The name of the image file to annotate
+  fileName = './resources/wakeupcat.jpg'
+
+  # Loads the image into memory
+  with io.open(fileName, 'rb') as image_file:
+    image = vision_client.image(content=image_file.read())
+
+  # Performs label detection on the image file
+  labels = image.detect_labels()
+
+  print('Labels:')
+  for label in labels:
+    print(label.description)
+  # [END vision_quickstart]
+
+
+if __name__ == '__main__':
+  run_quickstart()
diff --git a/vision/cloud-client/requirements.txt b/vision/cloud-client/requirements.txt
@@ -0,0 +1 @@
+google-cloud-vision==0.20.0
diff --git a/vision/cloud-client/resources/wakeupcat.jpg b/vision/cloud-client/resources/wakeupcat.jpg