twitterlost 0.0.5

data/MIT-LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2008 David Brady twitterlost@shinybit.com
+
+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

@@ -0,0 +1,59 @@
+README
+
+twitterlost is a command-line tool to keep track of your Twitter
+followers. Each time it runs it shows you the new and lost followers
+since the last time it ran.
+
+Description
+-----------
+
+Keep track of your twitter followers, see who has unfollowed
+you. Sadly it will not tell you why (but it was probably because of
+something you did).
+
+Installation
+------------
+
+1. Install the gem.
+
+2. mkdir ~/.twitterlost (or run twitterlost once and it will be
+   created for you)
+
+3. Edit ~/.twitterlost/twitter.yml with the following information:
+
+---
+:login: $USERNAME
+:password: $PASSWORD
+
+That's it. The first time you run twitterlost it will see all your
+followers as new; after that it will only report changes.
+
+License
+-------
+
+Twitterlost is released under the MIT license. Take it, play with it,
+do whatever you want with it, keep this version free.
+
+Motivation
+----------
+
+Why did I write Twitterlost? Because I think Twitterless.com is a good
+service wrapped around a brilliant idea, but I didn't want to give
+them my Twitter login and password. If you don't see a problem with
+giving them your login credentials, then by all means use their
+service; it's better than this hack. They'll send you regular email
+updates and such, where twitterlost has to be run by hand.
+
+Known Issues
+------------
+
+twitterlost uses the Twitter API to retrieve your list of
+friends. This is returned in chunks of 100. If you have more than 100
+followers, twitterlost must make multiple calls to Twitter. EACH CALL
+counts towards Twitter's 70-calls-per-hour limit. If you have many
+followers and are running a polling Twitter client, Twitter may slap
+you withan "overloaded" message. If this happens to twitterlost, it
+interprets this as the end of your friends list, which means it will
+report all those people as lost friends. They'll come back the next
+time you run twitterlost.
+

data/bin/twitterlost

@@ -0,0 +1,66 @@
+#!/usr/bin/env ruby
+# twitterlost--keep track of unsubscribed followers. Still just a 0.0.1 proof of concept. YMMV.
+# David Brady dbrady@shinybit.com http://twitter.com/chalain
+# 
+# TODO: Consider a sqlite database instead of flat files, track new/lost dates
+# TODO: Clean up ugly while loop
+
+# !!!IMPORTANT NOTE!!! requires twitter4r >= 0.3.1 and as of
+# 2008-10-11  rubyforge version is 0.3.0. Make sure you have github
+# gem sources, then gem install mbbx6spp-twitter4r
+require 'rubygems'
+require 'twitter'
+require 'yaml'
+
+base_dir = File.expand_path("~/.twitterlost/")
+yaml_file = File.join(base_dir, "twitter.yml")
+
+# Make sure the dir exists
+FileUtils.mkdir_p(base_dir)
+
+# Ensure twitter.yml exists; create default for user if not
+if File.exists?(yaml_file)
+  cfg = YAML::load_file( yaml_file )
+
+  old_followers = IO.readlines(File.join(base_dir, "followers.txt")).map {|line| line.strip }.sort rescue []
+
+  @client = Twitter::Client.new :login => cfg[:login], :password => cfg[:password] 
+
+  def followers_page(page)
+    @client.my :followers, :page => page
+  end
+
+  # Get all your followers. Loop is still kludgy.
+  p,f,followers=0,[],[]
+  followers += f.map { |u| u.screen_name } while (f=followers_page(p+=1)).any?
+  followers.sort!
+
+  lost_followers = old_followers - followers
+  new_followers = followers - old_followers
+
+  puts "You have #{followers.size} followers. Since the last time this program was run you lost #{lost_followers.size} followers and gained #{new_followers.size} new ones."
+
+  longest_lost, longest_new = lost_followers.map { |u| u.size }.max, new_followers.map { |u| u.size }.max
+  
+  puts lost_followers.map { |u| "LOST: %-#{longest_lost}s http://twitter.com/#{u}" % u}
+  puts new_followers.map { |u| "NEW: %-#{longest_new}s http://twitter.com/#{u}" % u}
+
+  File.new(File.join(base_dir, "followers.txt"), "w").puts followers.map {|f| "#{f}"}
+  File.new(File.join(base_dir, "lost.txt"), "a").puts lost_followers.map {|f| "#{f}"} if lost_followers.any?
+else
+  puts <<HELP
+Welcome to Twitterlost! I cannot find your twitter.yml file.
+
+I will write out a default file for you, but you will need to
+edit the file to contain your twitter username and password.
+
+Writing default file to #{yaml_file}...
+HELP
+
+  File.open(yaml_file, 'w') do |f|
+    f.puts '---'
+    f.puts ':login: USERNAME'
+    f.puts ':password: PASSWORD'
+  end
+end
+

data/twitter_sample.yml

@@ -0,0 +1,3 @@
+--- 
+:login: ACCOUNT_NAME
+:password: PASSWARD

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+name: twitterlost
+version: !ruby/object:Gem::Version 
+  version: 0.0.5
+platform: ruby
+authors: 
+- David Brady
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-05 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mbbx6spp-twitter4r
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.3.1
+    version: 
+description: Twitterlost - keep track of your twitter followers lost and gained
+email: github@shinybit.com
+executables: 
+- twitterlost
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- twitter_sample.yml
+- bin/twitterlost
+- README
+- MIT-LICENSE
+has_rdoc: true
+homepage: http://github.com/dbrady/twitterlost
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Twitterlost - keep track of your twitter followers lost and gained
+test_files: []
+