google-cloud-language 0.27.1 → 0.28.0

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

@@ -1,35 +0,0 @@
-# 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
-    module Language
-      ##
-      # @private Conversion to/from Language GRPC objects.
-      module Convert
-        ##
-        # @private Convert a Google::Protobuf::Map to a Hash
-        def self.map_to_hash map
-          if map.respond_to? :to_h
-            map.to_h
-          else
-            # Enumerable doesn't have to_h on ruby 2.0...
-            Hash[map.to_a]
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,375 +0,0 @@
-# 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.
-
-
-require "google/cloud/language/annotation"
-
-module Google
-  module Cloud
-    module Language
-      ##
-      # # Document
-      #
-      # Represents a document for the Language service.
-      #
-      # Be aware that only English, Spanish, and Japanese language content are
-      # supported.
-      #
-      # See {Project#document}.
-      #
-      # @example
-      #   require "google/cloud/language"
-      #
-      #   language = Google::Cloud::Language.new
-      #
-      #   content = "Star Wars is a great movie. The Death Star is fearsome."
-      #   document = language.document content
-      #   annotation = document.annotate
-      #
-      #   annotation.entities.count #=> 3
-      #   annotation.sentiment.score #=> 0.10000000149011612
-      #   annotation.sentiment.magnitude #=> 1.100000023841858
-      #   annotation.sentences.count #=> 2
-      #   annotation.tokens.count #=> 13
-      #
-      class Document
-        ##
-        # @private The gRPC Service object.
-        attr_accessor :service
-
-        ##
-        # @private Creates a new document instance.
-        def initialize
-          @grpc = nil
-          @service = nil
-        end
-
-        ##
-        # @private Whether the document has content.
-        #
-        def content?
-          @grpc.source == :content
-        end
-
-        ##
-        # @private Whether the document source is a Google Cloud Storage URI.
-        #
-        def gcs_url?
-          @grpc.source == :gcs_content_uri
-        end
-
-        ##
-        # @private The source of the document's content.
-        #
-        def source
-          return @grpc.content if content?
-          @grpc.gcs_content_uri
-        end
-
-        ##
-        # The document's format.
-        #
-        # @return [Symbol] `:text` or `:html`
-        #
-        def format
-          return :text if text?
-          return :html if html?
-        end
-
-        ##
-        # Sets the document's format.
-        #
-        # @param [Symbol, String] new_format Accepted values are `:text` or
-        #   `:html`.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   document = language.document "<p>The Old Man and the Sea</p>"
-        #   document.format = :html
-        #
-        def format= new_format
-          @grpc.type = :PLAIN_TEXT if new_format.to_s == "text"
-          @grpc.type = :HTML       if new_format.to_s == "html"
-          @grpc.type
-        end
-
-        ##
-        # Whether the document is the `TEXT` format.
-        #
-        # @return [Boolean]
-        #
-        def text?
-          @grpc.type == :PLAIN_TEXT
-        end
-
-        ##
-        # Sets the document to the `TEXT` format.
-        #
-        def text!
-          @grpc.type = :PLAIN_TEXT
-        end
-
-        ##
-        # Whether the document is the `HTML` format.
-        #
-        # @return [Boolean]
-        #
-        def html?
-          @grpc.type == :HTML
-        end
-
-        ##
-        # Sets the document to the `HTML` format.
-        #
-        def html!
-          @grpc.type = :HTML
-        end
-
-        ##
-        # The document's language. ISO and BCP-47 language codes are supported.
-        #
-        # @return [String]
-        #
-        def language
-          @grpc.language
-        end
-
-        ##
-        # Sets the document's language.
-        #
-        # @param [String, Symbol] new_language ISO and BCP-47 language codes are
-        #   accepted.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   document = language.document "<p>El viejo y el mar</p>"
-        #   document.language = "es"
-        #
-        def language= new_language
-          @grpc.language = new_language.to_s
-        end
-
-        ##
-        # Analyzes the document and returns sentiment, entity, and syntactic
-        # feature results, depending on the option flags. Calling `annotate`
-        # with no arguments will perform **all** analysis features. Each feature
-        # is priced separately. See [Pricing](https://cloud.google.com/natural-language/pricing)
-        # for details.
-        #
-        # @param [Boolean] sentiment Whether to perform sentiment analysis.
-        #   Optional. The default is `false`. If every feature option is
-        #   `false`, **all** features will be performed.
-        # @param [Boolean] entities Whether to perform the entity analysis.
-        #   Optional. The default is `false`. If every feature option is
-        #   `false`, **all** features will be performed.
-        # @param [Boolean] syntax Whether to perform syntactic analysis.
-        #   Optional. The default is `false`. If every feature option is
-        #   `false`, **all** features will be performed.
-        #
-        # @return [Annotation] The results of the content analysis.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   content = "Star Wars is a great movie. The Death Star is fearsome."
-        #   document = language.document content
-        #   annotation = document.annotate
-        #
-        #   annotation.sentiment.score #=> 0.10000000149011612
-        #   annotation.sentiment.magnitude #=> 1.100000023841858
-        #   annotation.entities.count #=> 3
-        #   annotation.sentences.count #=> 2
-        #   annotation.tokens.count #=> 13
-        #
-        # @example With feature flags:
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   content = "Star Wars is a great movie. The Death Star is fearsome."
-        #   document = language.document content
-        #   annotation = document.annotate entities: true, syntax: true
-        #
-        #   annotation.entities.count #=> 3
-        #   annotation.sentences.count #=> 2
-        #   annotation.tokens.count #=> 13
-        #
-        def annotate sentiment: false, entities: false, syntax: false
-          ensure_service!
-          grpc = service.annotate to_grpc, sentiment: sentiment,
-                                           entities: entities,
-                                           syntax: syntax
-          Annotation.from_grpc grpc
-        end
-        alias_method :mark, :annotate
-        alias_method :detect, :annotate
-
-        ##
-        # Syntactic analysis extracts linguistic information, breaking up the
-        # given text into a series of sentences and tokens (generally, word
-        # boundaries), providing further analysis on those tokens.
-        #
-        # @return [Annotation::Syntax] The results for the content analysis.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   content = "Star Wars is a great movie. The Death Star is fearsome."
-        #   document = language.document content
-        #
-        #   syntax = document.syntax
-        #
-        #   sentence = syntax.sentences.last
-        #   sentence.text #=> "The Death Star is fearsome."
-        #   sentence.offset #=> 28
-        #
-        #   syntax.tokens.count #=> 13
-        #   token = syntax.tokens.first
-        #
-        #   token.text #=> "Star"
-        #   token.offset #=> 0
-        #   token.part_of_speech.tag #=> :NOUN
-        #   token.head_token_index #=> 1
-        #   token.label #=> :TITLE
-        #   token.lemma #=> "Star"
-        #
-        def syntax
-          ensure_service!
-          grpc = service.syntax to_grpc
-          Annotation::Syntax.from_grpc grpc
-        end
-
-        ##
-        # Entity analysis inspects the given text for known entities (proper
-        # nouns such as public figures, landmarks, etc.) and returns information
-        # about those entities.
-        #
-        # @return [Annotation::Entities] The results for the entities analysis.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   content = "Star Wars is a great movie. The Death Star is fearsome."
-        #   document = language.document content
-        #   entities = document.entities # API call
-        #
-        #   entities.count #=> 3
-        #   entities.first.name #=> "Star Wars"
-        #   entities.first.type #=> :WORK_OF_ART
-        #   entities.first.mid #=> "/m/06mmr"
-        #
-        def entities
-          ensure_service!
-          grpc = service.entities to_grpc
-          Annotation::Entities.from_grpc grpc
-        end
-
-        ##
-        # Sentiment analysis inspects the given text and identifies the
-        # prevailing emotional opinion within the text, especially to determine
-        # a writer's attitude as positive, negative, or neutral. Currently, only
-        # English is supported for sentiment analysis.
-        #
-        # @return [Annotation::Sentiment] The results for the sentiment
-        #   analysis.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   content = "Star Wars is a great movie. The Death Star is fearsome."
-        #   document = language.document content
-        #
-        #   sentiment = document.sentiment
-        #
-        #   sentiment.score #=> 0.10000000149011612
-        #   sentiment.magnitude #=> 1.100000023841858
-        #   sentiment.language #=> "en"
-        #
-        #   sentence = sentiment.sentences.first
-        #   sentence.sentiment.score #=> 0.699999988079071
-        #   sentence.sentiment.magnitude #=> 0.699999988079071
-        #
-        def sentiment
-          ensure_service!
-          grpc = service.sentiment to_grpc
-          Annotation::Sentiment.from_grpc grpc
-        end
-
-        # @private
-        def inspect
-          "#<#{self.class.name} (" \
-            "#{(content? ? "\"#{source[0, 16]}...\"" : source)}, " \
-            "format: #{format.inspect}, language: #{language.inspect})>"
-        end
-
-        ##
-        # @private New gRPC object.
-        def to_grpc
-          @grpc
-        end
-
-        ##
-        # @private
-        def self.from_grpc grpc, service
-          new.tap do |i|
-            i.instance_variable_set :@grpc, grpc
-            i.instance_variable_set :@service, service
-          end
-        end
-
-        ##
-        # @private
-        def self.from_source source, service, format: nil, language: nil
-          source = String source
-          grpc = Google::Cloud::Language::V1::Document.new
-          if source.start_with? "gs://"
-            grpc.gcs_content_uri = source
-            format ||= :html if source.end_with? ".html"
-          else
-            grpc.content = source
-          end
-          if format.to_s == "html"
-            grpc.type = :HTML
-          else
-            grpc.type = :PLAIN_TEXT
-          end
-          grpc.language = language.to_s unless language.nil?
-          from_grpc grpc, service
-        end
-
-        protected
-
-        ##
-        # Raise an error unless an active language project object is available.
-        def ensure_service!
-          fail "Must have active connection" unless service
-        end
-      end
-    end
-  end
-end

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

@@ -1,376 +0,0 @@
-# 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.
-
-
-require "google/cloud/errors"
-require "google/cloud/env"
-require "google/cloud/language/service"
-require "google/cloud/language/document"
-require "google/cloud/language/annotation"
-
-module Google
-  module Cloud
-    module Language
-      ##
-      # # Project
-      #
-      # Google Cloud Natural Language API reveals the structure and meaning of
-      # text by offering powerful machine learning models in an easy to use REST
-      # API. You can analyze text uploaded in your request or integrate with
-      # your document storage on Google Cloud Storage.
-      #
-      # See {Google::Cloud#language}
-      #
-      # @example
-      #   require "google/cloud/language"
-      #
-      #   language = Google::Cloud::Language.new
-      #
-      #   content = "Star Wars is a great movie. The Death Star is fearsome."
-      #   annotation = language.annotate content
-      #
-      #   annotation.sentiment.score #=> 0.10000000149011612
-      #   annotation.sentiment.magnitude #=> 1.100000023841858
-      #   annotation.entities.count #=> 3
-      #   annotation.sentences.count #=> 2
-      #   annotation.tokens.count #=> 13
-      #
-      class Project
-        ##
-        # @private The gRPC Service object.
-        attr_accessor :service
-
-        ##
-        # @private Creates a new Language Project instance.
-        def initialize service
-          @service = service
-        end
-
-        # The Language project connected to.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new(
-        #     project: "my-project-id",
-        #     keyfile: "/path/to/keyfile.json"
-        #   )
-        #
-        #   language.project #=> "my-project-id"
-        #
-        def project
-          service.project
-        end
-
-        ##
-        # @private Default project.
-        def self.default_project
-          ENV["LANGUAGE_PROJECT"] ||
-            ENV["GOOGLE_CLOUD_PROJECT"] ||
-            ENV["GCLOUD_PROJECT"] ||
-            Google::Cloud.env.project_id
-        end
-
-        ##
-        # Returns a new document from the given content. No API call is made.
-        #
-        # @param [String, Google::Cloud::Storage::File] content A string of text
-        #   to be annotated, or a Cloud Storage URI of the form
-        #   `"gs://bucketname/path/to/document.ext"`; or an instance of
-        #   Google::Cloud::Storage::File of the text to be annotated.
-        # @param [String, Symbol] format The format of the document. Acceptable
-        #   values are: `text` or `html`. If no format is provided, the document
-        #   will default to `text`. Optional.
-        # @param [String, Symbol] language The language of the document (if not
-        #   specified, the language is automatically detected). Both ISO and
-        #   BCP-47 language codes are accepted. Optional.
-        #
-        # @return [Document] An document for the Language service.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   document = language.document "It was the best of times, it was..."
-        #
-        # @example With a Google Cloud Storage URI:
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   document = language.document "gs://bucket-name/path/to/document"
-        #
-        # @example With a Google Cloud Storage File object:
-        #   require "google/cloud/storage"
-        #   storage = Google::Cloud::Storage.new
-        #
-        #   bucket = storage.bucket "bucket-name"
-        #   file = bucket.file "path/to/document"
-        #
-        #   require "google/cloud/language"
-        #   language = Google::Cloud::Language.new
-        #
-        #   document = language.document file
-        #
-        # @example With `format` and `language` options:
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   document = language.document "<p>El viejo y el mar</p>",
-        #                           format: :html, language: "es"
-        #
-        def document content, format: nil, language: nil
-          content = content.to_gs_url if content.respond_to? :to_gs_url
-          if content.is_a? Document
-            # Create new document with the provided format and language
-            Document.from_source content.source, @service,
-                                 format: (format || content.format),
-                                 language: (language || content.language)
-          else
-            Document.from_source content, @service, format: format,
-                                                    language: language
-          end
-        end
-        alias_method :doc, :document
-
-        ##
-        # Returns a new document from the given content with the `format` value
-        # `:text`. No API call is made.
-        #
-        # @param [String, Google::Cloud::Storage::File] content A string of text
-        #   to be annotated, or a Cloud Storage URI of the form
-        #   `"gs://bucketname/path/to/document.ext"`; or an instance of
-        #   Google::Cloud::Storage::File of the text to be annotated.
-        # @param [String, Symbol] language The language of the document (if not
-        #   specified, the language is automatically detected). Both ISO and
-        #   BCP-47 language codes are accepted. Optional.
-        #
-        # @return [Document] An document for the Language service.
-        #
-        def text content, language: nil
-          document content, format: :text, language: language
-        end
-
-        ##
-        # Returns a new document from the given content with the `format` value
-        # `:html`. No API call is made.
-        #
-        # @param [String, Google::Cloud::Storage::File] content A string of text
-        #   to be annotated, or a Cloud Storage URI of the form
-        #   `"gs://bucketname/path/to/document.ext"`; or an instance of
-        #   Google::Cloud::Storage::File of the text to be annotated.
-        # @param [String, Symbol] language The language of the document (if not
-        #   specified, the language is automatically detected). Both ISO and
-        #   BCP-47 language codes are accepted. Optional.
-        #
-        # @return [Document] An document for the Language service.
-        #
-        def html content, language: nil
-          document content, format: :html, language: language
-        end
-
-        ##
-        # Analyzes the content and returns sentiment, entity, and syntactic
-        # feature results, depending on the option flags. Calling `annotate`
-        # with no arguments will perform **all** analysis features. Each feature
-        # is priced separately. See [Pricing](https://cloud.google.com/natural-language/pricing)
-        # for details.
-        #
-        # @param [String, Document, Google::Cloud::Storage::File] content The
-        #   content to annotate. This can be an {Document} instance, or any
-        #   other type that converts to an {Document}. See {#document} for
-        #   details.
-        # @param [Boolean] sentiment Whether to perform the sentiment analysis.
-        #   Optional. The default is `false`. If every feature option is
-        #   `false`, **all** features will be performed.
-        # @param [Boolean] entities Whether to perform the entity analysis.
-        #   Optional. The default is `false`. If every feature option is
-        #   `false`, **all** features will be performed.
-        # @param [Boolean] syntax Whether to perform the syntactic analysis.
-        #   Optional. The default is `false`. If every feature option is
-        #   `false`, **all** features will be performed.
-        # @param [String, Symbol] format The format of the document. Acceptable
-        #   values are: `text` or `html`. Optional.
-        # @param [String, Symbol] language The language of the document (if not
-        #   specified, the language is automatically detected). Both ISO and
-        #   BCP-47 language codes are accepted. Optional.
-        #
-        # @return [Annotation] The results for the content analysis.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   content = "Star Wars is a great movie. The Death Star is fearsome."
-        #   annotation = language.annotate content
-        #
-        #   annotation.sentiment.score #=> 0.10000000149011612
-        #   annotation.sentiment.magnitude #=> 1.100000023841858
-        #   annotation.entities.count #=> 3
-        #   annotation.sentences.count #=> 2
-        #   annotation.tokens.count #=> 13
-        #
-        def annotate content, sentiment: false, entities: false, syntax: false,
-                     format: nil, language: nil
-          ensure_service!
-          doc = document content, language: language, format: format
-          grpc = service.annotate doc.to_grpc, sentiment: sentiment,
-                                               entities: entities,
-                                               syntax: syntax
-          Annotation.from_grpc grpc
-        end
-        alias_method :mark, :annotate
-        alias_method :detect, :annotate
-
-        ##
-        # Syntactic analysis extracts linguistic information, breaking up the
-        # given text into a series of sentences and tokens (generally, word
-        # boundaries), providing further analysis on those tokens.
-        #
-        # @param [String, Document, Google::Cloud::Storage::File] content The
-        #   content to annotate. This can be an {Document} instance, or any
-        #   other type that converts to an {Document}. See {#document} for
-        #   details.
-        # @param [String, Symbol] format The format of the document. Acceptable
-        #   values are: `text` or `html`. Optional.
-        # @param [String, Symbol] language The language of the document (if not
-        #   specified, the language is automatically detected). Both ISO and
-        #   BCP-47 language codes are accepted. Optional.
-        #
-        # @return [Annotation::Syntax] The results for the content syntax
-        #   analysis.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   content = "Star Wars is a great movie. The Death Star is fearsome."
-        #   document = language.document content
-        #
-        #   syntax = language.syntax document
-        #
-        #   sentence = syntax.sentences.last
-        #   sentence.text #=> "The Death Star is fearsome."
-        #   sentence.offset #=> 28
-        #
-        #   syntax.tokens.count #=> 13
-        #   token = syntax.tokens.first
-        #
-        #   token.text #=> "Star"
-        #   token.offset #=> 0
-        #   token.part_of_speech.tag #=> :NOUN
-        #   token.head_token_index #=> 1
-        #   token.label #=> :TITLE
-        #   token.lemma #=> "Star"
-        #
-        def syntax content, format: nil, language: nil
-          ensure_service!
-          doc = document content, language: language, format: format
-          grpc = service.syntax doc.to_grpc
-          Annotation::Syntax.from_grpc grpc
-        end
-
-        ##
-        # Entity analysis inspects the given text for known entities (proper
-        # nouns such as public figures, landmarks, etc.) and returns information
-        # about those entities.
-        #
-        # @param [String, Document] content The content to annotate. This
-        #   can be an {Document} instance, or any other type that converts to an
-        #   {Document}. See {#document} for details.
-        # @param [String, Symbol] format The format of the document. Acceptable
-        #   values are: `text` or `html`. Optional.
-        # @param [String, Symbol] language The language of the document (if not
-        #   specified, the language is automatically detected). Both ISO and
-        #   BCP-47 language codes are accepted. Optional.
-        #
-        # @return [Annotation::Entities] The results for the entities analysis.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   content = "Star Wars is a great movie. The Death Star is fearsome."
-        #   document = language.document content
-        #
-        #   entities = language.entities document
-        #   entities.count #=> 3
-        #
-        def entities content, format: :text, language: nil
-          ensure_service!
-          doc = document content, language: language, format: format
-          grpc = service.entities doc.to_grpc
-          Annotation::Entities.from_grpc grpc
-        end
-
-        ##
-        # Sentiment analysis inspects the given text and identifies the
-        # prevailing emotional opinion within the text, especially to determine
-        # a writer's attitude as positive, negative, or neutral. Currently, only
-        # English is supported for sentiment analysis.
-        #
-        # @param [String, Document] content The content to annotate. This
-        #   can be an {Document} instance, or any other type that converts to an
-        #   {Document}. See {#document} for details.
-        # @param [String, Symbol] format The format of the document. Acceptable
-        #   values are: `text` or `html`. Optional.
-        # @param [String, Symbol] language The language of the document (if not
-        #   specified, the language is automatically detected). Both ISO and
-        #   BCP-47 language codes are accepted. Optional.
-        #
-        # @return [Annotation::Sentiment] The results for the sentiment
-        #   analysis.
-        #
-        # @example
-        #   require "google/cloud/language"
-        #
-        #   language = Google::Cloud::Language.new
-        #
-        #   content = "Star Wars is a great movie. The Death Star is fearsome."
-        #   document = language.document content
-        #
-        #   sentiment = language.sentiment document
-        #
-        #   sentiment.score #=> 0.10000000149011612
-        #   sentiment.magnitude #=> 1.100000023841858
-        #   sentiment.language #=> "en"
-        #
-        #   sentence = sentiment.sentences.first
-        #   sentence.sentiment.score #=> 0.699999988079071
-        #   sentence.sentiment.magnitude #=> 0.699999988079071
-        #
-        def sentiment content, format: :text, language: nil
-          ensure_service!
-          doc = document content, language: language, format: format
-          grpc = service.sentiment doc.to_grpc
-          Annotation::Sentiment.from_grpc grpc
-        end
-
-        protected
-
-        ##
-        # @private Raise an error unless an active connection to the service is
-        # available.
-        def ensure_service!
-          fail "Must have active connection to service" unless service
-        end
-      end
-    end
-  end
-end