babylon 0.1.0

data.tar.gz.sig

@@ -0,0 +1,2 @@
+ �d��j!�d�>��۞!����
+uO'b�y�N�6���

data/History.txt

@@ -0,0 +1,6 @@
+=== 0.1.0 / 2008-10-15
+
+* Initial Release
+
+  * First release.
+

data/Manifest.txt

@@ -0,0 +1,7 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/babylon.rb
+spec/spec_helper.rb
+spec/babylon_spec.rb

data/README.txt

@@ -0,0 +1,47 @@
+= Babylon
+
+== DESCRIPTION:
+
+Babylon allows you to easily determine the language of a text using the Google
+AJAX Language API (http://code.google.com/apis/ajaxlanguage/)
+
+== SYNOPSIS:
+
+  require 'rubygems'
+  require 'babylon'
+
+  Babylon.language_of('¿Dónde está el baño?', :ensure_reliability => true)
+  #=> :spanish
+
+== REQUIREMENTS:
+
+* HTTParty gem by John Nunemaker (http://railstips.org/2008/7/29/it-s-an-httparty-and-everyone-is-invited)
+
+== INSTALL:
+
+* sudo gem install babylon
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIX
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,19 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require 'httparty'
+require './lib/babylon.rb'
+
+Hoe.new('babylon', Babylon::VERSION) do |p|
+  p.rubyforge_name = "kickassrb"
+  p.name = "babylon"
+  p.author = "Thorben Schröder"
+  p.description = "Free language determination from content using Google API."
+  p.email = 'thorben@fetmab.net'
+  p.summary = "Free language determination from content using Google API."
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.extra_deps << ['httparty'," >=0.1.3"]
+end
+
+# vim: syntax=Ruby

data/lib/babylon.rb

@@ -0,0 +1,63 @@
+module Babylon
+  require 'rubygems'
+  require 'httparty'
+  include HTTParty
+  
+  class Error < ArgumentError; end;
+
+  class UncertaintyError < StandardError; end;
+
+  VERSION = '0.1.0'
+  
+  SERVICE_URL = 'http://www.google.com/uds/GlangDetect'
+  format :json
+  
+  #
+  # Determines the language of a string
+  #
+  # options: An options hash which can take two options:
+  #
+  #   :min_certainty: Google tells us how certain it is with it's decission of 
+  #                   what language the content is. If you want to avoid wild 
+  #                   guesses you can set the min_certainty to a level and if
+  #                   the resulting certainty is below this threshold an 
+  #                   Babylon::UncertaintyError is raised.
+  #                   Tip: For shorter strings 0.2 seems to mean a good result.
+  #                     For medium long strings 0.6 is ok and for any text more
+  #                     than 150 words or so google tends to be really confident 
+  #                     about what it does which leads to a certainty around 0.9
+  #
+  #   :ensure_reliability: In addition to the raw certainty value Google 
+  #                        delivers a boolean value in the result set to let us
+  #                        know if it thinks the result is reliable or not.
+  #                        If you set this option to true an 
+  #                        Babylon::UncertaintyError is raised unless Google
+  #                        think the result is reliable.
+  #
+  #   Babylon.language_of('¿Dónde está el baño?') #=> :spanish
+  #   Babylon.language_of('sgffdg sfdjkhsdfkh') #=> :english
+  #   Babylon.language_of('sgffdg sfdjkhsdfkh', :min_certainty => 0.1) #=> raises Babylon::UncertaintyError
+  #   Babylon.language_of('sgffdg sfdjkhsdfkh', :ensure_reliability => true) #=> raises Babylon::UncertaintyError
+  def self.language_of(content, options = {})
+    min_certainty = options[:min_certainty] || 0.0
+    ensure_reliability = options[:ensure_reliability]
+
+    result = self.raw_language_query(content)
+
+    certainty = result['responseData']['confidence']
+    reliable  = result['responseData']['isReliable']
+    raise UncertaintyError if certainty < min_certainty || (ensure_reliability && !reliable)
+
+    result['responseData']['language'];
+  end
+
+  # Method to get the raw result Google sends us.
+  #
+  #   Babylon.raw_language_query('¿Dónde está el baño?') => {"responseData"=>{"language"=>"es", "confidence"=>0.24530953, "isReliable"=>true}, "responseStatus"=>200, "responseDetails"=>nil
+  def self.raw_language_query(content)
+    result = get(SERVICE_URL, :query => {:v => 1.0, :q => content})
+    
+    raise Error.new('Bad response from Google!') unless result['responseStatus'] == 200
+    result
+  end
+end

data/spec/babylon_spec.rb

@@ -0,0 +1,45 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+
+describe Babylon do
+  it "should raise an Babylon::Error on erroneous Google response" do
+    Babylon.should_receive(:get).and_return({"responseStatus"=>400, "responseDetails"=>nil})
+
+    begin
+      Babylon.language_of("Text that causes an error")
+    rescue Babylon::Error
+    else
+      flunk 'Should raise an Babylon::Error'
+    end
+  end
+  
+  it "should raise an Babylon::UncertaintyError if the text can not be clearly determined an reliability is demanded" do
+    Babylon.should_receive(:get).and_return({"responseData"=>{"language"=>"en", "confidence"=>0.1771214, "isReliable"=>false}, "responseStatus"=>200, "responseDetails"=>nil})
+
+    begin
+      Babylon.language_of("Undeterminable text", :ensure_reliability => true)
+    rescue Babylon::UncertaintyError
+    else
+      flunk 'Should raise an Babylon::UncertaintyError'
+    end
+  end
+  
+  it "should raise no Babylon::UncertaintyError if the certainty equals the demanded one" do
+    Babylon.should_receive(:get).and_return({"responseData"=>{"language"=>"en", "confidence"=>0.20, "isReliable"=>true}, "responseStatus"=>200, "responseDetails"=>nil})
+    Babylon.language_of("Undeterminable text", :min_certainty => 0.20)
+  end
+  
+  it "should raise no Babylon::UncertaintyError if the certainty is above the demanded one" do
+    Babylon.should_receive(:get).and_return({"responseData"=>{"language"=>"en", "confidence"=>0.201, "isReliable"=>true}, "responseStatus"=>200, "responseDetails"=>nil})
+    Babylon.language_of("Undeterminable text", :min_certainty => 0.20)
+  end
+
+  it "should raise Babylon::UncertaintyError if the certainty is below the demanded one" do
+    Babylon.should_receive(:get).and_return({"responseData"=>{"language"=>"en", "confidence"=>0.209, "isReliable"=>true}, "responseStatus"=>200, "responseDetails"=>nil})
+    begin
+      Babylon.language_of("Undeterminable text", :min_certainty => 0.21)
+    rescue Babylon::UncertaintyError
+    else
+      flunk 'Should raise an Babylon::UncertaintyError'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  gem 'rspec'
+  require 'spec'
+end
+ 
+require File.join(File.dirname(__FILE__), '..', 'lib', 'babylon')

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification 
+name: babylon
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- "Thorben Schr\xC3\xB6der"
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDMjCCAhqgAwIBAgIBADANBgkqhkiG9w0BAQUFADA/MRAwDgYDVQQDDAd0aG9y
+  YmVuMRYwFAYKCZImiZPyLGQBGRYGZmV0bWFiMRMwEQYKCZImiZPyLGQBGRYDbmV0
+  MB4XDTA4MTAwOTIxNTQwNloXDTA5MTAwOTIxNTQwNlowPzEQMA4GA1UEAwwHdGhv
+  cmJlbjEWMBQGCgmSJomT8ixkARkWBmZldG1hYjETMBEGCgmSJomT8ixkARkWA25l
+  dDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOTrBWJAhXdd4FALdaz4
+  +2KKe6Loz7L8AQxvhYedX7trYpqrWmXNLyCZKvNDf7Hp0EmOn8k5Iti161bcWxwY
+  fj8ejQ02U3OUyKSQM7V7zUrzB9pkmZ8ROGWJmw+nWVu7ZF7UU6+kWwaSMU/unPno
+  c1PcfOQrwCjvXbedMTFPZ1b/W37DoaoVQJLzzx95ewXSZ7iPtLxTrjHESjWBPxFi
+  JMEVCZDM+5UTEm41ucAJJ58z54mKryRap4NMux9YmPFp13f0xFVKP5kST16Q96IV
+  qJaPKd4WApsB8WOOyxGVFzp6Lf1fAHKjrXca6ywHeAM070Ki6GzAXKPBzUV13/R7
+  azECAwEAAaM5MDcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFMCo
+  Q0fsO/qD4FD6zVoAIBw5ehlOMA0GCSqGSIb3DQEBBQUAA4IBAQCT+qucnHSHu9t0
+  Ntxpnm5gpQPVFz+kI6WCAqUeVlV5cbifH7/T+HKEePe+H3sF1eHG2X0QiXMYDZ26
+  Vgp6S9LCofXhJySOGYO26gcUyGfmkmQ//+YiwpJ0k+uznEM+RBNw/CSpFoXrnKa2
+  39/buzR3VtgPAcAOHb+5+WDIdX6NGgrKFF8udOqQ+rAvsoQXpJXfpfdqoFiOdfCa
+  Bqd6tQGVy0qUttoqMCOTxwMYWzoNs5GFXqtmbXxV6W2F81ipkELVVoWtSvRRkqtx
+  dX2CCcpgG+qXnji1CJyb6Dgm5ICJO/+B8ZKQ5qAYg798KOB7gyddzwRZWImtRoYU
+  kX4sVHCM
+  -----END CERTIFICATE-----
+
+date: 2008-10-16 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.1.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.0
+    version: 
+description: Free language determination from content using Google API.
+email: thorben@fetmab.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/babylon.rb
+- spec/spec_helper.rb
+- spec/babylon_spec.rb
+has_rdoc: true
+homepage: 
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: kickassrb
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Free language determination from content using Google API.
+test_files: []
+

metadata.gz.sig

@@ -0,0 +1 @@
+�6�`h�%����3�Қ2I��\�]��T
8:�?��|�a��h�e捞��<�b��O�6K�m��Z�z��C'gN"ӗ?`���� 5cd�|csE^+�a`zo��*.M��s�