tr4n5l4te 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: baf43689ac0bdb8454bf5f0d17075b43de3adce8
-  data.tar.gz: dd0db7f6b12a6593487768e2383af0b063bbc2af
+  metadata.gz: 2b4177a4047cbccd5f83335dae72a39945ba4bee
+  data.tar.gz: a11c1373ef983181b6a73bee55797ff43d196b9b
 SHA512:
-  metadata.gz: 2a31f3386128e42588df190dce4375e2d2cda12a70ce0ad27a2b9b6686cf37a760e48fb2f8d30c0ddf362a547ce4fb0f56f348a784e7808af9f0a54b9cd9f8b6
-  data.tar.gz: 8cbe2bfeb0da12bf7008e5beef5caa6c338fc6496e38faa11aa5cfff69cfaf95bf378994c62bd837b2c5837e9600bbac4d9681b8494ba76e6b92f8f6e0e52655
+  metadata.gz: 2c7bf02c1d0193dab810c7fee10762de2a9ebdfe89d2cb53bb6903e39e4e39f1a48129b8ff7fb68a1601de0671b6629f0e571bf8fe85ee594a8ed656f1c1ae43
+  data.tar.gz: 8a946e815184707c392521322e61829c86703f2992634fa286527debaa4aef51e6c8ba2991394fcf361cc0a2835ed32ea87f9c50e6434b97a97d73a681735ce2

data/CHANGELOG

@@ -1,3 +1,8 @@
+*0.1.3* (March 16, 2016)
+
+* Warn when passing in a non-string to the Translator.
+* Update README to include PhantomJS dependency and sleep_time override for command line translator.
+
 *0.1.2* (March 15, 2016)
 
 * Don't attempt to translate empty or nil strings.

data/README.md

@@ -1,6 +1,6 @@
 # Tr4n5l4te
 
-**Version: 0.1.2**
+**Version: 0.1.3**
 
 Use Google Translate without an API key.
 
@@ -8,6 +8,8 @@ Like me, maybe you've found that Google makes it a pain to work with their API.
 
 ## Installation
 
+First, install [PhantomJS](http://phantomjs.org/).
+
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -39,10 +41,18 @@ end
 # => cómo estás
 ```
 
+### Command Line
+
 To translate a YAML file:
 
     $ ./exe/translate -y /path/to/yml/file -l "destination-language"
 
+The translator will sleep for 2 seconds, by default, between each string translation. You can override that by passing in the amount of time, in seconds, you want it to sleep:
+
+    $ ./exe/translate -y config/locales/en.yml -l French -s 3
+
+Warning: If you pass in '0' and translate a large file, it is very likely that Google will ban your IP address.
+
 To list all known languages
 
     $ ./exe/translate -t

data/lib/tr4n5l4te/translator.rb

@@ -12,20 +12,32 @@ module Tr4n5l4te
     end
 
     def translate(text, from_lang, to_lang)
-      return '' if text.nil? || text == ''
+      encoded_text = validate_and_encode(text)
+      return '' if encoded_text == ''
+      smart_visit(translator_url(encoded_text, from_lang, to_lang))
+      result_box = browser.find('#result_box')
+      result_box.text
+    end
+
+    private
+
+    def validate_and_encode(text)
+      return '' if text.nil?
+      fail "Cannot translate a [#{text.class}]: '#{text}'" unless text.respond_to?(:gsub)
       text.strip!
-      return '' if text == ''
-      encoded_text = URI.encode(text)
-      url = "#{START_PAGE}/##{from_lang}/#{to_lang}/#{encoded_text}"
+      URI.encode(text)
+    end
+
+    def smart_visit(url)
       load_cookies
       agent.visit(url)
       store_cookies
       sleep_default
-      result_box = browser.find('#result_box')
-      result_box.text
     end
 
-    private
+    def translator_url(encoded_text, from_lang, to_lang)
+      "#{START_PAGE}/##{from_lang}/#{to_lang}/#{encoded_text}"
+    end
 
     def store_cookies
       agent.store_cookies(Tr4n5l4te.cookie_file)

data/lib/tr4n5l4te/version.rb

@@ -1,3 +1,3 @@
 module Tr4n5l4te
-  VERSION = '0.1.2'.freeze
+  VERSION = '0.1.3'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tr4n5l4te
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Chris Blackburn
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-03-15 00:00:00.000000000 Z
+date: 2016-03-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler