google-cloud-language-v1beta2 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8afc95ac60ea9e40b1ac4c38c802aa3e6650ddb4bd3570b581f42276e251a72e
-  data.tar.gz: 9009976bf309fcdeabb38cf07dd5f192b42e5f38c4836d1403924bb28295c974
+  metadata.gz: a848d58616ce066da01b52b73d9c0e7f37247bf09f263d307b1d3f614bd496e4
+  data.tar.gz: 752d80c52b6d62f0610cf0c6426fa6a276ee14525a30aef35eb6ffe524dcbcbb
 SHA512:
-  metadata.gz: 24002f867c2a24fb13c98bf6c5fdd6f00ad30a900999af99e8f903b108666a2182623e9775c2d794522422ae128548d3364df34a503418744469d43f857264a0
-  data.tar.gz: 9ee7c1ed416f09452b713f00c42e77e10fc04f8138e5b3c34a10ecdd537dea2936938e2407ea6cf9eec463de1258fb51870597dd37bea82ab9312659e6cb44ea
+  metadata.gz: 244ea95e05934f7c2e322d4ef1c3b4f6c58325b849915f0dbf1fa153da94fac01e1b5b8d768baea9a14a797076831327656fe557722d422ccce051c9104f6d5c
+  data.tar.gz: 5dc79decc6e60beff2478da0fca241f6f6140e65f992847b9b76db9b7376c074280622ea997d2df9ed24de2e36a58a9e9259f21a8d8fd17b9ac4d8b158a59f89

data/README.md

@@ -1,4 +1,4 @@
-# Natural Language V1beta2
+# Ruby Client for the Natural Language V1beta2 API
 
 API Client library for the Natural Language V1beta2 API
 
@@ -12,6 +12,53 @@ https://github.com/googleapis/google-cloud-ruby
 $ gem install google-cloud-language-v1beta2
 ```
 
+## Before You Begin
+
+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)
+1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+1. {file:AUTHENTICATION.md Set up authentication.}
+
+## Quick Start
+
+```ruby
+require "google/cloud/language/v1beta2"
+
+client = Google::Cloud::Language::V1beta2::LanguageService::Client.new
+request = my_create_request
+response = client.analyze_sentiment request
+```
+
+View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-language-v1beta2/latest)
+for class and method documentation.
+
+## Enabling Logging
+
+To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
+or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+
+Configuring a Ruby stdlib logger:
+
+```ruby
+require "logger"
+
+module MyLogger
+  LOGGER = Logger.new $stderr, level: Logger::WARN
+  def logger
+    LOGGER
+  end
+end
+
+# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+module GRPC
+  extend MyLogger
+end
+```
+
 ## Supported Ruby Versions
 
 This library is supported on Ruby 2.4+.

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

@@ -16,14 +16,8 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "gapic/common"
-require "gapic/config"
-require "gapic/config/method"
-
 require "google/cloud/errors"
-require "google/cloud/language/v1beta2/version"
 require "google/cloud/language/v1beta2/language_service_pb"
-require "google/cloud/language/v1beta2/language_service/credentials"
 
 module Google
   module Cloud
@@ -200,19 +194,26 @@ module Google
             # Analyzes the sentiment of the provided text.
             #
             # @overload analyze_sentiment(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1beta2::AnalyzeSentimentRequest | Hash]
-            #     Analyzes the sentiment of the provided text.
+            #   Pass arguments to `analyze_sentiment` via a request object, either of type
+            #   {Google::Cloud::Language::V1beta2::AnalyzeSentimentRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Language::V1beta2::AnalyzeSentimentRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload analyze_sentiment(document: nil, encoding_type: nil)
-            #   @param document [Google::Cloud::Language::V1beta2::Document | Hash]
+            #   Pass arguments to `analyze_sentiment` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param document [Google::Cloud::Language::V1beta2::Document, Hash]
             #     Required. Input document.
             #   @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
             #     The encoding type used by the API to calculate sentence offsets for the
             #     sentence sentiment.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Language::V1beta2::AnalyzeSentimentResponse]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -258,20 +259,25 @@ module Google
             # other properties.
             #
             # @overload analyze_entities(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1beta2::AnalyzeEntitiesRequest | Hash]
-            #     Finds named entities (currently proper names and common nouns) in the text
-            #     along with entity types, salience, mentions for each entity, and
-            #     other properties.
+            #   Pass arguments to `analyze_entities` via a request object, either of type
+            #   {Google::Cloud::Language::V1beta2::AnalyzeEntitiesRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Language::V1beta2::AnalyzeEntitiesRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload analyze_entities(document: nil, encoding_type: nil)
-            #   @param document [Google::Cloud::Language::V1beta2::Document | Hash]
+            #   Pass arguments to `analyze_entities` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param document [Google::Cloud::Language::V1beta2::Document, Hash]
             #     Required. Input document.
             #   @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Language::V1beta2::AnalyzeEntitiesResponse]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -316,19 +322,25 @@ module Google
             # sentiment associated with each entity and its mentions.
             #
             # @overload analyze_entity_sentiment(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentRequest | Hash]
-            #     Finds entities, similar to {Google::Cloud::Language::V1beta2::LanguageService::Client#analyze_entities AnalyzeEntities} in the text and analyzes
-            #     sentiment associated with each entity and its mentions.
+            #   Pass arguments to `analyze_entity_sentiment` via a request object, either of type
+            #   {Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload analyze_entity_sentiment(document: nil, encoding_type: nil)
-            #   @param document [Google::Cloud::Language::V1beta2::Document | Hash]
+            #   Pass arguments to `analyze_entity_sentiment` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param document [Google::Cloud::Language::V1beta2::Document, Hash]
             #     Required. Input document.
             #   @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Language::V1beta2::AnalyzeEntitySentimentResponse]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -374,20 +386,25 @@ module Google
             # properties.
             #
             # @overload analyze_syntax(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1beta2::AnalyzeSyntaxRequest | Hash]
-            #     Analyzes the syntax of the text and provides sentence boundaries and
-            #     tokenization along with part-of-speech tags, dependency trees, and other
-            #     properties.
+            #   Pass arguments to `analyze_syntax` via a request object, either of type
+            #   {Google::Cloud::Language::V1beta2::AnalyzeSyntaxRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Language::V1beta2::AnalyzeSyntaxRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload analyze_syntax(document: nil, encoding_type: nil)
-            #   @param document [Google::Cloud::Language::V1beta2::Document | Hash]
+            #   Pass arguments to `analyze_syntax` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param document [Google::Cloud::Language::V1beta2::Document, Hash]
             #     Required. Input document.
             #   @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Language::V1beta2::AnalyzeSyntaxResponse]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -431,15 +448,22 @@ module Google
             # Classifies a document into categories.
             #
             # @overload classify_text(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1beta2::ClassifyTextRequest | Hash]
-            #     Classifies a document into categories.
+            #   Pass arguments to `classify_text` via a request object, either of type
+            #   {Google::Cloud::Language::V1beta2::ClassifyTextRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Language::V1beta2::ClassifyTextRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload classify_text(document: nil)
-            #   @param document [Google::Cloud::Language::V1beta2::Document | Hash]
-            #     Required. Input document.
+            #   Pass arguments to `classify_text` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
             #
+            #   @param document [Google::Cloud::Language::V1beta2::Document, Hash]
+            #     Required. Input document.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Language::V1beta2::ClassifyTextResponse]
@@ -485,21 +509,27 @@ module Google
             # classification features in one call.
             #
             # @overload annotate_text(request, options = nil)
-            #   @param request [Google::Cloud::Language::V1beta2::AnnotateTextRequest | Hash]
-            #     A convenience method that provides all syntax, sentiment, entity, and
-            #     classification features in one call.
+            #   Pass arguments to `annotate_text` via a request object, either of type
+            #   {Google::Cloud::Language::V1beta2::AnnotateTextRequest} or an equivalent Hash.
+            #
+            #   @param request [Google::Cloud::Language::V1beta2::AnnotateTextRequest, Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
             #   @param options [Gapic::CallOptions, Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
             # @overload annotate_text(document: nil, features: nil, encoding_type: nil)
-            #   @param document [Google::Cloud::Language::V1beta2::Document | Hash]
+            #   Pass arguments to `annotate_text` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param document [Google::Cloud::Language::V1beta2::Document, Hash]
             #     Required. Input document.
-            #   @param features [Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features | Hash]
+            #   @param features [Google::Cloud::Language::V1beta2::AnnotateTextRequest::Features, Hash]
             #     Required. The enabled features.
             #   @param encoding_type [Google::Cloud::Language::V1beta2::EncodingType]
             #     The encoding type used by the API to calculate offsets.
             #
-            #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [Google::Cloud::Language::V1beta2::AnnotateTextResponse]
             # @yieldparam operation [GRPC::ActiveCall::Operation]
@@ -727,13 +757,3 @@ module Google
     end
   end
 end
-
-# rubocop:disable Lint/HandleExceptions
-
-# Once client is loaded, load helpers.rb if it exists.
-begin
-  require "google/cloud/language/v1beta2/language_service/helpers"
-rescue LoadError
-end
-
-# rubocop:enable Lint/HandleExceptions

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

@@ -16,5 +16,34 @@
 
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
-require "google/cloud/language/v1beta2/language_service/client"
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/language/v1beta2/version"
+
 require "google/cloud/language/v1beta2/language_service/credentials"
+require "google/cloud/language/v1beta2/language_service/client"
+
+module Google
+  module Cloud
+    module Language
+      module V1beta2
+        ##
+        # Provides text analysis operations such as sentiment analysis and entity
+        # recognition.
+        #
+        # To load this service and instantiate a client:
+        #
+        #     require "google/cloud/language/v1beta2/language_service"
+        #     client = Google::Cloud::Language::V1beta2::LanguageService::Client.new
+        #
+        module LanguageService
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "language_service", "helpers.rb"
+require "google/cloud/language/v1beta2/language_service/helpers" if ::File.file? helper_path

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Language
       module V1beta2
-        VERSION = "0.1.3"
+        VERSION = "0.1.4"
       end
     end
   end

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

@@ -17,3 +17,19 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/language/v1beta2/language_service"
+require "google/cloud/language/v1beta2/version"
+
+module Google
+  module Cloud
+    module Language
+      ##
+      # To load this package, including all its services, and instantiate a client:
+      #
+      #     require "google/cloud/language/v1beta2"
+      #     client = Google::Cloud::Language::V1beta2::LanguageService::Client.new
+      #
+      module V1beta2
+      end
+    end
+  end
+end

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

@@ -1 +1,21 @@
-require "google/cloud/language/v1beta2/version"
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+# This gem does not autoload during Bundler.require. To load this gem,
+# issue explicit require statements for the packages desired, e.g.:
+# require "google/cloud/language/v1beta2"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-language-v1beta2
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-06 00:00:00.000000000 Z
+date: 2020-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common