PageRankr 1.3.0 → 1.4.0

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Change Log
 
+## Version 1.4.0
+
+* Made it easier to get at the list of supported trackers.
+* Refactoring
+
 ## Version 1.3.0
 
 * Lots of refactoring. Should be much easier to extend and temporarily fix if needed.

data/PageRankr.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{PageRankr}
-  s.version = "1.3.0"
+  s.version = "1.4.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Allen Madsen"]
-  s.date = %q{2010-07-05}
+  s.date = %q{2010-07-06}
   s.description = %q{Easy way to retrieve Google Page Rank, Alexa Rank, and backlink counts}
   s.email = %q{blatyo@gmail.com}
   s.extra_rdoc_files = [
@@ -37,7 +37,9 @@ Gem::Specification.new do |s|
      "lib/page_rankr/ranks.rb",
      "lib/page_rankr/ranks/alexa.rb",
      "lib/page_rankr/ranks/google.rb",
-     "lib/page_rankr/ranks/google/checksum.rb"
+     "lib/page_rankr/ranks/google/checksum.rb",
+     "lib/page_rankr/ranks/rank.rb",
+     "lib/page_rankr/tracker.rb"
   ]
   s.homepage = %q{http://github.com/blatyo/page_rankr}
   s.rdoc_options = ["--charset=UTF-8"]

data/README.md

@@ -28,7 +28,9 @@ If you don't specify a search engine, then all of them are used.
         #=> {:google=>23000, :bing=>215000000, :yahoo=>250522337, :altavista=>137000000, :alltheweb=>74500000, :alexa=>727036} 
 
 You can also use the alias `backlink` instead of `backlinks`.
-Valid search engines are: `:google, :bing, :yahoo, :altavista, :alltheweb, :alexa`.
+Valid search engines are: `:google, :bing, :yahoo, :altavista, :alltheweb, :alexa`. To get this list you can do:
+
+    PageRankr.backlink_trackers #=> [:alexa, :alltheweb, :altavista, :bing, :google, :yahoo]
 
 ### Ranks
 
@@ -38,7 +40,10 @@ Valid search engines are: `:google, :bing, :yahoo, :altavista, :alltheweb, :alex
     PageRankr.ranks('www.google.com')                  #=> {:alexa=>1, :google=>10}
 
 You can also use the alias `rank` instead of `ranks`.
-There are two valid rank trackers supported: `:alexa, :google`.
+There are two valid rank trackers supported: `:alexa, :google`. To get this you can do:
+
+    PageRankr.rank_trackers #=> [:alexa, :google]
+
 Alexa ranks are descending where 1 is the most popular. If a site has an alexa rank of 0 then the site is unranked.
 Google page ranks are in the range 0-10 where 10 is the most popular. If a site is unindexed then the rank will be -1.
 

data/VERSION

@@ -1 +1 @@
-1.3.0
+1.4.0

data/lib/page_rankr.rb

@@ -1,3 +1,4 @@
+require File.join("page_rankr", "tracker")
 require File.join("page_rankr", "backlinks")
 require File.join("page_rankr", "ranks")
 
@@ -12,5 +13,13 @@ module PageRankr
       Ranks.new.lookup site, *rank_trackers
     end
     alias_method :rank, :ranks
+    
+    def rank_trackers
+      Ranks.new.rank_trackers
+    end
+    
+    def backlink_trackers
+      Backlinks.new.backlink_trackers
+    end
   end
 end

data/lib/page_rankr/backlinks.rb

@@ -7,26 +7,12 @@ require File.join("page_rankr", "backlinks", "google")
 require File.join("page_rankr", "backlinks", "yahoo")
 
 module PageRankr
-  class Backlinks
-    attr_accessor :search_engines
+  class Backlinks < Tracker
+    alias_method :backlink_trackers, :site_trackers
     
     def initialize
-      @search_engines = self.class.constants
-      @search_engines.delete(:Backlink)
-    end
-
-    def lookup(site, *engines)
-      engines = search_engines if engines.empty?
-      
-      backlinks = {}
-      engines.each do |engine|
-        name, klass = engine.to_s.capitalize, self.class
-        
-        next unless klass.const_defined? name
-        
-        backlinks[engine.to_s.downcase.to_sym] = klass.const_get(name).new(site).backlinks
-      end
-      backlinks
+      super
+      @site_trackers.delete(:backlink)
     end
   end
 end

data/lib/page_rankr/backlinks/alexa.rb

@@ -1,7 +1,7 @@
 require 'cgi'
 
 module PageRankr
-  class Backlinks
+  class Backlinks < Tracker
     class Alexa < Backlink
       def url(site)
         "http://data.alexa.com/data?cli=10&dat=snbamz&url=#{CGI.escape(site)}"

data/lib/page_rankr/backlinks/alltheweb.rb

@@ -1,7 +1,7 @@
 require 'cgi'
 
 module PageRankr
-  class Backlinks
+  class Backlinks < Tracker
     class Alltheweb < Backlink
       def url(site)
         "http://www.alltheweb.com/search?q=link%3A#{CGI.escape(site)}"

data/lib/page_rankr/backlinks/altavista.rb

@@ -1,7 +1,7 @@
 require 'cgi'
 
 module PageRankr
-  class Backlinks
+  class Backlinks < Tracker
     class Altavista < Backlink
       def url(site)
         "http://www.altavista.com/web/results?q=link%3A#{CGI.escape(site)}"

data/lib/page_rankr/backlinks/backlink.rb

@@ -2,9 +2,10 @@ require 'nokogiri'
 require 'open-uri'
 
 module PageRankr
-  class Backlinks
+  class Backlinks < Tracker
     class Backlink
       attr_reader :backlinks
+      alias_method :tracked, :backlinks
       
       def initialize(site)
         @backlinks = clean Nokogiri::HTML(open url(site)).at(xpath).to_s

data/lib/page_rankr/backlinks/bing.rb

@@ -1,7 +1,7 @@
 require 'cgi'
 
 module PageRankr
-  class Backlinks
+  class Backlinks < Tracker
     class Bing < Backlink
       def url(site)
         "http://www.bing.com/search?q=link%3A#{CGI.escape(site)}"

data/lib/page_rankr/backlinks/google.rb

@@ -1,7 +1,7 @@
 require 'cgi'
 
 module PageRankr
-  class Backlinks
+  class Backlinks < Tracker
     class Google < Backlink
       def url(site)
         "http://www.google.com/search?q=link%3A#{CGI.escape(site)}"

data/lib/page_rankr/backlinks/yahoo.rb

@@ -1,7 +1,7 @@
 require 'cgi'
 
 module PageRankr
-  class Backlinks
+  class Backlinks < Tracker
     class Yahoo < Backlink
       def url(site)
         "http://siteexplorer.search.yahoo.com/search?p=#{CGI.escape(site)}"

data/lib/page_rankr/ranks.rb

@@ -1,26 +1,14 @@
+require File.join("page_rankr", "ranks", "rank")
 require File.join("page_rankr", "ranks", "alexa")
 require File.join("page_rankr", "ranks", "google")
 
 module PageRankr
-  class Ranks
-    attr_reader :rank_trackers
+  class Ranks < Tracker
+    alias_method :rank_trackers, :site_trackers
     
     def initialize
-      @rank_trackers = self.class.constants
-    end
-    
-    def lookup(site, *trackers)
-      trackers = rank_trackers if trackers.empty?
-      
-      ranks = {}
-      trackers.each do |tracker|
-        name, klass = tracker.to_s.capitalize, self.class
-        
-        next unless klass.const_defined? name
-        
-        ranks[tracker.to_s.downcase.to_sym] = klass.const_get(name).new(site).rank
-      end
-      ranks
+      super
+      @site_trackers.delete(:rank)
     end
   end
 end

data/lib/page_rankr/ranks/alexa.rb

@@ -3,10 +3,8 @@ require 'cgi'
 require 'nokogiri'
 
 module PageRankr
-  class Ranks
-    class Alexa
-      attr_reader :rank
-    
+  class Ranks < Tracker
+    class Alexa < Rank
       def initialize(site)
         @rank = Nokogiri::HTML(open(url(site))).search(xpath).to_s.to_i
       end

data/lib/page_rankr/ranks/google.rb

@@ -2,10 +2,8 @@ require "open-uri"
 require File.join("page_rankr", "ranks", "google", "checksum")
 
 module PageRankr
-  class Ranks
-    class Google
-      attr_reader :rank
-    
+  class Ranks < Tracker
+    class Google < Rank
       def initialize(site)
         checksum = Checksum.generate(site)
         begin

data/lib/page_rankr/ranks/google/checksum.rb

@@ -1,6 +1,6 @@
 module PageRankr
-  class Ranks
-    class Google
+  class Ranks < Tracker
+    class Google < Rank
       class Checksum
         class << self
           def generate(site)

data/lib/page_rankr/ranks/rank.rb

@@ -0,0 +1,8 @@
+module PageRankr
+  class Ranks < Tracker
+    class Rank
+      attr_reader :rank
+      alias_method :tracked, :rank
+    end
+  end
+end

data/lib/page_rankr/tracker.rb

@@ -0,0 +1,23 @@
+module PageRankr
+  class Tracker
+    attr_accessor :site_trackers
+    
+    def initialize
+      @site_trackers = self.class.constants.collect{|tracker| tracker.to_s.downcase.to_sym}
+    end
+
+    def lookup(site, *trackers)
+      trackers = site_trackers if trackers.empty?
+      
+      tracked = {}
+      trackers.each do |tracker|
+        name, klass = tracker.to_s.capitalize, self.class
+        
+        next unless klass.const_defined? name
+        
+        tracked[tracker] = klass.const_get(name).new(site).tracked
+      end
+      tracked
+    end
+  end
+end

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 1
-  - 3
+  - 4
   - 0
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors: 
 - Allen Madsen
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-07-05 00:00:00 -04:00
+date: 2010-07-06 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -76,6 +76,8 @@ files:
 - lib/page_rankr/ranks/alexa.rb
 - lib/page_rankr/ranks/google.rb
 - lib/page_rankr/ranks/google/checksum.rb
+- lib/page_rankr/ranks/rank.rb
+- lib/page_rankr/tracker.rb
 has_rdoc: true
 homepage: http://github.com/blatyo/page_rankr
 licenses: []