Add new "quickstart" samples

bigquery/cloud-client/quickstart.py

@@ -0,0 +1,40 @@
+#!/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 bigquery_quickstart]
+ # Imports the Google Cloud client library
+ from google.cloud import bigquery
+
+ # Instantiates a client
+ bigquery_client = bigquery.Client()
+
+ # The name for the new dataset
+ dataset_name = 'my_new_dataset'
+
+ # Prepares the new dataset
+ dataset = bigquery_client.dataset(dataset_name)
+
+ # Creates the new dataset
+ dataset.create()
+
+ print('Dataset {} created.'.format(dataset.name))
+ # [END bigquery_quickstart]
+
+
+if __name__ == '__main__':
+ run_quickstart()

datastore/api/quickstart.py

@@ -0,0 +1,41 @@
+#!/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 datastore_quickstart]
+ # Imports the Google Cloud client library
+ from google.cloud import datastore
+
+ # Instantiates a client
+ datastore_client = datastore.Client()
+
+ # 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)
+
+ print('Fetched entity: {}'.format(entity.key.name))
+ # [END datastore_quickstart]
+
+
+if __name__ == '__main__':
+ run_quickstart()

language/cloud-client/quickstart.py

@@ -0,0 +1,39 @@
+#!/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()

language/cloud-client/requirements.txt

@@ -0,0 +1 @@
+google-cloud-language==0.20.0

logging/cloud-client/quickstart.py

@@ -0,0 +1,42 @@
+#!/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 logging_quickstart]
+ # Imports the Google Cloud client library
+ from google.cloud import logging
+
+ # 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 data to log
+ text = 'Hello, world!'
+
+ # Writes the log entry
+ logger.log_text(text)
+
+ print('Logged: {}'.format(text))
+ # [END logging_quickstart]
+
+
+if __name__ == '__main__':
+ run_quickstart()

pubsub/cloud-client/quickstart.py

@@ -0,0 +1,40 @@
+#!/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 pubsub_quickstart]
+ # Imports the Google Cloud client library
+ from google.cloud import pubsub
+
+ # Instantiates a client
+ pubsub_client = pubsub.Client()
+
+ # The name for the new topic
+ topic_name = 'my-new-topic'
+
+ # Prepares the new topic
+ topic = pubsub_client.topic(topic_name)
+
+ # Creates the new topic
+ topic.create()
+
+ print('Topic {} created.'.format(topic.name))
+ # [END pubsub_quickstart]
+
+
+if __name__ == '__main__':
+ run_quickstart()

storage/cloud-client/quickstart.py

@@ -0,0 +1,37 @@
+#!/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 storage_quickstart]
+ # Imports the Google Cloud client library
+ from google.cloud import storage
+
+ # Instantiates a client
+ storage_client = storage.Client()
+
+ # The name for the new bucket
+ bucket_name = 'my-new-bucket'
+
+ # Creates the new bucket
+ bucket = storage_client.create_bucket(bucket_name)
+
+ print('Bucket {} created.'.format(bucket.name))
+ # [END storage_quickstart]
+
+
+if __name__ == '__main__':
+ run_quickstart()

translate/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 translate_quickstart]
+ # Imports the Google Cloud client library
+ from google.cloud import translate
+
+ # Your Translate API key
+ api_key = 'YOUR_API_KEY'
+
+ # Instantiates a client
+ translate_client = translate.Client(api_key)
+
+ # 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)
+
+ print('Text: {}'.format(text))
+ print('Translation: {}'.format(
+ translation['translatedText'].encode('utf-8')))
+ # [END translate_quickstart]
+
+
+if __name__ == '__main__':
+ run_quickstart()

translate/cloud-client/requirements.txt

@@ -0,0 +1 @@
+google-cloud-translate==0.20.0

vision/cloud-client/quickstart.py

@@ -0,0 +1,45 @@
+#!/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()

vision/cloud-client/requirements.txt

@@ -0,0 +1 @@
+google-cloud-vision==0.20.0