geeklets 0.0.6 → 0.0.7

data/History.txt

@@ -1,3 +1,22 @@
+=== 0.0.7
+* updated WMATA_Alerts to use configurable values
+* updated VRE_Alerts to use configurable values
+* updated OPM_Alerts to use configurable values
+* show_help fixed for some scripts
+* show_help shows defaulted params and options
+* added command line overrides of configuration values
+* moved configuration into a module
+* added basic configuration and tests.
+* added tests for base class.
+* added base class for all Geeklet scripts.
+* added tests for the main geeklet engine
+* added tests for Next_Months_Calendar script
+* added tests for Trash_Usage script
+
+=== 0.0.6 2010-04-10
+
+* updated the dependencies in the gemspec
+
 === 0.0.2 2010-02-07
 
 * Added weather script from Ted Wise.

data/VERSION

@@ -1 +1 @@
-0.0.6
+0.0.7

data/bin/geeklets

@@ -4,5 +4,5 @@ $LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
 $LOAD_PATH.unshift File.dirname(__FILE__) + '/../vendor'
 
 require 'geeklets'
-
-Geeklets.run(ARGV)
+g = Geeklets.new
+g.run(ARGV)

data/lib/Next_Months_Calendar/next_months_calendar.rb

@@ -1,9 +1,10 @@
-class Next_Months_Calendar
+class Next_Months_Calendar < Geeklet
 
   def run(params)
+    super(:Next_Months_Calendar, params)
     today = Date.today
     nextmonth = today >> 1
-    system("cal","#{nextmonth.month}","#{nextmonth.year}")
+    Kernel.system("cal","#{nextmonth.month}","#{nextmonth.year}")
   end
 
 end

data/lib/OPM_Alerts/opm_alerts.rb

@@ -3,33 +3,18 @@ require 'rubygems'
 require 'open-uri'
 require 'nokogiri'
 
-class OPM_Alerts
-  URL = "http://www.opm.gov/status/index.aspx"
+class OPM_Alerts < Geeklet
+  registerConfiguration :OPM_Alerts, :URL, :default => "http://www.opm.gov/status/index.aspx", :description => "OPM website URL", :type => :string
+  registerConfiguration :OPM_Alerts, :width, :default => 40, :description => "Word wrap width", :type => :int
 
-  def die
-    puts <<-EOS
-  opm-status
-
-  USAGE:
-
-  \topm-status [wrapping-width]
-
-  Returns U.S. Office of Personnel Management status Alerts.
-
-  [wrapping-width] is an integer to limit the width of the descriptions
-  Defaults to: 40
-
-EOS
-
-    exit
+  def description
+    "Returns U.S. Office of Personnel Management status Alerts."
   end
 
   def run(params)
-    die if params[0] == "-h"
-
-    width = (params[1] and params[1].to_i) || 40
-
-    doc = Nokogiri::HTML(open(URL))
+    super(:OPM_Alerts, params)
+    
+    doc = Nokogiri::HTML(open(configurableValue(:OPM_Alerts, :URL)))
 
     date_str = doc.css('#_ctl0__ctl0_DisplayDateSpan').text.strip
     begin
@@ -52,6 +37,7 @@ EOS
     status = "Not found" if status.length == 0
 
     # display results
+    width = configurableValue(:OPM_Alerts, :width)
     puts Utility.wrap_text("#{date_str} - #{title}", width, date_str.length + 3, :outdent)
     puts "-" * width
     puts Utility.wrap_text(status, width)

data/lib/Trash_Usage/trash_usage.rb

@@ -1,7 +1,8 @@
-class Trash_Usage
+class Trash_Usage < Geeklet
 
   def run(params)
-    system("du -sh ~/.Trash/ | awk '{print \"Trash is using \"$1}'")    
+    super(:Trash_Usage, params)
+    Kernel.system("du -sh ~/.Trash/ | awk '{print \"Trash is using \"$1}'")    
   end
 
 end

data/lib/VRE_Alerts/vre_alerts.rb

@@ -3,40 +3,25 @@ require 'rubygems'
 require 'chronic'
 require 'mechanize'
 
-FEED_URL = "http://www.vre.org/service/daily-download.html"
-TRAIN_LINES = {"fbg_delay" => :fredericksburg, "mss_delay" => :manassas}
-
-class VRE_Alerts
-
-  def die
-    puts <<-EOS
-    vre-alert
-
-    USAGE:
-
-    \tvre-alert [rail_lines] [wrapping-width] [specific-date]
-
-    Returns Virgina Railway Express (VRE) Alerts.
-
-    [rail_lines] specifies which rail lines you want alerts for.
-    Can be:
-    \tfredericsburg - for the Fredericsburg line
-    \tmanassas      - for the Manassas line
-    \tboth          - for both lines.
-    Defaults to: both
+class VRE_Alerts < Geeklet
+  registerConfiguration :VRE_Alerts, :URL, :default => "http://www.vre.org/service/daily-download.html", :description => "VRE website URL", :type => :string
+  registerConfiguration :VRE_Alerts, :lines, :default => "both", :description => "Which rail line. (manassas, fredericksburg, or both)", :type => :string
+  registerConfiguration :VRE_Alerts, :width, :default => 40, :description => "Wrapping width", :type => :int
+  registerConfiguration :VRE_Alerts, :date, :default => "today", :description => "A string parseable by Date::parse which is the date from the VRE daily download to display. NOTE: this does not access history, it only allows you to choose a specific entry from the Daily Download to render.", :type => :string
+  
+  def name
+    "VRE_Alerts"
+  end
   
-    [wrapping-width] is an integer to limit the width of the descriptions
-    Defaults to: 40
+  def description
+    "Returns Virgina Railway Express (VRE) Alerts."
+  end
   
-    [specific-date] is a string parseable by Date::parse which is the date from
-    the VRE daily download to display. NOTE: this does not access history, it only
-    allows you to choose a specific entry from the Daily Download to render. Mostly
-    used for debugging.
-    Defaults to: The current system Date.
-
-  EOS
-
-    exit
+  def line(cell_class)
+    case cell_class
+    when "fbg_delay" then :fredericksburg
+    when "mss_delay" then :manassas
+    end
   end
 
   # >> notice.search("tr")[2].search("td")[0].attributes["class"].value
@@ -68,7 +53,8 @@ class VRE_Alerts
         end
       
         cell_class = cells[0].attributes["class"].value unless cells[0].text.empty?
-        detail[service] << {:line => TRAIN_LINES[cell_class], :train => cells[0].text, :description => cells[1].text} if @rail_lines == :both || @rail_lines == TRAIN_LINES[cell_class]
+        rail_lines = configurableValue(:VRE_Alerts, :lines).to_sym
+        detail[service] << {:line => line(cell_class), :train => cells[0].text, :description => cells[1].text} if rail_lines == :both || rail_lines == line(cell_class)
       else
         next
       end
@@ -100,23 +86,17 @@ class VRE_Alerts
   end
 
   def run(params)
-    die if params[0] == "-h"
-
-    @rail_lines = (params[0] || "both").to_sym
-    width = (params[1] and params[1].to_i) || 40
-    alert_date = (params[2] and Date.parse(params[2])) || Date.today
-
-    #debug - set a date of interest, and rail line of interest
-    # alert_date = Date.civil(2010, 1, 13)
-    # @rail_lines = :fredericksburg
+    super(:VRE_Alerts, params)
 
     agent = Mechanize.new
-    agent.get(FEED_URL)
+    agent.get(configurableValue(:VRE_Alerts, :URL))
     notices = agent.page.search(".format").map{ |notice| parse_notice(notice) }
 
     #debug
     #puts notices.to_yaml
 
+    width = configurableValue(:VRE_Alerts, :width)
+    alert_date = configurableValue(:VRE_Alerts, :date)
     render_notice(notices.select{ |notice| notice[:date] == alert_date }.shift, width)
   end
 

data/lib/WMATA_Alerts/wmata_alerts.rb

@@ -5,86 +5,65 @@ require 'open-uri'
 require 'chronic'
 require 'htmlentities'
 
-class WMATA_Alerts
+class WMATA_Alerts < Geeklet
+  registerConfiguration :WMATA_Alerts, :URL, :default => "http://www.wmata.com/rider_tools/metro_service_status/feeds/rail.xml", :description => "WMATA website URL", :type => :string
+  registerConfiguration :WMATA_Alerts, :width, :default => 40, :description => "Wrapping width", :type => :int
+  registerConfiguration :WMATA_Alerts, :history, :default => "7 days ago", :description => "how many days of feed history to display. Can be anything parseable by Chronic gem.", :type => :string
 
-  REPLACEMENTS = 
-  [
-    ["p.m.", "pm"], 
-    ["a.m.", "am"]
-  ]
-
-  FEED_URL = "http://www.wmata.com/rider_tools/metro_service_status/feeds/rail.xml"
-
-  def die
-    puts <<-EOS
-  metro-feed
-
-    USAGE:
-
-    \tmetro-feed [history] [wrapping-width]
-
-    Returns WMATA feed information for metro lines.
-
-    [history] is how many days of feed history to display.
-    \tdefaults to 7 days. Can be anything parseable by Chronic gem
-
-    [wrapping-width] is the limit to how wide the text can be
-    \tdefaults to 40 characters. should be a positive integer value.
-
-    Requires gems: chronic, htmlentities
-
-
-  EOS
-
-    exit
+  def name
+    "WMATA_Alerts"
   end
-
+  
+  def description
+    "Returns WMATA feed information for metro lines."
+  end
+  
+  def translate(message)
+    [
+      ["p.m.", "pm"], 
+      ["a.m.", "am"]
+    ].each { |r| message.gsub!(r[0], r[1]) }
+    message
+  end
+  
   def run(params)
+    super(:WMATA_Alerts, params)
 
-    die if params[0] == "-h"
+    rss_content = ""
 
-    @cutoff_string = params[0] || "7 days ago"
-    @width = params[1] || "40"
-    @width = @width.to_s.to_i
-
-    @cutoff = Chronic.parse(@cutoff_string)
-
-    @rss_content = ""
-
-    open(FEED_URL) do |f|
-      @rss_content = f.read
+    open(configurableValue(:WMATA_Alerts, :URL)) do |f|
+      rss_content = f.read
     end
 
-    @rss = RSS::Parser.parse(@rss_content, false)
+    rss = RSS::Parser.parse(rss_content, false)
 
-    @item_hash = {}
+    item_hash = {}
 
     # filter down to the items we want.
-    @rss.items.each do |item|
-      @item_hash[item.pubDate] = item unless item.pubDate < @cutoff
+    rss.items.each do |item|
+      item_hash[item.pubDate] = item unless item.pubDate < Chronic.parse(configurableValue(:WMATA_Alerts, :history))
     end
 
-    if @item_hash.empty?
+    if item_hash.empty?
       puts "No data from WMATA feed."
     else
-      @coder = HTMLEntities.new
-      @item_hash.keys.sort.reverse.each do |key|
-        item = @item_hash[key]
+      coder = HTMLEntities.new
+      item_hash.keys.sort.reverse.each do |key|
+        item = item_hash[key]
 
         title = "#{item.pubDate.strftime('%x')} - #{item.title}"
         puts title
         puts ("-" * title.length)
 
-        message = @coder.decode(item.description)
-        REPLACEMENTS.each do |r|
-          message = message.gsub(r[0], r[1])
-        end
+        message = coder.decode(item.description)
+        message = translate(message)
         subject, *body = message.split(".")
         
-        puts Utility.wrap_text(subject+"...", @width)
+        width = configurableValue(:WMATA_Alerts, :width)
+        puts Utility.wrap_text(subject + "...", width)
         body.each do |sentence|
-          puts Utility.wrap_text(sentence+".", @width, 3, :all)
-        end  
+          puts Utility.wrap_text(sentence + ".", width, 3, :all)
+        end
 
         puts
       end

data/lib/configurable.rb

@@ -0,0 +1,68 @@
+require 'unregistered_config_value_error'
+require 'configuration_required_error'
+require 'trollop'
+require 'yaml'
+
+module Configurable
+  
+  # configurations should be a hash of hashes, where the first key is the calculator type, and the second key is the tag
+  def configurations
+    @@configuration ||= {}
+  end
+
+  def isHelp?(param)
+    param.to_s.downcase == 'help'
+  end
+
+  def configurableValue(group, key)
+    raise UnregisteredConfigValueError unless configurations.include?(group)
+    raise UnregisteredConfigValueError unless configurations[group].include?(key)
+    value = configurations[group][key][:override] || configurations[group][key][:stored] || configurations[group][key][:default]
+    raise ConfigurationRequiredError unless value
+    value
+  end
+  
+  def registerConfiguration(group, key, options = {})
+    configurations[group] ||= {}
+    configurations[group][key] = options
+  end
+    
+  def command_parser(group)
+    groupConfigs = configurations[group]
+    return unless groupConfigs #if there are no configs defined, there is nothing to do.
+    
+    parser = Trollop::Parser.new do
+      groupConfigs.each do |key, options|
+        # our concept of a default is different from trollop's, so remove any default key and value
+        defaultValue = options[:stored] || options[:default]
+        if defaultValue
+          opt key, options[:description], options.merge({ :default => defaultValue })
+        else
+          opt key, options[:description], options
+        end
+      end
+    end
+  end  
+  
+  def add_overrides(group, params)
+    return if (params.nil? || params.empty?) # nothing to do in this case
+    raise Trollop::HelpNeeded if isHelp?(params[0])
+
+    groupConfigs = configurations[group]
+    trollop_opts = command_parser(group).parse(params)
+    trollop_opts.each do |key, value| 
+      groupConfigs[key][:override] = value if groupConfigs.key?(key) 
+    end
+    
+    # puts "trollop opts:"
+    # puts trollop_opts.to_yaml
+    # puts
+    # puts "group configs:"
+    # puts groupConfigs.to_yaml
+  end
+
+  def self.included(base)
+    base.extend(Configurable)
+  end
+
+end

data/lib/configuration_required_error.rb

@@ -0,0 +1,3 @@
+class ConfigurationRequiredError < Exception
+
+end

data/lib/geeklet.rb

@@ -0,0 +1,39 @@
+require 'configurable'
+
+class Geeklet
+  include Configurable
+  
+  
+  def name
+    self.class.to_s
+  end
+  
+  def description
+    "No description specified for this geeklet."
+  end
+
+  def show_help(group)
+    parser = command_parser(group)
+    Kernel.puts(
+<<-EOS
+Geeklet: #{name}
+
+Description: #{description}
+
+EOS
+)
+    parser.educate 
+  end
+
+  def run(group, params)
+    begin
+      add_overrides(group, params)
+    rescue => e
+      show_help(group)
+      # Kernel.puts e.inspect
+      Kernel.exit
+    end
+    true
+  end
+
+end

data/lib/geeklets.rb

@@ -1,51 +1,61 @@
 $:.unshift(File.dirname(__FILE__)) unless
-  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+$:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
 
 require 'pathname'
 require 'utility'
-require 'trollop'
+require 'geeklet'
+require 'yaml'
 
 class Geeklets
 
-  def self.show_usage
-    puts "Usage: geeklets <geeklet-script> [relevant-parameters-for-script]"
-    puts 
+  def initialize(scripts = {})
+    @geeklet_scripts = scripts
+    if @geeklet_scripts.empty?
+      cwd = File.dirname(__FILE__)
+      children = Pathname.new(cwd).children
+      children.reject! { |child| !child.directory? }
+      children.each do |child_dir|
+        geeklet_name = child_dir.basename.to_s
+        geeklet_file = geeklet_name.downcase
+        begin
+          Kernel.require "#{geeklet_name}/#{geeklet_file}"
+          @geeklet_scripts[geeklet_name] = Kernel.eval("#{geeklet_name}.new")
+        rescue => e
+          Kernel.puts "Problem loading #{geeklet_name} geeklet."
+          # Kernel.puts e.inspect
+          # Kernel.puts e.backtrace
+          next
+        end
+      end
+    end
   end
   
-  def self.show_known_scripts
-    puts "These are the currently known geeklet scripts:"
-    puts
-    script_inventory.each { |script| puts "\t#{script}"}
+  def show_usage
+    puts "Usage: geeklets <geeklet-script> [relevant-parameters-for-script]"
     puts
   end
-  
-  def self.script_inventory
-    cwd = File.dirname(__FILE__)
-    children = Pathname.new(cwd).children
-    children.reject! { |child| !child.directory? }
-    children.map! { |child| child.basename.to_s }
-  end
-  
-  def self.run_geeklet(geeklet, params)
-    require "#{geeklet}/#{geeklet.downcase}"
-    obj = eval("#{geeklet}.new")
-    obj.run(params)
+
+  def show_known_scripts
+    Kernel.puts "These are the currently known geeklet scripts:"
+    Kernel.puts
+    Kernel.puts "There are no defined geeklet scripts." if @geeklet_scripts.empty?
+    @geeklet_scripts.keys.sort.each { |key| Kernel.puts "\t#{key}" }
+    Kernel.puts
   end
 
-  def self.run(params)
-    if params.empty?
+  def run(params)
+    if params.nil? || params.empty?
       show_usage
       show_known_scripts
     else
       geeklet = params.shift
-      if script_inventory.include?(geeklet)
-        run_geeklet(geeklet, params)
+      if @geeklet_scripts.include?(geeklet)
+        @geeklet_scripts[geeklet].run(params)
       else
-        puts "I do not know how to run the #{geeklet} geeklet."
+        Kernel.puts "I do not know how to run the #{geeklet} geeklet."
         show_known_scripts
       end
     end
-    
   end
 
-end
+end

data/lib/unregistered_config_value_error.rb

@@ -0,0 +1,3 @@
+class UnregisteredConfigValueError < Exception
+
+end

data/spec/Next_Months_Calendar/next_months_calendar_spec.rb

@@ -0,0 +1,41 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'Next_Months_Calendar/next_months_calendar'
+
+describe Next_Months_Calendar do
+
+  before { @script = Next_Months_Calendar.new }
+  
+  subject { @script }
+
+  describe "In general" do
+    it { should be_a_kind_of(Geeklet)}
+  end
+
+  describe :run do
+    
+    context "when this month is April" do
+      it "should get the calendar for next month" do
+        Date.should_receive(:today).and_return(Date.civil(2010, 4, 26))        
+        Kernel.should_receive(:system).with("cal","5","2010")      
+        @script.run([])
+      end
+    end
+
+    context "when this month is December" do
+      it "should get the calendar for next month, in the next year" do
+        Date.should_receive(:today).and_return(Date.civil(2010, 12, 25))
+        Kernel.should_receive(:system).with("cal","1","2011")
+        @script.run([])
+      end
+    end
+
+    context "when the following month has fewer days" do
+      it "should get the calendar for next month, in the next year" do
+        Date.should_receive(:today).and_return(Date.civil(2010, 1, 31))
+        Kernel.should_receive(:system).with("cal","2","2010")
+        @script.run([])
+      end
+    end
+
+  end
+end

data/spec/Trash_Usage/trash_usage_spec.rb

@@ -0,0 +1,25 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+require 'Trash_Usage/trash_usage'
+
+describe Trash_Usage do
+
+  before { @script = Trash_Usage.new }
+  
+  subject { @script }
+
+  describe "in general" do
+    it { should be_a_kind_of(Geeklet) }
+  end
+
+  describe :run do
+    
+    it "should get the trash usage" do
+      
+      Kernel.should_receive(:system).with("du -sh ~/.Trash/ | awk '{print \"Trash is using \"$1}'")
+      
+      @script.run([])
+    end
+    
+  end
+
+end

data/spec/configurable_spec.rb

@@ -0,0 +1,72 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'configurable'
+
+describe Configurable do
+  
+  before do
+    klass = Class.new do
+      include Configurable
+    end
+    @configurable = klass.new
+  end
+  
+  describe :configurableValue do
+
+    context "when group not registered" do      
+      it "should throw an exception" do
+        lambda { @configurable.configurableValue("no_group", "someUnregisteredKey") }.should raise_exception(UnregisteredConfigValueError)
+      end      
+    end
+    
+    context "when group is registered but configurable value not registered" do      
+      it "should throw an exception" do
+        @configurable.registerConfiguration("group", "someRegisteredKey")
+        lambda { @configurable.configurableValue("group", "someUnregisteredKey") }.should raise_exception(UnregisteredConfigValueError)
+      end      
+    end
+    
+    context "when configurable value is registered" do
+    
+      context "with a default value" do
+        it "should return the default value" do
+          @configurable.registerConfiguration("group", "someRegisteredKey", :default => "some Default Value")
+          @configurable.configurableValue("group", "someRegisteredKey").should == "some Default Value"
+        end
+      end
+
+      context "without a default value" do
+        it "should indicate that configuration is necessary" do
+          @configurable.registerConfiguration("group", "someRegisteredKey")
+          lambda { @configurable.configurableValue("group", "someRegisteredKey") }.should raise_exception(ConfigurationRequiredError)
+        end
+      end
+      
+      context "when value is overridden" do
+        it "should return the overridden value" do
+           @configurable.registerConfiguration("group", "someRegisteredKey", :default => "default", :type => :string)
+           @configurable.add_overrides("group", ["-s", "override"])
+           @configurable.configurableValue("group", "someRegisteredKey").should == "override"
+        end
+      end
+
+    end
+    
+    
+    
+  end
+  
+  describe :isHelp do
+    
+    it "should return true when param is 'help'" do
+      help = ['Help', 'help', "HeLp"]      
+      help.each { |param| @configurable.isHelp?(param).should be_true }
+    end
+    
+    it "should be false when the param is not 'help'" do
+      not_help = [2, nil, ""]
+      not_help.each { |param| @configurable.isHelp?(param).should be_false }
+    end
+    
+  end
+
+end

data/spec/geeklet_spec.rb

@@ -0,0 +1,65 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'geeklet'
+
+describe Geeklet do
+
+  before { @geeklet = Geeklet.new }
+
+  subject { @geeklet }
+
+  it { should respond_to :run }
+  
+  describe :run do
+
+    context "When params is nil" do      
+      subject { @geeklet.run("group", nil)}
+      it { should be_true }      
+    end
+
+    context "When params is empty" do      
+      subject { @geeklet.run("group", [])}
+      it { should be_true }      
+    end
+
+    context "When params has items" do
+      subject { @geeklet.run("group", ["one", 2, "three"])}      
+      it { should be_true }      
+    end
+    
+    context "When params has 'help' as first item" do
+      it "should show help and exit" do
+        @geeklet.should_receive(:show_help)
+        Kernel.should_receive(:exit)
+        
+        @geeklet.run("group", ["Help", 2, "4.5"])
+      end
+    end
+
+  end
+  
+  
+  
+  describe :show_help do
+    
+    it "should display usage information" do
+      parser = mock("command_parser")
+      @geeklet.should_receive(:command_parser).with("group").and_return(parser)
+      @geeklet.should_receive(:name).and_return("Script Name")
+      @geeklet.should_receive(:description).and_return("Some script description")
+      Kernel.should_receive(:puts).with(
+<<-EOS
+Geeklet: Script Name
+
+Description: Some script description
+
+EOS
+)      
+      parser.should_receive(:educate)
+
+      @geeklet.show_help("group")
+    end
+    
+  end
+  
+  
+end

data/spec/geeklets_spec.rb

@@ -1,15 +1,200 @@
 require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'geeklets'
 
-describe "Geeklets" do
+module GeekletExampleHelperMethods
+  def mock_no_scripts
+    mock_cwd = mock("cwd")
+    mock_cwd_pathname = mock("cwd Pathname")
+    mock_children = []
   
-  it "should know how to show usage"
+    File.should_receive(:dirname).with(any_args()).and_return(mock_cwd)
+    Pathname.should_receive(:new).with(mock_cwd).and_return(mock_cwd_pathname) 
+    mock_cwd_pathname.should_receive(:children).and_return(mock_children)
+    mock_children.should_receive(:reject!)
+    
   
-  it "should know how to show the valid scripts"
+    geeklets = Geeklets.new
+  end
+
+  def mock_some_scripts_no_problems
+    mock_cwd = mock("cwd")
+    mock_cwd_pathname = mock("cwd Pathname")
+    mock_children = [ mock("Dir1"), mock("Dir2"), mock("Dir3")]
+    mock_children_basenames = ["Dir1.Basename", "Dir2.Basename", "Dir3.Basename"]
+    mock_script_1 = mock("script1")
+    mock_script_2 = mock("script2")
+    mock_script_3 = mock("script3")
+  
+    File.should_receive(:dirname).with(any_args()).and_return(mock_cwd)
+    Pathname.should_receive(:new).with(mock_cwd).and_return(mock_cwd_pathname) 
+    mock_cwd_pathname.should_receive(:children).and_return(mock_children)
+    mock_children[0].should_receive(:directory?).and_return(true)    
+    mock_children[1].should_receive(:directory?).and_return(true)    
+    mock_children[2].should_receive(:directory?).and_return(true)    
+
+    mock_children[0].should_receive(:basename).and_return(mock_children_basenames[0])    
+    Kernel.should_receive(:require).with("Dir1.Basename/dir1.basename")
+    Kernel.should_receive(:eval).with("Dir1.Basename.new").and_return(mock_script_1)
+
+    mock_children[1].should_receive(:basename).and_return(mock_children_basenames[1])    
+    Kernel.should_receive(:require).with("Dir2.Basename/dir2.basename")
+    Kernel.should_receive(:eval).with("Dir2.Basename.new").and_return(mock_script_2)
+
+    mock_children[2].should_receive(:basename).and_return(mock_children_basenames[2])    
+    Kernel.should_receive(:require).with("Dir3.Basename/dir3.basename")
+    Kernel.should_receive(:eval).with("Dir3.Basename.new").and_return(mock_script_3)
+  
+    geeklets = Geeklets.new
+  end
+
+  def mock_some_scripts_with_problems
+    mock_cwd = mock("cwd")
+    mock_cwd_pathname = mock("cwd Pathname")
+    mock_children = [ mock("Dir1"), mock("Dir2"), mock("Dir3")]
+    mock_children_basenames = ["Dir1.Basename", "Dir2.Basename", "Dir3.Basename"]
+    mock_script_3 = mock("script3")
+  
+    File.should_receive(:dirname).with(any_args()).and_return(mock_cwd)
+    Pathname.should_receive(:new).with(mock_cwd).and_return(mock_cwd_pathname) 
+    mock_cwd_pathname.should_receive(:children).and_return(mock_children)
+    mock_children[0].should_receive(:directory?).and_return(true)    
+    mock_children[1].should_receive(:directory?).and_return(true)    
+    mock_children[2].should_receive(:directory?).and_return(true)    
+
+    mock_children[0].should_receive(:basename).and_return(mock_children_basenames[0])    
+    Kernel.should_receive(:require).with("Dir1.Basename/dir1.basename").and_raise("can't require")
+
+    mock_children[1].should_receive(:basename).and_return(mock_children_basenames[1])    
+    Kernel.should_receive(:require).with("Dir2.Basename/dir2.basename")
+    Kernel.should_receive(:eval).with("Dir2.Basename.new").and_raise("can't create")
+    Kernel.should_receive(:puts).with("Problem loading Dir1.Basename geeklet.").ordered
+
+    mock_children[2].should_receive(:basename).and_return(mock_children_basenames[2])    
+    Kernel.should_receive(:require).with("Dir3.Basename/dir3.basename")
+    Kernel.should_receive(:eval).with("Dir3.Basename.new").and_return(mock_script_3)
+    Kernel.should_receive(:puts).with("Problem loading Dir2.Basename geeklet.").ordered
+  
+    geeklets = Geeklets.new
+  end
+
+end
+
+describe Geeklets do
+  
+  before(:all) { @geeklets = Geeklets.new }
+  
+  subject { @geeklets }
+  
+  it { should respond_to :show_usage }
+  it { should respond_to :show_known_scripts }
+  it { should respond_to :run }
+end
+
+describe Geeklets do
+    
+    context :initialize, "when there are no scripts" do
+      include GeekletExampleHelperMethods
   
-  it "should know how to obtain the list of valid scripts"
+      before(:each) { @geeklets = mock_no_scripts }
   
-  it "should know how to run an individual script"
+      it "should produce an empty list" do
+        Kernel.should_receive(:puts).with("These are the currently known geeklet scripts:").ordered
+        Kernel.should_receive(:puts).with(no_args()).ordered
+        Kernel.should_receive(:puts).with("There are no defined geeklet scripts.").ordered
+        Kernel.should_receive(:puts).with(no_args()).ordered
+
+        @geeklets.show_known_scripts
+      end
+    end
   
-  it "should know how to parse the parameters to determine what script to run"
+    context :initialize, "when there are scripts with no problems" do
+      include GeekletExampleHelperMethods
+
+      before(:each) { @geeklets = mock_some_scripts_no_problems }
+
+      it "should not produce an empty list" do
+        Kernel.should_receive(:puts).with("These are the currently known geeklet scripts:").ordered
+        Kernel.should_receive(:puts).with(no_args()).ordered
+        Kernel.should_receive(:puts).with("\tDir1.Basename").ordered
+        Kernel.should_receive(:puts).with("\tDir2.Basename").ordered
+        Kernel.should_receive(:puts).with("\tDir3.Basename").ordered
+        Kernel.should_receive(:puts).with(no_args()).ordered
+
+        @geeklets.show_known_scripts
+      end
+    end
 
+    context :initialize, "when there are scripts with problems" do
+      include GeekletExampleHelperMethods
+
+      before(:each) { @geeklets = mock_some_scripts_with_problems }
+
+      it "should skip the scripts with problems and report them" do
+        Kernel.should_receive(:puts).with("These are the currently known geeklet scripts:").ordered
+        Kernel.should_receive(:puts).with(no_args()).ordered
+        Kernel.should_receive(:puts).with("\tDir3.Basename").ordered
+        Kernel.should_receive(:puts).with(no_args()).ordered
+
+        @geeklets.show_known_scripts
+      end
+    end
+
+end
+
+describe Geeklets do
+  
+  before { @geeklets = Geeklets.new }
+    
+  subject { @geeklets.run }  
+    
+  context "when given no parameters" do
+    
+    it "should show usage and available scripts" do
+      @geeklets.should_receive(:show_usage)
+      @geeklets.should_receive(:show_known_scripts)
+    
+      @geeklets.run(nil)
+    end
+  
+  end
+
+  context "when given empty parameters" do
+    
+    it "should show usage and available scripts" do
+      @geeklets.should_receive(:show_usage)
+      @geeklets.should_receive(:show_known_scripts)
+    
+      @geeklets.run([])
+    end
+  
+  end
+
+  context "when given parmeters for a non existant script" do
+    
+    it "should indicate that it doesn't understand, and show the available scripts" do
+      Kernel.should_receive(:puts).with("I do not know how to run the noscript geeklet.").ordered
+      @geeklets.should_receive(:show_known_scripts)
+    
+      @geeklets.run(["noscript"])
+    end
+  
+  end
+
+  context "when given parmeters for an existing script" do
+    
+    before do 
+      @script_hash = mock("script hash") 
+      @script_hash.should_receive(:empty?).and_return(false)
+      @geeklets = Geeklets.new(@script_hash)
+    end
+    
+    it "should attempt to run that script" do
+      @script_hash.should_receive(:include?).with("some_script").and_return(true)
+      @script_hash.should_receive(:[]).with("some_script").and_return(mock_script = mock("some_script"))
+      mock_script.should_receive(:run).with(["some_params"])
+    
+      @geeklets.run(["some_script", "some_params"])
+    end
+  
+  end
 end

data/spec/spec_helper.rb

@@ -2,7 +2,6 @@ $LOAD_PATH.unshift(File.dirname(__FILE__))
 $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 
 require 'rubygems'
-require 'geeklets'
 require 'spec'
 require 'spec/autorun'
 

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 6
-  version: 0.0.6
+  - 7
+  version: 0.0.7
 platform: ruby
 authors: 
 - John F. Schank III
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-10 00:00:00 -04:00
+date: 2010-05-02 00:00:00 -04:00
 default_executable: geeklets
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -124,8 +124,16 @@ files:
 - lib/VRE_Alerts/vre_alerts.rb
 - lib/WMATA_Alerts/wmata_alerts.rb
 - lib/Weather/weather.rb
+- lib/configurable.rb
+- lib/configuration_required_error.rb
+- lib/geeklet.rb
 - lib/geeklets.rb
+- lib/unregistered_config_value_error.rb
 - lib/utility.rb
+- spec/Next_Months_Calendar/next_months_calendar_spec.rb
+- spec/Trash_Usage/trash_usage_spec.rb
+- spec/configurable_spec.rb
+- spec/geeklet_spec.rb
 - spec/geeklets_spec.rb
 - spec/spec.opts
 - spec/spec_helper.rb
@@ -162,6 +170,10 @@ signing_key:
 specification_version: 3
 summary: Scripts for GeekTool
 test_files: 
+- spec/configurable_spec.rb
+- spec/geeklet_spec.rb
 - spec/geeklets_spec.rb
+- spec/Next_Months_Calendar/next_months_calendar_spec.rb
 - spec/spec_helper.rb
+- spec/Trash_Usage/trash_usage_spec.rb
 - spec/utility_spec.rb