google-translate-free 0.0.2 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9281ea7400c5f0b3d2a379c41b26343229b20940dc3e87dfb0db0fa8b7afee2
-  data.tar.gz: 381d4e3df919260e9a480d2c25d6ef2b6dd1f2d06a5b3e0f4973348d2b392387
+  metadata.gz: 4d07599110943c837b830702a549267348e5daafc7e6a37c4b0fd8bba7a2419b
+  data.tar.gz: 8bd83c3cf57e6d2c34a9ece07939288d0005205c555513d6e43babe0286a5755
 SHA512:
-  metadata.gz: 6aa72aa855c0f45944788614e26dc0dd12e12e78ca0946f4dd26fc451f835eb3a51098df6357511aeed7f3c2b62580ea5fd0805348ff6f622ef0f5947845663a
-  data.tar.gz: 33cf81f18857b0c15510c7d7034915d7006687d443c25b2fe222e3668bff85998568c24874664eb9eec3ab2b1e4d26e09137e81d3b7e90a08f3535e0d41a98ef
+  metadata.gz: 872978126e335d6f2c4aab8fbe709ce069aff046fe4499d75d4a5ecbe6f28d832f0ae958c32f7448161d347ac009d912d39d66eaba63b8f5f16854ed8c58105f
+  data.tar.gz: 8670acf54fd88cf533f933532cd8d635f0e6eaa783c32fb39a7a1208cc31acaf3cd801ada3179e679d14e1c798447f800777dfdd411cdda3dded0e47ac10bc9c

data/README.md

@@ -1 +1,117 @@
-# google-translate-free
+# Google Translate Free
+
+This repository is a robust translation service designed to help you with a variety of language-based features including direct translations, alternate translations, definitions, examples, transliterations, spelling suggestions, language detection, and highly relevant keyword suggestions.
+
+Let's read the [documents](https://api.datpmt.com) before using it.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'google-translate-free', '~> 1.0'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install google-translate-free
+
+## Usage
+To translate
+```ruby
+Translate.translate('summer', :vi, :en)
+# => "mùa hè"
+```
+Without third params, Google Translate will auto-detect your source language.
+```ruby
+Translate.translate('summer', :vi)
+# => "mùa hè"
+```
+For alternate Translations
+```ruby
+Translate.alternate_translations('summer', :vi, :en)
+# =>
+#[
+#  "mùa hè",
+#  "mùa hạ",
+#  "hè"
+#]
+```
+Without third params, Google Translate will auto-detect your source language.
+```ruby
+Translate.alternate_translations('summer', :vi)
+# =>
+#[
+#  "mùa hè",
+#  "mùa hạ",
+#  "hè"
+#]
+```
+For definitions
+```ruby
+Translate.definitions('summer')
+# =>
+#[
+#  {
+#    :noun=>[
+#      ["The warmest season of the year, in the northern hemisphere from june to august and in the southern hemisphere from december to february.", "<b>summer</b> vacation.", nil],
+#      ["A horizontal bearing beam, especially one supporting joists or rafters.", nil, nil]
+#    ]
+#  },
+#  {
+#    :verb=>[
+#      ["Spend the summer in a particular place.", nil, nil]
+#    ]
+#  }
+#]
+```
+For examples
+```ruby
+Translate.examples('summer')
+# =>
+#[
+#  "The plant flowers in late <b>summer</b>.",
+#  "The golden <b>summer</b> of her life.",
+#  "A long hot <b>summer</b>.",
+#  "<b>summer</b> vacation."
+#]
+```
+For transliteration
+```ruby
+Translate.transliteration('summer')
+# => "ˈsəmər"
+```
+For spelling suggestions
+```ruby
+Translate.suggest('summmer')
+# => "summer"
+```
+For language detection
+```ruby
+Translate.detection('summer')
+# => ["en", 0.93254006]
+```
+For keyword suggestions
+```ruby
+Translate.see_more('summers')
+# => "summer"
+```
+
+## Contributors
+
+- [datpmt](https://github.com/datpmt)
+
+I welcome contributions to this project.
+
+1.  Fork it.
+2.  Create your feature branch (`git checkout -b your-feature`).
+3.  Commit your changes (`git commit -am 'Add some feature'`).
+4.  Push to the branch (`git push origin your-feature`).
+5.  Create a new pull request.
+
+## License
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/lib/google-translate-free.rb

@@ -4,6 +4,8 @@ require 'json'
 require_relative 'translate_lib/validation'
 
 module Translate
+  VERSION = '1.0.1'.freeze
+
   def self.translate(string, to_lang, from_lang = :auto)
     validate_language_code(from_lang, to_lang)
     encode = encode_url(string)
@@ -22,6 +24,7 @@ module Translate
   end
 
   def self.definitions(keyword)
+    validate_keyword(keyword)
     # [ preposition: [desc ex sysnonyms] ]
     uri = URI(url(:md, keyword, :auto))
     result = net_get(uri)[12]
@@ -32,7 +35,7 @@ module Translate
       {
         "#{pre}": preposition[1].map do |arr|
           code = arr.last
-          [arr[0].capitalize, examples(keyword, code)&.first, synonyms(pre, keyword, code)]
+          [arr[0], examples(keyword, code)&.first, synonyms(pre, keyword, code)]
         end
       }
     end
@@ -53,6 +56,7 @@ module Translate
   end
 
   def self.examples(keyword, code = nil)
+    validate_keyword(keyword)
     uri = URI(url(:ex, keyword, :auto))
     result = net_get(uri)[13]
     return unless result
@@ -63,31 +67,31 @@ module Translate
                 result[0].map { |ex| ex[0] if ex.last == code }.compact
               end
     last_rs.map do |ex|
-      "#{ex.capitalize}."
+      "#{ex}."
     end
   end
 
-  def self.transliteration(string)
-    encode = encode_url(string)
-    uri = URI(url(:rm, encode, :auto))
+  def self.transliteration(keyword)
+    validate_keyword(keyword)
+    uri = URI(url(:rm, keyword, :auto))
     net_get(uri)&.dig(0, 0, 3)
   end
 
   def self.suggest(string)
     encode = encode_url(string)
-    uri = URI(url(:qca, encode, :auto))
+    uri = URI(url(:qca, encode, :auto, detection(string).first == 'en' ? :vi : :en))
     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))
+    validate_keyword(keyword)
+    uri = URI(url(:rw, keyword, :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)}")
+    uri = URI(url(:rm, encode_url(string), :auto))
     response = net_get(uri)
     [response&.dig(2), response&.dig(6)]
   end
@@ -115,4 +119,8 @@ module Translate
   def self.validate_language_code(from_lang, to_lang)
     TranslateLib::Validation.validate_language_code(from_lang, to_lang)
   end
+
+  def self.validate_keyword(keyword)
+    TranslateLib::Validation.validate_keyword(keyword)
+  end
 end

data/lib/translate_lib/validation.rb

@@ -20,11 +20,19 @@ module TranslateLib
       raise_error!('Translate strings shorter than or equal to 5000 characters.') if string.length > 5000
     end
 
+    def self.validate_keyword(keyword)
+      raise_error!('keyword does not have a valid value.') unless single_word?(keyword)
+    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.single_word?(str)
+      !!(str =~ /^\p{L}+$/)
+    end
+
     def self.raise_error!(message)
       TranslateLib::Exception.raise_error!(message)
     end

metadata

@@ -1,16 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: google-translate-free
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 1.0.1
 platform: ruby
 authors:
 - datpmt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-05-10 00:00:00.000000000 Z
+date: 2024-08-27 00:00:00.000000000 Z
 dependencies: []
-description: Google Translate Free
+description: Translation service designed to help you with a variety of language-based
+  features including direct translations, alternate translations, definitions, examples,
+  transliterations, spelling suggestions, language detection, and highly relevant
+  keyword suggestions.
 email: datpmt.2k@gmail.com
 executables: []
 extensions: []
@@ -22,7 +25,6 @@ files:
 - lib/google-translate-free.rb
 - lib/translate_lib/exception.rb
 - lib/translate_lib/validation.rb
-- lib/version.rb
 homepage: https://rubygems.org/gems/google-translate-free
 licenses:
 - MIT
@@ -47,5 +49,5 @@ requirements: []
 rubygems_version: 3.2.3
 signing_key:
 specification_version: 4
-summary: Google Translate Free
+summary: Supports APIs related to Google Translate and more!
 test_files: []

data/lib/version.rb

@@ -1,3 +0,0 @@
-module YourGemName
-  VERSION = '0.0.2'.freeze
-end