tags4free 0.1.0

data/History.txt

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

data/Manifest.txt

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

data/README.txt

@@ -0,0 +1,46 @@
+= Tags4Free
+
+== DESCRIPTION:
+
+Tags4Free allows you to easily extract tags or keywords from any stringish 
+content using the Yahoo! search API.
+
+== SYNOPSIS:
+
+require 'rubygems'
+require 'tags_4_free'
+
+Tags4Free.for("Tags4Free allows you to easily extract tags or keywords from any stringish content using the Yahoo! search API.") # => ["search api", "yahoo search", "yahoo"]
+
+== REQUIREMENTS:
+
+* HTTParty gem by John Nunemaker (http://railstips.org/2008/7/29/it-s-an-httparty-and-everyone-is-invited)
+
+== INSTALL:
+
+* sudo gem install tags4free
+
+== 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,20 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require 'httparty'
+require './lib/tags_4_free.rb'
+
+Hoe.new('tags4free', Tags4Free::VERSION) do |p|
+  p.rubyforge_name = "kickassrb"
+  p.name = "tags4free"
+  p.author = "Thorben Schröder"
+  p.description = "Free tag extraction from content using Yahoo! search API."
+  p.email = 'thorben@fetmab.net'
+  p.summary = "Free tag extraction from content using Yahoo! search API."
+  p.remote_rdoc_dir = '' # Release to root
+  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/tags_4_free.rb

@@ -0,0 +1,33 @@
+module Tags4Free
+  require 'rubygems'
+  require 'httparty'
+  include HTTParty
+  
+  VERSION = '0.1.0'
+  
+  class YahooApiError < ArgumentError; end
+
+  class YahooApiFormatError < ArgumentError
+    def initialize(content, result_set)
+      super "Malformed answer by Yahoo! for `#{content}`: #{result_set.inspect}"
+    end
+  end
+  
+  APPID       = 'Tags4Free'
+  SERVICE_URL = 
+      'http://api.search.yahoo.com/ContentAnalysisService/V1/termExtraction'
+  format :xml
+  
+  #
+  # Generate tags for a string
+  #
+  # tags = Tags4Free.for('The content that should be tagged')
+  def self.for(content)
+    result_set = get(SERVICE_URL, :query => {:appid => APPID, :context => content})
+
+    raise YahooApiError.new(result_set['Error']['Message']) if result_set['Error']
+    raise YahooApiFormatError.new(content, result_set) unless result_set['ResultSet']
+    
+    result_set['ResultSet']['Result'] || []
+  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', 'tags4_free')

data/spec/tags_4_free_spec.rb

@@ -0,0 +1,33 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+
+describe Tags4Free do
+  it "should return an empty array if no tags were found" do
+    Tags4Free.should_receive(:get).and_return({"ResultSet"=>{"xsi:schemaLocation"=>"urn:yahoo:cate http://api.search.yahoo.com/ContentAnalysisService/V1/TermExtractionResponse.xsd", "xmlns:xsi"=>"http://www.w3.org/2001/XMLSchema-instance", "xmlns"=>"urn:yahoo:cate"}})
+
+    Tags4Free.for("No keywords extractable.").should eql([])
+  end
+  
+  it "should raise an exception if Yahoo! reports an error" do
+    Tags4Free.should_receive(:get).and_return({"Error"=>{"Message"=>"invalid value: context", "xmlns"=>"urn:yahoo:api"}})
+    
+    begin
+      Tags4Free.for("Erroneous content")
+    rescue Tags4Free::YahooApiError => e
+      e.message.should include('invalid value: context')
+    else
+      violated('YahooApiError should be raised!')
+    end
+  end
+  
+  it "should raise an exception if Yahoo! answers with wired bullshit" do
+    Tags4Free.should_receive(:get).and_return({"Some"=>{"Stupid"=>"bullshit", "xmlns"=>"urn:yahoo:api"}})
+    
+    begin
+      Tags4Free.for("Content that causes a bullshit answer")
+    rescue Tags4Free::YahooApiFormatError => e
+    else
+      violated('YahooApiFormatError should be raised!')
+    end
+  end
+  
+end

data.tar.gz.sig

@@ -0,0 +1,3 @@
+BW��q�	D��
+>	��-�J��
++�4�_[�VX^��/\k�q���B��t����E���٥՞�ޜ�c/�!���_��RT���V�����[2	��R����=��sO�0�����:

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification 
+name: tags4free
+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-10 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 tag extraction from content using Yahoo! search 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/tags_4_free.rb
+- spec/spec_helper.rb
+- spec/tags_4_free_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 tag extraction from content using Yahoo! search API.
+test_files: []
+

metadata.gz.sig

@@ -0,0 +1,2 @@
+€���i�����zc�A���_�Jk�D��ZPH���g�1S�lI��<�
+p�U_�46qL���	i!fI�t���w�h��ǃ/��B҉��6:��~��
��яh8
m_hd���T�������WL�UZq��P�W�N�:%b=�2�y��5��%M��}%�.