delicious-ext 1.0.0

data/README.rdoc

@@ -0,0 +1,72 @@
+= Del.icio.us Extended API
+
+This Module is an extension to official del.icio.us API. The main purpose here is to provide methods like get popular, fresh, hot and recent links using scraping. 
+
+=== Author:
+Thiago Bueno Silva  (mailto:tbueno@tbueno.com)
+
+=== License:
+Distributes under the same terms as Ruby
+
+
+== USAGE:
+
+
+  d = Delicious::Collector.new
+  links = d.popular 'ruby'
+  links.each do |link|  
+    puts '------------------------------------------'
+    puts "Text: #{link.text}"
+    puts "URL: #{link.url}"
+    puts "People: #{link.people}"
+    puts "Posted By: #{link.posted_by.name}" if link.posted_by.name
+    puts "Tags:  #{link.tags * ','}"
+  end
+
+
+== METHODS
+
+=== Popular 
+
+Get popular links found at "delicious.com/popular".
+
+  links = d.popular
+  links.each do |link|  
+    puts '------------------------------------------'
+    puts "Text: #{link.text}"
+    puts "URL: #{link.url}"
+    puts "People: #{link.people}"
+    puts "Posted By: #{link.posted_by.name}" if link.posted_by.name
+    puts "Tags:  #{link.tags * ','}"
+  end
+  
+  # This links can also be searched by tags
+  
+  d.popular 'ruby'
+  
+=== Recent
+
+Links newly added to delicious.
+  recent_links = d.recent
+
+=== Fresh
+
+"The freshest bookmarks that are flying like hotcakes on Delicious and beyond."
+
+  fresh_links = d.fresh
+
+=== Hot List
+
+Popular links right now.
+
+  hot_links = d.hot_list
+  
+=== Search
+
+Search links based on a term.
+
+  links = d.search 'rails' 
+
+
+
+

data/lib/delicious.rb

@@ -0,0 +1,151 @@
+require 'rubygems'
+require 'hpricot'
+require 'open-uri'
+
+
+# This Module is an extension to official del.icio.us API.
+# The main purpose here is to provide methods like 
+# get popular, hot and recent links using scraping. 
+
+# Author::    Thiago Bueno Silva  (mailto:tbueno@tbueno.com)
+# License::   Distributes under the same terms as Ruby
+module Delicious
+  
+  #Possible types of lists
+  FRESH = 0
+  POPULAR = 1
+  RECENT = 2
+  SEARCH = 3
+  BASE_URL = 'http://del.icio.us' 
+	
+  POPULAR_URL = BASE_URL+'/popular'
+  HOT_LIST_URL = BASE_URL+'/?view=hotlist'
+  RECENT_URL = BASE_URL+'/recent'
+  SEARCH_URL = BASE_URL+'/search?context=all&p='
+  
+  FRESH_QUERY = POPULAR_QUERY = "//ul[@id='bookmarklist']/li/div"	
+  SEARCH_QUERY = "//div/[@id='bd']/div[@id='yui-main']/div[@id='content']/ul/li/div"
+	
+  class Collector
+    @list_type = 0
+  
+   
+    def fresh
+      @list_type = FRESH
+      get_links BASE_URL, FRESH_QUERY
+    end
+    
+    def hot_list
+      @list_type = FRESH
+      get_links HOT_LIST_URL, FRESH_QUERY
+    end
+	
+    def popular(tag='')
+      @list_type = POPULAR
+      get_links POPULAR_URL+'/'+tag, POPULAR_QUERY
+    end
+	
+    def recent(min=2)
+      @list_type = RECENT
+      get_links RECENT_URL+'?min='+min.to_s, POPULAR_QUERY
+    end
+	
+    def search(term)
+      @list_type = SEARCH
+      get_links SEARCH_URL+term+"&lc=1", SEARCH_QUERY		
+    end
+
+    private
+    def get_links(base_url, query)
+      links = []
+     		
+      doc = Hpricot(open(base_url))  
+      (doc/query).each do |result|        
+        text = (result/"div[@class='data']/h4/a[@href").first.inner_text       
+        url =  (result/"div[@class='data']/h4/a[@href").first['href']
+        posted_by = get_posted_by(result)	
+        people = get_people(result).to_i
+        tags = get_tags(result)
+        links << Delicious::Link.new( text, url, posted_by, people, tags)
+  			
+      end
+      links		
+    end
+	
+    def get_posted_by(result)
+      name = " "   
+      if @list_type == POPULAR or @list_type == SEARCH        
+       name = (result/"div[@class='meta']/a/span").first.inner_text.split.last         
+      elsif @list_type == RECENT
+        name = (result/"div[@class='meta']/a[@class='user").first['href'].gsub("/", "")	
+      end
+      Delicious::Person.new(name)
+    end
+  
+    def get_people(result)
+      (result/"div[@class='data']/div/div/a/span").inner_text
+    end
+    
+    def get_tags(result)
+      tags = []
+      query = (result/"div[@class='tagdisplay']/ul/li/a/span").each do |span|
+          tags << span.inner_text
+      end           
+      tags
+    end
+  end
+  ####### Collector Class end #############
+  
+  class Link
+
+    attr_reader :text, :url, :posted_by, :people, :tags
+
+    def initialize(text, url, posted_by, people, tags)
+      @text = text
+      @url = url
+      @posted_by = posted_by
+      @people = people
+      @tags = tags		
+    end
+
+    #Comparator method. The links should be ordered by the number of people that saved them.
+    def <=> (link)      
+      if @people > link.people
+        return 1
+      elsif @people < link.people
+        return -1
+      end      
+      0      
+    end
+
+    def equal?(link)     
+      link.url == @url
+    end
+
+  end
+  ####### Link Class end #############
+  
+  class Person
+    
+    attr_reader :name, :url
+    
+    def initialize(name)
+      @name = name
+      @url = BASE_URL+'/'+name
+    end
+  end
+  ########### Person Class end ############
+  
+  class Tag
+    attr_reader :name, :url
+    
+    def initialize(name)
+      @name = name
+      @url = POPULAR_URL +'/'+name
+    end
+  end
+  
+  
+end
+
+

data/test/delicious_test.rb

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'test/unit'
+require File.dirname(__FILE__) + "/../lib/delicious"
+
+class DeliciousTest < Test::Unit::TestCase
+  
+  def setup
+    @delicious = Delicious::Collector.new  
+  end
+
+  def test_popular
+    assert(@delicious.popular.size > 0, "All query should return at least one occurence")    
+  end
+end

data/test/link_test.rb

@@ -0,0 +1,30 @@
+require 'rubygems'
+require 'test/unit'
+require File.dirname(__FILE__) + "/../lib/delicious"
+
+class LinkTest < Test::Unit::TestCase
+  
+  def setup
+    @link = Delicious::Link.new('text', 'url', 'author', 200, ['test','test2'])
+  end
+  def test_equals
+    link2 = Delicious::Link.new('', 'url', '', 0, [])
+    assert(@link.equal?(link2), "According to url, this links have to be equals") 
+  end
+  
+  def test_equals_should_notice_different
+    link2 = Delicious::Link.new('', 'url2', '', '', [])
+    assert(!@link.equal?(link2), "According to url, this links have to be different")
+  end
+  
+  def test_comparator
+    link2 = Delicious::Link.new('', 'url2', '', 201, [])
+    link3 = Delicious::Link.new('', 'url3', '', 203, [])
+    links = [link2, @link, link3].sort
+    
+    assert(@link == links[0], "#{@link} should be the firs element in this test")
+    
+    assert(link3 == links[2], "#{link3} should be the firs element in this test")
+  end
+end
+

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: delicious-ext
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Thiago Bueno Silva
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-02-01 00:00:00 -02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mime-types
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.15"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: diff-lcs
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.2
+    version: 
+description: An Extension to Del.icio.us API using Ruby.
+email: tbueno@tbueno.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- lib/delicious.rb
+has_rdoc: true
+homepage: http://github.com/tbueno/delicious-ext
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: delicious-ext
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: An Extension to Del.icio.us API using Ruby.
+test_files: 
+- test/delicious_test.rb
+- test/link_test.rb