@@ -0,0 +1,155 @@ |
||
| 1 |
+require "twitter" |
|
| 2 |
+ |
|
| 3 |
+module Agents |
|
| 4 |
+ class TwitterUserAgent < Agent |
|
| 5 |
+ cannot_receive_events! |
|
| 6 |
+ |
|
| 7 |
+ description <<-MD |
|
| 8 |
+ The TwitterUserAgent follows the timeline of a specified Twitter user. |
|
| 9 |
+ |
|
| 10 |
+ You must set up a Twitter app and provide it's `consumer_key`, `consumer_secret`, `oauth_token` and `oauth_token_secret`, (Also shown as "Access token" on the Twitter developer's site.) along with the `username` of the Twitter user to monitor. |
|
| 11 |
+ |
|
| 12 |
+ Set `expected_update_period_in_days` to the maximum amount of time that you'd expect to pass between Events being created by this Agent. |
|
| 13 |
+ MD |
|
| 14 |
+ |
|
| 15 |
+ event_description <<-MD |
|
| 16 |
+ Events are the raw JSON provided by the Twitter API. Should look something like: |
|
| 17 |
+ |
|
| 18 |
+ {
|
|
| 19 |
+ :created_at=>"Thu Apr 04 13:27:48 +0000 2013", |
|
| 20 |
+ :id=>319803490421596160, |
|
| 21 |
+ :id_str=>"319803490421596160", |
|
| 22 |
+ :text=> |
|
| 23 |
+ "In which @jeresig goes to an art gallery and is \"the JavaScript programmer\". http://t.co/gt3PT1d3G1", |
|
| 24 |
+ :source=> |
|
| 25 |
+ "<a href=\"http://itunes.apple.com/us/app/twitter/id409789998?mt=12\" rel=\"nofollow\">Twitter for Mac</a>", |
|
| 26 |
+ :truncated=>false, |
|
| 27 |
+ :in_reply_to_status_id=>nil, |
|
| 28 |
+ :in_reply_to_status_id_str=>nil, |
|
| 29 |
+ :in_reply_to_user_id=>nil, |
|
| 30 |
+ :in_reply_to_user_id_str=>nil, |
|
| 31 |
+ :in_reply_to_screen_name=>nil, |
|
| 32 |
+ :user=> |
|
| 33 |
+ {:id=>2341001,
|
|
| 34 |
+ :id_str=>"2341001", |
|
| 35 |
+ :name=>"Albert Sun", |
|
| 36 |
+ :screen_name=>"albertsun", |
|
| 37 |
+ :location=>"New York, NY", |
|
| 38 |
+ :description=> |
|
| 39 |
+ "News apps developer at NYT, formerly WSJ. graduated Penn 2010, geek, journalist, data-viz, nlp, gis, digital economics =)", |
|
| 40 |
+ :url=>"http://albertsun.info", |
|
| 41 |
+ :entities=> |
|
| 42 |
+ {:url=>
|
|
| 43 |
+ {:urls=>
|
|
| 44 |
+ [{:url=>"http://albertsun.info",
|
|
| 45 |
+ :expanded_url=>nil, |
|
| 46 |
+ :indices=>[0, 21]}]}, |
|
| 47 |
+ :description=>{:urls=>[]}},
|
|
| 48 |
+ :protected=>false, |
|
| 49 |
+ :followers_count=>1857, |
|
| 50 |
+ :friends_count=>798, |
|
| 51 |
+ :listed_count=>115, |
|
| 52 |
+ :created_at=>"Mon Mar 26 19:22:05 +0000 2007", |
|
| 53 |
+ :favourites_count=>9, |
|
| 54 |
+ :utc_offset=>-18000, |
|
| 55 |
+ :time_zone=>"Eastern Time (US & Canada)", |
|
| 56 |
+ :geo_enabled=>false, |
|
| 57 |
+ :verified=>false, |
|
| 58 |
+ :statuses_count=>2572, |
|
| 59 |
+ :lang=>"en", |
|
| 60 |
+ :contributors_enabled=>false, |
|
| 61 |
+ :is_translator=>false, |
|
| 62 |
+ :profile_background_color=>"1B2A2B", |
|
| 63 |
+ :profile_background_image_url=> |
|
| 64 |
+ "http://a0.twimg.com/profile_background_images/2802438/twitterbg.jpg", |
|
| 65 |
+ :profile_background_image_url_https=> |
|
| 66 |
+ "https://si0.twimg.com/profile_background_images/2802438/twitterbg.jpg", |
|
| 67 |
+ :profile_background_tile=>false, |
|
| 68 |
+ :profile_image_url=> |
|
| 69 |
+ "http://a0.twimg.com/profile_images/110500205/profile-square_normal.jpg", |
|
| 70 |
+ :profile_image_url_https=> |
|
| 71 |
+ "https://si0.twimg.com/profile_images/110500205/profile-square_normal.jpg", |
|
| 72 |
+ :profile_link_color=>"0000FF", |
|
| 73 |
+ :profile_sidebar_border_color=>"87BC44", |
|
| 74 |
+ :profile_sidebar_fill_color=>"E0FF92", |
|
| 75 |
+ :profile_text_color=>"000000", |
|
| 76 |
+ :profile_use_background_image=>true, |
|
| 77 |
+ :default_profile=>false, |
|
| 78 |
+ :default_profile_image=>false, |
|
| 79 |
+ :following=>false, |
|
| 80 |
+ :follow_request_sent=>false, |
|
| 81 |
+ :notifications=>false}, |
|
| 82 |
+ :geo=>nil, |
|
| 83 |
+ :coordinates=>nil, |
|
| 84 |
+ :place=>nil, |
|
| 85 |
+ :contributors=>nil, |
|
| 86 |
+ :retweet_count=>0, |
|
| 87 |
+ :favorite_count=>0, |
|
| 88 |
+ :entities=> |
|
| 89 |
+ {:hashtags=>[],
|
|
| 90 |
+ :urls=> |
|
| 91 |
+ [{:url=>"http://t.co/gt3PT1d3G1",
|
|
| 92 |
+ :expanded_url=> |
|
| 93 |
+ "http://www.nytimes.com/2013/04/04/fashion/art-and-techology-a-clash-of-cultures.html?pagewanted=all", |
|
| 94 |
+ :display_url=>"nytimes.com/2013/04/04/fas", |
|
| 95 |
+ :indices=>[77, 99]}], |
|
| 96 |
+ :user_mentions=> |
|
| 97 |
+ [{:screen_name=>"jeresig",
|
|
| 98 |
+ :name=>"John Resig", |
|
| 99 |
+ :id=>752673, |
|
| 100 |
+ :id_str=>"752673", |
|
| 101 |
+ :indices=>[9, 17]}]}, |
|
| 102 |
+ :favorited=>false, |
|
| 103 |
+ :retweeted=>false, |
|
| 104 |
+ :possibly_sensitive=>false, |
|
| 105 |
+ :lang=>"en" |
|
| 106 |
+ } |
|
| 107 |
+ MD |
|
| 108 |
+ |
|
| 109 |
+ default_schedule "every_1h" |
|
| 110 |
+ |
|
| 111 |
+ def validate_options |
|
| 112 |
+ unless options[:username].present? && options[:expected_update_period_in_days].present? && options[:consumer_key].present? && options[:consumer_secret].present? && options[:oauth_token].present? && options[:oauth_token_secret].present? |
|
| 113 |
+ errors.add(:base, "expected_update_period_in_days, username, consumer_key, consumer_secret, oauth_token and oauth_token_secret are required") |
|
| 114 |
+ end |
|
| 115 |
+ end |
|
| 116 |
+ |
|
| 117 |
+ def working? |
|
| 118 |
+ (event = event_created_within(options[:expected_update_period_in_days].to_i.days)) && event.payload.present? |
|
| 119 |
+ end |
|
| 120 |
+ |
|
| 121 |
+ def default_options |
|
| 122 |
+ {
|
|
| 123 |
+ :username => "tectonic", |
|
| 124 |
+ :expected_update_period_in_days => "2", |
|
| 125 |
+ :consumer_key => "---", |
|
| 126 |
+ :consumer_secret => "---", |
|
| 127 |
+ :oauth_token => "---", |
|
| 128 |
+ :oauth_token_secret => "---" |
|
| 129 |
+ } |
|
| 130 |
+ end |
|
| 131 |
+ |
|
| 132 |
+ def check |
|
| 133 |
+ Twitter.configure do |config| |
|
| 134 |
+ config.consumer_key = options[:consumer_key] |
|
| 135 |
+ config.consumer_secret = options[:consumer_secret] |
|
| 136 |
+ config.oauth_token = options[:oauth_token] |
|
| 137 |
+ config.oauth_token_secret = options[:oauth_token_secret] |
|
| 138 |
+ end |
|
| 139 |
+ |
|
| 140 |
+ since_id = memory[:since_id] || nil |
|
| 141 |
+ opts = {:count => 200, :include_rts => true, :exclude_replies => false, :include_entities => true, :contributor_details => true}
|
|
| 142 |
+ opts.merge! :since_id => since_id unless since_id.nil? |
|
| 143 |
+ |
|
| 144 |
+ tweets = Twitter.user_timeline(options[:username], opts) |
|
| 145 |
+ |
|
| 146 |
+ tweets.each do |tweet| |
|
| 147 |
+ memory[:since_id] = tweet.id if !memory[:since_id] || (tweet.id > memory[:since_id]) |
|
| 148 |
+ |
|
| 149 |
+ create_event :payload => tweet.attrs |
|
| 150 |
+ end |
|
| 151 |
+ |
|
| 152 |
+ save! |
|
| 153 |
+ end |
|
| 154 |
+ end |
|
| 155 |
+end |
@@ -0,0 +1 @@ |
||
| 1 |
+[{"created_at":"Sun Apr 07 20:34:17 +0000 2013","id":320997982096990208,"id_str":"320997982096990208","text":"@christophe971 Cool project!","source":"web","truncated":false,"in_reply_to_status_id":320990180205002752,"in_reply_to_status_id_str":"320990180205002752","in_reply_to_user_id":12574212,"in_reply_to_user_id_str":"12574212","in_reply_to_screen_name":"christophe971","user":{"id":9813372,"id_str":"9813372","name":"Andrew Cantino","screen_name":"tectonic","location":"San Francisco, CA","description":"Experimentalist, web developer, and VP of Engineering at @Mavenlink.","url":"http://andrewcantino.com","entities":{"url":{"urls":[{"url":"http://andrewcantino.com","expanded_url":null,"indices":[0,24]}]},"description":{"urls":[]}},"protected":false,"followers_count":999,"friends_count":492,"listed_count":39,"created_at":"Wed Oct 31 03:16:39 +0000 2007","favourites_count":132,"utc_offset":-28800,"time_zone":"Pacific Time (US & Canada)","geo_enabled":true,"verified":false,"statuses_count":3433,"lang":"en","contributors_enabled":false,"is_translator":false,"profile_background_color":"352726","profile_background_image_url":"http://a0.twimg.com/images/themes/theme5/bg.gif","profile_background_image_url_https":"https://si0.twimg.com/images/themes/theme5/bg.gif","profile_background_tile":false,"profile_image_url":"http://a0.twimg.com/profile_images/1694984565/me-right_normal.jpg","profile_image_url_https":"https://si0.twimg.com/profile_images/1694984565/me-right_normal.jpg","profile_link_color":"D02B55","profile_sidebar_border_color":"829D5E","profile_sidebar_fill_color":"99CC33","profile_text_color":"3E4415","profile_use_background_image":true,"default_profile":false,"default_profile_image":false,"following":null,"follow_request_sent":false,"notifications":null},"geo":null,"coordinates":null,"place":null,"contributors":null,"retweet_count":0,"favorite_count":0,"entities":{"hashtags":[],"urls":[],"user_mentions":[{"screen_name":"christophe971","name":"Christophe Maximin","id":12574212,"id_str":"12574212","indices":[0,14]}]},"favorited":false,"retweeted":false,"lang":"en"},{"created_at":"Sun Apr 07 20:34:06 +0000 2013","id":320997936773349378,"id_str":"320997936773349378","text":"@christophe971 Fair enough. I've previously worked on something very similar and wondered if you're looking for collaborators.","source":"web","truncated":false,"in_reply_to_status_id":320990180205002752,"in_reply_to_status_id_str":"320990180205002752","in_reply_to_user_id":12574212,"in_reply_to_user_id_str":"12574212","in_reply_to_screen_name":"christophe971","user":{"id":9813372,"id_str":"9813372","name":"Andrew Cantino","screen_name":"tectonic","location":"San Francisco, CA","description":"Experimentalist, web developer, and VP of Engineering at @Mavenlink.","url":"http://andrewcantino.com","entities":{"url":{"urls":[{"url":"http://andrewcantino.com","expanded_url":null,"indices":[0,24]}]},"description":{"urls":[]}},"protected":false,"followers_count":999,"friends_count":492,"listed_count":39,"created_at":"Wed Oct 31 03:16:39 +0000 2007","favourites_count":132,"utc_offset":-28800,"time_zone":"Pacific Time (US & Canada)","geo_enabled":true,"verified":false,"statuses_count":3433,"lang":"en","contributors_enabled":false,"is_translator":false,"profile_background_color":"352726","profile_background_image_url":"http://a0.twimg.com/images/themes/theme5/bg.gif","profile_background_image_url_https":"https://si0.twimg.com/images/themes/theme5/bg.gif","profile_background_tile":false,"profile_image_url":"http://a0.twimg.com/profile_images/1694984565/me-right_normal.jpg","profile_image_url_https":"https://si0.twimg.com/profile_images/1694984565/me-right_normal.jpg","profile_link_color":"D02B55","profile_sidebar_border_color":"829D5E","profile_sidebar_fill_color":"99CC33","profile_text_color":"3E4415","profile_use_background_image":true,"default_profile":false,"default_profile_image":false,"following":null,"follow_request_sent":false,"notifications":null},"geo":null,"coordinates":null,"place":null,"contributors":null,"retweet_count":0,"favorite_count":0,"entities":{"hashtags":[],"urls":[],"user_mentions":[{"screen_name":"christophe971","name":"Christophe Maximin","id":12574212,"id_str":"12574212","indices":[0,14]}]},"favorited":false,"retweeted":false,"lang":"en"},{"created_at":"Sun Apr 07 19:59:21 +0000 2013","id":320989192488382464,"id_str":"320989192488382464","text":"@christophe971 Is denisthebot open source?","source":"web","truncated":false,"in_reply_to_status_id":null,"in_reply_to_status_id_str":null,"in_reply_to_user_id":12574212,"in_reply_to_user_id_str":"12574212","in_reply_to_screen_name":"christophe971","user":{"id":9813372,"id_str":"9813372","name":"Andrew Cantino","screen_name":"tectonic","location":"San Francisco, CA","description":"Experimentalist, web developer, and VP of Engineering at @Mavenlink.","url":"http://andrewcantino.com","entities":{"url":{"urls":[{"url":"http://andrewcantino.com","expanded_url":null,"indices":[0,24]}]},"description":{"urls":[]}},"protected":false,"followers_count":999,"friends_count":492,"listed_count":39,"created_at":"Wed Oct 31 03:16:39 +0000 2007","favourites_count":132,"utc_offset":-28800,"time_zone":"Pacific Time (US & Canada)","geo_enabled":true,"verified":false,"statuses_count":3433,"lang":"en","contributors_enabled":false,"is_translator":false,"profile_background_color":"352726","profile_background_image_url":"http://a0.twimg.com/images/themes/theme5/bg.gif","profile_background_image_url_https":"https://si0.twimg.com/images/themes/theme5/bg.gif","profile_background_tile":false,"profile_image_url":"http://a0.twimg.com/profile_images/1694984565/me-right_normal.jpg","profile_image_url_https":"https://si0.twimg.com/profile_images/1694984565/me-right_normal.jpg","profile_link_color":"D02B55","profile_sidebar_border_color":"829D5E","profile_sidebar_fill_color":"99CC33","profile_text_color":"3E4415","profile_use_background_image":true,"default_profile":false,"default_profile_image":false,"following":null,"follow_request_sent":false,"notifications":null},"geo":null,"coordinates":null,"place":null,"contributors":null,"retweet_count":0,"favorite_count":0,"entities":{"hashtags":[],"urls":[],"user_mentions":[{"screen_name":"christophe971","name":"Christophe Maximin","id":12574212,"id_str":"12574212","indices":[0,14]}]},"favorited":false,"retweeted":false,"lang":"nl"},{"created_at":"Sun Apr 07 00:18:42 +0000 2013","id":320692069385527296,"id_str":"320692069385527296","text":"Netflix won’t allow a password longer than 10 characters. Fail.","source":"<a href=\"http://tapbots.com/software/tweetbot/mac\" rel=\"nofollow\">Tweetbot for Mac</a>","truncated":false,"in_reply_to_status_id":null,"in_reply_to_status_id_str":null,"in_reply_to_user_id":null,"in_reply_to_user_id_str":null,"in_reply_to_screen_name":null,"user":{"id":9813372,"id_str":"9813372","name":"Andrew Cantino","screen_name":"tectonic","location":"San Francisco, CA","description":"Experimentalist, web developer, and VP of Engineering at @Mavenlink.","url":"http://andrewcantino.com","entities":{"url":{"urls":[{"url":"http://andrewcantino.com","expanded_url":null,"indices":[0,24]}]},"description":{"urls":[]}},"protected":false,"followers_count":999,"friends_count":492,"listed_count":39,"created_at":"Wed Oct 31 03:16:39 +0000 2007","favourites_count":132,"utc_offset":-28800,"time_zone":"Pacific Time (US & Canada)","geo_enabled":true,"verified":false,"statuses_count":3433,"lang":"en","contributors_enabled":false,"is_translator":false,"profile_background_color":"352726","profile_background_image_url":"http://a0.twimg.com/images/themes/theme5/bg.gif","profile_background_image_url_https":"https://si0.twimg.com/images/themes/theme5/bg.gif","profile_background_tile":false,"profile_image_url":"http://a0.twimg.com/profile_images/1694984565/me-right_normal.jpg","profile_image_url_https":"https://si0.twimg.com/profile_images/1694984565/me-right_normal.jpg","profile_link_color":"D02B55","profile_sidebar_border_color":"829D5E","profile_sidebar_fill_color":"99CC33","profile_text_color":"3E4415","profile_use_background_image":true,"default_profile":false,"default_profile_image":false,"following":null,"follow_request_sent":false,"notifications":null},"geo":null,"coordinates":null,"place":{"id":"8d2591b0d50daf32","url":"https://api.twitter.com/1.1/geo/id/8d2591b0d50daf32.json","place_type":"neighborhood","name":"Lower Haight","full_name":"Lower Haight, San Francisco","country_code":"US","country":"United States","polylines":[],"bounding_box":{"type":"Polygon","coordinates":[[[-122.437382,37.769551],[-122.421482,37.769551],[-122.421482,37.77602],[-122.437382,37.77602]]]},"attributes":{}},"contributors":null,"retweet_count":2,"favorite_count":0,"entities":{"hashtags":[],"urls":[],"user_mentions":[]},"favorited":false,"retweeted":false,"lang":"en"},{"created_at":"Sat Apr 06 18:42:44 +0000 2013","id":320607521532432384,"id_str":"320607521532432384","text":"@ryanmaxwell @draconisnz let me know if you use it, or have suggestions!","source":"<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>","truncated":false,"in_reply_to_status_id":320454615885807616,"in_reply_to_status_id_str":"320454615885807616","in_reply_to_user_id":14658141,"in_reply_to_user_id_str":"14658141","in_reply_to_screen_name":"ryanmaxwell","user":{"id":9813372,"id_str":"9813372","name":"Andrew Cantino","screen_name":"tectonic","location":"San Francisco, CA","description":"Experimentalist, web developer, and VP of Engineering at @Mavenlink.","url":"http://andrewcantino.com","entities":{"url":{"urls":[{"url":"http://andrewcantino.com","expanded_url":null,"indices":[0,24]}]},"description":{"urls":[]}},"protected":false,"followers_count":999,"friends_count":492,"listed_count":39,"created_at":"Wed Oct 31 03:16:39 +0000 2007","favourites_count":132,"utc_offset":-28800,"time_zone":"Pacific Time (US & Canada)","geo_enabled":true,"verified":false,"statuses_count":3433,"lang":"en","contributors_enabled":false,"is_translator":false,"profile_background_color":"352726","profile_background_image_url":"http://a0.twimg.com/images/themes/theme5/bg.gif","profile_background_image_url_https":"https://si0.twimg.com/images/themes/theme5/bg.gif","profile_background_tile":false,"profile_image_url":"http://a0.twimg.com/profile_images/1694984565/me-right_normal.jpg","profile_image_url_https":"https://si0.twimg.com/profile_images/1694984565/me-right_normal.jpg","profile_link_color":"D02B55","profile_sidebar_border_color":"829D5E","profile_sidebar_fill_color":"99CC33","profile_text_color":"3E4415","profile_use_background_image":true,"default_profile":false,"default_profile_image":false,"following":null,"follow_request_sent":false,"notifications":null},"geo":null,"coordinates":null,"place":null,"contributors":null,"retweet_count":0,"favorite_count":0,"entities":{"hashtags":[],"urls":[],"user_mentions":[{"screen_name":"ryanmaxwell","name":"Ryan Maxwell","id":14658141,"id_str":"14658141","indices":[0,12]},{"screen_name":"draconisNZ","name":"Dan","id":14979092,"id_str":"14979092","indices":[13,24]}]},"favorited":false,"retweeted":false,"lang":"en"}]
|
@@ -0,0 +1,28 @@ |
||
| 1 |
+require 'spec_helper' |
|
| 2 |
+ |
|
| 3 |
+describe Agents::TwitterUserAgent do |
|
| 4 |
+ before do |
|
| 5 |
+ # intercept the twitter API request for @tectonic's user profile |
|
| 6 |
+ stub_request(:any, /tectonic/).to_return(:body => File.read(Rails.root.join("spec/data_fixtures/user_tweets.json")), :status => 200)
|
|
| 7 |
+ |
|
| 8 |
+ @opts = {
|
|
| 9 |
+ :username => "tectonic", |
|
| 10 |
+ :expected_update_period_in_days => "2", |
|
| 11 |
+ :consumer_key => "---", |
|
| 12 |
+ :consumer_secret => "---", |
|
| 13 |
+ :oauth_token => "---", |
|
| 14 |
+ :oauth_token_secret => "---" |
|
| 15 |
+ } |
|
| 16 |
+ |
|
| 17 |
+ @checker = Agents::TwitterUserAgent.new(:name => "tectonic", :options => @opts) |
|
| 18 |
+ @checker.user = users(:bob) |
|
| 19 |
+ @checker.save! |
|
| 20 |
+ end |
|
| 21 |
+ |
|
| 22 |
+ describe "#check" do |
|
| 23 |
+ it "should check for changes" do |
|
| 24 |
+ lambda { @checker.check }.should change { Event.count }.by(5)
|
|
| 25 |
+ end |
|
| 26 |
+ end |
|
| 27 |
+ |
|
| 28 |
+end |