Add new "quickstart" samples (#547)

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