google-cloud-language 0.27.1 → 0.28.0

data/lib/google/cloud/language/v1/language_service_services_pb.rb

@@ -40,10 +40,15 @@ module Google
             # along with entity types, salience, mentions for each entity, and
             # other properties.
             rpc :AnalyzeEntities, AnalyzeEntitiesRequest, AnalyzeEntitiesResponse
+            # Finds entities, similar to [AnalyzeEntities][google.cloud.language.v1.LanguageService.AnalyzeEntities] in the text and analyzes
+            # sentiment associated with each entity and its mentions.
+            rpc :AnalyzeEntitySentiment, AnalyzeEntitySentimentRequest, AnalyzeEntitySentimentResponse
             # Analyzes the syntax of the text and provides sentence boundaries and
             # tokenization along with part of speech tags, dependency trees, and other
             # properties.
             rpc :AnalyzeSyntax, AnalyzeSyntaxRequest, AnalyzeSyntaxResponse
+            # Classifies a document into categories.
+            rpc :ClassifyText, ClassifyTextRequest, ClassifyTextResponse
             # A convenience method that provides all the features that analyzeSentiment,
             # analyzeEntities, and analyzeSyntax provide in one call.
             rpc :AnnotateText, AnnotateTextRequest, AnnotateTextResponse

data/lib/google/cloud/language/v1beta2.rb

@@ -1,4 +1,5 @@
 # Copyright 2017, 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
@@ -12,3 +13,109 @@
 # limitations under the License.
 
 require "google/cloud/language/v1beta2/language_service_client"
+
+module Google
+  module Cloud
+    # rubocop:disable LineLength
+
+    ##
+    # # Ruby Client for Google Cloud Natural Language API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
+    #
+    # [Google Cloud Natural Language API][Product Documentation]:
+    # Google Cloud Natural Language API provides natural language understanding
+    # technologies to developers. Examples include sentiment analysis, entity
+    # recognition, and text annotations.
+    # - [Product Documentation][]
+    #
+    # ## Quick Start
+    # In order to use this library, you first need to go through the following
+    # steps:
+    #
+    # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+    # 2. [Enable the Google Cloud Natural Language API.](https://console.cloud.google.com/apis/api/language)
+    # 3. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+    #
+    # ### Preview
+    # #### LanguageServiceClient
+    # ```rb
+    # require "google/cloud/language/v1beta2"
+    #
+    # language_service_client = Google::Cloud::Language::V1beta2.new
+    # content = "Hello, world!"
+    # type = :PLAIN_TEXT
+    # document = { content: content, type: type }
+    # response = language_service_client.analyze_sentiment(document)
+    # ```
+    #
+    # ### Next Steps
+    # - Read the [Google Cloud Natural Language API Product documentation][Product Documentation]
+    #   to learn more about the product and see How-to Guides.
+    # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
+    #   to see the full list of Cloud APIs that we cover.
+    #
+    # [Product Documentation]: https://cloud.google.com/language
+    #
+    #
+    module Language
+      module V1beta2
+        # rubocop:enable LineLength
+
+        ##
+        # Provides text analysis operations such as sentiment analysis and entity
+        # recognition.
+        #
+        # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
+        #   Provides the means for authenticating requests made by the client. This parameter can
+        #   be many types.
+        #   A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
+        #   authenticating requests made by this client.
+        #   A `String` will be treated as the path to the keyfile to be used for the construction of
+        #   credentials for this client.
+        #   A `Hash` will be treated as the contents of a keyfile to be used for the construction of
+        #   credentials for this client.
+        #   A `GRPC::Core::Channel` will be used to make calls through.
+        #   A `GRPC::Core::ChannelCredentials` for the setting up the RPC client. The channel credentials
+        #   should already be composed with a `GRPC::Core::CallCredentials` object.
+        #   A `Proc` will be used as an updater_proc for the Grpc channel. The proc transforms the
+        #   metadata for requests, generally, to give OAuth credentials.
+        # @param scopes [Array<String>]
+        #   The OAuth scopes for this service. This parameter is ignored if
+        #   an updater_proc is supplied.
+        # @param client_config [Hash]
+        #   A Hash for call options for each method. See
+        #   Google::Gax#construct_settings for the structure of
+        #   this data. Falls back to the default config if not specified
+        #   or the specified config is missing data points.
+        # @param timeout [Numeric]
+        #   The default timeout, in seconds, for calls made through this client.
+        def self.new \
+            service_path: nil,
+            port: nil,
+            channel: nil,
+            chan_creds: nil,
+            updater_proc: nil,
+            credentials: nil,
+            scopes: nil,
+            client_config: nil,
+            timeout: nil,
+            lib_name: nil,
+            lib_version: nil
+          kwargs = {
+            service_path: service_path,
+            port: port,
+            channel: channel,
+            chan_creds: chan_creds,
+            updater_proc: updater_proc,
+            credentials: credentials,
+            scopes: scopes,
+            client_config: client_config,
+            timeout: timeout,
+            lib_name: lib_name,
+            lib_version: lib_version
+          }.select { |_, v| v != nil }
+          Google::Cloud::Language::V1beta2::LanguageServiceClient.new(**kwargs)
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/language/v1beta2/doc/google/cloud/language/v1beta2/language_service.rb

@@ -15,6 +15,17 @@
 module Google
   module Cloud
     module Language
+      ##
+      # # Google Cloud Natural Language API Contents
+      #
+      # | Class | Description |
+      # | ----- | ----------- |
+      # | [LanguageServiceClient][] | Google Cloud Natural Language API provides natural language understanding technologies to developers. Examples include sentiment analysis, entity recognition, and text annotations. |
+      # | [Data Types][] | Data types for Google::Cloud::Language::V1beta2 |
+      #
+      # [LanguageServiceClient]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-language/latest/google/cloud/language/v1beta2/languageserviceclient
+      # [Data Types]: https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-language/latest/google/cloud/language/v1beta2/datatypes
+      #
       module V1beta2
         # ================================================================ #
         #
@@ -729,6 +740,24 @@ module Google
 
             # Dislocated relation (for fronted/topicalized elements)
             DISLOCATED = 76
+
+            # Aspect marker
+            ASP = 77
+
+            # Genitive modifier
+            GMOD = 78
+
+            # Genitive object
+            GOBJ = 79
+
+            # Infinitival modifier
+            INFMOD = 80
+
+            # Measure
+            MES = 81
+
+            # Nominal complement of a noun
+            NCOMP = 82
           end
         end
 

data/lib/google/cloud/language/v1beta2/doc/overview.rb

@@ -0,0 +1,67 @@
+# Copyright 2017, 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.
+
+module Google
+  module Cloud
+    # rubocop:disable LineLength
+
+    ##
+    # # Ruby Client for Google Cloud Natural Language API ([Alpha](https://github.com/GoogleCloudPlatform/google-cloud-ruby#versioning))
+    #
+    # [Google Cloud Natural Language API][Product Documentation]:
+    # Google Cloud Natural Language API provides natural language understanding
+    # technologies to developers. Examples include sentiment analysis, entity
+    # recognition, and text annotations.
+    # - [Product Documentation][]
+    #
+    # ## Quick Start
+    # In order to use this library, you first need to go through the following
+    # steps:
+    #
+    # 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
+    # 2. [Enable the Google Cloud Natural Language API.](https://console.cloud.google.com/apis/api/language)
+    # 3. [Setup Authentication.](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
+    #
+    # ### Installation
+    # ```
+    # $ gem install google-cloud-language
+    # ```
+    #
+    # ### Preview
+    # #### LanguageServiceClient
+    # ```rb
+    # require "google/cloud/language"
+    #
+    # language_service_client = Google::Cloud::Language.new
+    # content = "Hello, world!"
+    # type = :PLAIN_TEXT
+    # document = { content: content, type: type }
+    # response = language_service_client.analyze_sentiment(document)
+    # ```
+    #
+    # ### Next Steps
+    # - Read the [Google Cloud Natural Language API Product documentation][Product Documentation]
+    #   to learn more about the product and see How-to Guides.
+    # - View this [repository's main README](https://github.com/GoogleCloudPlatform/google-cloud-ruby/blob/master/README.md)
+    #   to see the full list of Cloud APIs that we cover.
+    #
+    # [Product Documentation]: https://cloud.google.com/language
+    #
+    #
+    module Language
+      module V1beta2
+      end
+    end
+  end
+end

data/lib/google/cloud/language/v1beta2/language_service_client.rb

@@ -56,11 +56,10 @@ module Google
             "https://www.googleapis.com/auth/cloud-platform"
           ].freeze
 
-          # @param credentials
-          #   [Google::Gax::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
+          # @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]
           #   Provides the means for authenticating requests made by the client. This parameter can
           #   be many types.
-          #   A `Google::Gax::Credentials` uses a the properties of its represented keyfile for
+          #   A `Google::Auth::Credentials` uses a the properties of its represented keyfile for
           #   authenticating requests made by this client.
           #   A `String` will be treated as the path to the keyfile to be used for the construction of
           #   credentials for this client.
@@ -74,7 +73,7 @@ module Google
           # @param scopes [Array<String>]
           #   The OAuth scopes for this service. This parameter is ignored if
           #   an updater_proc is supplied.
-          # @param client_config[Hash]
+          # @param client_config [Hash]
           #   A Hash for call options for each method. See
           #   Google::Gax#construct_settings for the structure of
           #   this data. Falls back to the default config if not specified
@@ -106,7 +105,7 @@ module Google
               credentials ||= chan_creds
               credentials ||= updater_proc
             end
-            if service_path || port
+            if service_path != SERVICE_ADDRESS || port != DEFAULT_SERVICE_PORT
               warn "`service_path` and `port` parameters are deprecated and will be removed"
             end
 
@@ -124,7 +123,7 @@ module Google
             if credentials.is_a?(Proc)
               updater_proc = credentials
             end
-            if credentials.is_a?(Google::Gax::Credentials)
+            if credentials.is_a?(Google::Auth::Credentials)
               updater_proc = credentials.updater_proc
             end
 

data/lib/google/cloud/language/v1beta2/language_service_pb.rb

@@ -255,6 +255,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     value :NUMC, 74
     value :COP, 75
     value :DISLOCATED, 76
+    value :ASP, 77
+    value :GMOD, 78
+    value :GOBJ, 79
+    value :INFMOD, 80
+    value :MES, 81
+    value :NCOMP, 82
   end
   add_message "google.cloud.language.v1beta2.EntityMention" do
     optional :text, :message, 1, "google.cloud.language.v1beta2.TextSpan"

metadata

@@ -1,114 +1,71 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-language
 version: !ruby/object:Gem::Version
-  version: 0.27.1
+  version: 0.28.0
 platform: ruby
 authors:
-- Mike Moore
-- Chris Smith
+- Google Inc
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-08-30 00:00:00.000000000 Z
+date: 2017-11-14 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: google-cloud-core
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: google-gax
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.2
+        version: 0.10.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.2
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.10'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.10'
+        version: 0.10.1
 - !ruby/object:Gem::Dependency
-  name: minitest-autotest
+  name: googleapis-common-protos
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: minitest-focus
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-  type: :development
+        version: 1.3.1
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: 1.3.1
 - !ruby/object:Gem::Dependency
-  name: minitest-rg
+  name: googleauth
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
-  type: :development
+        version: 0.6.1
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: 0.6.1
 - !ruby/object:Gem::Dependency
-  name: autotest-suffix
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '5.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '5.10'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -137,39 +94,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: yard
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.9'
-- !ruby/object:Gem::Dependency
-  name: yard-doctest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "<="
-      - !ruby/object:Gem::Version
-        version: 0.1.8
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "<="
-      - !ruby/object:Gem::Version
-        version: 0.1.8
 description: google-cloud-language is the official library for Google Cloud Natural
   Language API.
-email:
-- mike@blowmage.com
-- quartzmo@gmail.com
+email: googleapis-packages@google.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -177,32 +104,29 @@ files:
 - ".yardopts"
 - LICENSE
 - README.md
-- lib/google-cloud-language.rb
 - lib/google/cloud/language.rb
-- lib/google/cloud/language/annotation.rb
-- lib/google/cloud/language/convert.rb
 - lib/google/cloud/language/credentials.rb
-- lib/google/cloud/language/document.rb
-- lib/google/cloud/language/project.rb
-- lib/google/cloud/language/service.rb
 - lib/google/cloud/language/v1.rb
 - lib/google/cloud/language/v1/doc/google/cloud/language/v1/language_service.rb
+- lib/google/cloud/language/v1/doc/overview.rb
 - lib/google/cloud/language/v1/language_service_client.rb
 - lib/google/cloud/language/v1/language_service_client_config.json
 - lib/google/cloud/language/v1/language_service_pb.rb
 - lib/google/cloud/language/v1/language_service_services_pb.rb
 - lib/google/cloud/language/v1beta2.rb
 - lib/google/cloud/language/v1beta2/doc/google/cloud/language/v1beta2/language_service.rb
+- lib/google/cloud/language/v1beta2/doc/overview.rb
 - lib/google/cloud/language/v1beta2/language_service_client.rb
 - lib/google/cloud/language/v1beta2/language_service_client_config.json
 - lib/google/cloud/language/v1beta2/language_service_pb.rb
 - lib/google/cloud/language/v1beta2/language_service_services_pb.rb
-- lib/google/cloud/language/version.rb
-homepage: https://github.com/GoogleCloudPlatform/google-cloud-ruby/tree/master/google-cloud-language
+homepage: https://github.com/googleapis/googleapis
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message: 'This release, 0.28.0, introduces breaking changes relative
+  to the previous release, 0.27.1. For more details and instructions to migrate your
+  code, please visit the migration guide: https://cloud.google.com/natural-language/docs/ruby-client-migration.'
 rdoc_options: []
 require_paths:
 - lib
@@ -218,7 +142,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 2.7.2
 signing_key: 
 specification_version: 4
 summary: API Client library for Google Cloud Natural Language API