dbrady-twitterlost 0.0.3

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,44 @@
+#!/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/")
+
+# Make sure the dir exists
+FileUtils.mkdir_p(base_dir)
+
+cfg = YAML::load_file( File.join(base_dir, "twitter.yml") )
+
+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."
+
+puts lost_followers.map { |u| "LOST: #{u}" }
+puts new_followers.map { |u| "NEW: #{u}" }
+
+File.new(File.join(base_dir, "followers.txt"), "w").puts followers
+File.new(File.join(base_dir, "lost.txt"), "a").puts lost_followers if lost_followers.any?

data/twitter_sample.yml

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

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+name: dbrady-twitterlost
+version: !ruby/object:Gem::Version 
+  version: 0.0.3
+platform: ruby
+authors: 
+- David Brady
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-05 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mbbx6spp-twitter4r
+  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: false
+homepage: http://github.com/dbrady/twitterlost
+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.2.0
+signing_key: 
+specification_version: 2
+summary: Twitterlost - keep track of your twitter followers lost and gained
+test_files: []
+