google-translate-free 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 61878476dbea93fa674c06ec15e5447c79d59534aac01e45767467dde0964186
+  data.tar.gz: 3d46fe34808ad0391f7ddd3d43357fdaacb023270ab3e72e4e32f2a46a6c361b
+SHA512:
+  metadata.gz: 4b1d3d8c3af406f0b003dc47b9c723363051a149487608b1340b0ffffdcfd9aa7b2e024b96d0389c54b77a7ba079fb49a7da088b3a071f41e36223fd3414b4b7
+  data.tar.gz: c6576a7a50fa7d15f1a9e02b2a404584b638ff547aab17aafdc387e43b682df4324d9a85afc6c49986ad1d8ad3a67307e7050748e975ed72257698ba117fc4da

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2022] [datpmt]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1 @@
+# google-translate-free

data/lib/translate.rb

@@ -0,0 +1,118 @@
+require 'cgi'
+require 'net/http'
+require 'json'
+require_relative 'translate_lib/validation'
+
+module Translate
+  def self.translate(string, to_lang, from_lang = :auto)
+    validate_language_code(from_lang, to_lang)
+    encode = encode_url(string)
+    uri = URI("https://translate.googleapis.com/translate_a/t?client=gtx&sl=#{from_lang}&tl=#{to_lang}&dt=t&q=#{encode}")
+    result = net_get(uri)&.first
+    from_lang.to_sym == :auto ? result&.first : result
+  end
+
+  def self.alternate_translations(string, to_lang, from_lang = :auto)
+    validate_language_code(from_lang, to_lang)
+    uri = URI(url(:at, encode_url(string), from_lang, to_lang))
+    result = net_get(uri).dig(5, 0, 2)
+    return if result.nil?
+
+    result.map { |arr| arr[0].downcase }.uniq
+  end
+
+  def self.definitions(keyword)
+    # [ preposition: [desc ex sysnonyms] ]
+    uri = URI(url(:md, keyword, :auto))
+    result = net_get(uri)[12]
+    return if result.nil?
+
+    result.map do |preposition|
+      pre = preposition[0]
+      {
+        "#{pre}": preposition[1].map do |arr|
+          code = arr.last
+          [arr[0].capitalize, examples(keyword, code)&.first, synonyms(pre, keyword, code)]
+        end
+      }
+    end
+  end
+
+  def self.synonyms(pre, keyword, code)
+    uri = URI(url(:ss, keyword, :auto))
+    result = net_get(uri)[11]
+    return if result.nil?
+
+    rs_response = ''
+
+    result.each do |preposition|
+      rs_response = preposition[1].map { |arr| arr[0] if arr[1] == code }.compact.join(', ') if pre == preposition[0]
+    end
+
+    rs_response == '' ? nil : rs_response
+  end
+
+  def self.examples(keyword, code = nil)
+    uri = URI(url(:ex, keyword, :auto))
+    result = net_get(uri)[13]
+    return unless result
+
+    last_rs = if code.nil?
+                result[0].map { |ex| ex[0] }
+              else
+                result[0].map { |ex| ex[0] if ex.last == code }.compact
+              end
+    last_rs.map do |ex|
+      "#{ex.capitalize}."
+    end
+  end
+
+  def self.transliteration(string)
+    encode = encode_url(string)
+    uri = URI(url(:rm, encode, :auto))
+    net_get(uri)&.dig(0, 0, 3)
+  end
+
+  def self.suggest(string)
+    encode = encode_url(string)
+    uri = URI(url(:qca, encode, :auto))
+    net_get(uri)&.dig(7, 1) || string
+  end
+
+  def self.see_more(keyword)
+    # ex [kids -> kid, tables -> table]
+    encode = encode_url(keyword)
+    uri = URI(url(:rw, encode, :auto))
+    net_get(uri)&.dig(14, 0, 0) || keyword
+  end
+
+  def self.detection(string)
+    uri = URI("https://translate.google.com/translate_a/single?client=gtx&sl=auto&q=#{encode_url(string)}")
+    response = net_get(uri)
+    [response&.dig(2), response&.dig(6)]
+  end
+
+  def self.url(dt_value, q_value, from_lang, to_lang = nil)
+    "https://translate.googleapis.com/translate_a/single?client=gtx&sl=#{from_lang}&tl=#{to_lang}&dt=#{dt_value}&q=#{q_value}"
+  end
+
+  def self.encode_url(string)
+    TranslateLib::Validation.validate_string(string)
+    CGI.escape(string)
+  end
+
+  def self.net_get(uri)
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = true
+    request = Net::HTTP::Get.new(uri.request_uri)
+
+    response = http.request(request)
+    JSON.parse(response.body)
+  rescue StandardError => e
+    raise StandardError, e.message
+  end
+
+  def self.validate_language_code(from_lang, to_lang)
+    TranslateLib::Validation.validate_language_code(from_lang, to_lang)
+  end
+end

data/lib/translate_lib/exception.rb

@@ -0,0 +1,7 @@
+module TranslateLib
+  class Exception < StandardError
+    def self.raise_error!(message)
+      raise self, message
+    end
+  end
+end

data/lib/translate_lib/validation.rb

@@ -0,0 +1,32 @@
+require_relative 'exception'
+
+module TranslateLib
+  class Validation
+    ALLOW_LANGUAGE_CODE = %w[
+      auto
+      af sq am ar hy as ay az bm eu be bn bho bs
+      bg ca ceb zh-cn zh-tw zh co hr cs da dv doi nl en
+      eo et ee fil fi fr fy gl ka de el gn gu ht
+      ha haw he hi hmn hu is ig ilo id ga it ja jv jw
+      kn kk km rw gom ko kri ku ckb ky lo la lv ln
+      lt lg lb mk mai mg ms ml mt mi mr mni-mtei lus
+      mn my ne no ny or om ps fa pl pt pa qu ro ru
+      sm sa gd nso sr st sn sd si sk sl so es su sw
+      sv tl tg ta tt te th ti ts tr tk ak uk ur ug
+      uz vi cy xh yi yo zu
+    ].freeze
+
+    def self.validate_string(string)
+      raise_error!('Translate strings shorter than or equal to 5000 characters.') if string.length > 5000
+    end
+
+    def self.validate_language_code(from_lang, to_lang)
+      raise_error!('from_lang does not have a valid value.') unless ALLOW_LANGUAGE_CODE.include?(from_lang.to_s.downcase)
+      raise_error!('to_lang does not have a valid value.') unless ALLOW_LANGUAGE_CODE.include?(to_lang.to_s.downcase)
+    end
+
+    def self.raise_error!(message)
+      TranslateLib::Exception.raise_error!(message)
+    end
+  end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: google-translate-free
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- datpmt
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-05-10 00:00:00.000000000 Z
+dependencies: []
+description: Google Translate Free
+email: datpmt.2k@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.MD
+- LICENSE
+- README.md
+- lib/translate.rb
+- lib/translate_lib/exception.rb
+- lib/translate_lib/validation.rb
+homepage: https://rubygems.org/gems/google-translate-free
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/datpmt/google-translate-free
+  changelog_uri: https://github.com/datpmt/google-translate-free/blob/main/CHANGELOG.md
+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: []
+rubygems_version: 3.2.3
+signing_key:
+specification_version: 4
+summary: Google Translate Free
+test_files: []