jlchafardet / tr4n5l4te

Use Google Translate without an API key.

Tr4n5l4te

Version: 0.1.3

Use Google Translate without an API key.

Like me, maybe you've found that Google makes it a pain to work with their API. Tr4n5l4te gets around all that.

Installation

First, install PhantomJS.

Add this line to your application's Gemfile:

gem 'tr4n5l4te'

And then execute:

$ bundle

Or install it yourself as:

$ gem install tr4n5l4te

Usage

In your code:

translator = Tr4n5l4te::Translator.new
english_strings = %w(
  hello
  how are you
)
english_strings.each do |text|
  puts translator.translate(text, :en, :es)
end
# => hola
# => 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

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

Specs

The specs are sprinkled with integration tests which will actually go out and hit the live web. To run them:

$ INTEGRATION=1 rake spec

Please be kind or Google is likely to ban your IP address.

Spec Coverage

$ INTEGRATION=1 COVERAGE=1 rake spec
$ open coverage/index.html # if you are on OSX

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/midwire/tr4n5l4te.

License

The gem is available as open source under the terms of the MIT License.