et-wsm 0.3.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7220f40d497b857957df43eb0375f5ba6601b4f8
+  data.tar.gz: af7c20b017e370ff66e96149f93b78252e8adb84
+SHA512:
+  metadata.gz: 162c831567d8f5bb24a2db513d595d711b0824dce6e67d69b84dcd4add420a0bde6e162af2055288e1e7aaa8ab993c6b4f0085895f13c9402c2b2536ee015beb
+  data.tar.gz: 4308eb1d2d1689facd6dc20a3abfad614a3db705a17048d1b84a16303b7763d0f2c7f31d96fd00caa2cfb025af1cc9547f938f3fedefa788cb02e983634dc62f

data/lib/easy_translate.rb

@@ -0,0 +1,21 @@
+require File.dirname(__FILE__) + '/easy_translate/detection'
+require File.dirname(__FILE__) + '/easy_translate/translation'
+require File.dirname(__FILE__) + '/easy_translate/translation_target'
+
+module EasyTranslate
+
+  autoload :EasyTranslateException, File.dirname(__FILE__) + '/easy_translate/easy_translate_exception'
+  autoload :Request, File.dirname(__FILE__) + '/easy_translate/request'
+
+  autoload :LANGUAGES, File.dirname(__FILE__) + '/easy_translate/languages'
+  autoload :VERSION, File.dirname(__FILE__) + '/easy_translate/version'
+
+  extend Detection # Language Detection
+  extend Translation # Language Translation
+  extend TranslationTarget # Language Translation Targets
+
+  class << self
+    attr_accessor :api_key
+  end
+
+end

data/lib/easy_translate/detection.rb

@@ -0,0 +1,82 @@
+require 'json'
+require 'cgi'
+require File.dirname(__FILE__) + '/request'
+
+module EasyTranslate
+
+  module Detection
+
+    # Detect language
+    # @param [String, Array] texts - A single string or set of strings to detect for
+    # @param [Hash] options - Extra options to pass along with the request
+    # @return [String, Array] The resultant language or languages
+    def detect(texts, options = {}, http_options = {})
+      request = DetectionRequest.new(texts, options, http_options)
+      # Turn the response into an array of detections
+      raw = request.perform_raw
+      detections = JSON.parse(raw)['data']['detections'].map do |res|
+        res.empty? ? nil : res.first['language']
+      end
+      # And then return, if they only asked for one, only give one back
+      request.multi? ? detections : detections.first
+    end
+
+    # A convenience class for wrapping a detection request
+    class DetectionRequest < EasyTranslate::Request
+
+      # Set the texts and options
+      # @param [String, Array] texts - The text (or texts) to translate
+      # @param [Hash] options - Options to override or pass along with the request
+      def initialize(texts, options = {}, http_options = {})
+        super(options, http_options)
+        if replacement_api_key = @options.delete(:api_key)
+          @options[:key] = replacement_api_key
+        end
+        self.texts = texts
+      end
+
+      # The params for this request
+      # @return [Hash] the params for the request
+      def params
+        params = super || {}
+        params.merge! @options if @options
+        params
+      end
+
+      # The path for the request
+      # @return [String] The path for the request
+      def path
+        '/language/translate/v2/detect'
+      end
+
+      # The body for the request
+      # @return [String] the body for the request, URL escaped
+      def body
+        @texts.map { |t| "q=#{CGI::escape(t)}" }.join '&'
+      end
+
+      # Whether or not this was a request for multiple texts
+      # @return [Boolean]
+      def multi?
+        @multi
+      end
+
+      private
+
+      # Set the texts for this request
+      # @param [String, Array] texts - The text or texts for this request
+      def texts=(texts)
+        if texts.is_a?(String)
+          @multi = false
+          @texts = [texts]
+        else
+          @multi = true
+          @texts = texts
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/easy_translate/easy_translate_exception.rb

@@ -0,0 +1,6 @@
+module EasyTranslate
+
+  class EasyTranslateException < StandardError
+  end
+
+end

data/lib/easy_translate/languages.rb

@@ -0,0 +1,58 @@
+module EasyTranslate
+
+  LANGUAGES = {
+    'af' => 'afrikaans',
+    'sq' => 'albanian',
+    'ar' => 'arabic',
+    'be' => 'belarusian',
+    'bg' => 'bulgarian',
+    'ca' => 'catalan',
+    'zh-CN' => 'chinese_simplified',
+    'zh-TW' => 'chinese_traditional',
+    'hr' => 'croatian',
+    'cs' => 'czech',
+    'da' => 'danish',
+    'nl' => 'dutch',
+    'en' => 'english',
+    'et' => 'estonian',
+    'tl' => 'filipino',
+    'fi' => 'finnish',
+    'fr' => 'french',
+    'gl' => 'galician',
+    'de' => 'german',
+    'el' => 'greek',
+    'iw' => 'hebrew',
+    'hi' => 'hindi',
+    'hu' => 'hungarian',
+    'is' => 'icelandic',
+    'id' => 'indonesian',
+    'ga' => 'irish',
+    'it' => 'italian',
+    'ja' => 'japanese',
+    'ko' => 'korean',
+    'lv' => 'latvian',
+    'lt' => 'lithuanian',
+    'mk' => 'macedonian',
+    'ms' => 'malay',
+    'mt' => 'maltese',
+    'no' => 'norwegian',
+    'fa' => 'persian',
+    'pl' => 'polish',
+    'pt' => 'portuguese',
+    'ro' => 'romanian',
+    'ru' => 'russian',
+    'sr' => 'serbian',
+    'sk' => 'slovak',
+    'sl' => 'slovenian',
+    'es' => 'spanish',
+    'sw' => 'swahili',
+    'sv' => 'swedish',
+    'th' => 'thai',
+    'tr' => 'turkish',
+    'uk' => 'ukrainian',
+    'vi' => 'vietnamese',
+    'cy' => 'welsh',
+    'yi' => 'yiddish'
+  }
+
+end

data/lib/easy_translate/request.rb

@@ -0,0 +1,105 @@
+require 'net/http'
+require 'net/https'
+require 'uri'
+
+module EasyTranslate
+
+  class Request
+    attr_accessor :http_options
+
+    def initialize(options = {}, http_options = {})
+      @options = options
+      @http_options = http_options
+    end
+
+    # Body, blank by default
+    # @return [String] The body for this request
+    def body
+      ''
+    end
+
+    # The path for the request
+    # @return [String] The path for this request
+    def path
+      raise NotImplementedError.new('path is not implemented')
+    end
+
+    # The base params for a request
+    # @return [Hash] a hash of the base parameters for any request
+    def params
+      params = {}
+      params[:key] = EasyTranslate.api_key if EasyTranslate.api_key
+      params[:prettyPrint] = 'false' # eliminate unnecessary overhead
+      params
+    end
+
+    # Perform the given request
+    # @return [String] The response String
+    def perform_raw
+      # Construct the request
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.add_field('X-HTTP-Method-Override', 'GET')
+      request.body = body
+      # Fire and return
+      response = http.request(request)
+      unless response.code == '200'
+        err = JSON.parse(response.body)['error']['errors'].first['message']
+        raise EasyTranslateException.new(err)
+      end
+      response.body
+    end
+
+    private
+
+    def uri
+      @uri ||= URI.parse("https://www.googleapis.com#{path}?#{param_s}")
+    end
+
+    def http
+      @http ||= Net::HTTP.new(uri.host, uri.port).tap do |http|
+        configure_timeouts(http)
+        configure_ssl(http)
+      end
+    end
+
+    def configure_timeouts(http)
+      http.read_timeout = http.open_timeout = http_options[:timeout] if http_options[:timeout]
+      http.open_timeout = http_options[:open_timeout]                if http_options[:open_timeout]
+    end
+
+    def configure_ssl(http)
+      http.use_ssl      = true
+      http.verify_mode  = OpenSSL::SSL::VERIFY_PEER
+      http.cert_store   = ssl_cert_store
+
+      http.cert         = ssl_options[:client_cert]  if ssl_options[:client_cert]
+      http.key          = ssl_options[:client_key]   if ssl_options[:client_key]
+      http.ca_file      = ssl_options[:ca_file]      if ssl_options[:ca_file]
+      http.ca_path      = ssl_options[:ca_path]      if ssl_options[:ca_path]
+      http.verify_depth = ssl_options[:verify_depth] if ssl_options[:verify_depth]
+      http.ssl_version  = ssl_options[:version]      if ssl_options[:version]
+    end
+
+    def ssl_cert_store
+      return ssl_options[:cert_store] if ssl_options[:cert_store]
+      # Use the default cert store by default, i.e. system ca certs
+      cert_store = OpenSSL::X509::Store.new
+      cert_store.set_default_paths
+      cert_store
+    end
+
+    def ssl_options
+      http_options[:ssl] || {}
+    end
+
+    # Stringify the params
+    # @return [String] The params as a string
+    def param_s
+      params.map do |k, v|
+        "#{k}=#{v}" unless v.nil?
+      end.compact.join('&')
+    end
+
+  end
+
+end

data/lib/easy_translate/translation.rb

@@ -0,0 +1,111 @@
+require 'json'
+require 'cgi'
+require File.dirname(__FILE__) + '/request'
+
+module EasyTranslate
+
+  module Translation
+
+    # Translate text
+    # @param [String, Array] texts - A single string or set of strings to translate
+    # @option options [String, Symbol] :source - The source language (optional)
+    # @option options [String, Symbol] :target - The target language (required)
+    # @option options [Boolean] :html - Whether or not the supplied string is HTML (optional)
+    # @return [String, Array] Translated text or texts
+    def translate(texts, options = {}, http_options = {})
+      request = TranslationRequest.new(texts, options, http_options)
+      # Turn the response into an array of translations
+      raw = request.perform_raw
+      translations = JSON.parse(raw)['data']['translations'].map do |res|
+        res['translatedText']
+      end
+      # And then return, if they only asked for one, only give one back
+      request.multi? ? translations : translations.first
+    end
+
+    # A convenience class for wrapping a translation request
+    class TranslationRequest < EasyTranslate::Request
+
+      # Set the texts and options
+      # @param [String, Array] texts - the text (or texts) to translate
+      # @param [Hash] options - Options to override or pass along with the request
+      def initialize(texts, options, http_options = {})
+        self.texts = texts
+        self.html = options.delete(:html)
+        @source = options.delete(:from)
+        @target = options.delete(:to)
+        raise ArgumentError.new('No target language provided') unless @target
+        raise ArgumentError.new('Support for multiple targets dropped in V2') if @target.is_a?(Array)
+        @http_options = http_options
+        if options
+          @options = options
+          if replacement_api_key = @options.delete(:api_key)
+            @options[:key] = replacement_api_key
+          end
+        end
+      end
+
+      # The params for this request
+      # @return [Hash] the params for the request
+      def params
+        params = super || {}
+        params[:source] = lang(@source) unless @source.nil?
+        params[:target] = lang(@target) unless @target.nil?
+        params[:format] = @format unless @format.nil?
+        params.merge! @options if @options
+        params
+      end
+
+      # The path for the request
+      # @return [String] The path for the request
+      def path
+        '/language/translate/v2'
+      end
+
+      # The body for the request
+      # @return [String] the body for the request, URL escaped
+      def body
+        @texts.map { |t| "q=#{CGI::escape(t)}" }.join '&'
+      end
+
+      # Whether or not this was a request for multiple texts
+      # @return [Boolean]
+      def multi?
+        @multi
+      end
+
+      private
+
+      # Look up a language in the table (if needed)
+      def lang(orig)
+        look = orig.is_a?(String) ? orig : orig.to_s
+        return look if LANGUAGES[look] # shortcut iteration
+        if val = LANGUAGES.detect { |k, v| v == look }
+          return val.first
+        end
+        look
+      end
+
+      # Set the HTML attribute, if true add a format
+      # @param [Boolean] b - Whether or not the text supplied iS HTML
+      def html=(b)
+        @format = b ? 'html' : nil
+      end
+
+      # Set the texts for this request
+      # @param [String, Array] texts - The text or texts for this request
+      def texts=(texts)
+        if texts.is_a?(String)
+          @multi = false
+          @texts = [texts]
+        else
+          @multi = true
+          @texts = texts
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/easy_translate/translation_target.rb

@@ -0,0 +1,47 @@
+require 'json'
+require File.dirname(__FILE__) + '/request'
+
+module EasyTranslate
+
+  module TranslationTarget
+
+    # Determine what translations are available
+    # @param [String] source - The source language (optional)
+    # @param [Hash] options - extra options
+    # @return [Array] an array of strings representing languages
+    def translations_available(target = nil, options = {})
+      request = TranslationTargetRequest.new(target, options)
+      raw = request.perform_raw
+      JSON.parse(raw)['data']['languages'].map do |res|
+        res['language']
+      end
+    end
+
+    class TranslationTargetRequest < EasyTranslate::Request
+
+      def initialize(target = nil, options = nil)
+        super(options)
+        @target = target
+        if @options
+          if replacement_api_key = @options.delete(:api_key)
+            @options[:key] = replacement_api_key
+          end
+        end
+      end
+
+      def params
+        params = super || {}
+        params[:target] = @target unless @target.nil?
+        params.merge! @options if @options
+        params
+      end
+
+      def path
+        '/language/translate/v2/languages'
+      end
+
+    end
+
+  end
+
+end

data/lib/easy_translate/version.rb

@@ -0,0 +1,5 @@
+module EasyTranslate
+
+  VERSION = '0.3.3'
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+# Start SimpleCov
+begin
+  require 'simplecov'
+  SimpleCov.start
+rescue LoadError
+  puts 'for coverage please install SimpleCov'
+end
+
+# Require the actual project
+require 'ostruct'
+require File.dirname(__FILE__) + '/../lib/easy_translate'

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: et-wsm
+version: !ruby/object:Gem::Version
+  version: 0.3.3
+platform: ruby
+authors:
+- Test Only
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-06-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: easy_translate is a wrapper for the google translate API that makes sense
+  programatically, and implements API keys
+email: test@test_fake.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/easy_translate.rb
+- lib/easy_translate/detection.rb
+- lib/easy_translate/easy_translate_exception.rb
+- lib/easy_translate/languages.rb
+- lib/easy_translate/request.rb
+- lib/easy_translate/translation.rb
+- lib/easy_translate/translation_target.rb
+- lib/easy_translate/version.rb
+- spec/spec_helper.rb
+homepage: https://www.google.com
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '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: Google Translate API Wrapper for Ruby
+test_files:
+- spec/spec_helper.rb