bing_translator 5.2.0 → 6.0.0.beta.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 30d94b0e0875f32aeadcdaba47c6c9744dab2628
-  data.tar.gz: 60ca01d9b5ceb5eed85b52ed8d2bd0512bdfb149
+  metadata.gz: 9106de975569bef3303a4940318a78b536beaf10
+  data.tar.gz: e40c556e6f474d185b74f6753635a448720600f6
 SHA512:
-  metadata.gz: a6b42ea3aae1e84110313d12c37499c2639399ad759633afeae288cac2823c3d2b8cb41c22212e245e628a2340b2441d1aba19a92f20cb925f0677be3fbcd7ee
-  data.tar.gz: 2a3735bf3b80e69c22c77d47f4e760f7613f46a2be04b50e25f97651f496608c144b1e34c805e71b6757a6b89387b4d759235aa2f59c694eacfe968de3c5d968
+  metadata.gz: 8b84d0f6c1b4a405ee631221a961f8e5462c7de1b0ca3eb26b0f0b2dc105e3b0e8ac19c085c8de320191a66895af313fc1b1f718f81b13505a6b31ab8a20108c
+  data.tar.gz: c22b944db83f5b437b9fa56e8df83da1bd69f7b81f9ef65dedb51a66d82c79714fba29701da46a6bd1b027e56ff69e54f3e5c21bddfccacddfadd3daa252e3a4

data/lib/bing_translator.rb

@@ -1,192 +1,165 @@
-#!/usr/bin/env ruby
-# encoding: utf-8
-# (c) 2011-present. Ricky Elrod <ricky@elrod.me>
-# Released under the MIT license.
-require 'rubygems'
-require 'cgi'
-require 'uri'
-require 'net/http'
-require 'net/https'
-require 'nokogiri'
-require 'json'
-require 'savon'
-
-class BingTranslator
-  WSDL_URI = 'http://api.microsofttranslator.com/V2/soap.svc?wsdl'
-  NAMESPACE_URI = 'http://api.microsofttranslator.com/V2'
-  COGNITIVE_ACCESS_TOKEN_URI = URI.parse('https://api.cognitive.microsoft.com/sts/v1.0/issueToken').freeze
-
-  class Exception < StandardError; end
-
-  def initialize(subscription_key, options = {})
-    @skip_ssl_verify = options.fetch(:skip_ssl_verify, false)
-    @subscription_key = subscription_key
-  end
-
-  def translate(text, params = {})
-    raise "Must provide :to." if params[:to].nil?
-
-    # Important notice: param order makes sense in SOAP. Do not reorder or delete!
-    params = {
-      'text'        => text.to_s,
-      'from'        => params[:from].to_s,
-      'to'          => params[:to].to_s,
-      'category'    => 'general',
-      'contentType' => params[:content_type] || 'text/plain'
-    }
-
-    result(:translate, params)
-  end
-
-  def translate_array(texts, params = {})
-    raise "Must provide :to." if params[:to].nil?
-
-    # Important notice: param order makes sense in SOAP. Do not reorder or delete!
-    params = {
-      'texts'       => { 'arr:string' => texts },
-      'from'        => params[:from].to_s,
-      'to'          => params[:to].to_s,
-      'category'    => 'general',
-      'contentType' => params[:content_type] || 'text/plain'
-    }
-
-    array_wrap(result(:translate_array, params)[:translate_array_response]).map{|r| r[:translated_text]}
-  end
-
- def translate_array2(texts, params = {})
-    raise "Must provide :to." if params[:to].nil?
-
-    # Important notice: param order makes sense in SOAP. Do not reorder or delete!
-    params = {
-      'texts'       => { 'arr:string' => texts },
-      'from'        => params[:from].to_s,
-      'to'          => params[:to].to_s,
-      'category'    => 'general',
-      'contentType' => params[:content_type] || 'text/plain'
-    }
-
-    array_wrap(result(:translate_array2, params)[:translate_array2_response]).map{|r| [r[:translated_text], r[:alignment]]}
-  end
-
-  def detect(text)
-    params = {
-      'text'     => text.to_s,
-      'language' => '',
-    }
-
-    if lang = result(:detect, params)
-      lang.to_sym
-    end
-  end
-
-  # format:   'audio/wav' [default] or 'audio/mp3'
-  # language: valid translator language code
-  # options:  'MinSize' [default] or 'MaxQuality'
-  def speak(text, params = {})
-    raise "Must provide :language" if params[:language].nil?
-
-    params = {
-      'text'     => text.to_s,
-      'language' => params[:language].to_s,
-      'format'   => params[:format] || 'audio/wav',
-      'options'  => params[:options] || 'MinSize',
-    }
-
-    uri = URI.parse(result(:speak, params))
-
-    http = Net::HTTP.new(uri.host, uri.port)
-    if uri.scheme == "https"
-      http.use_ssl = true
-      http.verify_mode = OpenSSL::SSL::VERIFY_NONE if @skip_ssl_verify
-    end
-    results = http.get(uri.to_s, {'Authorization' => "Bearer #{get_access_token['access_token']}"})
-
-    if results.response.code.to_i == 200
-      results.body
-    else
-      html = Nokogiri::HTML(results.body)
-      raise Exception, html.xpath("//text()").remove.map(&:to_s).join(' ')
-    end
-  end
-
-  def supported_language_codes
-    result(:get_languages_for_translate)[:string]
-  end
-
-  def language_names(codes, locale = 'en')
-    response = result(:get_language_names, locale: locale, languageCodes: {'a:string' => codes}) do
-      attributes 'xmlns:a' => 'http://schemas.microsoft.com/2003/10/Serialization/Arrays'
-    end
-
-    response[:string]
-  end
-
-  private
-
-  # Get a new access token and set it internally as @access_token
-  #
-  # @return {hash}
-  # Returns existing @access_token if we don't need a new token yet,
-  # or returns the one just obtained.
-  def get_access_token
-    headers = {
-      'Ocp-Apim-Subscription-Key' => @subscription_key
-    }
-
-    http = Net::HTTP.new(COGNITIVE_ACCESS_TOKEN_URI.host, COGNITIVE_ACCESS_TOKEN_URI.port)
-    http.use_ssl = true
-    http.verify_mode = OpenSSL::SSL::VERIFY_NONE if @skip_ssl_verify
-
-    response = http.post(COGNITIVE_ACCESS_TOKEN_URI.path, "", headers)
-
-    @access_token = {
-      'access_token' => response.body,
-      'expires_at' => Time.now + 480
-    }
-  end
-
-  # Performs actual request to Bing Translator SOAP API
-  def result(action, params = {}, &block)    
-    soap_client.call(action, message: build_soap_message(params), &block).body[:"#{action}_response"][:"#{action}_result"]
-  rescue Savon::SOAPFault => e
-    raise Exception, e.message
-  end
-
-  # Specify SOAP namespace in tag names (see https://github.com/savonrb/savon/issues/340 )
-  #
-  # @return [Hash]
-  def build_soap_message(params)    
-    Hash[params.map{|k,v| ["v2:#{k}", v]}]
-  end
-
-  # Private: Constructs SOAP client
-  #
-  # Construct and store new client when called first time.
-  # Return stored client while access token is fresh.
-  # Construct and store new client when token have been expired.
-  def soap_client
-    return @client if @client and @access_token and @access_token['expires_at'] and
-      Time.now < @access_token['expires_at']
-
-    @client = Savon.client(
-      wsdl: WSDL_URI,
-      namespace: NAMESPACE_URI,
-      namespace_identifier: :v2,
-      namespaces: {
-        'xmlns:arr' =>  'http://schemas.microsoft.com/2003/10/Serialization/Arrays'
-      },
-      headers: {'Authorization' => "Bearer #{get_access_token['access_token']}"},
-    )
-  end
-
-  # Private: Array#wrap based on ActiveSupport extension
-  def array_wrap(object)
-    if object.nil?
-      []
-    elsif object.respond_to?(:to_ary)
-      object.to_ary || [object]
-    else
-      [object]
-    end
-  end
-end
+#!/usr/bin/env ruby
+
+# (c) 2011-present. Ricky Elrod <ricky@elrod.me>
+# Released under the MIT license.
+require 'rubygems'
+require 'cgi'
+require 'uri'
+require 'net/http'
+require 'net/https'
+require 'json'
+
+class BingTranslator
+  class Exception < StandardError; end
+
+  class ApiClient
+    API_HOST = 'https://api.cognitive.microsofttranslator.com'.freeze
+    COGNITIVE_ACCESS_TOKEN_URI =
+      URI.parse('https://api.cognitive.microsoft.com/sts/v1.0/issueToken').freeze
+
+    def initialize(subscription_key, skip_ssl_verify)
+      @subscription_key = subscription_key
+      @skip_ssl_verify = skip_ssl_verify
+    end
+
+    def get(path, params: {}, headers: {}, authorization: false)
+      uri = request_uri(path, params)
+      request = Net::HTTP::Get.new(uri.request_uri, default_headers(authorization).merge(headers))
+
+      json_response(uri, request)
+    end
+
+    def post(path, params: {}, headers: {}, data: {}, authorization: true)
+      uri = request_uri(path, params)
+
+      request = Net::HTTP::Post.new(uri.request_uri, default_headers(authorization).merge(headers))
+      request.body = data
+
+      json_response(uri, request)
+    end
+
+    private
+
+    def default_headers(authorization = true)
+      headers = { 'Content-Type' => 'application/json' }
+      headers['Authorization'] = "Bearer #{access_token}" if authorization
+      headers
+    end
+
+    def json_response(uri, request)
+      http = http_client(uri)
+
+      response = http.request(request)
+
+      raise Exception.new("Unsuccessful API call: Code: #{response.code}") unless response.code == '200'
+      JSON.parse(response.body)
+    end
+
+    def http_client(uri)
+      http = Net::HTTP.new(uri.host, 443)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE if @skip_ssl_verify
+      http
+    end
+
+    def request_uri(path, params)
+      encoded_params = URI.encode_www_form(params.merge('api-version' => '3.0'))
+      uri = URI.parse("#{API_HOST}#{path}")
+      uri.query = encoded_params
+      uri
+    end
+
+    def access_token
+      if @access_token.nil? || Time.now < @access_token_expiration_time
+        @access_token = request_new_access_token
+      end
+      @access_token
+    end
+
+    def request_new_access_token
+      headers = {
+        'Ocp-Apim-Subscription-Key' => @subscription_key
+      }
+
+      http = Net::HTTP.new(COGNITIVE_ACCESS_TOKEN_URI.host, COGNITIVE_ACCESS_TOKEN_URI.port)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE if @skip_ssl_verify
+
+      response = http.post(COGNITIVE_ACCESS_TOKEN_URI.path, '', headers)
+      if response.code != '200'
+        raise Exception.new('Invalid credentials')
+      else
+        @access_token_expiration_time = Time.now + 480
+        response.body
+      end
+    end
+  end
+
+  def initialize(subscription_key, options = {})
+    skip_ssl_verify = options.fetch(:skip_ssl_verify, false)
+    @api_client = ApiClient.new(subscription_key, skip_ssl_verify)
+  end
+
+  def translate(text, params)
+    translate_array([text], params).first
+  end
+
+  def translate_array(texts, params = {})
+    translations = translation_request(texts, params)
+    translations.map do |translation|
+      translation['text'] if translation.is_a?(Hash)
+    end
+  end
+
+  def translate_array2(texts, params = {})
+    translations = translation_request(texts, params.merge('includeAlignment' => true))
+    translations.map do |translation|
+      [translation['text'], translation['alignment']['proj']] if translation.is_a?(Hash)
+    end
+  end
+
+  def detect(text)
+    data = [{ 'Text' => text }].to_json
+
+    response_json = api_client.post('/detect', data: data)
+    best_detection = response_json.sort_by { |detection| -detection['score'] }.first
+    best_detection['language'].to_sym
+  end
+
+  def speak(text, params = {})
+    raise Exception.new('Not supported since 3.0.0')
+  end
+
+  def supported_language_codes
+    response_json = api_client.get('/languages',
+                                   params: { scope: 'translation' },
+                                   authorization: false)
+    response_json['translation'].keys
+  end
+
+  def language_names(codes, locale = 'en')
+    response_json = api_client.get('/languages',
+                                   params: { scope: 'translation' },
+                                   headers: { 'Accept-Language' => locale },
+                                   authorization: false)
+    codes.map do |code|
+      response = response_json['translation'][code.to_s]
+      response['name'] unless response.nil?
+    end
+  end
+
+  private
+
+  attr_reader :api_client
+
+  def translation_request(texts, params)
+    raise Exception.new('Must provide :to.') if params[:to].nil?
+
+    data = texts.map { |text| { 'Text' => text } }.to_json
+    response_json = api_client.post('/translate', params: params, data: data)
+    response_json.map do |translation|
+      # There should be just one translation, but who knows...
+      translation['translations'].find { |result| result['to'] == params[:to].to_s }
+    end
+  end
+end

metadata

@@ -1,119 +1,23 @@
 --- !ruby/object:Gem::Specification
 name: bing_translator
 version: !ruby/object:Gem::Version
-  version: 5.2.0
+  version: 6.0.0.beta.1
 platform: ruby
 authors:
 - Ricky Elrod
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-29 00:00:00.000000000 Z
+date: 2019-03-25 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: nokogiri
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.6.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 1.9.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.6.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 1.9.0
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.8.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.8.0
-- !ruby/object:Gem::Dependency
-  name: savon
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 2.10.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 2.10.0
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: rspec-html-matchers
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.9.1
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 0.10.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.9.1
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 0.10.0
-- !ruby/object:Gem::Dependency
-  name: dotenv
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -143,13 +47,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
 summary: Translate using the Bing HTTP API
 test_files: []
+has_rdoc: