tweetline 0.0.3 → 0.0.4

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Anthony Crumley
+
+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.rdoc

@@ -0,0 +1,39 @@
+This is the initial proof of concept for a twitter command line tool.  Now that I understand the problem, I am currently in the process of writing a more robust implementation.
+
+== Getting Started
+
+1. Install Tweetline at the command prompt if you haven't yet:
+
+    gem install tweetline
+
+2. Until Twitter approves xAuth for Tweetline, you will have to create a ~/.tweetlinerc yaml file with your authentication credentials like the following...
+
+    :consumer_key: "your-key"
+    :consumer_secret: "your-secret"
+    :oauth_token: "your-token"
+    :oauth_token_secret: "your-secret"
+
+3. Enter commands with tl:
+
+    tl ls
+
+    ESV Daily Verse (@esvdaily) [04:46 AM]
+         A friend loves at all times, and a brother is born for adversity. http://esv.to/Pr17.17 (54842265859915777)
+
+    DHH (@dhh) [04/02/11 11:43 AM]
+         I've tried many answers for "what do you get out of working on open source?", but the truth is the act of creation is its own reward. (54222543829213184)
+
+== Tasks
+
+  tl cat [ID]                # Display the details of a tweet with responses based on twitter id or piped in tweets.
+  tl follow [SCREEN_NAME]    # Follows the twitter user based on their screen name or piped in tweets.
+  tl help [TASK]             # Describe available tasks or one specific task
+  tl json                    # Lists tweets from the timeline in JSON format.
+  tl ls [SCREEN_NAME]        # Lists tweets from the timeline.
+  tl retweet [ID]            # Retweets the tweet by the Twitter id or a group of piped in tweets.
+  tl rm [ID]                 # Removes the tweet by it's id or a list of piped in tweets.
+  tl say                     # Speaks the tweet at the top of your timeline.
+  tl tail                    # Displays recent tweets in chronological order.
+  tl unfollow [SCREEN_NAME]  # Unfollows the twitter user based on their screen name or piped in tweets.
+  tl update STATUS           # Updates your current Twitter status.
+  tl yaml                    # Lists tweets from the timeline in YAML format.

data/bin/tl

@@ -1,7 +1,7 @@
 #!/usr/bin/ruby
 
 require 'rubygems'
-require 'lib/tweetline'
-require 'lib/tweetline/cli'
+require 'tweetline'
+require 'tweetline/cli'
 
 Tweetline::CLI.start

data/lib/tweetline/cli.rb

@@ -0,0 +1,146 @@
+module Tweetline
+  class CLI < Thor
+    def initialize(*)
+      super
+      Tweetline.configure_twitter
+      Tweetline.configure_pipes
+    end
+
+    default_task :ls
+
+    desc "cat [ID]", "Display the details of a tweet with responses based on twitter id or piped in tweets."
+    def cat(twitter_id = "")
+      if twitter_id.strip.length > 0
+        tweet = Twitter.status(ARGV[1])
+        Tweetline.cat_tweet(tweet.id, tweet.created_at, tweet.user.name, tweet.user.screen_name, tweet.text)
+      else
+        Tweetline.each_tweet do |tweet|
+          Tweetline.cat_tweet(tweet["id"], tweet["created_at"], tweet["name"], tweet["screen_name"], tweet["text"])
+        end
+      end
+    end
+  
+    desc "follow [SCREEN_NAME]", "Follows the twitter user based on their screen name or piped in tweets."
+    def follow(screen_name = "")
+      if screen_name.strip.length > 0
+        Twitter.follow(screen_name) 
+      else
+        Tweetline.each_tweet do |tweet|
+          Twitter.follow(tweet["screen_name"])
+          puts "Followed -> #{tweet["screen_name"]}" unless Twitter.is_piped_to_tweetline?
+        end
+      end
+    end
+
+    desc "json", "Lists tweets from the timeline in JSON format."
+    def json
+      Tweetline.each_tweet do |tweet|
+        puts tweet.to_json
+      end
+    end
+
+    desc "ls [SCREEN_NAME]", "Lists tweets from the timeline."
+    def ls(screen_name = "")
+      options = {:count => 10}
+      options[:screen_name] = screen_name if screen_name.strip.length > 0
+      Tweetline.each_tweet(options) do |tweet|
+        Tweetline.put_tweet(tweet["id"], tweet["created_at"], tweet["name"], tweet["screen_name"], tweet["text"])
+      end
+    end
+
+    desc "raw", "Raw output for testing."
+    def raw
+      STDIN.each do |text|
+        puts text
+      end
+    end
+
+    desc "retweet [ID]", "Retweets the tweet by the Twitter id or a group of piped in tweets."
+    def retweet(twitter_id = "")
+      if twitter_id.strip.length > 0
+        Twitter.retweet(twitter_id)
+      else
+        Tweetline.each_tweet do |tweet|
+          Twitter.retweet(tweet["id"])
+          puts "Retweeted:" unless Twitter.is_piped_to_tweetline?
+          Twitter.put_tweet(tweet["id"], tweet["created_at"], tweet["name"], tweet["screen_name"], tweet["text"])
+        end
+      end
+    end
+
+    desc "rm [ID]", "Removes the tweet by it's id or a list of piped in tweets."
+    def rm(twitter_id = "")
+      if twitter_id.strip.length > 0
+        Twitter.status_destroy(twitter_id)
+      else
+        Tweetline.each_tweet do |tweet|
+          Twitter.status_destroy(tweet["id"])
+          puts "Removed:" unless Twitter.is_piped_to_tweetline?
+          Twitter.put_tweet(tweet["id"], tweet["created_at"], tweet["name"], tweet["screen_name"], tweet["text"])
+        end
+      end
+    end
+
+    desc "say", "Speaks the tweet at the top of your timeline."
+    def say
+      Tweetline.each_tweet(:count => 1) do |tweet|
+        Tweetline.say_tweet(tweet["id"], tweet["created_at"], tweet["name"], tweet["screen_name"], tweet["text"])
+      end
+    end
+
+    desc "tail", "Displays recent tweets in chronological order."
+    method_option :follow, :type => :boolean, :aliases => "-f", :defatul => false, :banner => "Continue following tweets as they are added."
+    method_option :number, :type => :numeric, :aliases => "-n", :default => 10, :banner => "Specifies the number of tweets to display."
+    def tail
+      opts = options.dup
+
+      Signal.trap("SIGINT") do
+        exit!
+      end
+
+      previous_id = "1"
+      begin
+	tweets = Twitter.home_timeline(:count => opts[:number], :since_id => previous_id) rescue []
+        tweets.reverse_each do |tweet|
+          Tweetline.put_tweet(tweet.id, tweet.created_at, tweet.user.name, tweet.user.screen_name, tweet.text)
+          previous_id = tweet.id
+        end
+
+	sleep(30) if opts[:follow]
+
+      end while opts[:follow]
+    end
+
+    desc "unfollow [SCREEN_NAME]", "Unfollows the twitter user based on their screen name or piped in tweets."
+    def unfollow(screen_name = "")
+      if screen_name.strip.length > 0
+        Twitter.unfollow(screen_name) 
+      else
+        Tweetline.each_tweet do |tweet|
+          Twitter.unfollow(tweet["screen_name"])
+          puts "Followed -> #{tweet["screen_name"]}" unless Twitter.is_piped_to_tweetline?
+        end
+      end
+    end
+
+    desc "update STATUS", "Updates your current Twitter status."
+    def update(status)
+      if status.length > 140
+        puts ""
+        puts "This status is too long."
+	puts ""
+	puts "     #{status[0..139]}"
+	puts ""
+      else
+        Twitter.update(status)
+      end
+    end
+
+    desc "yaml", "Lists tweets from the timeline in YAML format."
+    def yaml
+      Tweetline.each_tweet do |tweet|
+        puts tweet.to_yaml
+      end
+    end
+  end
+end

data/lib/tweetline.rb

@@ -0,0 +1,82 @@
+require 'thor'
+require 'twitter'
+require 'json'
+
+module Tweetline
+  class << self
+	  
+    def cat_tweet(tweet_id, created_at, name, screen_name, text)
+      Tweetline.put_tweet(tweet_id, created_at, name, screen_name, text)
+      
+      tweet = Twitter.status(tweet_id)
+      puts "Conversation:", "" if tweet.in_reply_to_status_id
+      while tweet.in_reply_to_status_id
+        tweet = Twitter.status(tweet.in_reply_to_status_id)
+        Tweetline.put_tweet(tweet.id, tweet.created_at, tweet.user.name, tweet.user.screen_name, tweet.text)
+      end
+    end
+
+    def configure_twitter
+      Twitter.configure do |config|
+        File.open(File.expand_path('~/.tweetlinerc')) do |yaml|
+          options = YAML.load(yaml)
+          config.consumer_key = options[:consumer_key]
+          config.consumer_secret = options[:consumer_secret]
+          config.oauth_token = options[:oauth_token]
+          config.oauth_token_secret = options[:oauth_token_secret]
+        end
+      end
+    end
+
+    def configure_pipes
+      STDOUT.sync = true
+    end
+
+    def each_tweet(options={:count => 10})
+      if STDIN.fcntl(Fcntl::F_GETFL, 0) == 0
+        STDIN.each do |line|
+          yield JSON.load(line)
+        end
+      else
+        if options[:screen_name]
+          screen_name = options.delete(:screen_name)
+          timeline = Twitter.user_timeline(screen_name, options)
+        else
+          timeline = Twitter.home_timeline(options)
+        end
+        timeline.each do |tweet|
+          yield({"id" => tweet.id, "created_at" => tweet.created_at, "name" => tweet.user.name, "screen_name" => tweet.user.screen_name, "text" => tweet.text})
+        end
+      end
+    end
+
+    def is_piped_to_tweetline?
+      @is_piped_to_tweetline |= `ps -ax -o pid,args | grep -E "^[ ]*#{Process.pid+1}"` =~ /\/tl[^\/]*$/
+    end
+
+    def put_tweet(tweet_id, created_at, name, screen_name, text)
+      if STDOUT.fcntl(Fcntl::F_GETFL, 0) == 1 and Tweetline.is_piped_to_tweetline?
+        puts({"id" => tweet_id, "created_at" => created_at, "name" => name, "screen_name" => screen_name, "text" => text}.to_json)
+      else
+        puts "#{name} (@#{screen_name}) [#{time_stamp(created_at)}]", "     #{text} (#{tweet_id})", ""
+      end
+    end
+    
+    def say_tweet(tweet_id, created_at, name, screen_name, text)
+      tweet_text = text.strip.gsub(/http:.*?( |$)/, '').gsub(/^RT/, '').gsub(/@/, '').split(/ /).map{|s| s.gsub(/[^A-Za-z0-9.!?,']/, '')}.join(' ')
+      connector = text.strip =~ /^RT/ ? " retweets " : "says"
+      # puts name, "     #{connector} #{tweet_text}", ""
+      Tweetline.put_tweet(tweet_id, created_at, name, screen_name, text)
+      `say #{name} #{connector} "#{tweet_text}"`
+    end
+
+    def time_stamp(time)
+      time = Time.parse(time)
+      format = '%I:%M %p'
+      format = '%m/%d/%y ' + format unless time.yday == Time.now.yday
+    
+      return time.strftime(format)
+    end
+    
+  end
+end

data/tweetline.gemspec

@@ -0,0 +1,27 @@
+Gem::Specification.new do |s|
+  s.platform = Gem::Platform::RUBY
+  s.name = "tweetline"
+  s.version = "0.0.4"
+  s.summary = "Command line client for Twitter."
+  s.description = "Tweetline is a command line Twitter client for those who can't imagine a better interface to anything than the command line.  Also, some folks may find it useful for automating Twitter interactions."
+
+  s.required_ruby_version = ">= 1.8.7"
+  s.required_rubygems_version = ">= 1.3.6"
+
+  s.author = "Anthony Crumley"
+  s.email = "anthony.crumley@gmail.com"
+  s.homepage = "https://github.com/craftycode/tweetline"
+  s.rubyforge_project = "tweetline"
+
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {test}/*`.split("\n")
+  
+  s.bindir = "bin"
+  s.executables = ["tl"]
+  s.default_executable = "tl"
+  s.require_paths = ['lib']
+
+  s.add_dependency('twitter', '~> 1.2.0')
+  s.add_dependency('json', '~> 1.5.1')
+  s.add_dependency('thor', '~> 0.14.6')
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: tweetline
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 23
   prerelease: false
   segments: 
   - 0
   - 0
-  - 3
-  version: 0.0.3
+  - 4
+  version: 0.0.4
 platform: ruby
 authors: 
 - Anthony Crumley
@@ -75,7 +75,13 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
+- .gitignore
+- MIT-LICENSE
+- README.rdoc
 - bin/tl
+- lib/tweetline.rb
+- lib/tweetline/cli.rb
+- tweetline.gemspec
 has_rdoc: true
 homepage: https://github.com/craftycode/tweetline
 licenses: []