gtranslate-two 0.1.0 → 0.1.1

data/README.rdoc

@@ -1,6 +1,90 @@
 = gtranslate-two
 
-Something funny.
+This is a simple Ruby gem designed to use Google Translate API v2 - unlike other gems which use the first version of the API. Also unlike other available gems, this one requires the use of an API key, which you can get from the Google APIs console (https://code.google.com/apis/console/).
+
+Basic use:
+
+# First, require the gem:
+require 'gtranslate-two'
+
+# Second, set your API key
+GTranslator.key = 'YOUR_GOOGLE_TRANSLATE_KEY'
+
+# Now, let's try translating something from English to Icelandic
+GTranslator.translate('Hello world', GLanguage::Icelandic, GLanguage::English)
+# The result (in irb console) should look something like this:
+#<GTranslatorResult:0x1013e8558 @original="Hello world", @source="en", @translation="Hall\303\263 heimur", @target="is">
+# As you can see, the result is a GTranslatorResult object with properties:
+# - original (the original query)
+# - source (source language)
+# - translation (translated query)
+# - target (target language)
+
+# The gem also supports Google Translate language detection mechanism. Let's imagine we did not know the source language but still wanted to translate the phrase to, say, Irish.
+# To do that, we'll basically leave out the third argument in the translate method, falling back on automatic language detection:
+GTranslator.translate('Hello world', GLanguage::Irish)
+# The result (in irb console) should look somewhat like this:
+#<GTranslatorResult:0x1013dced8 @original="Hello world", @source="en", @translation="Dia duit ar domhan", @target="ga">
+# As you can see, the result is a GTranslatorResult object with the same set of properties, only this time the source is determined automatically.
+
+# Last but not least the gem supports language detection operation (without translation)
+GTranslator.detect_language('Mam na imie Marcin')
+# The result should be "pl"
+
+# The gem supports all languages supported by Google Translate API. They are implemented in the GLanguage module as constants:
+
+GLanguage::Afrikaans	= 'af'
+GLanguage::Albanian = 'sq'
+GLanguage::Arabic = 'ar'
+GLanguage::Belarusian = 'be'
+GLanguage::Bulgarian	= 'bg'
+GLanguage::Catalan	= 'ca'
+GLanguage::Chinese_Simplified = 'zh-CN'
+GLanguage::Chinese_Traditional	= 'zh-TW'
+GLanguage::Croatian = 'hr'
+GLanguage::Czech	= 'cs'
+GLanguage::Danish = 'da'
+GLanguage::Dutch	= 'nl'
+GLanguage::English	= 'en'
+GLanguage::Estonian = 'et'
+GLanguage::Filipino = 'tl'
+GLanguage::Finnish = 'fi'
+GLanguage::French = 'fr'
+GLanguage::Galician = 'gl'
+GLanguage::German = 'de'
+GLanguage::Greek	= 'el'
+GLanguage::Haitian_Creole = 'ht'
+GLanguage::Hebrew = 'iw'
+GLanguage::Hindi	= 'hi'
+GLanguage::Hungarian	= 'hu'
+GLanguage::Icelandic	= 'is'
+GLanguage::Indonesian = 'id'
+GLanguage::Irish	= 'ga'
+GLanguage::Italian	= 'it'
+GLanguage::Japanese = 'ja'
+GLanguage::Latvian = 'lv'
+GLanguage::Lithuanian = 'lt'
+GLanguage::Macedonian = 'mk'
+GLanguage::Malay = 'ms'
+GLanguage::Maltese	= 'mt'
+GLanguage::Norwegian = 'no'
+GLanguage::Persian = 'fa'
+GLanguage::Polish = 'pl'
+GLanguage::Portuguese = 'pt'
+GLanguage::Romanian = 'ro'
+GLanguage::Russian = 'ru'
+GLanguage::Serbian	= 'sr'
+GLanguage::Slovak = 'sk'
+GLanguage::Slovenian = 'sl'
+GLanguage::Spanish	= 'es'
+GLanguage::Swahili	= 'sw'
+GLanguage::Swedish	= 'sv'
+GLanguage::Thai = 'th'
+GLanguage::Turkish	= 'tr'
+GLanguage::Ukrainian	= 'uk'
+GLanguage::Vietnamese = 'vi'
+GLanguage::Welsh = 'cy'
+GLanguage::Yiddish = 'yi'
 
 == Contributing to gtranslate-two
  

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

data/gtranslate-two.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{gtranslate-two}
-  s.version = "0.1.0"
+  s.version = "0.1.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Marcin Wyszynski"]
-  s.date = %q{2011-01-19}
+  s.date = %q{2011-01-23}
   s.description = %q{This is a super-simple Ruby client for Google Translate API v2. You will need the developer key to work with it.}
   s.email = %q{marcin.pixie@gmail.com}
   s.extra_rdoc_files = [

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: gtranslate-two
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: false
   segments: 
   - 0
   - 1
-  - 0
-  version: 0.1.0
+  - 1
+  version: 0.1.1
 platform: ruby
 authors: 
 - Marcin Wyszynski
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-19 00:00:00 +00:00
+date: 2011-01-23 00:00:00 +00:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency