oii_twitter_goodies 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 344af42c7d494fcbf3126d96dbf716f7454790b0
+  data.tar.gz: 318f52d851942f33c8893a9b3c1a0c6438274be5
+SHA512:
+  metadata.gz: 35908cc4716bcceded07b1b58ead4994ee7b2357df66f16f48d6d174df3977611d309757de7cac6fdece9e5fa7927f338da8141f757b7b6327731c6e2fef9a3b
+  data.tar.gz: b679c6c0ed1d69859217321e807e05600e262fba553f0cc0af7fb68663755b98b4fb29e34e71fb002714f6fba39a523835a6a080d79b6e4aeaf69b58bbb9776f

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in oii_twitter_goodies.gemspec
+gem 'bundler'
+gem 'mongo_mapper'
+gem 'oauth'
+gem 'twitter'
+gem 'tweetstream'
+gem 'hashie'
+gem 'typhoeus'
+gem 'json'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Devin Gaffney
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,37 @@
+# OII Twitter Goodies
+
+This set of libraries, functions, and monkey patches to existing Twitter gems aims to make the work that Oxford Internet Institute's various faculty and staff undertakes as simple as possible. Have fun.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'oii_twitter_goodies'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install oii_twitter_goodies
+
+## Usage
+
+Although this is *just* a gem, it has a few notable dependencies depending on what you're playing with:
+
+1. If you're using the OIITwitter class to collect REST API data from Twitter, you're going to need:
+  a. MongoDB installed locally, running on port 27017 (this is the default port). Thankfully, MongoDB is relatively easy to install
+  b. MongoMapper, the Ruby Gem that is responsible for tying between MongoDB's internals and Ruby code (the term for this type of Gem is ORM - may want to read up on that if you're ever bored).
+  c. Twitter and TweetStream (these are the two principle Gems used for Twitter data collection).
+2. What you get:
+  a. OIITwitter: A library of several functions that cover most of the bases of data collection that any of you guys are going to need (currently supports grabbing sets of tweets, users, follower/friend IDs, and egonets (and caches it!))
+  b. OIITweetStream: A library that wraps TweetStream's streaming API functionality, and sets up a best-practices database for storing data from the stream.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/oii_twitter_goodies/extensions/twitter_api_utils.rb

@@ -0,0 +1,30 @@
+module Twitter
+  module API
+    module Utils
+      def objects_from_response(klass, request_method, path, options={})
+        response = send(request_method.to_sym, path, options)
+        if response.class == Hash && response[:body]
+          response = response[:body]
+          objects_from_array(klass, response)
+        else
+          return response
+        end
+      end
+
+      def object_from_response(klass, request_method, path, options={})
+        response = send(request_method.to_sym, path, options)
+        return klass.from_response(response) || response
+      end
+      
+      def cursor_from_response(collection_name, klass, request_method, path, options, method_name)
+        merge_default_cursor!(options)
+        response = send(request_method.to_sym, path, options)
+        if (response.class == Hash || response.class == BSON::OrderedHash) && !response.keys.include?(:body)
+          Twitter::Cursor.from_response({:body => response}, collection_name.to_sym, klass, self, method_name, options)
+        else
+          Twitter::Cursor.from_response(response, collection_name.to_sym, klass, self, method_name, options)
+        end
+      end
+    end
+  end
+end

data/lib/oii_twitter_goodies/extensions/twitter_client.rb

@@ -0,0 +1,17 @@
+module Twitter
+  class Client
+    def get(path, params={})
+      lookup = TwitterAPICall.first(:url => path.to_s, :params => params)
+      if lookup
+        return lookup.data
+      else
+        response = request(:get, path, params)
+        if response[:status] && response[:status] == 200
+          lookup = TwitterAPICall.new(:url => path.to_s, :params => params, :data => response[:body])
+          lookup.save!
+        end
+        return response
+      end
+    end
+  end
+end

data/lib/oii_twitter_goodies/lib/followers_for_users.rb

@@ -0,0 +1,64 @@
+class FollowersForUsers
+
+  attr_accessor :screen_names, :oauth_token, :oauth_token_secret, :consumer_key, :consumer_secret, :client
+
+  def initialize(opts={})
+    opts = Hashie::Mash[opts]
+    @screen_names = opts[:screen_names] || []
+    @oauth_token = opts[:oauth_token]
+    @oauth_token_secret = opts[:oauth_token_secret]
+    @consumer_key = opts[:consumer_key]
+    @consumer_secret = opts[:consumer_secret]
+    @screen_names = [@screen_names].flatten
+    Twitter.configure do |config|
+      config.consumer_key = @consumer_key
+      config.consumer_secret = @consumer_secret
+      config.oauth_token = @oauth_token
+      config.oauth_token_secret = @oauth_token_secret
+    end
+    @client = Twitter::Client.new
+  end
+  
+  def grab_followers
+    results = {}
+    @screen_names.each do |screen_name|
+      puts "Current progress: #{@screen_names.index(screen_name)}/#{@screen_names.length} started"
+      user = user_data_for(screen_name)
+      follower_ids = follower_ids_for(screen_name)
+      user_data = user_data_for(follower_ids)
+      results[user.first.attrs] = user_data
+      puts "Current progress: ##{@screen_names.index(screen_name)}/#{@screen_names.length} complete"      
+    end
+    puts "Done!"
+    return results
+  end
+    
+  def follower_ids_for(screen_name)
+    return direction_ids_for screen_name, "follower"
+  end
+
+  def friend_ids_for(screen_name)
+    return direction_ids_for screen_name, "friend"
+  end
+
+  def direction_ids_for(screen_name, direction)
+    cursor = -1
+    ids = []
+    while cursor != 0
+      puts cursor
+      data = Hashie::Mash[@client.send(direction+"_ids", screen_name, :cursor => cursor).attrs]
+      ids = ids|data.ids
+      cursor = data["next_cursor"]
+    end
+    return ids
+  end
+  
+  def user_data_for(screen_names)
+    screen_names = [screen_names].flatten
+    user_data = []
+    screen_names.each_slice(100) do |screen_name_set|
+      user_data = [user_data|@client.users(screen_name_set)].flatten
+    end
+    user_data
+  end
+end

data/lib/oii_twitter_goodies/lib/streamer.rb

@@ -0,0 +1,64 @@
+class Streamer
+  attr_accessor :stream_type, :stream_conditions, :oauth_token, :oauth_token_secret, :consumer_key, :consumer_secret
+
+  def initialize(opts={})
+    opts = Hashie::Mash[opts]
+    @stream_type = opts[:stream_type] || "track"
+    @stream_conditions = opts[:stream_conditions] || "lol"
+    @oauth_token = opts[:oauth_token]
+    @oauth_token_secret = opts[:oauth_token_secret]
+    @consumer_key = opts[:consumer_key]
+    @consumer_secret = opts[:consumer_secret]
+    TweetStream.configure do |config|
+      config.consumer_key = @consumer_key
+      config.consumer_secret = @consumer_secret
+      config.oauth_token = @oauth_token
+      config.oauth_token_secret = @oauth_token_secret
+    end
+    @client = TweetStream::Client.new
+    self.send("prepare_#{@stream_type}_variables")
+  end
+  
+  def prepare_follow_variables
+    raise "Stream Conditions can't be nil!" if @stream_conditions.nil?
+    raise "Stream Conditions must be a comma-separated string or array!" if ![String, Array].include?(@stream_conditions.class)
+    @stream_conditions = @stream_conditions.split(",") if @stream_conditions.class == String
+    sc_count = @stream_conditions.count
+    @stream_conditions = @stream_conditions.collect(&:to_i)
+    @stream_conditions = @stream_conditions.select{|sc| sc != 0}
+    raise "#{sc_count-@stream_conditions.length} values were dropped from stream conditions as they were not integers. You must specify integers (representing valid user IDs on Twitter) for this to work" if sc_count != @stream_conditions.length
+    raise "Stream conditions are empty!" if @stream_conditions.length == 0
+    @stream_conditions
+  end
+  
+  def prepare_track_variables
+    raise "Stream Conditions can't be nil!" if @stream_conditions.nil?
+    raise "Stream Conditions must be a comma-separated string or array!" if ![String, Array].include?(@stream_conditions.class)
+    raise "Stream conditions are empty!" if @stream_conditions.length == 0
+    @stream_conditions = @stream_conditions.split(",") if @stream_conditions.class == String
+    @stream_conditions
+  end
+  
+  def prepare_locations_variables
+    new_value = []
+    @stream_conditions.split(",").each_slice(4) do |lat_lon_pair|
+      boundings = lat_lon_pair.collect{|b| b.to_f}
+      raise "Must input two pairs of numbers, separated by commas." if boundings.length!=4
+      raise "Latitudes are out of range (max 90 degrees)" if boundings[1].abs>90 || boundings[3].abs>90
+      raise "Longitudes are out of range (max 180 degrees)" if boundings[0].abs>180 || boundings[2].abs>180
+      new_value << boundings
+    end
+    @stream_conditions = new_value.flatten.collect(&:to_f )
+    
+  end
+  
+  def stream(&block)
+    EM.run do
+      @client.on_error {|msg| puts msg }
+      @client.on_limit {|skip_count| puts "limit reached: #{skip_count} skipped"}
+      @client.send(@stream_type, @stream_conditions) do |status|
+        block.call status
+      end
+    end
+  end
+end

data/lib/oii_twitter_goodies/model/bounding_box.rb

@@ -0,0 +1,22 @@
+class BoundingBox
+  include MongoMapper::Document
+  key :type, String, :required => true
+  key :coordinates, Array, :required => true
+  key :place_id, ObjectId
+  belongs_to :place
+  
+  def self.example
+    {"type"=>"Polygon", "coordinates"=>[[[4.7289, 52.278227], [5.079207, 52.278227], [5.079207, 52.431229], [4.7289, 52.431229]]]}
+  end
+  
+  def self.new_from_raw(bounding_box, place_id)
+    return nil if bounding_box.nil?
+    bounding_box = Hashie::Mash[bounding_box]
+    obj = self.new
+    obj.type = bounding_box["type"]
+    obj.coordinates = bounding_box["coordinates"]
+    obj.place_id = place_id
+    obj.save!
+    obj
+  end
+end

data/lib/oii_twitter_goodies/model/coordinate.rb

@@ -0,0 +1,23 @@
+class Coordinate
+  include MongoMapper::Document
+  key :type, String
+  #coordinate coordinates are lon lat - geo coordinates are lat lon.
+  key :coordinates, Array
+  key :tweet_id, ObjectId
+  belongs_to :tweet
+  
+  def self.example
+    {"type"=>"Point", "coordinates"=>[4.8930892, 52.37051453]}
+  end
+  
+  def self.new_from_raw(coordinate, tweet_id)
+    return if coordinate.nil?
+    coordinate = Hashie::Mash[coordinate]
+    obj = self.new
+    obj.type = coordinate["type"]
+    obj.coordinates = coordinate["coordinates"]
+    obj.tweet_id = tweet_id
+    obj.save!
+    obj
+  end
+end

data/lib/oii_twitter_goodies/model/edge.rb

@@ -0,0 +1,9 @@
+class Edge
+  include MongoMapper::Document
+  key :source
+  key :target
+  key :edge_type
+  key :metadata
+  key :ended_at
+  timestamps!
+end

data/lib/oii_twitter_goodies/model/egonet.rb

@@ -0,0 +1,8 @@
+class Egonet
+  include MongoMapper::Document
+  key :alter_ids, Array
+  key :ego_id, Integer
+  key :alter_user_ids, Array
+  key :user_id, ObjectId
+  belongs_to :user
+end

data/lib/oii_twitter_goodies/model/geo.rb

@@ -0,0 +1,23 @@
+class Geo
+  include MongoMapper::Document
+  key :type, String
+  #coordinate coordinates are lon lat - geo coordinates are lat lon.
+  key :coordinates, Array
+  key :tweet_id, ObjectId
+  belongs_to :tweet
+  
+  def self.example
+    {"type"=>"Point", "coordinates"=>[52.37051453, 4.8930892]}
+  end
+  
+  def self.new_from_raw(geo, tweet_id)
+    return if geo.nil?
+    geo = Hashie::Mash[geo]
+    obj = self.new
+    obj.type = geo["type"]
+    obj.coordinates = geo["coordinates"]
+    obj.tweet_id = tweet_id
+    obj.save!
+    obj
+  end
+end

data/lib/oii_twitter_goodies/model/hashtag.rb

@@ -0,0 +1,21 @@
+class Hashtag
+  include MongoMapper::Document
+  key :text, String
+  key :indices, Array
+  key :tweet_id, ObjectId
+  belongs_to :tweet
+  
+  def self.example
+    {"text"=>"IDMA", "indices"=>[27, 32]}
+  end
+  
+  def self.new_from_raw(entity, tweet_id)
+    entity = Hashie::Mash[entity]
+    obj         = self.new
+    obj.text    = entity["text"]
+    obj.indices = entity["indices"]
+    obj.tweet_id = tweet_id
+    obj.save!
+    obj
+  end
+end

data/lib/oii_twitter_goodies/model/location.rb

@@ -0,0 +1,44 @@
+require 'open-uri'
+class Location
+  include MongoMapper::Document
+  key :term, String
+  key :coordinate_data_yahoo, String
+  key :coordinate_data_google, Hash
+  
+  def self.grab(term)
+    term = term || ""
+    if (loc = Location.first(:term => term.downcase))
+      return loc
+    else
+      loc = Location.new(:term => term.downcase)
+      loc.coordinate_data_yahoo = Location.coordinate_data_yahoo(term)
+      loc.coordinate_data_google = Location.coordinate_data_google(term)
+      loc.save!
+      return loc
+    end
+  end
+  
+  def self.coordinate_data_yahoo(term)
+    return Yahoo.locate(term)
+  end
+  
+  def self.coordinate_data_google(term)
+    return Google.locate(term).to_hash
+  end
+  
+  def google
+    return self.coordinate_data_google if self.coordinate_data_google.nil?
+    if self.coordinate_data_google["success"] && self.coordinate_data_google["success"] == true
+      return {:lat => self.coordinate_data_google["lat"], :lng => self.coordinate_data_google["lng"]}
+    else
+      return nil
+    end
+  end
+
+  def yahoo
+    return self.coordinate_data_yahoo if self.coordinate_data_yahoo.nil? || self.coordinate_data_yahoo.empty?
+    lat = self.coordinate_data_yahoo.split(",").first.to_f
+    lng = self.coordinate_data_yahoo.split(",").last.to_f
+    return {:lat => lat, :lng => lng}
+  end
+end

data/lib/oii_twitter_goodies/model/media.rb

@@ -0,0 +1,43 @@
+require_relative 'size'
+
+class Medium
+  include MongoMapper::Document
+  key :display_url, String
+  key :media_url, String
+  key :id_str, String
+  key :media_url_https, String
+  key :expanded_url, String
+  key :url, String
+  key :type, String
+  key :id, Integer
+  key :indices, Array
+  key :size_ids, Array
+  many :sizes, :in => :size_ids
+  key :tweet_id, ObjectId
+  belongs_to :tweet
+  
+  def self.example
+    {"display_url"=>"pic.twitter.com/I8kPMVvy", "media_url"=>"http://pbs.twimg.com/media/A9TiOUSCYAArxdM.jpg", "sizes"=>{"thumb"=>{"resize"=>"crop", "h"=>150, "w"=>150}, "large"=>{"resize"=>"fit", "h"=>230, "w"=>632}, "small"=>{"resize"=>"fit", "h"=>124, "w"=>340}, "medium"=>{"resize"=>"fit", "h"=>218, "w"=>600}}, "id_str"=>"276094212766851072", "media_url_https"=>"https://pbs.twimg.com/media/A9TiOUSCYAArxdM.jpg", "expanded_url"=>"http://twitter.com/insomniacevents/status/276094212758462465/photo/1", "url"=>"http://t.co/I8kPMVvy", "type"=>"photo", "id"=>276094212766851072, "indices"=>[118, 138]}
+  end
+
+  def self.new_from_raw(media, tweet_id)
+    media = Hashie::Mash[media]
+    obj = self.new
+    obj.display_url     = media["display_url"]
+    obj.media_url       = media["media_url"]
+    obj.id_str          = media["id_str"]
+    obj.media_url_https = media["media_url_https"]
+    obj.expanded_url    = media["expanded_url"]
+    obj.url             = media["url"]
+    obj.type            = media["type"]
+    obj.id              = media["id"]
+    obj.indices         = media["indices"]
+    media["sizes"].each_pair do |size_type, size_data|
+      size = Size.new_from_raw(size_type, size_data, obj._id)
+      obj.sizes << size
+    end
+    obj.tweet_id = tweet_id
+    obj.save!
+    obj
+  end
+end

data/lib/oii_twitter_goodies/model/place.rb

@@ -0,0 +1,48 @@
+require_relative 'place_attribute'
+require_relative 'bounding_box'
+
+class Place
+  include MongoMapper::Document
+  key :twitter_id, Integer
+  key :url, String
+  key :place_type, String
+  key :name, String
+  key :full_name, String
+  key :country_code, String
+  key :country, String
+  key :bounding_box_id, ObjectId
+  key :place_attribute_ids, Array
+  many :place_attributes, :in => :place_attribute_ids
+  key :tweet_id, ObjectId
+  belongs_to :tweet
+  belongs_to :bounding_box
+
+  def self.example
+    {"id"=>"99cdab25eddd6bce", "url"=>"http://api.twitter.com/1/geo/id/99cdab25eddd6bce.json", "place_type"=>"city", "name"=>"Amsterdam", "full_name"=>"Amsterdam, North Holland", "country_code"=>"NL", "country"=>"The Netherlands", "bounding_box"=>{"type"=>"Polygon", "coordinates"=>[[[4.7289, 52.278227], [5.079207, 52.278227], [5.079207, 52.431229], [4.7289, 52.431229]]]}, "attributes"=>{}}
+  end
+    
+  def self.new_from_raw(place, tweet_id)
+    return if place.nil?
+    place = Hashie::Mash[place]
+    obj = self.new
+    obj.twitter_id   = place["twitter_id"]
+    obj.url          = place["url"]
+    obj.place_type   = place["place_type"]
+    obj.name         = place["name"]
+    obj.full_name    = place["full_name"]
+    obj.country_code = place["country_code"]
+    obj.country      = place["country"]
+    bounding_box = BoundingBox.new_from_raw(place["bounding_box"], obj._id)
+    if bounding_box
+      obj.bounding_box = bounding_box
+    end
+    
+    place["attributes"].each_pair do |key, value|
+      place = PlaceAttribute.new_from_raw(key, value, obj._id)
+      obj.place_attributes << place
+    end
+    obj.tweet_id = tweet_id
+    obj.save!
+    obj
+  end
+end

data/lib/oii_twitter_goodies/model/place_attribute.rb

@@ -0,0 +1,20 @@
+class PlaceAttribute
+  include MongoMapper::Document
+  key :name, String
+  key :value, String
+  key :place_id, ObjectId
+  belongs_to :place
+
+  def self.example
+    {"street_address"=>"5403 Stevens Creek Blvd"}
+  end
+  
+  def self.new_from_raw(key, value, place_id)
+    obj = self.new
+    obj.name = key
+    obj.value = value
+    obj.place_id = place_id
+    obj.save!
+    obj
+  end
+end

data/lib/oii_twitter_goodies/model/result.rb

@@ -0,0 +1,8 @@
+class Result
+  include MongoMapper::Document
+  key :type, String, :required => true, :default => "export_processes"
+  key :data
+  key :user_id, ObjectId
+  belongs_to :user
+end
+# Result.ensure_index([[:user_id, 1], [:type, 1]], :unique => true)

data/lib/oii_twitter_goodies/model/sample.rb

@@ -0,0 +1,4 @@
+class Sample
+  include MongoMapper::Document
+  key :user_id
+end

data/lib/oii_twitter_goodies/model/size.rb

@@ -0,0 +1,25 @@
+class Size
+  include MongoMapper::Document
+  key :size, String
+  key :resize, String
+  key :h, Integer
+  key :w, Integer
+  key :media_id, ObjectId
+  belongs_to :media
+  
+  def self.example
+    {"thumb"=>{"resize"=>"crop", "h"=>150, "w"=>150}}
+  end
+
+  def self.new_from_raw(size_type, size_data, media_id)
+    size_data = Hashie::Mash[size_data]
+    obj = self.new
+    obj.size   = size_type
+    obj.resize = size_data["resize"]
+    obj.h      = size_data["h"]
+    obj.w      = size_data["w"]
+    obj.media_id = media_id
+    obj.save!
+    obj
+  end
+end

data/lib/oii_twitter_goodies/model/tweet.rb

@@ -0,0 +1,112 @@
+require_relative 'user_mention'
+require_relative 'coordinate'
+require_relative 'hashtag'
+require_relative 'media'
+require_relative 'place'
+require_relative 'geo'
+require_relative 'url'
+
+class Tweet
+  include MongoMapper::Document
+  key :created_at, Time, :required => true
+  key :twitter_id, Integer, :required => true
+  key :twitter_id_str, String, :required => true
+  key :text, String, :required => true
+  key :source, String, :required => true
+  key :truncated, Boolean, :default => false, :required => true
+  key :in_reply_to_status_id, Integer
+  key :in_reply_to_status_id_str, String
+  key :in_reply_to_user_id, Integer
+  key :in_reply_to_user_id_str, String
+  key :in_reply_to_screen_name, String
+  key :contributors, Array, :default => []
+  key :retweet_count, Integer, :default => 0, :required => true
+  key :favorited, Boolean, :default => false, :required => true
+  key :retweeted, Boolean, :default => false, :required => true
+  key :possibly_sensitive, Boolean, :default => false, :required => true
+  key :geo_id, ObjectId
+  key :coordinate_id, ObjectId
+  key :place_id, ObjectId
+  key :user_id, ObjectId
+  key :hashtag_ids, Array
+  key :url_ids, Array
+  key :user_mention_ids, Array
+  key :media_ids, Array
+  many :hashtags, :in => :hashtag_ids
+  many :urls, :in => :url_ids
+  many :user_mentions, :in => :user_mention_ids
+  many :media, :in => :media_ids
+  key :user_id, ObjectId
+  belongs_to :geo
+  belongs_to :coordinate
+  belongs_to :place
+  belongs_to :user
+
+  def self.example
+    {"entities"=>{"user_mentions"=>[], "urls"=>[{"display_url"=>"tehelka.com/story_main54.a...", "expanded_url"=>"http://www.tehelka.com/story_main54.asp?filename=Ws041212SPORTS.asp", "url"=>"http://t.co/uZmKgdkO", "indices"=>[120, 140]}], "hashtags"=>[]}, "text"=>"On the day Indian Olympics Association was suspended by IOC, Rahul Mehra says the move gives an opportunity to clean up http://t.co/uZmKgdkO", "retweet_count"=>2, "coordinates"=>nil, "possibly_sensitive"=>false, "in_reply_to_status_id_str"=>nil, "contributors"=>nil, "in_reply_to_user_id_str"=>nil, "id_str"=>"276035961274638336", "in_reply_to_screen_name"=>nil, "retweeted"=>false, "truncated"=>false, "created_at"=>"Tue Dec 04 18:51:16 +0000 2012", "geo"=>nil, "place"=>nil, "in_reply_to_status_id"=>nil, "favorited"=>false, "source"=>"web", "id"=>276035961274638336, "in_reply_to_user_id"=>nil}
+  end
+
+  def self.new_from_raw(tweet, user_id)
+    return if tweet.nil?
+    tweet = Hashie::Mash[tweet]
+    obj = self.new
+    obj.created_at                = tweet["created_at"]
+    obj.twitter_id                = tweet["id"]
+    obj.twitter_id_str            = tweet["id_str"]
+    obj.text                      = tweet["text"]
+    obj.source                    = tweet["source"]
+    obj.truncated                 = tweet["truncated"]
+    obj.in_reply_to_status_id     = tweet["in_reply_to_status_id"]
+    obj.in_reply_to_status_id_str = tweet["in_reply_to_status_id_str"]
+    obj.in_reply_to_user_id       = tweet["in_reply_to_user_id"]
+    obj.in_reply_to_user_id_str   = tweet["in_reply_to_user_id_str"]
+    obj.in_reply_to_screen_name   = tweet["in_reply_to_screen_name"]
+    obj.contributors              = tweet["contributors"]
+    obj.retweet_count             = tweet["retweet_count"]
+    obj.favorited                 = tweet["favorited"]
+    obj.retweeted                 = tweet["retweeted"]
+    obj.possibly_sensitive        = tweet["possibly_sensitive"]
+    tweet["twitter_id"]           = obj.twitter_id
+    if tweet["entities"]
+      tweet["entities"].each_pair do |entity_type, entities|
+        if entity_type == "media"
+          entities.each do |entity|
+            entity = Medium.new_from_raw(entity, obj._id)
+            obj.media << entity
+          end
+        elsif entity_type == "urls"
+          entities.each do |entity|
+            entity = Url.new_from_raw(entity, obj._id)
+            obj.urls << entity
+          end
+        elsif entity_type == "hashtags"
+          entities.each do |entity|
+            entity = Hashtag.new_from_raw(entity, obj._id)
+            obj.hashtags << entity
+          end
+        elsif entity_type == "user_mentions"
+          entities.each do |entity|
+            entity = UserMention.new_from_raw(entity, obj._id)
+            obj.user_mentions << entity
+          end
+        end
+      end
+    end
+    place = Place.new_from_raw(tweet["place"], obj._id)
+    if place
+      obj.place = place
+    end
+    geo = Geo.new_from_raw(tweet["geo"], obj._id)
+    if geo
+      obj.geo = geo
+    end
+    coordinate = Coordinate.new_from_raw(tweet["coordinate"], obj._id)
+    if coordinate
+      obj.coordinate = coordinate
+    end
+    obj.user_id = user_id
+    obj.save!
+    obj
+  end  
+  
+end

data/lib/oii_twitter_goodies/model/twitter_api_call.rb

@@ -0,0 +1,7 @@
+class TwitterAPICall
+  include MongoMapper::Document
+  key :url, String
+  key :data
+  key :params
+  timestamps!
+end

data/lib/oii_twitter_goodies/model/url.rb

@@ -0,0 +1,25 @@
+class Url
+  include MongoMapper::Document
+  key :url, String
+  key :expanded_url, String
+  key :display_url, String
+  key :indices, Array
+  key :tweet_id, ObjectId
+  belongs_to :tweet
+  
+  def self.example
+    {"display_url"=>"bit.ly/SKHqYj", "expanded_url"=>"http://bit.ly/SKHqYj", "url"=>"http://t.co/ZDfXBGCk", "indices"=>[97, 117]}
+  end
+  
+  def self.new_from_raw(url, tweet_id)
+    url = Hashie::Mash[url]
+    obj = self.new
+    obj.url          = url["url"]
+    obj.expanded_url = url["expanded_url"]
+    obj.display_url  = url["display_url"]
+    obj.indices      = url["indices"]
+    obj.tweet_id     = tweet_id
+    obj.save!
+    obj
+  end
+end

data/lib/oii_twitter_goodies/model/user.rb

@@ -0,0 +1,106 @@
+require_relative 'tweet'
+
+class User
+  include MongoMapper::Document
+  key :twitter_id, Integer, :required => true
+  key :twitter_id_str, String
+  key :name, String
+  key :screen_name, String, :required => true
+  key :location, String
+  key :url, String
+  key :description, String
+  key :protected, Boolean, :default => false, :required => true
+  key :followers_count, Integer, :default => 0, :required => true
+  key :friends_count, Integer, :default => 0, :required => true
+  key :listed_count, Integer, :default => 0, :required => true
+  key :created_at, Time, :required => true
+  key :favourites_count, Integer
+  key :utc_offset, Integer
+  key :time_zone, String
+  key :geo_enabled, Boolean, :default => false, :required => true
+  key :verified, Boolean, :default => false, :required => true
+  key :statuses_count, Integer, :default => 0, :required => true
+  key :lang, String
+  key :contributors_enabled, Boolean, :default => false, :required => true
+  key :is_translator, Boolean, :default => false, :required => true
+  key :profile_background_color, String, :default => "C0DEED", :required => true
+  key :profile_background_image_url, String
+  key :profile_background_image_url_https, String
+  key :profile_background_tile, Boolean, :default => false, :required => true
+  key :profile_image_url, String
+  key :profile_image_url_https, String
+  key :profile_link_color, String, :default => "0084B4", :required => true
+  key :profile_sidebar_border_color, String, :default => "C0DEED", :required => true
+  key :profile_sidebar_fill_color, String, :default => "DDEEF6", :required => true
+  key :profile_text_color, String, :default => "333333", :required => true
+  key :profile_use_background_image, Boolean, :default => true, :required => true
+  key :default_profile, Boolean, :default => false, :required => true
+  key :default_profile_image, Boolean, :default => false, :required => true
+  key :following, Boolean, :default => false, :required => true
+  key :follow_request_sent, Boolean, :default => false, :required => true
+  key :notifications, Boolean, :default => false, :required => true
+  key :tweet_ids, Array
+  many :tweets, :in => :tweet_ids
+  
+  def self.example
+    {"created_at"=>"Sat Dec 01 11:01:18 +0000 2012", "id"=>274830526970474496, "id_str"=>"274830526970474496", "text"=>"Getting ready for the #kingsofcode hack battle in Amsterdam! Just got off the plane, running on 2hrs sleep, so will see how this goes!", "source"=>"<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>", "truncated"=>false, "in_reply_to_status_id"=>nil, "in_reply_to_status_id_str"=>nil, "in_reply_to_user_id"=>nil, "in_reply_to_user_id_str"=>nil, "in_reply_to_screen_name"=>nil, "user"=>{"id"=>14447132, "id_str"=>"14447132", "name"=>"Aaron Parecki", "screen_name"=>"aaronpk", "location"=>"Portland, OR", "url"=>"http://aaronparecki.com/", "description"=>"CTO of @esri R&D Center, Portland. Creating my own reality.", "protected"=>false, "followers_count"=>1776, "friends_count"=>619, "listed_count"=>200, "created_at"=>"Sat Apr 19 22:38:15 +0000 2008", "favourites_count"=>1543, "utc_offset"=>-28800, "time_zone"=>"Pacific Time (US & Canada)", "geo_enabled"=>true, "verified"=>false, "statuses_count"=>4331, "lang"=>"en", "contributors_enabled"=>false, "is_translator"=>false, "profile_background_color"=>"7A9AAF", "profile_background_image_url"=>"http://a0.twimg.com/profile_background_images/185835062/4786064324_b7049fbec8_b.jpg", "profile_background_image_url_https"=>"https://si0.twimg.com/profile_background_images/185835062/4786064324_b7049fbec8_b.jpg", "profile_background_tile"=>true, "profile_image_url"=>"http://a0.twimg.com/profile_images/1767475493/aaronpk-glasses_normal.png", "profile_image_url_https"=>"https://si0.twimg.com/profile_images/1767475493/aaronpk-glasses_normal.png", "profile_link_color"=>"0000FF", "profile_sidebar_border_color"=>"87BC44", "profile_sidebar_fill_color"=>"94C8FF", "profile_text_color"=>"000000", "profile_use_background_image"=>true, "default_profile"=>false, "default_profile_image"=>false, "following"=>true, "follow_request_sent"=>false, "notifications"=>nil}, "geo"=>{"type"=>"Point", "coordinates"=>[52.37051453, 4.8930892]}, "coordinates"=>{"type"=>"Point", "coordinates"=>[4.8930892, 52.37051453]}, "place"=>{"id"=>"99cdab25eddd6bce", "url"=>"http://api.twitter.com/1/geo/id/99cdab25eddd6bce.json", "place_type"=>"city", "name"=>"Amsterdam", "full_name"=>"Amsterdam, North Holland", "country_code"=>"NL", "country"=>"The Netherlands", "bounding_box"=>{"type"=>"Polygon", "coordinates"=>[[[4.7289, 52.278227], [5.079207, 52.278227], [5.079207, 52.431229], [4.7289, 52.431229]]]}, "attributes"=>{}}, "contributors"=>nil, "retweet_count"=>0, "favorited"=>false, "retweeted"=>false}
+  end
+  
+  def self.new_from_raw(status)
+    status = Hashie::Mash[status]
+    obj = self.new
+    obj.twitter_id                         = status["user"].nil? ? status["id"]                                 : status["user"]["id"]
+    obj.twitter_id_str                     = status["user"].nil? ? status["id_str"]                             : status["user"]["id_str"]
+    obj.name                               = status["user"].nil? ? status["name"]                               : status["user"]["name"]
+    obj.screen_name                        = status["user"].nil? ? status["screen_name"]                        : status["user"]["screen_name"]
+    obj.location                           = status["user"].nil? ? status["location"]                           : status["user"]["location"]
+    obj.url                                = status["user"].nil? ? status["url"]                                : status["user"]["url"]
+    obj.description                        = status["user"].nil? ? status["description"]                        : status["user"]["description"]
+    obj.protected                          = status["user"].nil? ? status["protected"]                          : status["user"]["protected"]
+    obj.followers_count                    = status["user"].nil? ? status["followers_count"]                    : status["user"]["followers_count"]
+    obj.friends_count                      = status["user"].nil? ? status["friends_count"]                      : status["user"]["friends_count"]
+    obj.listed_count                       = status["user"].nil? ? status["listed_count"]                       : status["user"]["listed_count"]
+    obj.created_at                         = status["user"].nil? ? status["created_at"]                         : status["user"]["created_at"]
+    obj.favourites_count                   = status["user"].nil? ? status["favourites_count"]                   : status["user"]["favourites_count"]
+    obj.utc_offset                         = status["user"].nil? ? status["utc_offset"]                         : status["user"]["utc_offset"]
+    obj.time_zone                          = status["user"].nil? ? status["time_zone"]                          : status["user"]["time_zone"]
+    obj.geo_enabled                        = status["user"].nil? ? status["geo_enabled"]                        : status["user"]["geo_enabled"]
+    obj.verified                           = status["user"].nil? ? status["verified"]                           : status["user"]["verified"]
+    obj.statuses_count                     = status["user"].nil? ? status["statuses_count"]                     : status["user"]["statuses_count"]
+    obj.lang                               = status["user"].nil? ? status["lang"]                               : status["user"]["lang"]
+    obj.contributors_enabled               = status["user"].nil? ? status["contributors_enabled"]               : status["user"]["contributors_enabled"]
+    obj.is_translator                      = status["user"].nil? ? status["is_translator"]                      : status["user"]["is_translator"]
+    obj.profile_background_color           = status["user"].nil? ? status["profile_background_color"]           : status["user"]["profile_background_color"]
+    obj.profile_background_image_url       = status["user"].nil? ? status["profile_background_image_url"]       : status["user"]["profile_background_image_url"]
+    obj.profile_background_image_url_https = status["user"].nil? ? status["profile_background_image_url_https"] : status["user"]["profile_background_image_url_https"]
+    obj.profile_background_tile            = status["user"].nil? ? status["profile_background_tile"]            : status["user"]["profile_background_tile"]
+    obj.profile_image_url                  = status["user"].nil? ? status["profile_image_url"]                  : status["user"]["profile_image_url"]
+    obj.profile_image_url_https            = status["user"].nil? ? status["profile_image_url_https"]            : status["user"]["profile_image_url_https"]
+    obj.profile_link_color                 = status["user"].nil? ? status["profile_link_color"]                 : status["user"]["profile_link_color"]
+    obj.profile_sidebar_border_color       = status["user"].nil? ? status["profile_sidebar_border_color"]       : status["user"]["profile_sidebar_border_color"]
+    obj.profile_sidebar_fill_color         = status["user"].nil? ? status["profile_sidebar_fill_color"]         : status["user"]["profile_sidebar_fill_color"]
+    obj.profile_text_color                 = status["user"].nil? ? status["profile_text_color"]                 : status["user"]["profile_text_color"]
+    obj.profile_use_background_image       = status["user"].nil? ? status["profile_use_background_image"]       : status["user"]["profile_use_background_image"]
+    obj.default_profile                    = status["user"].nil? ? status["default_profile"]                    : status["user"]["default_profile"]
+    obj.default_profile_image              = status["user"].nil? ? status["default_profile_image"]              : status["user"]["default_profile_image"]
+    obj.following                          = status["user"].nil? ? status["following"]                          : status["user"]["following"]
+    obj.follow_request_sent                = status["user"].nil? ? status["follow_request_sent"]                : status["user"]["follow_request_sent"]
+    obj.notifications                      = status["user"].nil? ? status["notifications"]                      : status["user"]["notifications"]
+    if status["text"]
+      tweet = Tweet.new_from_raw(status, obj._id)
+      obj.tweets << tweet
+    end
+    if status["status"]
+      tweet = Tweet.new_from_raw(status["status"], obj._id)
+      obj.tweets << tweet
+    end
+    if status["statuses"]
+      status["statuses"].each do |status|
+        tweet = Tweet.new_from_raw(status, obj._id)
+        obj.tweets << tweet
+      end
+    end
+    obj.save!
+    obj
+  end
+end

data/lib/oii_twitter_goodies/model/user_mention.rb

@@ -0,0 +1,28 @@
+class UserMention
+  include MongoMapper::Document
+  key :screen_name, String
+  key :name, String
+  key :twitter_id, Integer
+  key :twitter_id_str, String
+  key :indices, Array
+  key :tweet_id, ObjectId
+  belongs_to :tweet
+  
+  def self.example
+    {"name"=>"film.culture360", "id_str"=>"211760188", "id"=>211760188, "indices"=>[3, 19], "screen_name"=>"film_culture360"}
+  end
+
+  def self.new_from_raw(entity, tweet_id)
+    entity = Hashie::Mash[entity]
+    obj                = self.new
+    obj.screen_name    = entity["screen_name"]
+    obj.name           = entity["name"]
+    obj.twitter_id     = entity["id"]
+    obj.twitter_id_str = entity["id_str"]
+    obj.indices        = entity["indices"]
+    obj.tweet_id = tweet_id
+    obj.save!
+    obj
+  end
+  
+end

data/lib/oii_twitter_goodies/version.rb

@@ -0,0 +1,3 @@
+module OIITwitterGoodies
+  VERSION = "0.0.2"
+end

data/lib/oii_twitter_goodies.rb

@@ -0,0 +1,20 @@
+require 'bundler'
+require 'mongo_mapper'
+require 'oauth'
+require 'twitter'
+require 'tweetstream'
+require 'hashie'
+require 'typhoeus'
+require 'json'
+
+require "oii_twitter_goodies/version"
+
+Dir[File.dirname(__FILE__) + '/oii_twitter_goodies/extensions/*.rb'].each {|file| require file }
+Dir[File.dirname(__FILE__) + '/oii_twitter_goodies/lib/*.rb'].each {|file| require file }
+Dir[File.dirname(__FILE__) + '/oii_twitter_goodies/model/*.rb'].each {|file| require file }
+
+
+
+module OIITwitterGoodies
+  # Your code goes here...
+end

data/oii_twitter_goodies.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'oii_twitter_goodies/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "oii_twitter_goodies"
+  gem.version       = OIITwitterGoodies::VERSION
+  gem.authors       = ["Devin Gaffney"]
+  gem.email         = ["itsme@devingaffney.com"]
+  gem.description   = %q{OII Twitter Goodies!}
+  gem.summary       = %q{Warm goopy Ruby code for people at OII (or anyone really) to quickly get their hands dirty with Twitter data}
+  gem.homepage      = "http://oii.ox.ac.uk"
+  gem.add_development_dependency "bundler", ">= 1.0.0"
+  gem.add_development_dependency "mongo_mapper"
+  gem.add_development_dependency "bcrypt-ruby"
+  gem.add_development_dependency "bson_ext"
+  gem.add_development_dependency "oauth"
+  gem.add_development_dependency "twitter"
+  gem.add_development_dependency "tweetstream"
+  gem.add_development_dependency "minitest"
+  gem.add_development_dependency "hashie"
+  gem.add_development_dependency "typhoeus"
+  gem.add_development_dependency "json"
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,231 @@
+--- !ruby/object:Gem::Specification
+name: oii_twitter_goodies
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Devin Gaffney
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: mongo_mapper
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bcrypt-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bson_ext
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: twitter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tweetstream
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: OII Twitter Goodies!
+email:
+- itsme@devingaffney.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .DS_Store
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/oii_twitter_goodies.rb
+- lib/oii_twitter_goodies/.DS_Store
+- lib/oii_twitter_goodies/extensions/twitter_api_utils.rb
+- lib/oii_twitter_goodies/extensions/twitter_client.rb
+- lib/oii_twitter_goodies/lib/followers_for_users.rb
+- lib/oii_twitter_goodies/lib/streamer.rb
+- lib/oii_twitter_goodies/model/.DS_Store
+- lib/oii_twitter_goodies/model/bounding_box.rb
+- lib/oii_twitter_goodies/model/coordinate.rb
+- lib/oii_twitter_goodies/model/edge.rb
+- lib/oii_twitter_goodies/model/egonet.rb
+- lib/oii_twitter_goodies/model/geo.rb
+- lib/oii_twitter_goodies/model/hashtag.rb
+- lib/oii_twitter_goodies/model/location.rb
+- lib/oii_twitter_goodies/model/media.rb
+- lib/oii_twitter_goodies/model/place.rb
+- lib/oii_twitter_goodies/model/place_attribute.rb
+- lib/oii_twitter_goodies/model/result.rb
+- lib/oii_twitter_goodies/model/sample.rb
+- lib/oii_twitter_goodies/model/size.rb
+- lib/oii_twitter_goodies/model/tweet.rb
+- lib/oii_twitter_goodies/model/twitter_api_call.rb
+- lib/oii_twitter_goodies/model/url.rb
+- lib/oii_twitter_goodies/model/user.rb
+- lib/oii_twitter_goodies/model/user_mention.rb
+- lib/oii_twitter_goodies/version.rb
+- oii_twitter_goodies.gemspec
+homepage: http://oii.ox.ac.uk
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Warm goopy Ruby code for people at OII (or anyone really) to quickly get
+  their hands dirty with Twitter data
+test_files: []