postrank-api 0.1.2 → 0.1.3

data/README.md

@@ -26,4 +26,13 @@ For complete documentation on all endpoints please see [PostRank API Docs](http:
     eng    = api.engagement(igvita['id'], :start => 'yesterday')
 
     # lookup social metrics for a url
-    metrics = api.metrics('http://www.igvita.com/')
+    metrics = api.metrics('http://www.igvita.com/')
+
+    # get recommended feeds
+    recommendations = api.recommendations(igvita['id'])
+
+    #lookup relative postranks for given posts
+    postrank = api.postrank(top['items'].collect!{|info| info['original_link']})
+
+    #lookup metrics history for a given post hash
+    history = api.postrank(top['items'].first['id'], :start => '1 month ago')

data/VERSION

@@ -1 +1 @@
-0.1.2
+0.1.3

data/lib/postrank-api/api.rb

@@ -7,6 +7,7 @@ require 'yajl'
 
 module PostRank
   class API
+    V1_API_BASE = 'http://api.postrank.com/v1'
     V2_API_BASE = 'http://api.postrank.com/v2'
 
     def initialize(appkey)
@@ -44,6 +45,50 @@ module PostRank
       parse(http.response)
     end
 
+    def recommendations(feeds, opts = {})  
+      req = {
+        :query => {
+          :appkey => @appkey,
+          :num => opts[:num] || 10
+        },
+      :body => build_body(feeds, 'feed')
+      }
+
+      http = post("#{V2_API_BASE}/recommend", req)
+      parse(http.response)
+    end
+
+    def metrics_versioned(posts, opts = {})
+
+      start_time = opts[:start] || 'yesterday'
+      end_time = opts[:end] || 'today'
+
+     req = {
+        :query => {
+          :appkey => @appkey,
+          :min_time => Chronic.parse(start_time).to_i,
+          :max_time => Chronic.parse(end_time).to_i
+        },
+        :body => build_body( posts, 'post_hash')
+      }
+      
+      http = post("#{V2_API_BASE}/entry/metrics/historic", req)
+      parse(http.response)
+    end
+
+    def postrank(urls, feeds = [], opts = {})
+      req = {
+        :query => {
+          :appkey => @appkey,
+          :format => 'json',
+        },
+        :body => (build_body(urls, 'url'))+"&"+(build_body(feeds, 'feed_hash'))
+      }
+      http = post("#{V1_API_BASE}/postrank", req)
+      parse(http.response)
+    end
+
+
     def top_posts(feed, opts = {})
       req = {
         :query => {
@@ -142,6 +187,14 @@ module PostRank
         dispatch(:get, url, req)
       end
 
+      def build_body(urls, key)
+        [urls].flatten.map { |e| "#{key}[]=#{e}" }.join("&")
+      end
+
+      def post(url, req)
+        dispatch(:post, url, req)
+      end
+
       def dispatch(method, url, req)
         if EM.reactor_running?
           http = EM::HttpRequest.new(url).send(method, req)
@@ -153,5 +206,5 @@ module PostRank
         end
         http
       end
-  end
 end
+end

data/postrank-api.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{postrank-api}
-  s.version = "0.1.2"
+  s.version = "0.1.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Ilya Grigorik"]
-  s.date = %q{2010-06-24}
+  s.date = %q{2010-07-28}
   s.description = %q{PostRank API Wrapper}
   s.email = %q{ilya@igvita.com}
   s.extra_rdoc_files = [

data/spec/api_spec.rb

@@ -5,7 +5,6 @@ require 'pp'
 describe PostRank::API do
   IGVITA = '421df2d86ab95100de7dcc2e247a08ab'
   EVERBURNING = 'cb3e81ac96fb0ada1212dfce4f329474'
-
   let(:api) { PostRank::API.new('test') }
 
   it "should initialize with appkey" do
@@ -71,6 +70,28 @@ describe PostRank::API do
     end
   end
 
+  describe "Recommendations API" do
+
+    it "should fetch recommendations for a single feed" do
+       EM.synchrony do
+          resp = api.recommendations(IGVITA)
+            resp.class.should == Array
+          EM.stop
+        end
+      end
+
+    it "should fetch recommendation for a set of feeds" do
+     EM.synchrony do
+        resp = api.recommendations([IGVITA, EVERBURNING], :num => 1)
+
+          resp.class.should == Array
+          resp.size.should == 1
+
+        EM.stop
+      end
+    end
+  end
+
   describe "Top Posts API" do
     it "should fetch top posts for a feed" do
       EM.synchrony do
@@ -85,6 +106,44 @@ describe PostRank::API do
     end
   end
 
+ describe "Metrics Versioned API" do
+    it "should fetch metrics for a single post" do
+      EM.synchrony do
+        met = api.metrics_versioned('b0432f947bc0d44766d046bfc3c15043', {:start => '5 years ago', :end => 'today'})
+        met.class.should == Hash
+        met.keys.size.should == 1
+        EM.stop
+      end
+    end
+    it "should fetch metrics for multiple posts" do
+      EM.synchrony do
+        met = api.metrics_versioned(['b0432f947bc0d44766d046bfc3c15043', 'a020c1c3a5b2aef1ab4a7307cf3d2cb6'], {:start => '5 years ago', :end => 'today'})
+        met.class.should == Hash
+        met.keys.size.should == 2
+        EM.stop
+      end
+    end
+  end
+
+  describe "Postrank API" do
+    it "should fetch postrank with respect to provided urls" do
+      EM.synchrony do
+          pr = api.postrank(['http://www.igvita.com/2008/06/19/splunk-your-distributed-logs-in-ec2/', 'http://www.igvita.com/2008/02/11/nginx-and-memcached-a-400-boost/'])
+          pr.class.should == Hash
+          pr.keys.size.should == 2
+        EM.stop
+       end
+    end
+    it "should fetch postrank with respect specific feeds" do
+      EM.synchrony do
+        pr = api.postrank(['http://www.igvita.com/2008/06/19/splunk-your-distributed-logs-in-ec2/', 'http://www.igvita.com/2008/02/11/nginx-and-memcached-a-400-boost/'], ['421df2d86ab95100de7dcc2e247a08ab'])
+        pr.class.should == Hash
+        pr.keys.size.should == 2
+       EM.stop
+      end
+    end
+  end
+
   describe "Feed Engagement API" do
     it "should fetch engagement for a feed" do
       EM.synchrony do
@@ -169,7 +228,6 @@ describe PostRank::API do
 
   it "should invoke and kill EM reactor transparently" do
     metrics = api.metrics('1c1a5357e8bd00128db845b2595d5ebe')
-
     metrics.keys.size.should == 1
     metrics['1c1a5357e8bd00128db845b2595d5ebe'].class.should == Hash
   end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 2
-  version: 0.1.2
+  - 3
+  version: 0.1.3
 platform: ruby
 authors: 
 - Ilya Grigorik
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-06-24 00:00:00 -04:00
+date: 2010-07-28 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency