google-cloud-translate 0.20.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7e06b7f7e4e48d78576b68e7918f645f55b552cb
+  data.tar.gz: efabd14fecbf35fdd359f153313639d0e031941a
+SHA512:
+  metadata.gz: e4a537004207777396d4a6a078b87d3bb4ab64c4f8e558e09a6a91172f343d2f0ed3a9c5789b8a4c74be833a2a51e5846b84f6817f3f1be39c21bace11c65a0b
+  data.tar.gz: 3e4c0ad24a9c8c5d5847a5efaa904d398ec3f12ea06ebaf8096595e093e03d87c72d87ec18d74d8f2aa44b3ae70dff179e628dd88448e20f8a642831fdff7ea8

data/lib/google-cloud-translate.rb

@@ -0,0 +1,121 @@
+# 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.
+
+##
+# This file is here to be autorequired by bundler, so that the .bigquery and
+# #bigquery methods can be available, but the library and all dependencies won't
+# be loaded until required and used.
+
+
+gem "google-cloud-core"
+require "google/cloud"
+
+module Google
+  module Cloud
+    ##
+    # Creates a new object for connecting to the Translate service.
+    # Each call creates a new connection.
+    #
+    # Unlike other Cloud Platform services, which authenticate using a project
+    # ID and OAuth 2.0 credentials, Google Translate API requires a public API
+    # access key. (This may change in future releases of Google Translate API.)
+    # Follow the general instructions at [Identifying your application to
+    # Google](https://cloud.google.com/translate/v2/using_rest#auth), and the
+    # specific instructions for [Server
+    # keys](https://cloud.google.com/translate/v2/using_rest#creating-server-api-keys).
+    #
+    # @param [String] key a public API access key (not an OAuth 2.0 token)
+    # @param [Integer] retries Number of times to retry requests on server
+    #   error. The default value is `3`. Optional.
+    # @param [Integer] timeout Default timeout to use in requests. Optional.
+    #
+    # @return [Google::Cloud::Translate::Api]
+    #
+    # @example
+    #   require "google/cloud"
+    #
+    #   gcloud = Google::Cloud.new
+    #   translate = gcloud.translate "api-key-abc123XYZ789"
+    #
+    #   translation = translate.translate "Hello world!", to: "la"
+    #   translation.text #=> "Salve mundi!"
+    #
+    # @example Using API Key from the environment variable.
+    #   require "google/cloud"
+    #
+    #   ENV["TRANSLATE_KEY"] = "api-key-abc123XYZ789"
+    #
+    #   gcloud = Google::Cloud.new
+    #   translate = gcloud.translate
+    #
+    #   translation = translate.translate "Hello world!", to: "la"
+    #   translation.text #=> "Salve mundi!"
+    #
+    def translate key = nil, retries: nil, timeout: nil
+      Google::Cloud.translate key, retries: (retries || @retries),
+                                   timeout: (timeout || @timeout)
+    end
+
+    ##
+    # Creates a new object for connecting to the Translate service.
+    # Each call creates a new connection.
+    #
+    # Unlike other Cloud Platform services, which authenticate using a project
+    # ID and OAuth 2.0 credentials, Google Translate API requires a public API
+    # access key. (This may change in future releases of Google Translate API.)
+    # Follow the general instructions at [Identifying your application to
+    # Google](https://cloud.google.com/translate/v2/using_rest#auth), and the
+    # specific instructions for [Server
+    # keys](https://cloud.google.com/translate/v2/using_rest#creating-server-api-keys).
+    #
+    # @param [String] key a public API access key (not an OAuth 2.0 token)
+    # @param [Integer] retries Number of times to retry requests on server
+    #   error. The default value is `3`. Optional.
+    # @param [Integer] timeout Default timeout to use in requests. Optional.
+    #
+    # @return [Google::Cloud::Translate::Api]
+    #
+    # @example
+    #   require "google/cloud"
+    #
+    #   translate = Google::Cloud.translate "api-key-abc123XYZ789"
+    #
+    #   translation = translate.translate "Hello world!", to: "la"
+    #   translation.text #=> "Salve mundi!"
+    #
+    # @example Using API Key from the environment variable.
+    #   require "google/cloud"
+    #
+    #   ENV["TRANSLATE_KEY"] = "api-key-abc123XYZ789"
+    #
+    #   translate = Google::Cloud.translate
+    #
+    #   translation = translate.translate "Hello world!", to: "la"
+    #   translation.text #=> "Salve mundi!"
+    #
+    def self.translate key = nil, retries: nil, timeout: nil
+      require "google/cloud/translate"
+      key ||= ENV["TRANSLATE_KEY"]
+      key ||= ENV["GOOGLE_CLOUD_KEY"]
+      if key.nil?
+        key_missing_msg = "An API key is required to use the Translate API."
+        fail ArgumentError, key_missing_msg
+      end
+
+      Google::Cloud::Translate::Api.new(
+        Google::Cloud::Translate::Service.new(
+          key, retries: retries, timeout: timeout))
+    end
+  end
+end

data/lib/google/cloud/translate.rb

@@ -0,0 +1,221 @@
+# 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-translate"
+require "google/cloud/translate/api"
+
+module Google
+  module Cloud
+    ##
+    # # Google Translate API
+    #
+    # [Google Translate API](https://cloud.google.com/translate/) provides a
+    # simple, programmatic interface for translating an arbitrary string into
+    # any supported language. It is highly responsive, so websites and
+    # applications can integrate with Translate API for fast, dynamic
+    # translation of source text. Language detection is also available in cases
+    # where the source language is unknown.
+    #
+    # Translate API supports more than ninety different languages, from
+    # Afrikaans to Zulu. Used in combination, this enables translation between
+    # thousands of language pairs. Also, you can send in HTML and receive HTML
+    # with translated text back. You don't need to extract your source text or
+    # reassemble the translated content.
+    #
+    # ## Authenticating
+    #
+    # Unlike other Cloud Platform services, which authenticate using a project
+    # ID and OAuth 2.0 credentials, Translate API requires a public API access
+    # key. (This may change in future releases of Translate API.) Follow the
+    # general instructions at [Identifying your application to
+    # Google](https://cloud.google.com/translate/v2/using_rest#auth), and the
+    # specific instructions for [Server
+    # keys](https://cloud.google.com/translate/v2/using_rest#creating-server-api-keys).
+    #
+    # ## Translating texts
+    #
+    # Translating text from one language to another is easy (and extremely
+    # fast.) The only required arguments to
+    # {Google::Cloud::Translate::Api#translate} are a string and the [ISO
+    # 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) code of the
+    # language to which you wish to translate.
+    #
+    # ```ruby
+    # require "google/cloud"
+    #
+    # gcloud = Google::Cloud.new
+    # translate = gcloud.translate
+    #
+    # translation = translate.translate "Hello world!", to: "la"
+    #
+    # puts translation #=> Salve mundi!
+    #
+    # translation.from #=> "en"
+    # translation.origin #=> "Hello world!"
+    # translation.to #=> "la"
+    # translation.text #=> "Salve mundi!"
+    # ```
+    #
+    # You may want to use the `from` option to specify the language of the
+    # source text, as the following example illustrates. (Single words do not
+    # give Translate API much to work with.)
+    #
+    # ```ruby
+    # require "google/cloud"
+    #
+    # gcloud = Google::Cloud.new
+    # translate = gcloud.translate
+    #
+    # translation = translate.translate "chat", to: "en"
+    #
+    # translation.detected? #=> true
+    # translation.from #=> "en"
+    # translation.text #=> "chat"
+    #
+    # translation = translate.translate "chat", from: "fr", to: "en"
+    #
+    # translation.detected? #=> false
+    # translation.from #=> "fr"
+    # translation.text #=> "cat"
+    # ```
+    #
+    # You can pass multiple texts to {Google::Cloud::Translate::Api#translate}.
+    #
+    # ```ruby
+    # require "google/cloud"
+    #
+    # gcloud = Google::Cloud.new
+    # translate = gcloud.translate
+    #
+    # translations = translate.translate "chien", "chat", from: "fr", to: "en"
+    #
+    # translations.size #=> 2
+    # translations[0].origin #=> "chien"
+    # translations[0].text #=> "dog"
+    # translations[1].origin #=> "chat"
+    # translations[1].text #=> "cat"
+    # ```
+    #
+    # By default, any HTML in your source text will be preserved.
+    #
+    # ```ruby
+    # require "google/cloud"
+    #
+    # gcloud = Google::Cloud.new
+    # translate = gcloud.translate
+    #
+    # translation = translate.translate "<strong>Hello</strong> world!",
+    #                                   to: :la
+    # translation.text #=> "<strong>Salve</strong> mundi!"
+    # ```
+    #
+    # ## Detecting languages
+    #
+    # You can use {Google::Cloud::Translate::Api#detect} to see which language
+    # the Translate API ranks as the most likely source language for a text. The
+    # `confidence` score is a float value between `0` and `1`.
+    #
+    # ```ruby
+    # require "google/cloud"
+    #
+    # gcloud = Google::Cloud.new
+    # translate = gcloud.translate
+    #
+    # detection = translate.detect "chat"
+    #
+    # detection.text #=> "chat"
+    # detection.language #=> "en"
+    # detection.confidence #=> 0.59922177
+    # ```
+    #
+    # You can pass multiple texts to {Google::Cloud::Translate::Api#detect}.
+    #
+    # ```ruby
+    # require "google/cloud"
+    #
+    # gcloud = Google::Cloud.new
+    # translate = gcloud.translate
+    #
+    # detections = translate.detect "chien", "chat"
+    #
+    # detections.size #=> 2
+    # detections[0].text #=> "chien"
+    # detections[0].language #=> "fr"
+    # detections[0].confidence #=> 0.7109375
+    # detections[1].text #=> "chat"
+    # detections[1].language #=> "en"
+    # detections[1].confidence #=> 0.59922177
+    # ```
+    #
+    # ## Listing supported languages
+    #
+    # Translate API adds new languages frequently. You can use
+    # {Google::Cloud::Translate::Api#languages} to query the list of supported
+    # languages.
+    #
+    # ```ruby
+    # require "google/cloud"
+    #
+    # gcloud = Google::Cloud.new
+    # translate = gcloud.translate
+    #
+    # languages = translate.languages
+    #
+    # languages.size #=> 104
+    # languages[0].code #=> "af"
+    # languages[0].name #=> nil
+    # ```
+    #
+    # To receive the names of the supported languages, as well as their [ISO
+    # 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) codes,
+    # provide the code for the language in which you wish to receive the names.
+    #
+    # ```ruby
+    # require "google/cloud"
+    #
+    # gcloud = Google::Cloud.new
+    # translate = gcloud.translate
+    #
+    # languages = translate.languages "en"
+    #
+    # languages.size #=> 104
+    # languages[0].code #=> "af"
+    # languages[0].name #=> "Afrikaans"
+    # ```
+    #
+    # ## Configuring retries and timeout
+    #
+    # You can configure how many times API requests may be automatically
+    # retried. When an API request fails, the response will be inspected to see
+    # if the request meets criteria indicating that it may succeed on retry,
+    # such as `500` and `503` status codes or a specific internal error code
+    # such as `rateLimitExceeded`. If it meets the criteria, the request will be
+    # retried after a delay. If another error occurs, the delay will be
+    # increased before a subsequent attempt, until the `retries` limit is
+    # reached.
+    #
+    # You can also set the request `timeout` value in seconds.
+    #
+    # ```ruby
+    # require "google/cloud"
+    #
+    # gcloud = Google::Cloud.new
+    # translate = gcloud.translate retries: 10, timeout: 120
+    # ```
+    #
+    module Translate
+    end
+  end
+end

data/lib/google/cloud/translate/api.rb

@@ -0,0 +1,244 @@
+# 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/translate/service"
+require "google/cloud/translate/translation"
+require "google/cloud/translate/detection"
+require "google/cloud/translate/language"
+
+module Google
+  module Cloud
+    module Translate
+      ##
+      # # Api
+      #
+      # Represents top-level access to the Google Translate API. Each instance
+      # requires a public API access key. To create a key, follow the general
+      # instructions at [Identifying your application to
+      # Google](https://cloud.google.com/translate/v2/using_rest#auth), and the
+      # specific instructions for [Server
+      # keys](https://cloud.google.com/translate/v2/using_rest#creating-server-api-keys).
+      # See {Google::Cloud#translate}.
+      #
+      # @see https://cloud.google.com/translate/v2/getting_started Translate API
+      #   Getting Started
+      #
+      # @example
+      #   require "google/cloud"
+      #
+      #   gcloud = Google::Cloud.new
+      #   translate = gcloud.translate
+      #
+      #   translation = translate.translate "Hello world!", to: "la"
+      #
+      #   puts translation #=> Salve mundi!
+      #
+      #   translation.from #=> "en"
+      #   translation.origin #=> "Hello world!"
+      #   translation.to #=> "la"
+      #   translation.text #=> "Salve mundi!"
+      #
+      class Api
+        ##
+        # @private The Service object.
+        attr_accessor :service
+
+        ##
+        # @private Creates a new Translate Api instance.
+        #
+        # See {Google::Cloud.translate}
+        def initialize service
+          @service = service
+        end
+
+        ##
+        # Returns text translations from one language to another.
+        #
+        # @see https://cloud.google.com/translate/v2/using_rest#Translate
+        #   Translate Text
+        #
+        # @param [String] text The text or texts to translate.
+        # @param [String] to The target language into which the text should be
+        #   translated. This is required. The value must be an [ISO
+        #   639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)
+        #   language code.
+        # @param [String] from The source language of the text or texts. This is
+        #   an [ISO
+        #   639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)
+        #   language code. This is optional.
+        # @param [String] format The format of the text. Possible values include
+        #   `:text` and `:html`. This is optional. The Translate API default is
+        #   `:html`.
+        # @param [String] cid The customization id for translate. This is
+        #   optional.
+        #
+        # @return [Translation, Array<Translation>] A single {Translation}
+        #   object if just one text was given, or an array of {Translation}
+        #   objects if multiple texts were given.
+        #
+        # @example
+        #   require "google/cloud"
+        #
+        #   gcloud = Google::Cloud.new
+        #   translate = gcloud.translate
+        #
+        #   translation = translate.translate "Hello world!", to: "la"
+        #
+        #   puts translation #=> Salve mundi!
+        #
+        #   translation.detected? #=> true
+        #   translation.from #=> "en"
+        #   translation.origin #=> "Hello world!"
+        #   translation.to #=> "la"
+        #   translation.text #=> "Salve mundi!"
+        #
+        # @example Setting the `from` language.
+        #   require "google/cloud"
+        #
+        #   gcloud = Google::Cloud.new
+        #   translate = gcloud.translate
+        #
+        #   translation = translate.translate "Hello world!",
+        #                                     from: :en, to: :la
+        #   translation.detected? #=> false
+        #   translation.text #=> "Salve mundi!"
+        #
+        # @example Retrieving multiple translations.
+        #   require "google/cloud"
+        #
+        #   gcloud = Google::Cloud.new
+        #   translate = gcloud.translate
+        #
+        #   translations = translate.translate "Hello my friend.",
+        #                                      "See you soon.",
+        #                                      from: "en", to: "la"
+        #   translations.count #=> 2
+        #   translations[0].text #=> "Salve amice."
+        #   translations[1].text #=> "Vide te mox."
+        #
+        # @example Preserving HTML tags.
+        #   require "google/cloud"
+        #
+        #   gcloud = Google::Cloud.new
+        #   translate = gcloud.translate
+        #
+        #   translation = translate.translate "<strong>Hello</strong> world!",
+        #                                     to: :la
+        #   translation.text #=> "<strong>Salve</strong> mundi!"
+        #
+        def translate *text, to: nil, from: nil, format: nil, cid: nil
+          return nil if text.empty?
+          fail ArgumentError, "to is required" if to.nil?
+          to = to.to_s
+          from = from.to_s if from
+          format = format.to_s if format
+          text = Array(text).flatten
+          gapi = service.translate text, to: to, from: from,
+                                         format: format, cid: cid
+          Translation.from_gapi_list gapi, text, to, from
+        end
+
+        ##
+        # Detect the most likely language or languages of a text or multiple
+        # texts.
+        #
+        # @see https://cloud.google.com/translate/v2/using_rest#detect-language
+        #   Detect Language
+        #
+        # @param [String] text The text or texts upon which language detection
+        #   should be performed.
+        #
+        # @return [Detection, Array<Detection>] A single {Detection} object if
+        #   just one text was given, or an array of {Detection} objects if
+        #   multiple texts were given.
+        #
+        # @example
+        #   require "google/cloud"
+        #
+        #   gcloud = Google::Cloud.new
+        #   translate = gcloud.translate
+        #
+        #   detection = translate.detect "Hello world!"
+        #   puts detection.language #=> en
+        #   puts detection.confidence #=> 0.7100697
+        #
+        # @example Detecting multiple texts.
+        #   require "google/cloud"
+        #
+        #   gcloud = Google::Cloud.new
+        #   translate = gcloud.translate
+        #
+        #   detections = translate.detect "Hello world!",
+        #                                 "Bonjour le monde!"
+        #   puts detections.count #=> 2
+        #   puts detection.first.language #=> en
+        #   puts detection.first.confidence #=> 0.7100697
+        #   puts detection.last.language #=> fr
+        #   puts detection.last.confidence #=> 0.40440267
+        #
+        def detect *text
+          return nil if text.empty?
+          text = Array(text).flatten
+          gapi = service.detect(text)
+          Detection.from_gapi gapi, text
+        end
+
+        ##
+        # List the languages supported by the API. These are the languages to
+        # and from which text can be translated.
+        #
+        # @see https://cloud.google.com/translate/v2/using_rest#supported-languages
+        #   Discover Supported Languages
+        #
+        # @param [String] language The language and collation in which the names
+        #   of the languages are returned. If this is `nil` then no names are
+        #   returned.
+        #
+        # @return [Array<Language>] An array of {Language} objects supported by
+        #   the API.
+        #
+        # @example
+        #   require "google/cloud"
+        #
+        #   gcloud = Google::Cloud.new
+        #   translate = gcloud.translate
+        #
+        #   languages = translate.languages
+        #   languages.count #=> 104
+        #
+        #   english = languages.detect { |l| l.code == "en" }
+        #   english.name #=> nil
+        #
+        # @example Get all languages with their names in French.
+        #   require "google/cloud"
+        #
+        #   gcloud = Google::Cloud.new
+        #   translate = gcloud.translate
+        #
+        #   languages = translate.languages "fr"
+        #   languages.count #=> 104
+        #
+        #   english = languages.detect { |l| l.code == "en" }
+        #   english.name #=> "Anglais"
+        #
+        def languages language = nil
+          language = language.to_s if language
+          gapi = service.languages language
+          Array(gapi.languages).map { |g| Language.from_gapi g }
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/translate/detection.rb

@@ -0,0 +1,140 @@
+# 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.
+
+
+module Google
+  module Cloud
+    module Translate
+      ##
+      # # Detection
+      #
+      # Represents a detect language query result. Returned by
+      # {Google::Cloud::Translate::Api#detect}.
+      #
+      # @see https://cloud.google.com/translate/v2/using_rest#detect-language
+      #   Detect Language
+      #
+      # @example
+      #   require "google/cloud"
+      #
+      #   gcloud = Google::Cloud.new
+      #   translate = gcloud.translate
+      #
+      #   detections = translate.detect "chien", "chat"
+      #
+      #   detections.size #=> 2
+      #   detections[0].text #=> "chien"
+      #   detections[0].language #=> "fr"
+      #   detections[0].confidence #=> 0.7109375
+      #   detections[1].text #=> "chat"
+      #   detections[1].language #=> "en"
+      #   detections[1].confidence #=> 0.59922177
+      #
+      class Detection
+        ##
+        # The text upon which the language detection was performed.
+        #
+        # @return [String]
+        attr_reader :text
+
+        ##
+        # The list of detection results for the given text. The most likely
+        # language is listed first, and its attributes can be accessed through
+        # {#language} and {#confidence}.
+        #
+        # @return [Array<Detection::Result>]
+        attr_reader :results
+
+        ##
+        # @private Create a new object.
+        def initialize text, results
+          @text = text
+          @results = results
+        end
+
+        ##
+        # The confidence that the language detection result is correct. The
+        # closer this value is to 1, the higher the confidence in language
+        # detection.
+        #
+        # @return [Float] a value between 0 and 1
+        def confidence
+          return nil if results.empty?
+          results.first.confidence
+        end
+
+        ##
+        # The most likely language that was detected. This is an [ISO
+        # 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language
+        # code.
+        #
+        # @return [String] the language code
+        def language
+          return nil if results.empty?
+          results.first.language
+        end
+
+        ##
+        # @private New Detection from a ListDetectionsResponse object as
+        # defined by the Google API Client object.
+        def self.from_gapi gapi, text
+          res = text.zip(Array(gapi.detections)).map do |txt, detections_gapi|
+            results = detections_gapi.map { |g| Result.from_gapi g }
+            new txt, results
+          end
+          return res.first if res.size == 1
+          res
+        end
+
+        ##
+        # # Result
+        #
+        # Represents an individual result in a
+        # {Google::Cloud::Translate::Detection} result.
+        #
+        class Result
+          ##
+          # The confidence that the language detection result is correct. The
+          # closer this value is to 1, the higher the confidence in language
+          # detection.
+          #
+          # @return [Float] a value between 0 and 1
+          attr_reader :confidence
+
+          ##
+          # The language detected. This is an [ISO
+          # 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)
+          # language code.
+          #
+          # @return [String] the language code
+          attr_reader :language
+
+          ##
+          # @private Create a new object.
+          def initialize confidence, language
+            @confidence = confidence
+            @language = language
+          end
+
+          ##
+          # @private New Detection::Result from a DetectionsResource object as
+          # defined by the Google API Client object.
+          def self.from_gapi gapi
+            new gapi.confidence, gapi.language
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,71 @@
+# 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.
+
+
+module Google
+  module Cloud
+    module Translate
+      ##
+      # # Language
+      #
+      # Represents a supported languages query result. Returned by
+      # {Google::Cloud::Translate::Api#languages}.
+      #
+      # @see https://cloud.google.com/translate/v2/using_rest#supported-languages
+      #   Discover Supported Languages
+      #
+      # @example
+      #   require "google/cloud"
+      #
+      #   gcloud = Google::Cloud.new
+      #   translate = gcloud.translate
+      #
+      #   languages = translate.languages "en"
+      #
+      #   languages.size #=> 104
+      #   languages[0].code #=> "af"
+      #   languages[0].name #=> "Afrikaans"
+      #
+      class Language
+        ##
+        # The language code. This is an [ISO
+        # 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language
+        # code.
+        #
+        # @return [String]
+        attr_reader :code
+
+        ##
+        # The localized name of the language, if available.
+        #
+        # @return [String]
+        attr_reader :name
+
+        ##
+        # @private Create a new object.
+        def initialize code, name
+          @code = code
+          @name = name
+        end
+
+        ##
+        # @private New Language from a LanguagesResource object as defined by
+        # the Google API Client object.
+        def self.from_gapi gapi
+          new gapi.language, gapi.name
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/translate/service.rb

@@ -0,0 +1,87 @@
+# 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/translate/version"
+require "google/apis/translate_v2"
+
+module Google
+  module Cloud
+    module Translate
+      ##
+      # @private
+      # Represents the service to Translate, exposing the API calls.
+      class Service
+        ##
+        # Alias to the Google Client API module
+        API = Google::Apis::TranslateV2
+
+        attr_accessor :credentials
+
+        ##
+        # Creates a new Service instance.
+        def initialize key, retries: nil, timeout: nil
+          @service = API::TranslateService.new
+          @service.client_options.application_name    = "google-cloud-translate"
+          @service.client_options.application_version = \
+            Google::Cloud::Translate::VERSION
+          @service.request_options.retries = retries || 3
+          @service.request_options.timeout_sec = timeout if timeout
+          @service.authorization = nil
+          @service.key = key
+        end
+
+        def service
+          return mocked_service if mocked_service
+          @service
+        end
+        attr_accessor :mocked_service
+
+        ##
+        # Returns API::ListTranslationsResponse
+        def translate text, to: nil, from: nil, format: nil, cid: nil
+          execute do
+            service.list_translations Array(text), to, cid: cid, format: format,
+                                                       source: from
+          end
+        end
+
+        ##
+        # Returns API::ListDetectionsResponse
+        def detect text
+          execute { service.list_detections Array(text) }
+        end
+
+        ##
+        # Returns API::ListLanguagesResponse
+        def languages language = nil
+          execute { service.list_languages target: language }
+        end
+
+        def inspect
+          "#{self.class}"
+        end
+
+        protected
+
+        def execute
+          yield
+        rescue Google::Apis::Error => e
+          raise Google::Cloud::Error.from_error(e)
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/translate/translation.rb

@@ -0,0 +1,114 @@
+# 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.
+
+
+module Google
+  module Cloud
+    module Translate
+      ##
+      # # Translation
+      #
+      # Represents a translation query result. Returned by
+      # {Google::Cloud::Translate::Api#translate}.
+      #
+      # @see https://cloud.google.com/translate/v2/using_rest#Translate
+      #   Translate Text
+      #
+      # @example
+      #   require "google/cloud"
+      #
+      #   gcloud = Google::Cloud.new
+      #   translate = gcloud.translate
+      #
+      #   translation = translate.translate "Hello world!", to: "la"
+      #
+      #   puts translation #=> Salve mundi!
+      #
+      #   translation.from #=> "en"
+      #   translation.origin #=> "Hello world!"
+      #   translation.to #=> "la"
+      #   translation.text #=> "Salve mundi!"
+      #
+      class Translation
+        ##
+        # The translated result.
+        #
+        # @return [String]
+        attr_reader :text
+        alias_method :to_s, :text
+        alias_method :to_str, :text
+
+        ##
+        # The original query text that was translated.
+        #
+        # @return [String]
+        attr_reader :origin
+
+        ##
+        # The target language into which the text was translated.
+        #
+        # @return [String]
+        attr_reader :to
+        alias_method :language, :to
+        alias_method :target, :to
+
+        ##
+        # The source language from which the text was translated.
+        attr_reader :from
+        alias_method :source, :from
+
+        ##
+        # @private Create a new object.
+        def initialize text, to, origin, from, detected
+          @text = text
+          @to = to
+          @origin = origin
+          @from = from
+          @detected = detected
+        end
+
+        ##
+        # Determines if the source language was detected by the Google Cloud
+        # Translate API.
+        #
+        # @return [Boolean] `true` if the source language was detected by the
+        #   Translate service, `false` if the source language was provided in
+        #   the request
+        def detected?
+          @detected
+        end
+
+        ##
+        # @private New Translation from a TranslationsListResponse object as
+        # defined by the Google API Client object.
+        def self.from_gapi_list gapi, text, to, from
+          res = text.zip(Array(gapi.translations)).map do |origin, g|
+            from_gapi g, to, origin, from
+          end
+          return res.first if res.size == 1
+          res
+        end
+
+        ##
+        # @private New Translation from a TranslationsResource object as defined
+        # by the Google API Client object.
+        def self.from_gapi gapi, to, origin, from
+          from ||= gapi.detected_source_language
+          detected = !gapi.detected_source_language.nil?
+          new gapi.translated_text, to, origin, from, detected
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/translate/version.rb

@@ -0,0 +1,22 @@
+# 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.
+
+
+module Google
+  module Cloud
+    module Translate
+      VERSION = "0.20.0"
+    end
+  end
+end

metadata

@@ -0,0 +1,194 @@
+--- !ruby/object:Gem::Specification
+name: google-cloud-translate
+version: !ruby/object:Gem::Version
+  version: 0.20.0
+platform: ruby
+authors:
+- Mike Moore
+- Chris Smith
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-08-27 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: 0.20.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.20.0
+- !ruby/object:Gem::Dependency
+  name: google-api-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.11
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.9'
+- !ruby/object:Gem::Dependency
+  name: minitest-autotest
+  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
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: minitest-rg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: autotest-suffix
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 0.35.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<="
+      - !ruby/object:Gem::Version
+        version: 0.35.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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
+  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'
+description: google-cloud-translate is the official library for Google Translate API.
+email:
+- mike@blowmage.com
+- quartzmo@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/google-cloud-translate.rb
+- lib/google/cloud/translate.rb
+- lib/google/cloud/translate/api.rb
+- lib/google/cloud/translate/detection.rb
+- lib/google/cloud/translate/language.rb
+- lib/google/cloud/translate/service.rb
+- lib/google/cloud/translate/translation.rb
+- lib/google/cloud/translate/version.rb
+homepage: http://googlecloudplatform.github.io/google-cloud-ruby/
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.4
+signing_key: 
+specification_version: 4
+summary: API Client library for Google Translate API
+test_files: []