to_lang 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+*.gem
+.bundle

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,19 @@
+PATH
+  remote: .
+  specs:
+    to_lang (0.0.1)
+      httparty (~> 0.6.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    crack (0.1.8)
+    httparty (0.6.1)
+      crack (= 0.1.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  httparty (~> 0.6.1)
+  to_lang!

data/README.textile

@@ -0,0 +1,39 @@
+h1. to_lang
+
+*to_lang* is a Ruby gem that uses the Google Translate API to allow you to perform a translation directly on a string.
+
+h2. Usage
+
+To use *to_lang*, require the library, then call @ToLang.start@ with your Google Translate API key to initialize the connector and include the methods in @String@. Then you have access to @String#translate@.
+
+bq. *translate(to, *options)*
+_to_ (required): a string indicating the language to translate to, e.g. "es"
+_options[:from]_ (optional): a string indicating the language of the original string, used when automatic language detection is not accurate
+
+h2. Examples
+
+Load and initialize *to_lang*:
+
+bq. require 'to_lang'
+ToLang.start('YOUR_GOOGLE_TRANSLATE_API_KEY')
+
+Translate some text to Spanish:
+
+bq. "Very cool gem!".translate('es')
+# "Muy fresco joya!"
+
+If the source string is of an ambiguous language, the translation might not work as expected. In this case, you can specify the source language explicitly with the @:from@ option:
+
+bq. "a pie".translate('es')
+# "a pie"
+"a pie".translate('es', :from => 'en')
+# "un pastel"
+
+h2. Roadmap
+
+- Add tests for current code. *to_lang* is in its infancy so use at your own risk.
+- Add automagic sugar methods for translating to specific languages, such as @to_spanish@ and @to_spanish_from_english@
+
+h2. Feedback and Contributions
+
+Feedback is appreciated, as are patch contributions. Feel free to fork the project and send me a pull request.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/to_lang.rb

@@ -0,0 +1,19 @@
+require File.expand_path("../to_lang/connector", __FILE__)
+
+module ToLang
+  def self.start(key)
+    @@connector = ToLang::Connector.new(key)
+
+    String.send(:include, InstanceMethods)
+  end
+
+  def self.connector
+    @@connector
+  end
+
+  module InstanceMethods
+    def translate(target, *args)
+      ToLang.connector.request(self, target, *args)
+    end
+  end
+end

data/lib/to_lang/connector.rb

@@ -0,0 +1,39 @@
+require 'httparty'
+require 'uri'
+
+module ToLang
+  class Connector
+    include HTTParty
+
+    API_URL = "https://www.googleapis.com/language/translate/v2"
+
+    attr_reader :key
+
+    def initialize(key)
+      @key = key
+    end
+
+    def request(q, target, *args)
+      response = self.class.get request_url(q, target, *args)
+      response.parsed_response["data"]["translations"][0]["translatedText"]
+    end
+
+    private
+
+    def request_url(q, target, *args)
+      options = extract_options(*args)
+      source = options[:from]
+      url = "#{API_URL}?key=#{@key}&q=#{URI.escape(q)}&target=#{target}"
+      url += "&source=#{source}" if source
+      url
+    end
+
+    def extract_options(*args)
+      if args.last.is_a? Hash
+        args.pop
+      else
+        {}
+      end
+    end
+  end
+end

data/lib/to_lang/version.rb

@@ -0,0 +1,3 @@
+module ToLang
+  VERSION = "0.0.1"
+end

data/to_lang.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "to_lang/version"
+
+Gem::Specification.new do |s|
+  s.name        = "to_lang"
+  s.version     = ToLang::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Jimmy Cuadra"]
+  s.email       = ["jimmy@jimmycuadra.com"]
+  s.homepage    = "http://github.com/jimmycuadra/to_lang"
+  s.summary     = %q{A Ruby client for the Google Translate API built directly into String}
+  s.description = %q{A Ruby client for the Google Translate API built directly into String}
+
+  s.rubyforge_project = "to_lang"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency "httparty", "~> 0.6.1"
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: to_lang
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jimmy Cuadra
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-02 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 0
+        - 6
+        - 1
+        version: 0.6.1
+  type: :runtime
+  version_requirements: *id001
+description: A Ruby client for the Google Translate API built directly into String
+email: 
+- jimmy@jimmycuadra.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.textile
+- Rakefile
+- lib/to_lang.rb
+- lib/to_lang/connector.rb
+- lib/to_lang/version.rb
+- to_lang.gemspec
+has_rdoc: true
+homepage: http://github.com/jimmycuadra/to_lang
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: to_lang
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A Ruby client for the Google Translate API built directly into String
+test_files: []
+