fxtwitter 0.1.0

data/History.txt

@@ -0,0 +1,13 @@
+=== 1.0.0 / 2008-03-15
+
+* 4 major enhancement
+
+  * Birthday!
+  * Read your friends' Tweets
+  * Post your own Tweets
+  * Character counter lets you know that your Tweet is short enough.
+
+* 1 major limitation
+
+  * No tests!
+

data/Manifest.txt

@@ -0,0 +1,7 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/fxtwitter
+lib/fxtwitter.rb
+test/test_fxtwitter.rb

data/README.txt

@@ -0,0 +1,56 @@
+= fxtwitter
+
+* http://projects.rubyforge.org/fxtwitte
+
+== DESCRIPTION:
+
+fxtwitter is a GUI client for the Twitter <http://twitter.com> system.
+It provides a simple interface comparable to many popular instant
+messaging chat clients.
+
+== FEATURES/PROBLEMS:
+
+* View the recent tweets of all your friends in a scrolled window
+* Post your own tweets
+
+== SYNOPSIS:
+
+The fxtwitter executable should be installed in a file on your path. Running
+the application after installation should be easy:
+
+    $ fxtwitter -u USERNAME -p PASSWORD
+
+== REQUIREMENTS:
+
+* Ruby (developed on 1.8.6)
+* Twitter4R (developed with 0.3.0)
+* FXRuby (developed with 1.6.13)
+
+== INSTALL:
+
+    $ sudo gem install fxtwitter
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Brian Wisti
+
+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/Rakefile

@@ -0,0 +1,13 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/fxtwitter.rb'
+
+Hoe.new('fxtwitter', FxTwitter::VERSION) do |p|
+  p.developer('Brian Wisti', 'brianwisti@rubyforge.org')
+  p.extra_deps << [ 'fxruby' ]
+  p.extra_deps << [ 'twitter4r' ]
+end
+
+# vim: syntax=Ruby

data/bin/fxtwitter

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'fxtwitter'
+
+FxTwitter.main()
+
+#vim:set filetype=ruby

data/lib/fxtwitter.rb

@@ -0,0 +1,187 @@
+require 'rubygems'
+require 'cgi'
+require 'fox16'
+require 'fox16/colors'
+require 'time'
+require 'twitter'
+
+include Fox
+
+class FxTwitter
+  VERSION = '0.1.0'
+  TWEET_LENGTH = 140 # Twitter allows this many characters at most.
+
+  # The primary user interface for fxtwitter
+  class TwitterWindow < Fox::FXMainWindow
+    include Fox
+    def initialize(app, username, password)
+      super(app, "fxtwitter", nil, nil, 
+            :opts  => DECOR_TITLE |  DECOR_CLOSE | DECOR_RESIZE, 
+            :width => 480)
+      @username = username
+      @password = password
+        
+      # Put together UI elements
+      @tweet_display = FXText.new(self,
+                                   :opts => LAYOUT_FIX_WIDTH | LAYOUT_FIX_HEIGHT | 
+                                           LAYOUT_FILL_X | LAYOUT_FILL_Y |
+                                           TEXT_READONLY | TEXT_WORDWRAP,
+                                   :width => 480, :height => 200)
+
+      @control_frame = FXHorizontalFrame.new(self)
+      @quit_btn      = FXButton.new(@control_frame, "Quit")
+      @refresh_btn   = FXButton.new(@control_frame, "Refresh")
+      @post_btn      = FXButton.new(@control_frame, "Post")
+      FXHorizontalSeparator.new(@control_frame)
+      @length_lbl    = FXLabel.new(@control_frame, TWEET_LENGTH.to_s)
+      @twitter_input = FXTextField.new(self, 80,
+                                       :opts => LAYOUT_FILL_X | TEXTFIELD_ENTER_ONLY,
+                                       :width => 450)
+      @status_line   = FXStatusLine.new(self)
+      @status_line.normalText = "fxtwitter"
+
+      @post_btn.connect(SEL_COMMAND) do |sender, selector, data|
+        post_tweet()
+      end
+
+      @quit_btn.connect(SEL_COMMAND) do |sender, selecter, data|
+        quit_application()
+      end
+
+      @refresh_btn.connect(SEL_COMMAND) do |sender, selector, data|
+        update_tweets()
+      end
+
+      @twitter_input.connect(SEL_CHANGED) do |sender, selector, data|
+        @length_lbl.text = (TWEET_LENGTH - data.length).to_s
+      end
+
+      @twitter_input.connect(SEL_COMMAND) do |sender, selector, data|
+        post_tweet()
+      end
+
+      # Set up text styles for the twitter display
+      name_style = FXHiliteStyle.from_text(@tweet_display)
+      name_style.style = FXText::STYLE_BOLD
+      time_style = FXHiliteStyle.from_text(@tweet_display)
+      time_style.normalForeColor = FXColor::MidnightBlue
+      @tweet_display.styled = true
+      @tweet_display.hiliteStyles = [ name_style, time_style ]
+
+      # TODO: Replace global constant with config and/or user input.
+      @tweets_updated_at = nil
+      @tweets = []
+    end
+
+    # Opens a validated connection to the Twitter service.
+    def connect_to_twitter(login, password)
+      @status_line.text = "Connecting #{login} to Twitter"
+      return Twitter::Client.new(:login => login, :password => password)
+    end
+
+    # Part of the GUI construction code
+    def create()
+      super
+      show(PLACEMENT_SCREEN)
+      setup_twitter()
+    end
+
+    # Submit user text from twitter_input
+    def post_tweet()
+      tweet_text = @twitter_input.text
+      if tweet_text.length > 0 then
+        if tweet_text.length <= TWEET_LENGTH then
+          @status_line.text = "Posting Tweet..."
+          status = Twitter::Status.create(:text => tweet_text, 
+                                          :client => @twitter)
+          @twitter_input.text = ""
+          @length_lbl.text = TWEET_LENGTH.to_s
+        else
+          message = "Your Tweet must have #{TWEET_LENGTH} or less characters"
+          FXMessageBox.warning(self, MBOX_OK, "Tweet too long!", message)
+        end
+      end
+    end
+
+    # Perform any needed cleanup and exit
+    def quit_application()
+      exit
+    end
+
+    def setup_twitter()
+      if @username and @password then
+        @twitter = connect_to_twitter(@username, @password)
+        update_tweets()
+
+        # Check for new Tweets every minute
+        timeout_duration = 60 * 1000
+        @refresh_timeout = app.addTimeout(timeout_duration, :repeat => true) do |sender, selector, data|
+          update_tweets()
+        end
+      else
+        # TODO: Login view
+        raise "Username and password required. fxtwitter --help for usage"
+      end
+    end
+
+    def update_tweets()
+      this_load = Time.now
+      @status_line.text = "#{this_load}: Updating Tweets..."
+      begin
+        if @tweets and @tweets_updated_at then
+          tweets = @twitter.timeline_for(:friends, :since => @tweets_updated_at)
+          @tweets_updated_at = Time.now
+        else
+          tweets = @twitter.timeline_for(:friends)
+          @tweets_updated_at = this_load
+        end
+      rescue Twitter::RESTError => e
+        if e.message == "Not Modified" then
+          @status_line.normalText = "#{this_load}: No new Tweets"
+          return
+        else
+          raise e
+        end
+      end
+      @tweets = tweets
+      @tweets_updated_at = this_load
+      @status_line.normalText = "#{@tweets_updated_at}: #{@tweets.length} new Tweets"
+
+      # Now that we have new Tweets, display them.
+      @tweets.reverse.each do |tweet|
+        created_at = tweet.created_at.strftime("%I:%M %p")
+        screen_name = CGI::unescapeHTML(tweet.user.screen_name)
+        text = ": #{CGI::unescapeHTML(tweet.text)} -- "
+        @tweet_display.appendStyledText(screen_name, 1)
+        @tweet_display.appendText(text)
+        @tweet_display.appendStyledText(created_at, 2)
+        @tweet_display.appendStyledText("\n")
+        @tweet_display.makePositionVisible(@tweet_display.cursorPos)
+      end
+    end
+
+  end
+
+  # Runs the fxtwitter application.
+  def FxTwitter.main()
+    require 'optparse'
+    login = nil
+    password = nil
+    opts = OptionParser.new
+    opts.on("-u", "--user USERNAME", "Twitter account name", String) { |val| login = val }
+    opts.on("-p", "--password PASSWORD", "Twitter account password", String) { |val| password = val }
+    opts.on("-h", "--help", "Show usage") { |val| puts opts.to_s; exit }
+    opts.parse(ARGV)
+
+    unless login and password
+      puts "Username and password required in this version of fxtwitter"
+      print opts.to_s
+      exit
+    end
+
+    application = FXApp.new
+    main_window = TwitterWindow.new(application, login, password)
+    application.create()
+    application.run()
+  end
+end

data/test/test_fxtwitter.rb

@@ -0,0 +1,3 @@
+# No tests yet!
+# (How *do* I test a GUI?)
+

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: fxtwitter
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Brian Wisti
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-03-16 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: fxruby
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: twitter4r
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.5.1
+    version: 
+description: fxtwitter is a GUI client for the Twitter <http://twitter.com> system. It provides a simple interface comparable to many popular instant messaging chat clients.
+email: 
+- brianwisti@rubyforge.org
+executables: 
+- fxtwitter
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/fxtwitter
+- lib/fxtwitter.rb
+- test/test_fxtwitter.rb
+has_rdoc: true
+homepage: http://projects.rubyforge.org/fxtwitte
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: fxtwitter
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: fxtwitter is a GUI client for the Twitter <http://twitter.com> system
+test_files: 
+- test/test_fxtwitter.rb