stream_grabber 0.1.0

data/README.md

@@ -0,0 +1,67 @@
+StreamGrabber
+=============
+
+StreamGrabber is a way of multiplexing streams and feeds together into a timeline, it supports twitter, last.fm and github at the moment but is designed to be fairly trivial to add new sources, providing they have some kind of public facing data stream…
+
+Usage
+-----
+At the moment StreamGrabber supports Twitter, last.fm and Github so
+you'll need to give it your username for these sites. Create
+`#{RAILS_ROOT}/config/stream_grabber.yml` so that it looks like the
+following
+
+    :twitter: username
+    :lastfm: username
+    :github: username
+
+And then you can include the plugin in your Gemfile like so
+
+    gem 'stream_grabber'
+
+and load the helper method in your chosen controller.
+
+    class HomepageController < ApplicationController
+      helper :stream_grabber
+
+      # blah blah blah
+    end
+
+then in your views you use
+
+    <%= generate_stream_list %>
+
+to render an ordered list of your most recent activity, most recent
+first. There are a couple of additional options you can pass to
+customise the output, the first is the number of results you'd like back
+(defaults to 15) and the second is the css id and class you wish to be 
+applied to the output. You can use these as follows
+
+    <%= generate_stream_list 5, :class => 'foo' , :id => 'bar' %>
+
+Adding new Sources
+------------------
+
+Sources are defined as classes in the StreamGrabber module, they are all
+loaded dynamically so all your new source has to do is conform to the
+following interface
+
+    module StreamGrabber
+      class Twitter
+        def initialize(user_name)
+          # do your setup in here to grab and parse the stream
+        end
+
+        def last_five
+          # returns your data as a timestamp keyed hash
+        end
+      end
+    end
+
+And as long as `last_five` returns a hash with timestamps as keys, then
+whatever is in the hash values will be squirted into the `li` elements
+in the resulting list.
+
+Over engineered? Damn Straight!!
+
+If you want to add sources, please give me a pull request and I'll merge
+them straight in.

data/Rakefile

@@ -0,0 +1,11 @@
+require "rubygems"
+require "rake/gempackagetask"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = true
+end
+
+task :default => [:test]
+

data/app/helpers/stream_grabber_helper.rb

@@ -0,0 +1,14 @@
+module StreamGrabberHelper
+  def generate_stream_list(num=15, *args)
+    if args.present?
+      css_class = args.first[:class]
+      css_id = args.first[:id]
+    end
+
+    data = StreamGrabber.grab(num).inject([]){ |memo,acc| memo << content_tag(:li,raw(acc[1])) }
+
+    content_tag :ol, {:class => css_class || 'activity_list', :id => css_id || 'stream_grabber'} do 
+      raw(data.join("\n"))
+    end
+  end
+end

data/lib/stream_grabber/github.rb

@@ -0,0 +1,24 @@
+require 'simple-rss'
+require 'open-uri'
+require 'pp'
+
+module StreamGrabber
+  class Github
+    def initialize(user_name)
+      @doc = SimpleRSS.parse(open("https://github.com/#{user_name}.private.actor.atom?token=4ec7548d4e071bdc85462077a69bcdf2"))
+    end
+
+    def last_five
+      commits = {}
+      @doc.items.first(5).each do |item|
+        date = Time.parse(item[:updated].to_s).to_i
+        commits[date] = message_from(item[:link], item[:title])
+      end
+      commits
+    end
+
+    def message_from(link, title)
+      %Q{<a href="#{link}">#{title}</a>"}
+    end
+  end
+end

data/lib/stream_grabber/last_fm.rb

@@ -0,0 +1,28 @@
+require 'nokogiri'
+require 'open-uri'
+
+module StreamGrabber
+  class LastFm
+    def initialize(user_name)
+      @user_name = user_name
+      @doc ||= Nokogiri::XML(open("http://ws.audioscrobbler.com/2.0/?method=user.getlovedtracks&user=#{user_name}&api_key=b25b959554ed76058ac220b7b2e0a026"))
+    end
+
+    def last_five
+      tracks = {}
+      ff = @doc.xpath("//track").first(5)
+      ff.each do |elem|
+        date_loved = elem.>('date').first['uts'].to_i
+        artist_name = elem.css('artist > name').text
+        track_name = elem.>('name').text
+        url = elem.>('url').text
+        tracks[date_loved] = message_for(artist_name,track_name, url)
+      end
+      tracks
+    end
+
+    def message_for(artist, title, url)
+      %Q{ #{@user_name} loved the track <a href="#{url}">#{title} by #{artist}</a> on Last.fm }
+    end
+  end
+end

data/lib/stream_grabber/twitter.rb

@@ -0,0 +1,25 @@
+require 'json'
+require 'open-uri'
+
+module StreamGrabber
+  class Twitter
+    def initialize(user_name)
+      @user_name = user_name
+      @doc = JSON.load(open("http://api.twitter.com/1/statuses/user_timeline.json?count=6&screen_name=#{user_name}"))
+    end
+
+    def last_five
+      tweets = {}
+      @doc.each do |tweet|
+        date = Time.parse(tweet["created_at"]).to_i
+        tweets[date] = message_from(tweet["text"], tweet["id"])
+      end
+      tweets
+    end
+
+    def message_from(text, id)
+      %Q{<a href="http://twitter.com/#{@user_name}/status/#{id}">#{text}</a>}
+    end
+
+  end
+end

data/lib/stream_grabber.rb

@@ -0,0 +1,42 @@
+require 'stream_grabber/last_fm'
+require 'stream_grabber/github'
+require 'stream_grabber/twitter'
+require 'rails'
+
+if ENV['OFFLINE']
+  # use test data if we are developing offline
+  require File.expand_path(File.join(File.dirname(__FILE__), *%w[.. test test_helper.rb]))
+end
+
+module StreamGrabber
+
+  class Engine < Rails::Engine; end
+
+  class << self
+    def usernames
+      @usernames ||= YAML.load_file(Rails.root + 'config/stream_grabber.yml')
+    end
+
+    def mux_stream
+      messages = {}
+      StreamGrabber.constants.each do |klass|
+        k = StreamGrabber.const_get(klass)
+        if k.instance_of?(Class) and k.method_defined?('last_five')
+          name = k.name.partition('::').last.split(/(?=[A-Z])/).join("_").downcase
+          user_name = usernames[name.to_sym]
+          messages.merge!(k.new(user_name).send(:last_five))
+        end
+      end
+      arr = messages.sort.reverse
+    end
+
+    def grab_all
+      mux_stream
+    end
+
+    def grab(n)
+      mux_stream.first(n)
+    end
+  end
+
+end