to_lang 0.3.1 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d9bf52a1b7871b0277a755c4d0e85ff30cb30d18
+  data.tar.gz: 238cccb4c0cafeefe0c7c3b187880aa13e93a928
+SHA512:
+  metadata.gz: 3edd8b9f2ba89e5475675abb194448316376fb8c3c099a4a4ba08eb1afd07c518eb6016c123a5212ddf3dbab0594046102f48ab326f965d8c03ff32e6d2ab19a
+  data.tar.gz: 3b8bafb0ff80ab4cd75dd5d4a7dbf87cb79ef35bea66a14548925f79bac7988a952d5bea037a7609f81dac51bfa37aec7d53d357a7522d9d850befe9af183901

data/.rspec

@@ -1,2 +1 @@
 --color
---format nested

data/.travis.yml

@@ -1,5 +1,4 @@
 ---
 rvm:
-  - 1.8.7
-  - 1.9.2
-
+  - 1.9.3
+  - 2.0.0

data/Gemfile

@@ -1,4 +1,4 @@
-source :rubygems
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in to_lang.gemspec
 gemspec

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (C) 2010-2011 by Jimmy Cuadra
+Copyright (C) 2010-2011, 2015 by Jimmy Cuadra
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -0,0 +1,190 @@
+[![Gem Version](https://badge.fury.io/rb/to_lang.png)](http://badge.fury.io/rb/to_lang)
+[![Build Status](https://travis-ci.org/jimmycuadra/to_lang.png?branch=master)](https://travis-ci.org/jimmycuadra/to_lang)
+[![Code Climate](https://codeclimate.com/github/jimmycuadra/to_lang.png)](https://codeclimate.com/github/jimmycuadra/to_lang)
+
+# to_lang
+
+**to_lang** is a Ruby library that adds language translation methods to strings and arrays, backed by the Google Translate API.
+
+## Installation
+
+Simply run:
+
+``` bash
+gem install to_lang
+```
+
+## Usage
+
+To use **to_lang**, require the library, then call `ToLang.start` with your Google Translate API key. At this point you will have access to all the new translation methods, which take the form `to_language`, where "language" is the language you wish to translate to.
+
+Google Translate attempts to detect the source language, but you can specify it explicitly by calling methods in the form `to_target_language_from_source_language`, where "target language" is the language you are translating to and "source_language" is the language you are starting with. An inverted form with equivalent functionality, `from_source_language_to_target_language` is also available. These methods are generated dynamically and will not appear in a calls to `String.instance_methods` or `Array.instance_methods` until they have been called once. Strings and arrays will, however, `respond_to?` these methods prior to their dynamic definition.
+
+The dynamic methods are simply syntactic sugar for `String#translate` and `Array#translate`, which you can use directly as well.
+
+**to_lang** also comes with a command line utility for quick translations from the shell.
+
+## String Examples
+
+Load and initialize **to_lang**:
+
+``` ruby
+require 'to_lang'
+
+ToLang.start('YOUR_GOOGLE_TRANSLATE_API_KEY')
+```
+
+Translate some text to Spanish:
+
+``` ruby
+"Very cool gem!".to_spanish # => "Muy fresco joya!"
+```
+
+A case where the source language is ambiguous:
+
+``` ruby
+"a pie".to_spanish # => "a pie"
+"a pie".to_spanish_from_english # => "un pastel"
+```
+
+Or equivalently:
+
+``` ruby
+"a pie".from_english_to_spanish # => "un pastel"
+```
+
+Using `String#translate` directly:
+
+``` ruby
+"hello world".translate('es') # => "hola mundo"
+"a pie".translate('es', :from => 'en') # => "un pastel"
+```
+
+## Array Examples
+
+Arrays can be used to translate a batch of strings in a single method call and a single HTTP request. The exact same methods shown above work for arrays as well. For example, to translate an array of strings to Spanish:
+
+``` ruby
+["One", "Two", "Three"].to_spanish # => ["Uno", "Dos", "Tres"]
+```
+
+## Debugging
+
+`translate` also has the advantage of allowing you to get debug output for a translation. `translate` accepts a `:debug` option with three possible values: `:request`, `:response`, and `:all`. `:request` will cause the method to return a hash of the parameters that will be sent to the Google Translate API. `:response` will cause the method to return the full response from the API call as a hash. `:all` will cause the method to return a hash which contains both the request hash and the full response.
+
+``` ruby
+"hello world".translate('es', :debug => :request)
+# => {:key=>"my_key", :q=>"hello world", :target=>"es"}
+```
+
+``` ruby
+"hello world".translate('es', :debug => :response)
+# => {"data"=>{"translations"=>[{"translatedText"=>"hola mundo", "detectedSourceLanguage"=>"en"}]}}
+```
+
+``` ruby
+"hello world".translate('es', :debug => :all)
+# => {:request=>{:key=>"my_key", :q=>"hello world", :target=>"es"},
+#    :response=>{"data"=>{"translations"=>[{"translatedText"=>"hola mundo",
+#    "detectedSourceLanguage"=>"en"}]}}}
+```
+
+## Command Line Interface
+
+The command line utility `to_lang` has the following interface:
+
+```
+to_lang [--key API_KEY] [--from SOURCE_LANGUAGE] --to DESTINATION_LANGUAGE STRING [STRING, ...]
+```
+
+`to_lang` accepts a space separated list of strings to translate. At least one string is required, as is the `--to` option, which accepts a language code (e.g. "es"). `to_lang` will attempt to load a Google Translate API key from the `GOOGLE_TRANSLATE_API_KEY` environment variable. If one is not available, it must be passed in from the command line with the `--key` option. For complete usage instructions, invoke the utility with the `--help` option.
+
+Examples:
+
+A simple translation with the key being passed in directly from the command line:
+
+``` bash
+to_lang --key YOUR_GOOGLE_TRANSLATE_API_KEY --to es "hello world"
+hola mundo
+```
+
+With the key in an environment variable and multiple strings:
+
+``` bash
+to_lang --to es "hello world" "a pie"
+hola mundo
+a pie
+```
+
+Specifying the source language:
+
+``` bash
+to_lang --from en --to es "hello world" "a pie"
+hola mundo
+un pastel
+```
+
+## Supported Languages
+
+**to_lang** adds the following methods to strings and arrays. Each of these methods can be called with an explicit source language by appending `_from_source_language` or prepending `from_source_language_` to the method name.
+
+* to_afrikaans
+* to_albanian
+* to_arabic
+* to_belarusian
+* to_bulgarian
+* to_catalan
+* to_simplified_chinese
+* to_traditional_chinese
+* to_croatian
+* to_czech
+* to_danish
+* to_dutch
+* to_english
+* to_estonian
+* to_filipino
+* to_finnish
+* to_french
+* to_galician
+* to_german
+* to_greek
+* to_haitian_creole
+* to_hebrew
+* to_hindi
+* to_hungarian
+* to_icelandic
+* to_indonesian
+* to_irish
+* to_italian
+* to_japanese
+* to_latvian
+* to_lithuanian
+* to_macedonian
+* to_malay
+* to_maltese
+* to_norwegian
+* to_persian
+* to_polish
+* to_portuguese
+* to_romanian
+* to_russian
+* to_serbian
+* to_slovak
+* to_slovenian
+* to_spanish
+* to_swahili
+* to_swedish
+* to_thai
+* to_turkish
+* to_ukrainian
+* to_vietnamese
+* to_welsh
+* to_yiddish
+
+## Documentation
+
+API documentation can be found at [rubydoc.info](http://rubydoc.info/github/jimmycuadra/to_lang/master/frames).
+
+## Feedback and Contributions
+
+Feedback is greatly appreciated. If you have any problems with **to_lang**, please open a new issue. Make sure you are using the latest version of the gem, or HEAD if you've cloned the Git repository directly. Please include debugging output from using the `:debug` option of `translate`, if relevant to your issue. If you'd like to fix bugs, add features, or improve the library in general, feel free to fork the project and send me a pull request with your changes.

data/Rakefile

@@ -1,7 +1,6 @@
-require 'bundler'
-Bundler::GemHelper.install_tasks
-
+require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
-RSpec::Core::RakeTask.new(:spec)
+
+RSpec::Core::RakeTask.new
 
 task :default => :spec

data/lib/to_lang/version.rb

@@ -1,5 +1,5 @@
 module ToLang
   # The current version of the Ruby gem.
   #
-  VERSION = "0.3.1"
+  VERSION = '1.0.0'
 end

data/spec/to_lang/connector_spec.rb

@@ -1,9 +1,7 @@
 require "spec_helper"
 
 describe ToLang::Connector do
-  before :all do
-    @connector = ToLang::Connector.new('apikey')
-  end
+  let(:connector) { ToLang::Connector.new('apikey') }
 
   describe "custom query string normalizer" do
     it "returns a query string with unsorted parameters" do
@@ -13,19 +11,21 @@ describe ToLang::Connector do
         :target => 'es',
         :q => ["banana", "apple"]
       }
-      ToLang::Connector::UNSORTED_QUERY_STRING_NORMALIZER.call(params).should =~ /q=banana&q=apple/
+      expect(
+        ToLang::Connector::UNSORTED_QUERY_STRING_NORMALIZER.call(params)
+      ).to match(/q=banana&q=apple/)
     end
   end
 
   it "stores a key when initialized" do
-    @connector.key.should_not be_nil
+    expect(connector.key).not_to be_nil
   end
 
   describe "#request" do
     # helper methods
     def stub_response(parsed_response)
-      mock_response = mock('HTTParty::Response', :parsed_response => parsed_response)
-      ToLang::Connector.stub(:post).and_return(mock_response)
+      mock_response = double('HTTParty::Response', :parsed_response => parsed_response)
+      allow(ToLang::Connector).to receive(:post).and_return(mock_response)
     end
 
     def stub_good_response(translated_text)
@@ -51,7 +51,7 @@ describe ToLang::Connector do
       context "with only a target language" do
         it "returns the translated string" do
           stub_good_response "hola mundo"
-          @connector.request("hello world", "es").should == "hola mundo"
+          expect(connector.request("hello world", "es")).to eq("hola mundo")
         end
       end
 
@@ -59,14 +59,14 @@ describe ToLang::Connector do
         context "and no source language specified" do
           it "returns the same string" do
             stub_good_response "a pie"
-            @connector.request("a pie", "es").should == "a pie"
+            expect(connector.request("a pie", "es")).to eq("a pie")
           end
         end
 
         context "and a source language specified" do
           it "returns the translated string" do
             stub_good_response "un pastel"
-            @connector.request("a pie", "es", :from => "en").should == "un pastel"
+            expect(connector.request("a pie", "es", :from => "en")).to eq("un pastel")
           end
         end
       end
@@ -74,28 +74,35 @@ describe ToLang::Connector do
       context "with a bad language pair" do
         it "raises an exception" do
           stub_bad_response "Bad language pair: en|en"
-          expect { @connector.request("a pie", "en", :from => "en") }.to raise_error(RuntimeError, "Bad language pair: en|en")
+          expect { connector.request("a pie", "en", :from => "en") }.to raise_error(RuntimeError, "Bad language pair: en|en")
         end
       end
 
       context "when debugging the request" do
         it "returns the request URL" do
-          @connector.request("hello world", "es", :from => "en", :debug => :request).should == { :key=> "apikey", :q => "hello world", :target => "es", :source => "en" }
+          expect(connector.request("hello world", "es", :from => "en", :debug => :request)).to eq({
+            :key=> "apikey", :q => "hello world", :target => "es", :source => "en"
+          })
         end
       end
 
       context "when debugging the response" do
         it "returns the full parsed response" do
           expected_response = stub_good_response("hola mundo")
-          @connector.request("hello world", "es", :from => "en", :debug => :response).should == expected_response
+          expect(
+            connector.request("hello world", "es", :from => "en", :debug => :response)
+          ).to eq(expected_response)
         end
       end
 
       context "when debugging the request and the response" do
         it "returns a hash with the request URL and the full parsed response" do
           expected_response = stub_good_response("hola mundo")
-          output = @connector.request("hello world", "es", :from => "en", :debug => :all)
-          output.should == { :request => { :key=> "apikey", :q => "hello world", :target => "es", :source => "en" }, :response => expected_response }
+          output = connector.request("hello world", "es", :from => "en", :debug => :all)
+          expect(output).to eq({
+            :request => { :key=> "apikey", :q => "hello world", :target => "es", :source => "en" },
+            :response => expected_response
+          })
         end
       end
     end
@@ -103,7 +110,7 @@ describe ToLang::Connector do
     context "given an array of strings" do
       it "returns an array of translated strings" do
         stub_good_array_response ["hola", "mundo"]
-        @connector.request(["hello", "world"], "es").should == ["hola", "mundo"]
+        expect(connector.request(["hello", "world"], "es")).to eq(["hola", "mundo"])
       end
     end
   end

data/spec/to_lang/core_ext_spec.rb

@@ -12,33 +12,33 @@ describe Hash do
 
     test_hashes.each do |hash, params|
       it "converts hash: #{hash.inspect} to params: #{params.inspect}" do
-        hash.to_params.split('&').sort.should == params.split('&').sort
+        expect(hash.to_params.split('&').sort).to eq(params.split('&').sort)
       end
     end
 
     it "doesn't leave a trailing &" do
-      {
+      expect({
         :name => 'Bob',
         :address => {
           :street => '111 Ruby Ave.',
           :city => 'Ruby Central',
           :phones => ['111-111-1111', '222-222-2222']
         }
-      }.to_params.should_not =~ /&$/
+      }.to_params).not_to match(/&$/)
     end
 
     it "URL encodes unsafe characters" do
-      { :q => "?&\" +" }.to_params.should == "q=%3F%26%22%20%2B"
+      expect({ :q => "?&\" +" }.to_params).to eq("q=%3F%26%22%20%2B")
     end
 
     it "converts deeply nested hashes" do
-      {
+      expect({
         :one => {
           :two => {
             :three => true
           }
         }
-      }.to_params.should == "one[two][three]=true"
+      }.to_params).to eq("one[two][three]=true")
     end
   end
 end

data/spec/to_lang/translatable_spec.rb

@@ -7,44 +7,40 @@ describe "A translatable class" do
 
   describe "#translate" do
     it "calls ToLang::Connector#request" do
-      ToLang.connector.stub(:request)
-      ToLang.connector.should_receive(:request).with("hello world", "es")
+      expect(ToLang.connector).to receive(:request).with("hello world", "es")
       "hello world".translate("es")
     end
   end
 
   it "will respond to :to_<language>" do
-    "hello world".should respond_to :to_spanish
+    expect("hello world").to respond_to(:to_spanish)
   end
 
   it "will respond to :to_<target>_from_<source>" do
-    "hello world".should respond_to :to_spanish_from_english
+    expect("hello world").to respond_to(:to_spanish_from_english)
   end
 
   it "will respond to :from_<source>_to_<target>" do
-    "hello world".should respond_to :from_english_to_spanish
+    expect("hello world").to respond_to(:from_english_to_spanish)
   end
 
   it "translates to <language> when sent :to_<language>" do
-    ToLang.connector.stub(:request)
-    ToLang.connector.should_receive(:request).with("hello world", 'es')
+    expect(ToLang.connector).to receive(:request).with("hello world", 'es')
     "hello world".send(:to_spanish)
   end
 
   it "translates to <target> from <source> when sent :to_<target>_from_<source>" do
-    ToLang.connector.stub(:request)
-    ToLang.connector.should_receive(:request).with("hello world", 'es', :from => 'en')
+    expect(ToLang.connector).to receive(:request).with("hello world", 'es', :from => 'en')
     "hello world".send(:to_spanish_from_english)
   end
 
   it "translates to <target> from <source> when sent :from_<source>_to_<target>" do
-    ToLang.connector.stub(:request)
-    ToLang.connector.should_receive(:request).with("hello world", 'es', :from => 'en')
+    expect(ToLang.connector).to receive(:request).with("hello world", 'es', :from => 'en')
     "hello world".send(:from_english_to_spanish)
   end
 
   it "defines magic methods when first called and doesn't call :method_missing after that" do
-    ToLang.connector.stub(:request)
+    allow(ToLang.connector).to receive(:request)
     string = "hello world"
     magic_methods = lambda do
       string.to_spanish
@@ -52,7 +48,7 @@ describe "A translatable class" do
       string.from_english_to_spanish
     end
     magic_methods.call
-    string.should_not_receive(:method_missing)
+    expect(string).not_to receive(:method_missing)
     magic_methods.call
   end
 

data/spec/to_lang_spec.rb

@@ -7,19 +7,19 @@ describe ToLang do
     end
 
     it "returns false if :start was already called" do
-      ToLang.start('apikey').should == false
+      expect(ToLang.start('apikey')).to be_falsy
     end
 
     it "stores a ToLang::Connector object" do
-      ToLang.connector.should be_an_instance_of ToLang::Connector
+      expect(ToLang.connector).to be_an_instance_of(ToLang::Connector)
     end
 
     it "mixes Translatable into String" do
-      String.should include ToLang::Translatable
+      expect(String).to include(ToLang::Translatable)
     end
 
     it "mixes Translatable into Array" do
-      Array.should include ToLang::Translatable
+      expect(Array).to include(ToLang::Translatable)
     end
   end
 end

data/to_lang.gemspec

@@ -1,5 +1,7 @@
-# -*- encoding: utf-8 -*-
-require File.expand_path("../lib/to_lang/version", __FILE__)
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "to_lang/version"
 
 Gem::Specification.new do |s|
   s.name        = "to_lang"
@@ -16,12 +18,8 @@ Gem::Specification.new do |s|
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
 
-  s.add_dependency "httparty", "~> 0.8.0"
-  s.add_development_dependency "rake", "~> 0.9.2"
-  s.add_development_dependency "rspec", "~> 2.6.0"
-  s.add_development_dependency "simplecov", "~> 0.5.3"
-  s.add_development_dependency "RedCloth", "~> 4.2.8"
-  s.add_development_dependency "guard-rspec", "~> 0.4.5"
-  s.add_development_dependency "rb-fsevent", "~> 0.4.3" if RUBY_PLATFORM[/darwin/]
-  s.add_development_dependency "growl_notify", "~> 0.0.1" if RUBY_PLATFORM[/darwin/]
+  s.add_dependency "httparty", ">= 0.8.0"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rspec", ">= 3.1.0"
+  s.add_development_dependency "simplecov", ">= 0.5.3"
 end

metadata

@@ -1,104 +1,71 @@
 --- !ruby/object:Gem::Specification
 name: to_lang
 version: !ruby/object:Gem::Version
-  version: 0.3.1
-  prerelease: 
+  version: 1.0.0
 platform: ruby
 authors:
 - Jimmy Cuadra
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-09-15 00:00:00.000000000Z
+date: 2015-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
-  requirement: &70175836589280 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.8.0
   type: :runtime
   prerelease: false
-  version_requirements: *70175836589280
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: &70175836588020 !ruby/object:Gem::Requirement
-    none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.2
-  type: :development
-  prerelease: false
-  version_requirements: *70175836588020
+        version: 0.8.0
 - !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: &70175836585300 !ruby/object:Gem::Requirement
-    none: false
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.6.0
+        version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70175836585300
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: &70175836583680 !ruby/object:Gem::Requirement
-    none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.3
-  type: :development
-  prerelease: false
-  version_requirements: *70175836583680
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: RedCloth
-  requirement: &70175836582060 !ruby/object:Gem::Requirement
-    none: false
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.2.8
+        version: 3.1.0
   type: :development
   prerelease: false
-  version_requirements: *70175836582060
-- !ruby/object:Gem::Dependency
-  name: guard-rspec
-  requirement: &70175836580900 !ruby/object:Gem::Requirement
-    none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.5
-  type: :development
-  prerelease: false
-  version_requirements: *70175836580900
+        version: 3.1.0
 - !ruby/object:Gem::Dependency
-  name: rb-fsevent
-  requirement: &70175836579720 !ruby/object:Gem::Requirement
-    none: false
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.3
+        version: 0.5.3
   type: :development
   prerelease: false
-  version_requirements: *70175836579720
-- !ruby/object:Gem::Dependency
-  name: growl_notify
-  requirement: &70175836578060 !ruby/object:Gem::Requirement
-    none: false
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.0.1
-  type: :development
-  prerelease: false
-  version_requirements: *70175836578060
+        version: 0.5.3
 description: Adds language translation methods to strings and arrays, backed by the
   Google Translate API
 email:
@@ -108,14 +75,13 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .rspec
-- .travis.yml
-- .yardopts
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- ".yardopts"
 - Gemfile
-- Guardfile
 - LICENSE
-- README.textile
+- README.md
 - Rakefile
 - bin/to_lang
 - lib/to_lang.rb
@@ -132,33 +98,26 @@ files:
 - to_lang.gemspec
 homepage: https://github.com/jimmycuadra/to_lang
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -2363449024598261982
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -2363449024598261982
 requirements: []
 rubyforge_project: to_lang
-rubygems_version: 1.8.10
+rubygems_version: 2.4.5
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Translate strings with Google Translate
 test_files:
 - spec/spec_helper.rb

data/Guardfile

@@ -1,5 +0,0 @@
-guard 'rspec', :cli => '--format nested' do
-  watch(%r{^spec/.+_spec\.rb})
-  watch(%r{^lib/(.+)\.rb})     { |m| "spec/#{m[1]}_spec.rb" }
-  watch('spec/spec_helper.rb') { "spec" }
-end

data/README.textile

@@ -1,178 +0,0 @@
-h1. to_lang
-
-*to_lang* is a Ruby library that adds language translation methods to strings and arrays, backed by the Google Translate API.
-
-h2. Build Status
-
-"!https://travis-ci.org/jimmycuadra/to_lang.png!":http://travis-ci.org/jimmycuadra/to_lang
-
-h2. Installation
-
-Simply run @gem install to_lang@.
-
-h2. Usage
-
-To use *to_lang*, require the library, then call @ToLang.start@ with your Google Translate API key. At this point you will have access to all the new translation methods, which take the form @to_language@, where "language" is the language you wish to translate to.
-
-Google Translate attempts to detect the source language, but you can specify it explicitly by calling methods in the form @to_target_language_from_source_language@, where "target language" is the language you are translating to and "source_language" is the language you are starting with. An inverted form with equivalent functionality, @from_source_language_to_target_language@ is also available. These methods are generated dynamically and will not appear in a calls to @String.instance_methods@ or @Array.instance_methods@ until they have been called once. Strings and arrays will, however, @respond_to?@ these methods prior to their dynamic definition.
-
-The dynamic methods are simply syntactic sugar for @String#translate@ and @Array#translate@, which you can use directly as well.
-
-*to_lang* also comes with a command line utility for quick translations from the shell.
-
-h2. String Examples
-
-Load and initialize *to_lang*:
-
-<pre><code>require 'to_lang'
-ToLang.start('YOUR_GOOGLE_TRANSLATE_API_KEY')
-</code></pre>
-
-Translate some text to Spanish:
-
-<pre><code>"Very cool gem!".to_spanish
-=> "Muy fresco joya!"
-</code></pre>
-
-A case where the source language is ambiguous:
-
-<pre><code>"a pie".to_spanish
-=> "a pie"
-"a pie".to_spanish_from_english
-=> "un pastel"
-</code></pre>
-
-Or equivalently:
-
-<pre><code>"a pie".from_english_to_spanish
-=> "un pastel"
-</code></pre>
-
-Using @String#translate@ directly:
-
-<pre><code>"hello world".translate('es')
-=> "hola mundo"
-"a pie".translate('es', :from => 'en')
-=> "un pastel"
-</code></pre>
-
-h2. Array Examples
-
-Arrays can be used to translate a batch of strings in a single method call and a single HTTP request. The exact same methods shown above work for arrays as well. For example, to translate an array of strings to Spanish:
-
-<pre><code>["One", "Two", "Three"].to_spanish
-=> ["Uno", "Dos", "Tres"]
-</code></pre>
-
-h2. Debugging
-
-@translate@ also has the advantage of allowing you to get debug output for a translation. @translate@ accepts a @:debug@ option with three possible values: @:request@, @:response@, and @:all@. @:request@ will cause the method to return a hash of the parameters that will be sent to the Google Translate API. @:response@ will cause the method to return the full response from the API call as a hash. @:all@ will cause the method to return a hash which contains both the request hash and the full response.
-
-<pre><code>"hello world".translate('es', :debug => :request)
-=> {:key=>"my_key", :q=>"hello world", :target=>"es"}
-</code></pre>
-
-<pre><code>"hello world".translate('es', :debug => :response)
-=> {"data"=>{"translations"=>[{"translatedText"=>"hola mundo", "detectedSourceLanguage"=>"en"}]}}
-</code></pre>
-
-<pre><code>"hello world".translate('es', :debug => :all)
-=> {:request=>{:key=>"my_key", :q=>"hello world", :target=>"es"},
-   :response=>{"data"=>{"translations"=>[{"translatedText"=>"hola mundo",
-   "detectedSourceLanguage"=>"en"}]}}}
-</code></pre>
-
-h2. Command Line Interface
-
-The command line utility @to_lang@ has the following interface:
-
-@to_lang [--key API_KEY] [--from SOURCE_LANGUAGE] --to DESTINATION_LANGUAGE STRING [STRING, ...]@
-
-@to_lang@ accepts a space separated list of strings to translate. At least one string is required, as is the @--to@ option, which accepts a language code (e.g. "es"). @to_lang@ will attempt to load a Google Translate API key from the @GOOGLE_TRANSLATE_API_KEY@ environment variable. If one is not available, it must be passed in from the command line with the @--key@ option. For complete usage instructions, invoke the utility with the @--help@ option.
-
-Examples:
-
-A simple translation with the key being passed in directly from the command line:
-
-<pre><code>$ to_lang --key YOUR_GOOGLE_TRANSLATE_API_KEY --to es "hello world"
-hola mundo
-</code></pre>
-
-With the key in an environment variable and multiple strings:
-
-<pre><code>$ to_lang --to es "hello world" "a pie"
-hola mundo
-a pie
-</code></pre>
-
-Specifying the source language:
-
-<pre><code>$ to_lang --from en --to es "hello world" "a pie"
-hola mundo
-un pastel
-</code></pre>
-
-h2. Supported Languages
-
-*to_lang* adds the following methods to strings and arrays. Each of these methods can be called with an explicit source language by appending @_from_source_language@ or prepending @from_source_language_@ to the method name.
-
-* to_afrikaans
-* to_albanian
-* to_arabic
-* to_belarusian
-* to_bulgarian
-* to_catalan
-* to_simplified_chinese
-* to_traditional_chinese
-* to_croatian
-* to_czech
-* to_danish
-* to_dutch
-* to_english
-* to_estonian
-* to_filipino
-* to_finnish
-* to_french
-* to_galician
-* to_german
-* to_greek
-* to_haitian_creole
-* to_hebrew
-* to_hindi
-* to_hungarian
-* to_icelandic
-* to_indonesian
-* to_irish
-* to_italian
-* to_japanese
-* to_latvian
-* to_lithuanian
-* to_macedonian
-* to_malay
-* to_maltese
-* to_norwegian
-* to_persian
-* to_polish
-* to_portuguese
-* to_romanian
-* to_russian
-* to_serbian
-* to_slovak
-* to_slovenian
-* to_spanish
-* to_swahili
-* to_swedish
-* to_thai
-* to_turkish
-* to_ukrainian
-* to_vietnamese
-* to_welsh
-* to_yiddish
-
-h2. Documentation
-
-API documentation can be found at "rubydoc.info":http://rubydoc.info/github/jimmycuadra/to_lang/master/frames.
-
-h2. Feedback and Contributions
-
-Feedback is greatly appreciated. If you have any problems with *to_lang*, please open a new issue. Make sure you are using the latest version of the gem, or HEAD if you've cloned the Git repository directly. Please include debugging output from using the @:debug@ option of @translate@, if relevant to your issue. If you'd like to fix bugs, add features, or improve the library in general, feel free to fork the project and send me a pull request with your changes.