rad 0.2.9 → 0.3.0

data/History.txt

@@ -1,3 +1,8 @@
+== 0.3.0 2008-09-22
+* Pushing to rubyforge.. 
+	- added rad install arduino
+	- added rad test arduino
+
 == 0.2.5 2008-07-21
 * 1ish large post Bastille Day update:
 	- added i2c capability

data/Manifest.txt

@@ -37,6 +37,7 @@ lib/examples/motor_knob.rb
 lib/examples/servo_buttons.rb
 lib/examples/servo_calibrate_continuous.rb
 lib/examples/servo_throttle.rb
+lib/examples/software_serial.rb
 lib/examples/sparkfun_lcd.rb
 lib/examples/spectra_soft_pot.rb
 lib/examples/times_method.rb
@@ -104,6 +105,7 @@ lib/rad/generators/makefile/makefile.erb
 lib/rad/generators/makefile/makefile.rb
 lib/rad/hardware_library.rb
 lib/rad/init.rb
+lib/rad/progressbar.rb
 lib/rad/rad_processor.rb
 lib/rad/rad_rewriter.rb
 lib/rad/rad_type_checker.rb
@@ -123,6 +125,8 @@ spec/models/sketch_compiler_spec.rb
 spec/models/spec_helper.rb
 spec/sim/hello_world_spec.rb
 spec/spec.opts
+test/hello_world_test/Makefile
+test/hello_world_test/hello_world.cpp
 test/test_array_processing.rb
 test/test_plugin_loading.rb
 test/test_translation_post_processing.rb

data/bin/rad

@@ -9,8 +9,11 @@ end
 require 'optparse'
 require 'fileutils'
 require 'yaml'
+require 'open-uri'
+require 'readline'
 
 require File.expand_path(File.dirname(__FILE__)) + "/../lib/rad/version.rb"
+require File.expand_path(File.dirname(__FILE__)) + "/../lib/rad/progressbar.rb"
 
 class OptionParser #:nodoc:
     
@@ -23,7 +26,7 @@ class OptionParser #:nodoc:
                 "physical_reset"   => false
                 },
                 "software" => {
-                  "arduino_root"   => "/Applications/arduino-0011"
+                  "arduino_root"   => "/Applications/arduino-0012"
                  }
                }
     
@@ -90,158 +93,218 @@ end
 # 
 
 
-# Handle options:
-options, parser = OptionParser.parse(ARGV)
-sketch_name = ARGV[0]
-parser.parse!(["-h"]) unless sketch_name 
+if ARGV[0] == "install"
+  raise "Sorry. Can only install Arduino on Mac OS X. See here for Linux instructions: http://www.arduino.cc/playground/Learning/Linux" unless RUBY_PLATFORM =~ /darwin/
+  puts "Downloading arduino-0012 for Mac from Arduino.cc"
+  File.open("/Applications/arduino-0012.zip", "w") do |file|
+    pbar = nil
+    file << open("http://www.arduino.cc/files/arduino-0012-mac.zip",
+    :content_length_proc => lambda {|t|
+      if t && 0 < t
+        pbar = ProgressBar.new(" Progress", t)
+        pbar.file_transfer_mode
+      end
+    },
+    :progress_proc => lambda {|s|
+      pbar.set s if pbar
+    }).read
+    pbar.finish
+  end
+  puts "Unzipping..."
+  `cd /Applications; unzip arduino-0012.zip`
+  `rm /Applications/arduino-0012.zip`
+  puts "installed Arduino here: /Applications/arduino-0012"
+elsif ARGV[0] == "test"
+  test_dir = File.expand_path(File.dirname(__FILE__)) + "/../test/hello_world_test"
+  puts "Compiling hello_world.cpp to test your Arduino."
+  puts "cd #{test_dir}; make depend; make;"
+  `cd #{test_dir}; make depend; make;`
+  puts
+  puts "Compilation successful."
+  puts
+  puts "Make sure your Arduino is connected and then hit return."
+  Readline::readline('')
   
-
-# Build vendor/rad:  
+  `cd #{test_dir}; make upload`
   
-FileUtils.mkdir_p "#{sketch_name}/vendor/rad"
-puts "Successfully created your sketch directory."
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/rad/.", "#{sketch_name}/vendor/rad"
-puts "Installed RAD into #{sketch_name}/vendor/rad"
-puts
-
-# Build vendor/libraries:  
-
-FileUtils.mkdir_p "#{sketch_name}/vendor/libraries"
-puts "Successfully created your libraries directory."
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/AF_XPort/.", "#{sketch_name}/vendor/libraries/AF_XPort"
-puts "Installed AF_XPort into #{sketch_name}/vendor/libraries"
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/AFSoftSerial/.", "#{sketch_name}/vendor/libraries/AFSoftSerial"
-puts "Installed AFSoftSerial into #{sketch_name}/vendor/libraries"
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/DS1307/.", "#{sketch_name}/vendor/libraries/DS1307"
-puts "Installed DS1307 into #{sketch_name}/vendor/libraries"
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/FrequencyTimer2/.", "#{sketch_name}/vendor/libraries/FrequencyTimer2"
-puts "Installed FrequencyTimer2 into #{sketch_name}/vendor/libraries"
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/I2CEEPROM/.", "#{sketch_name}/vendor/libraries/I2CEEPROM" 
-puts "Installed I2CEEPROM into #{sketch_name}/vendor/libraries" 
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/LoopTimer/.", "#{sketch_name}/vendor/libraries/LoopTimer" 
-puts "Installed LoopTimer into #{sketch_name}/vendor/libraries" 
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/OneWire/.", "#{sketch_name}/vendor/libraries/OneWire"
-puts "Installed OneWire into #{sketch_name}/vendor/libraries"
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/Servo/.", "#{sketch_name}/vendor/libraries/Servo"
-puts "Installed Servo into #{sketch_name}/vendor/libraries"
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/Stepper/.", "#{sketch_name}/vendor/libraries/Stepper"
-puts "Installed Stepper into #{sketch_name}/vendor/libraries"
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/SWSerLCDpa/.", "#{sketch_name}/vendor/libraries/SWSerLCDpa"
-puts "Installed SWSerLCDpa into #{sketch_name}/vendor/libraries"
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/SWSerLCDsf/.", "#{sketch_name}/vendor/libraries/SWSerLCDsf"
-puts "Installed SWSerLCDsf into #{sketch_name}/vendor/libraries"
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/Wire/.", "#{sketch_name}/vendor/libraries/Wire"
-puts "Installed Wire into #{sketch_name}/vendor/libraries"
-puts
-
-# Build examples -- used for basic testing
-
-FileUtils.mkdir_p "#{sketch_name}/vendor/libraries"
-puts "Successfully created your examples directory."
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/examples/.", "#{sketch_name}/examples"
-puts "Installed examples into #{sketch_name}/examples"
-puts
-
-# Build test -- used testing
-
-# FIXME: this should put the tests into the vendor/tests directory instead.
- 
-# FileUtils.mkdir_p "#{sketch_name}/test"
-# puts "Successfully created your test directory."
-# 
-# FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/test/.", "#{sketch_name}/test"
-# puts "Installed tests into #{sketch_name}/test"
-# puts
-
-# Build vendor/plugins:  
-
-FileUtils.mkdir_p "#{sketch_name}/vendor/plugins"
-puts "Successfully created your plugins directory."
-puts
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/plugins/.", "#{sketch_name}/vendor/plugins"
-puts "Installed Default plugins into #{sketch_name}/vendor/plugins"
-puts
-
-# Add an default sketch directory # needed to run test:compile
-
-FileUtils.mkdir_p "#{sketch_name}/#{sketch_name}"
-puts "Successfully created your default sketch directory."
-puts
-
-# Copy the README how_to to the sketch directory
-
-FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/rad/README.rdoc", "#{sketch_name}"
-puts "Copied README how_to into #{sketch_name}"
-puts
-
-
-# Build sketch files, etc.:  
-
-FileUtils.touch "#{sketch_name}/#{sketch_name}.rb"
-File.open("#{sketch_name}/#{sketch_name}.rb", "w") do |file|
-  file << <<-EOS
-class #{sketch_name.split("_").collect{|c| c.capitalize}.join("")} < ArduinoSketch
-  
-  # looking for hints?  check out the examples directory
-  # example sketches can be uploaded to your arduino with
-  # rake make:upload sketch=examples/hello_world
-  # just replace hello_world with other examples
-  
-    def loop
-     # your code here
-    end
+  # find the USB port to make sure the Arduino's actually plugged in
+  options, parser = OptionParser.parse(ARGV)
+  usb_port = options["hardware"]["serial_port"]
+  port_name = usb_port.split("/").last
+  port_dir = usb_port.split("/")[0..(usb_port.split("/").length-2)].join("/")
+  unless `ls #{port_dir}`.split(/\n/).any?{|d| d.match(/#{port_name}/)}
+    puts
+    puts "******************************************************"
+    puts "*** It looks like your Arduino is not plugged in.  ***"
+    puts "***        Plug it in and try again.               ***"
+    puts "***                                                ***"
+    puts "***   NOTE: If your usb port is not /dev/tty.usb*  ***"
+    puts "***  pass it in to this script with the -p option. ***"
+    puts "******************************************************"
+  else 
+    puts
+    puts "******************************************************"
+    puts "***                 Success!                       ***"
+    puts "***  If your Arduino's light starts blinking soon, ***"
+    puts "***     then your Arduino environment is           ***"
+    puts "***          correctly configured.                 ***"
+    puts "***                                                ***"
+    puts "*** Otherwise something is not hooked up properly. ***"
+    puts "******************************************************"
+  end
+  puts
+  puts "cleaning up..."
+  `rm #{test_dir}/hello_world.hex #{test_dir}/core.a #{test_dir}/hello_world.elf`
+else
+  # Handle options:
+  options, parser = OptionParser.parse(ARGV)
+  sketch_name = ARGV[0]
+  parser.parse!(["-h"]) unless sketch_name 
     
-end
-  EOS
-end
-puts "Added #{sketch_name}/#{sketch_name}.rb"
-
-File.open("#{sketch_name}/Rakefile", 'w') do |file|
-  file << <<-EOS 
-require 'vendor/rad/init.rb'
-  EOS
-end
-puts "Added #{sketch_name}/Rakefile"
-
-FileUtils.mkdir_p "#{sketch_name}/config"
-puts "Added #{sketch_name}/config"
-
-File.open("#{sketch_name}/config/hardware.yml", 'w') do |file|
-  file << options["hardware"].to_yaml
-end
-puts "Added #{sketch_name}/config/hardware.yml"
-
-File.open("#{sketch_name}/config/software.yml", 'w') do |file|
-  file << options["software"].to_yaml
-end
-puts "Added #{sketch_name}/config/software.yml"
+  
+  # Build vendor/rad:  
+    
+  FileUtils.mkdir_p "#{sketch_name}/vendor/rad"
+  puts "Successfully created your sketch directory."
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/rad/.", "#{sketch_name}/vendor/rad"
+  puts "Installed RAD into #{sketch_name}/vendor/rad"
+  puts
+  
+  # Build vendor/libraries:  
+  
+  FileUtils.mkdir_p "#{sketch_name}/vendor/libraries"
+  puts "Successfully created your libraries directory."
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/AF_XPort/.", "#{sketch_name}/vendor/libraries/AF_XPort"
+  puts "Installed AF_XPort into #{sketch_name}/vendor/libraries"
+  puts
 
-puts
-puts "Run 'rake -T' inside your sketch dir to learn how to compile and upload it."
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/AFSoftSerial/.", "#{sketch_name}/vendor/libraries/AFSoftSerial"
+  puts "Installed AFSoftSerial into #{sketch_name}/vendor/libraries"
+  puts
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/DS1307/.", "#{sketch_name}/vendor/libraries/DS1307"
+  puts "Installed DS1307 into #{sketch_name}/vendor/libraries"
+  puts
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/FrequencyTimer2/.", "#{sketch_name}/vendor/libraries/FrequencyTimer2"
+  puts "Installed FrequencyTimer2 into #{sketch_name}/vendor/libraries"
+  puts
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/I2CEEPROM/.", "#{sketch_name}/vendor/libraries/I2CEEPROM" 
+  puts "Installed I2CEEPROM into #{sketch_name}/vendor/libraries" 
+  puts
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/LoopTimer/.", "#{sketch_name}/vendor/libraries/LoopTimer" 
+  puts "Installed LoopTimer into #{sketch_name}/vendor/libraries" 
+  puts
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/OneWire/.", "#{sketch_name}/vendor/libraries/OneWire"
+  puts "Installed OneWire into #{sketch_name}/vendor/libraries"
+  puts
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/Servo/.", "#{sketch_name}/vendor/libraries/Servo"
+  puts "Installed Servo into #{sketch_name}/vendor/libraries"
+  puts
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/Stepper/.", "#{sketch_name}/vendor/libraries/Stepper"
+  puts "Installed Stepper into #{sketch_name}/vendor/libraries"
+  puts
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/SWSerLCDpa/.", "#{sketch_name}/vendor/libraries/SWSerLCDpa"
+  puts "Installed SWSerLCDpa into #{sketch_name}/vendor/libraries"
+  puts
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/SWSerLCDsf/.", "#{sketch_name}/vendor/libraries/SWSerLCDsf"
+  puts "Installed SWSerLCDsf into #{sketch_name}/vendor/libraries"
+  puts
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/libraries/Wire/.", "#{sketch_name}/vendor/libraries/Wire"
+  puts "Installed Wire into #{sketch_name}/vendor/libraries"
+  puts
+  
+  # Build examples -- used for basic testing
+  
+  FileUtils.mkdir_p "#{sketch_name}/vendor/libraries"
+  puts "Successfully created your examples directory."
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/examples/.", "#{sketch_name}/examples"
+  puts "Installed examples into #{sketch_name}/examples"
+  puts
+  
+  # Build test -- used testing
+  
+  # FIXME: this should put the tests into the vendor/tests directory instead.
+   
+  # FileUtils.mkdir_p "#{sketch_name}/test"
+  # puts "Successfully created your test directory."
+  # 
+  # FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/test/.", "#{sketch_name}/test"
+  # puts "Installed tests into #{sketch_name}/test"
+  # puts
+  
+  # Build vendor/plugins:  
+  
+  FileUtils.mkdir_p "#{sketch_name}/vendor/plugins"
+  puts "Successfully created your plugins directory."
+  
+  FileUtils.cp_r "#{File.dirname(__FILE__)}/../lib/plugins/.", "#{sketch_name}/vendor/plugins"
+  puts "Installed Default plugins into #{sketch_name}/vendor/plugins"
+  puts
+  
+  # Add an default sketch directory # needed to run test:compile
+  
+  FileUtils.mkdir_p "#{sketch_name}/#{sketch_name}"
+  puts "Successfully created your default sketch directory."
+  
+  # Build sketch files, etc.:  
+  
+  FileUtils.touch "#{sketch_name}/#{sketch_name}.rb"
+  File.open("#{sketch_name}/#{sketch_name}.rb", "w") do |file|
+    file << <<-EOS
+  class #{sketch_name.split("_").collect{|c| c.capitalize}.join("")} < ArduinoSketch
+    
+    # looking for hints?  check out the examples directory
+    # example sketches can be uploaded to your arduino with
+    # rake make:upload sketch=examples/hello_world
+    # just replace hello_world with other examples
+    
+      def loop
+       # your code here
+      end
+      
+  end
+    EOS
+  end
+  puts "Added #{sketch_name}/#{sketch_name}.rb"
+  
+  File.open("#{sketch_name}/Rakefile", 'w') do |file|
+    file << <<-EOS 
+  require 'vendor/rad/init.rb'
+    EOS
+  end
+  puts "Added #{sketch_name}/Rakefile"
+  
+  FileUtils.mkdir_p "#{sketch_name}/config"
+  puts "Added #{sketch_name}/config"
+  
+  File.open("#{sketch_name}/config/hardware.yml", 'w') do |file|
+    file << options["hardware"].to_yaml
+  end
+  puts "Added #{sketch_name}/config/hardware.yml"
+  
+  File.open("#{sketch_name}/config/software.yml", 'w') do |file|
+    file << options["software"].to_yaml
+  end
+  puts "Added #{sketch_name}/config/software.yml"
+  
+  puts
+  puts "Run 'rake -T' inside your sketch dir to learn how to compile and upload it."
+  
+  puts "***************************************************"
+  puts "***     Please note: This version supports      ***"
+  puts "***            Arduino 12 only!                 ***"
+  puts "***   run rad install arduino to upgrade        ***"
+  puts "***************************************************"
+end

data/lib/examples/software_serial.rb

@@ -0,0 +1,10 @@
+class SoftwareSerial < ArduinoSketch
+  output_pin 13, :as => :led
+  software_serial 6, 7, :as => :gps
+  serial_begin
+
+  def loop
+    digitalWrite(led, true)
+    serial_print(gps.read)
+  end
+end

data/lib/rad/generators/makefile/makefile.erb

@@ -69,7 +69,7 @@ SRC = $(ARDUINO)/pins_arduino.c $(ARDUINO)/wiring.c \
 $(ARDUINO)/wiring_analog.c $(ARDUINO)/wiring_digital.c \
 $(ARDUINO)/wiring_pulse.c $(ARDUINO)/wiring_serial.c \
 $(ARDUINO)/wiring_shift.c $(ARDUINO)/WInterrupts.c <%= params['twi_c'] %>
-CXXSRC = $(ARDUINO)/HardwareSerial.cpp $(SOFTWARE_SERIAL)/SoftwareSerial.cpp<%= params['libraries'].collect{|l| " $(LIBRARY_ROOT)/#{ l }/#{l }.cpp"}.join('') %>
+CXXSRC = $(ARDUINO)/HardwareSerial.cpp $(SOFTWARE_SERIAL)/SoftwareSerial.cpp $(ARDUINO)/Print.cpp<%= params['libraries'].collect{|l| " $(LIBRARY_ROOT)/#{ l }/#{l }.cpp"}.join('') %>
 MCU = <%= params['mcu'] %>
 <% if params['asm_files'] %>ASRC = <%= params['asm_files'].join(' ') %><% end %>
 F_CPU = 16000000

data/lib/rad/progressbar.rb

@@ -0,0 +1,236 @@
+#
+# Ruby/ProgressBar - a text progress bar library
+#
+# Copyright (C) 2001-2005 Satoru Takabayashi <satoru@namazu.org>
+#     All rights reserved.
+#     This is free software with ABSOLUTELY NO WARRANTY.
+#
+# You can redistribute it and/or modify it under the terms
+# of Ruby's license.
+#
+
+class ProgressBar
+  VERSION = "0.9"
+
+  def initialize (title, total, out = STDERR)
+    @title = title
+    @total = total
+    @out = out
+    @terminal_width = 80
+    @bar_mark = "o"
+    @current = 0
+    @previous = 0
+    @finished_p = false
+    @start_time = Time.now
+    @previous_time = @start_time
+    @title_width = 14
+    @format = "%-#{@title_width}s %3d%% %s %s"
+    @format_arguments = [:title, :percentage, :bar, :stat]
+    clear
+    show
+  end
+  attr_reader   :title
+  attr_reader   :current
+  attr_reader   :total
+  attr_accessor :start_time
+
+  private
+  def fmt_bar
+    bar_width = do_percentage * @terminal_width / 100
+    sprintf("|%s%s|", 
+            @bar_mark * bar_width, 
+            " " *  (@terminal_width - bar_width))
+  end
+
+  def fmt_percentage
+    do_percentage
+  end
+
+  def fmt_stat
+    if @finished_p then elapsed else eta end
+  end
+
+  def fmt_stat_for_file_transfer
+    if @finished_p then 
+      sprintf("%s %s %s", bytes, transfer_rate, elapsed)
+    else 
+      sprintf("%s %s %s", bytes, transfer_rate, eta)
+    end
+  end
+
+  def fmt_title
+    @title[0,(@title_width - 1)] + ":"
+  end
+
+  def convert_bytes (bytes)
+    if bytes < 1024
+      sprintf("%6dB", bytes)
+    elsif bytes < 1024 * 1000 # 1000kb
+      sprintf("%5.1fKB", bytes.to_f / 1024)
+    elsif bytes < 1024 * 1024 * 1000  # 1000mb
+      sprintf("%5.1fMB", bytes.to_f / 1024 / 1024)
+    else
+      sprintf("%5.1fGB", bytes.to_f / 1024 / 1024 / 1024)
+    end
+  end
+
+  def transfer_rate
+    bytes_per_second = @current.to_f / (Time.now - @start_time)
+    sprintf("%s/s", convert_bytes(bytes_per_second))
+  end
+
+  def bytes
+    convert_bytes(@current)
+  end
+
+  def format_time (t)
+    t = t.to_i
+    sec = t % 60
+    min  = (t / 60) % 60
+    hour = t / 3600
+    sprintf("%02d:%02d:%02d", hour, min, sec);
+  end
+
+  # ETA stands for Estimated Time of Arrival.
+  def eta
+    if @current == 0
+      "ETA:  --:--:--"
+    else
+      elapsed = Time.now - @start_time
+      eta = elapsed * @total / @current - elapsed;
+      sprintf("ETA:  %s", format_time(eta))
+    end
+  end
+
+  def elapsed
+    elapsed = Time.now - @start_time
+    sprintf("Time: %s", format_time(elapsed))
+  end
+  
+  def eol
+    if @finished_p then "\n" else "\r" end
+  end
+
+  def do_percentage
+    if @total.zero?
+      100
+    else
+      @current  * 100 / @total
+    end
+  end
+
+  def get_width
+    # FIXME: I don't know how portable it is.
+    default_width = 80
+    begin
+      tiocgwinsz = 0x5413
+      data = [0, 0, 0, 0].pack("SSSS")
+      if @out.ioctl(tiocgwinsz, data) >= 0 then
+        rows, cols, xpixels, ypixels = data.unpack("SSSS")
+        if cols >= 0 then cols else default_width end
+      else
+        default_width
+      end
+    rescue Exception
+      default_width
+    end
+  end
+
+  def show
+    arguments = @format_arguments.map {|method| 
+      method = sprintf("fmt_%s", method)
+      send(method)
+    }
+    line = sprintf(@format, *arguments)
+
+    width = get_width
+    if line.length == width - 1 
+      @out.print(line + eol)
+      @out.flush
+    elsif line.length >= width
+      @terminal_width = [@terminal_width - (line.length - width + 1), 0].max
+      if @terminal_width == 0 then @out.print(line + eol) else show end
+    else # line.length < width - 1
+      @terminal_width += width - line.length + 1
+      show
+    end
+    @previous_time = Time.now
+  end
+
+  def show_if_needed
+    if @total.zero?
+      cur_percentage = 100
+      prev_percentage = 0
+    else
+      cur_percentage  = (@current  * 100 / @total).to_i
+      prev_percentage = (@previous * 100 / @total).to_i
+    end
+
+    # Use "!=" instead of ">" to support negative changes
+    if cur_percentage != prev_percentage || 
+        Time.now - @previous_time >= 1 || @finished_p
+      show
+    end
+  end
+
+  public
+  def clear
+    @out.print "\r"
+    @out.print(" " * (get_width - 1))
+    @out.print "\r"
+  end
+
+  def finish
+    @current = @total
+    @finished_p = true
+    show
+  end
+
+  def finished?
+    @finished_p
+  end
+
+  def file_transfer_mode
+    @format_arguments = [:title, :percentage, :bar, :stat_for_file_transfer]
+  end
+
+  def format= (format)
+    @format = format
+  end
+
+  def format_arguments= (arguments)
+    @format_arguments = arguments
+  end
+
+  def halt
+    @finished_p = true
+    show
+  end
+
+  def inc (step = 1)
+    @current += step
+    @current = @total if @current > @total
+    show_if_needed
+    @previous = @current
+  end
+
+  def set (count)
+    if count < 0 || count > @total
+      raise "invalid count: #{count} (total: #{@total})"
+    end
+    @current = count
+    show_if_needed
+    @previous = @current
+  end
+
+  def inspect
+    "#<ProgressBar:#{@current}/#{@total}>"
+  end
+end
+
+class ReversedProgressBar < ProgressBar
+  def do_percentage
+    100 - super
+  end
+end
+