migrate code from googleapis/python-language

.github/CODEOWNERS

@@ -55,6 +55,7 @@
 /kms/**/** @GoogleCloudPlatform/dee-infra @GoogleCloudPlatform/python-samples-reviewers
 /kubernetes_engine/**/* @GoogleCloudPlatform/python-samples-reviewers
 /kubernetes_engine/django_tutorial/**/* @glasnt @GoogleCloudPlatform/python-samples-reviewers
+/language/**/* @googleapis/python-samples-reviewers @googleapis/cdpe-cloudai
 /media_cdn/**/* @justin-mp @msampathkumar @GoogleCloudPlatform/python-samples-reviewers
 /memorystore/**/* @GoogleCloudPlatform/python-samples-reviewers
 /ml_engine/**/* @ivanmkc @GoogleCloudPlatform/python-samples-reviewers

.github/blunderbuss.yml

@@ -85,6 +85,10 @@ assign_issues_by:
  - 'api: cloudiot'
  to:
  - GoogleCloudPlatform/api-iot
+- labels:
+ - 'api: language'
+ to:
+ - googleapis/cdpe-cloudai
 - labels:
  - 'api: ml'
  to:

.github/header-checker-lint.yml

@@ -18,6 +18,8 @@ ignoreFiles:
  - "**/ghcnd-stations.txt"
  - "texttospeech/snippets/resources/example.txt"
  - "texttospeech/snippets/resources/hello.txt"
+ - "language/**/*.txt"
+ - "language/v1/test/*.yaml"
 
 ignoreLicenseYear: true
 

language/AUTHORING_GUIDE.md

@@ -0,0 +1 @@
+See https://github.com/GoogleCloudPlatform/python-docs-samples/blob/master/AUTHORING_GUIDE.md

language/CONTRIBUTING.md

@@ -0,0 +1 @@
+See https://github.com/GoogleCloudPlatform/python-docs-samples/blob/master/CONTRIBUTING.md

language/snippets/README.md

@@ -0,0 +1,15 @@
+# Google Cloud Natural Language API examples
+
+[![Open in Cloud Shell][shell_img]][shell_link]
+
+[shell_img]: http://gstatic.com/cloudssh/images/open-btn.png
+[shell_link]: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=language/README.md
+
+This directory contains Python examples that use the
+[Google Cloud Natural Language API](https://cloud.google.com/natural-language/).
+
+- [api](api) has a simple command line tool that shows off the API's features.
+
+- [sentiment](sentiment) contains the [Sentiment Analysis
+ Tutorial](https://cloud.google.com/natural-language/docs/sentiment-tutorial)
+code as used within the documentation.

language/snippets/api/README.rst

@@ -0,0 +1,98 @@
+.. This file is automatically generated. Do not edit this file directly.
+
+Google Cloud Natural Language API Python Samples
+===============================================================================
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+ :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=language/api/README.rst
+
+
+This directory contains samples for Google Cloud Natural Language API. The `Google Cloud Natural Language API`_ 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.
+
+
+
+
+.. _Google Cloud Natural Language API: https://cloud.google.com/natural-language/docs/
+
+
+
+
+
+Setup
+-------------------------------------------------------------------------------
+
+
+Authentication
+++++++++++++++
+
+This sample requires you to have authentication setup. Refer to the
+`Authentication Getting Started Guide`_ for instructions on setting up
+credentials for applications.
+
+.. _Authentication Getting Started Guide:
+ https://cloud.google.com/docs/authentication/getting-started
+
+Install Dependencies
+++++++++++++++++++++
+
+#. Clone python-docs-samples and change directory to the sample directory you want to use.
+
+ .. code-block:: bash
+
+ $ git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
+
+#. Install `pip`_ and `virtualenv`_ if you do not already have them. You may want to refer to the `Python Development Environment Setup Guide`_ for Google Cloud Platform for instructions.
+
+ .. _Python Development Environment Setup Guide:
+ https://cloud.google.com/python/setup
+
+#. Create a virtualenv. Samples are compatible with Python 2.7 and 3.4+.
+
+ .. code-block:: bash
+
+ $ virtualenv env
+ $ source env/bin/activate
+
+#. Install the dependencies needed to run the samples.
+
+ .. code-block:: bash
+
+ $ pip install -r requirements.txt
+
+.. _pip: https://pip.pypa.io/
+.. _virtualenv: https://virtualenv.pypa.io/
+
+Samples
+-------------------------------------------------------------------------------
+
+Analyze syntax
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+ :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=language/api/analyze.py,language/api/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+ $ python analyze.py
+
+ usage: analyze.py [-h] {entities,sentiment,syntax} text
+
+ Analyzes text using the Google Cloud Natural Language API.
+
+ positional arguments:
+ {entities,sentiment,syntax}
+ text
+
+ optional arguments:
+ -h, --help show this help message and exit
+
+
+
+
+
+.. _Google Cloud SDK: https://cloud.google.com/sdk/

language/snippets/api/README.rst.in

@@ -0,0 +1,22 @@
+# This file is used to generate README.rst
+
+product:
+ name: Google Cloud Natural Language API
+ short_name: Cloud Natural Language API
+ url: https://cloud.google.com/natural-language/docs/
+ description: > 
+ The `Google Cloud Natural Language API`_ 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.
+
+setup:
+- auth
+- install_deps
+
+samples:
+- name: Analyze syntax
+ file: analyze.py
+ show_help: true
+
+folder: language/api

language/snippets/api/analyze.py

@@ -0,0 +1,92 @@
+#!/usr/bin/env python
+
+# Copyright 2016 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.
+
+"""Analyzes text using the Google Cloud Natural Language API."""
+
+import argparse
+import json
+import sys
+
+import googleapiclient.discovery
+
+
+def get_native_encoding_type():
+ """Returns the encoding type that matches Python's native strings."""
+ if sys.maxunicode == 65535:
+ return "UTF16"
+ else:
+ return "UTF32"
+
+
+def analyze_entities(text, encoding="UTF32"):
+ body = {
+ "document": {"type": "PLAIN_TEXT", "content": text},
+ "encoding_type": encoding,
+ }
+
+ service = googleapiclient.discovery.build("language", "v1")
+
+ request = service.documents().analyzeEntities(body=body)
+ response = request.execute()
+
+ return response
+
+
+def analyze_sentiment(text, encoding="UTF32"):
+ body = {
+ "document": {"type": "PLAIN_TEXT", "content": text},
+ "encoding_type": encoding,
+ }
+
+ service = googleapiclient.discovery.build("language", "v1")
+
+ request = service.documents().analyzeSentiment(body=body)
+ response = request.execute()
+
+ return response
+
+
+def analyze_syntax(text, encoding="UTF32"):
+ body = {
+ "document": {"type": "PLAIN_TEXT", "content": text},
+ "encoding_type": encoding,
+ }
+
+ service = googleapiclient.discovery.build("language", "v1")
+
+ request = service.documents().analyzeSyntax(body=body)
+ response = request.execute()
+
+ return response
+
+
+if __name__ == "__main__":
+ parser = argparse.ArgumentParser(
+ description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter
+ )
+ parser.add_argument("command", choices=["entities", "sentiment", "syntax"])
+ parser.add_argument("text")
+
+ args = parser.parse_args()
+
+ if args.command == "entities":
+ result = analyze_entities(args.text, get_native_encoding_type())
+ elif args.command == "sentiment":
+ result = analyze_sentiment(args.text, get_native_encoding_type())
+ elif args.command == "syntax":
+ result = analyze_syntax(args.text, get_native_encoding_type())
+
+ print(json.dumps(result, indent=2))