cards 0.7 → 0.9

data/CHANGES.txt

@@ -1,5 +1,14 @@
 = Change Log
 
+== Version 0.9
+
+* example that directly imports into tracker api
+* direct exports out of numbers '09
+
+== Version 0.8
+
+* example of custom csv builder
+
 == Version 0.7
 
 * fixing the dot writer

data/README.txt

@@ -1,4 +1,4 @@
-= Project: CardWallGen
+= Project: Cards
 
 == Description
 

data/Rakefile

@@ -11,7 +11,7 @@ require 'hoe'
 require 'lib/cards'
 
 desc "Default Task"
-task :default => [:spec]
+task :default => [:generate_manifest, :spec]
 
 task :test => :spec
 
@@ -19,6 +19,12 @@ Spec::Rake::SpecTask.new(:spec) do |t|
   t.spec_files = FileList['spec/**/*_spec.rb']
 end
 
+task :generate_manifest do
+  File.open("Manifest.txt", "w") do |f|
+    f << FileList["CHANGES.txt", "Rakefile", "README.txt", "examples/**/*", "lib/**/*", "spec/**/*"].to_a.join("\n")
+  end
+end
+
 desc "export to dot file"
 task :run_dot do
   file = ENV["FILE"] || SAMPLE_FILE

data/examples/csv to dot/generate_card_walls

@@ -1,10 +1,10 @@
 #!/usr/bin/env ruby
-
 require 'rubygems'
+gem 'cards'
 require 'cards'
-
 include Cards
 
+
 def csv_file(name)
   CsvParser.new(File.dirname(__FILE__) + "/#{name}.csv")
 end
@@ -22,4 +22,4 @@ end
 puts "generated Stories.dot"
 
 # uncomment this line if you want to see the generated file
-# `open "#{File.dirname(__FILE__)}/Stories.dot"`
+# `open "#{File.dirname(__FILE__)}/Stories.dot"`

data/examples/custom csv builder/Stories.csv

@@ -0,0 +1,16 @@
+Activity,Task,Story,Note,Estimate,Priority
+Voter,Vote on question,Ability to see question,,1,H
+,,Ability to see choices,,1,M
+,,Ability to choose,This is the server trip,2,H
+,Navigate questions,Ability to continue to next / prev,,1,H
+,,Ability to see list of questions,This includes ability to jump to that question,4,H
+,Submit,Ability to return to new screen,,1,M
+Admin,Create questions,Ability to enter question,,4,H
+,,Ability to reorder question,,4,H
+,,Ability to enter multiple choice question,,1,L
+,,Ability to enter text question,,1,H
+,,Ability to enter long text question,,1,H
+,,Ability to enter list question,,2,L
+,Compile votes,Ability to see results in spreadsheet,,4,H
+,,Ability to see summary of results,This includes percentage of each question answering which answer,2,M
+,Announce winners,,,,

data/examples/custom csv builder/Stories.tracker.csv

@@ -0,0 +1,29 @@
+Story,Labels,Story Type,Estimate,Description,Priority
+Ability to see question,"Vote on question, H",,1,"while Voter
+",2
+Ability to see choices,"Vote on question, M",,1,"while Voter
+",1
+Ability to choose,"Vote on question, H",,2,"while Voter
+This is the server trip",2
+Ability to continue to next / prev,"Navigate questions, H",,1,"while Voter
+",2
+Ability to see list of questions,"Navigate questions, H",,4,"while Voter
+This includes ability to jump to that question",2
+Ability to return to new screen,"Submit, M",,1,"while Voter
+",1
+Ability to enter question,"Create questions, H",,4,"while Admin
+",2
+Ability to reorder question,"Create questions, H",,4,"while Admin
+",2
+Ability to enter multiple choice question,"Create questions, L",,1,"while Admin
+",0
+Ability to enter text question,"Create questions, H",,1,"while Admin
+",2
+Ability to enter long text question,"Create questions, H",,1,"while Admin
+",2
+Ability to enter list question,"Create questions, L",,2,"while Admin
+",0
+Ability to see results in spreadsheet,"Compile votes, H",,4,"while Admin
+",2
+Ability to see summary of results,"Compile votes, M",,2,"while Admin
+This includes percentage of each question answering which answer",1

data/examples/custom csv builder/generate_card_wall

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+gem 'cards'
+require 'cards'
+include Cards
+
+
+def csv_file(name)
+  CsvParser.new(File.dirname(__FILE__) + "/#{name}.csv")
+end
+
+class Tracker < CsvBuilder
+  PRIORITY = %w(L M H)
+  
+  def header
+    ["Story", "Labels", "Story Type", "Estimate", "Description", "Priority"]
+  end
+
+  def add_story(name, row = {})
+    @csv << [
+              name,
+              "#{@task}, #{row[:priority]}",
+              nil,
+              row[:estimate],
+              "while #{@activity}\n#{row[:note]}",
+              PRIORITY.index(row[:priority])
+            ]
+  end
+end
+
+Tracker.from csv_file("Stories")

data/examples/excel to visio/generate card walls.rb

@@ -0,0 +1,10 @@
+require File.expand_path(File.dirname(__FILE__)) + '/CardWallGenerator/include.rb'
+
+
+data = load_excel_data 'Business Processes.xls', 1
+create_visio_document data, 'Caution.vsd'
+
+data = load_excel_data 'Business Processes.xls', 2
+create_visio_document data, 'TPS.vsd'
+
+

data/examples/excel to visio/readme.html

@@ -0,0 +1,104 @@
+<html>
+<head>
+  <title>Card Wall Generator</title>
+</head>
+<body>
+<div align="center">
+<div style="width:800;" align="left">
+<h1>Card Wall Generator</h1>
+
+
+
+<h2>What is it?</h2>
+<hr/>
+
+<p>
+this tool will take an excel spreadsheet with a hierarchical story list in it, and generate
+a "card wall" in visio from it.
+</p>
+
+<p style="text-align:right">
+<img src="TPS-small.png"><br>
+<i>a "card wall"</i>
+</p>
+
+<p>
+the spreadsheet might look like - <a href="business processes.xls">business processes.xls</a>
+</p>
+
+<p>
+and the card wall might look like - <a href="TPS.vsd">TPS.vsd</a><br>
+</p>
+
+
+
+
+<h2>Installation</h2>
+<hr/>
+
+<h3>You will need:</h3>
+
+<ul>
+<li>Windows - sorry only works on windows right now...
+<li>Excel
+<li>Visio
+<li>Ruby - download it from here - <a href="http://rubyforge.org/projects/rubyinstaller/">http://rubyforge.org/projects/rubyinstaller/</a>
+</ul>
+
+<p>
+Once you have all those installed, you can test your installation by double clicking the
+"generate card walls.rb" file.  It should open excel for a second, then open up visio and
+generate 2 card walls.
+</p>
+
+<h3>The Driver File</h3>
+
+<p>
+What the card wall generator does is configured by the "generate card walls.rb" file.  Open
+it up and take a look.  You should see stuff like :
+</p>
+
+<code><pre>
+     data = load_excel_data 'Business Processes.xls', 1
+     create_visio_document data, 'Caution.vsd'
+</pre></code>
+
+<p>You can customize this for your needs.  Basically copy these 2 lines for every card wall
+you want to create, and substitute these for the values :
+<ul>
+<li>excel file with the master story list - "Business Processes.xls"
+<li>index of the sheet within the excel file - "1"
+<li>visio file that will be created - "Caution.vsd"
+</ul>
+</p>
+
+
+
+<h2>More Information</h2>
+<hr/>
+
+<p>Visit the project website at :</p>
+
+<p><a href="http://rubyforge.org/projects/cardwallgen">http://rubyforge.org/projects/cardwallgen</a></p>
+
+<p>The documentation is still pretty sparse.  If you can find someone that knows ruby, have them poke
+around, and they'll probably be able to figure out how to do most things.  Otherwise, email the list
+at cardwallgen-users@rubyforge.org, or sign up for the list at the project website.</p>
+
+
+
+
+<h2>License</h2>
+<hr/>
+
+<p>
+<i>Copyright (C) 2006 Jeremy Stell-Smith</i>
+</p>
+
+<p>
+This software is distributed under the LGPL license.
+</p>
+</div>
+</div>
+</body>
+</html>

data/examples/importing into tracker api/Stories.csv

@@ -0,0 +1,16 @@
+Activity,Task,Story,Note,Estimate,Priority
+Voter,Vote on question,Ability to see question,,1,H
+,,Ability to see choices,,1,M
+,,Ability to choose,This is the server trip,2,H
+,Navigate questions,Ability to continue to next / prev,,1,H
+,,Ability to see list of questions,This includes ability to jump to that question,3,H
+,Submit,Ability to return to new screen,,1,M
+Admin,Create questions,Ability to enter question,,3,H
+,,Ability to reorder question,,3,H
+,,Ability to enter multiple choice question,,1,L
+,,Ability to enter text question,,1,H
+,,Ability to enter long text question,,1,H
+,,Ability to enter list question,,2,L
+,Compile votes,Ability to see results in spreadsheet,,3,H
+,,Ability to see summary of results,This includes percentage of each question answering which answer,2,M
+,Announce winners,,,,

data/examples/importing into tracker api/appscript_example.rb

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'appscript'
+
+itunes = Appscript.app('iTunes')
+
+track = itunes.current_track
+p track                     # <OSA::Itunes::FileTrack:0x1495e20>
+p track.name                # "Over The Rainbow" 
+p track.artist              # "Keith Jarrett" 
+p track.duration            # 362.368988037109 
+p track.date_added.to_s     # "2006-06-30" 
+p track.enabled?            # true
+
+# Play the selected track.
+itunes.play                    
+
+# Fade the volume.
+100.times { |i| itunes.sound_volume = i; sleep 0.1 }

data/examples/importing into tracker api/from_numbers_09

@@ -0,0 +1,50 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require File.dirname(__FILE__) + "/../../lib/cards" # you probably want to include the gem version
+require 'rest_client'
+
+token = "d6b1b5ded944959aec78754ff9f018bd"
+project_id = "9989"
+priority = %w(L M H)
+
+project = RestClient::Resource.new("http://www.pivotaltracker.com/services/v2/projects/#{project_id}", 
+                                   :headers => { "X-TrackerToken" => token })
+
+# puts project["stories?filter=type:bug"].get
+
+require 'rbosa'
+numbers = OSA.app('Numbers')
+
+# itunes = OSA.app('iTunes')
+# track = itunes.current_track
+# p track                     # <OSA::Itunes::FileTrack:0x1495e20>
+# p track.name                # "Over The Rainbow" 
+# p track.artist              # "Keith Jarrett" 
+# p track.duration            # 362.368988037109 
+# p track.date_added.to_s     # "2006-06-30" 
+# p track.enabled?            # true
+# 
+
+
+
+
+
+
+csv = Cards::CsvParser.new(File.dirname(__FILE__) + "/Stories.csv")
+rows = csv.denormalized_rows(:story, [:activity, :task])
+rows = rows.sort_by {|row| priority.index(row[:priority])}
+
+rows.each do |row|
+  puts "adding #{row[:story]}"
+
+  params = {}
+  params[:name] = row[:story]
+  # params[:story_type] = "bug"
+  params[:current_state] = "unstarted"
+  params[:requested_by] = "Cards Test User"
+  params[:estimate] = row[:estimate]
+  params[:description] = "while #{row[:activity]}\n#{row[:note]}"
+
+  # project["stories"].post(:story => params)
+end
+  

data/examples/importing into tracker api/generate_card_wall

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require File.dirname(__FILE__) + "/../../lib/cards" # you probably want to include the gem version
+require 'rest_client'
+
+token = "d6b1b5ded944959aec78754ff9f018bd"
+project_id = "9989"
+priority = %w(L M H)
+
+project = RestClient::Resource.new("http://www.pivotaltracker.com/services/v2/projects/#{project_id}", 
+                                   :headers => { "X-TrackerToken" => token })
+
+# puts project["stories?filter=type:bug"].get
+
+csv = Cards::CsvParser.new(File.dirname(__FILE__) + "/Stories.csv")
+rows = csv.denormalized_rows(:story, [:activity, :task])
+rows = rows.sort_by {|row| priority.index(row[:priority])}
+
+rows.each do |row|
+  puts "adding #{row[:story]}"
+
+  params = {}
+  params[:name] = row[:story]
+  # params[:story_type] = "bug"
+  params[:current_state] = "unstarted"
+  params[:requested_by] = "Cards Test User"
+  params[:estimate] = row[:estimate]
+  params[:description] = "while #{row[:activity]}\n#{row[:note]}"
+
+  project["stories"].post(:story => params)
+end
+  

data/examples/importing into tracker api/osa.rb

@@ -0,0 +1,39 @@
+require 'rubygems'
+require 'rbosa'
+
+def find_table(document, name)
+  document.sheets.each do |sheet|
+    sheet.tables.each do |table|
+      return table
+    end
+  end
+end
+
+numbers = OSA.app('Numbers')
+document = numbers.open(File.dirname(__FILE__) + "/Voting Example.numbers")
+table = find_table(document, "Stories")
+
+p table.name
+table.rows.each do |row|
+  values = []
+  row.cells.map do |cell|
+    values << cell.name << cell.value
+  end
+  p values
+end
+
+# itunes = OSA.app('iTunes')
+# 
+# track = itunes.current_track
+# p track                     # <OSA::Itunes::FileTrack:0x1495e20>
+# p track.name                # "Over The Rainbow" 
+# p track.artist              # "Keith Jarrett" 
+# p track.duration            # 362.368988037109 
+# p track.date_added.to_s     # "2006-06-30" 
+# p track.enabled?            # true
+# 
+# # Play the selected track.
+# itunes.play                    
+# 
+# # Fade the volume.
+# 100.times { |i| itunes.sound_volume = i; sleep 0.1 }

data/examples/numbers to omnigraffle/generate_card_walls

@@ -1,29 +1,31 @@
 #!/usr/bin/env ruby
-# this doesn't actually read the numbers document, you must export csv from numbers as we've done here, 
-# the csv can then be parsed and turned into omnigraffle
-
 require 'rubygems'
+gem 'cards'
 require 'cards'
+require 'cards/numbers_parser'
 include Cards
 
-def csv_file(name)
-  CsvParser.new(File.dirname(__FILE__) + "/Voting Example/Cards-#{name}.csv")
+# this requires numbers '09, before that you must export to csv and use the csv parser
+
+def table(name)
+  file = File.dirname(__FILE__) + "/Voting Example.numbers"
+  NumbersParser.new(file, name)
 end
 
 CardWall.colors[:goal] = :green
 CardWall.writer = GraffleWriter
 
-CardWall.from csv_file("Goals") do
+CardWall.from table("Goals") do
   column :goal
 end
 
-CardWall.from csv_file("Workflow") do
+CardWall.from table("Workflow") do
   row :role
   column :task, :wrap_at => 5
 end
 
-CardWall.from csv_file("Stories") do
-  row :role
+CardWall.from table("Stories") do
+  row :activity
   row :task
   column :story, :wrap_at => 4 do |card, row|
     card.name = "                                       #{row[:estimate]}\n\n#{card.name}" unless row[:estimate].blank?

data/lib/cards.rb

@@ -9,9 +9,11 @@ require 'cards/card_wall'
 require 'cards/writers/dot_writer'
 require 'cards/writers/graffle_writer'
 
+# csv builders
+require 'cards/csv_builder'
 require 'cards/master_story_list'
 require 'cards/tracker_csv'
 
 module Cards
-  VERSION = "0.7"
+  VERSION = "0.9"
 end

data/lib/cards/csv_builder.rb

@@ -1,46 +1,48 @@
-class CsvBuilder
-  def initialize(file_name)
-    @file_name = file_name
-    @file = File.open(file_name, "wb")
-    @csv = CSV::Writer.create(@file)
-    @csv << header
-  end
+module Cards
+  class CsvBuilder
+    def initialize(file_name)
+      @file_name = file_name
+      @file = File.open(file_name, "wb")
+      @csv = CSV::Writer.create(@file)
+      @csv << header
+    end
   
-  def header
-    raise "implement me"
-  end
+    def header
+      raise "implement me"
+    end
   
-  def self.from(parser)
-    builder = self.new(parser.default_output_file + ".#{self.to_s.gsub("Cards::", "").downcase}.csv")
+    def self.from(parser)
+      builder = self.new(parser.default_output_file + ".#{self.to_s.gsub("Cards::", "").downcase}.csv")
 
-    parser.each_row do |row|
-      builder.process(row)
-    end
+      parser.each_row do |row|
+        builder.process(row)
+      end
     
-    builder.done
-  end
+      builder.done
+    end
   
-  def process(row)
-    [:activity, :task, :story].each do |handler|
-      send("add_#{handler}", row[handler], row) if row[handler]
+    def process(row)
+      [:activity, :task, :story].each do |handler|
+        send("add_#{handler}", row[handler], row) if row[handler]
+      end
     end
-  end
   
-  def add_activity(name, params = {})
-    @activity = name
-  end
+    def add_activity(name, params = {})
+      @activity = name
+    end
   
-  def add_task(name, params = {})
-    @task = name
-  end
+    def add_task(name, params = {})
+      @task = name
+    end
   
-  def add_story(name, params = {})
-    raise "implement me"
-  end
+    def add_story(name, params = {})
+      raise "implement me"
+    end
   
-  def done
-    @csv.close
-    @file.close
-    `open #{@file_name.gsub(' ', '\\ ')}`
+    def done
+      @csv.close
+      @file.close
+      `open #{@file_name.gsub(' ', '\\ ')}`
+    end
   end
 end

data/lib/cards/csv_parser.rb

@@ -1,60 +1,22 @@
 require 'csv'
+require 'cards/tabular_parser'
 
 module Cards
   class CsvParser
+    include TabularParser
+    
     def initialize(file)
       @file = file
     end
 
-    def rows
-      rows = []
-      each_row {|row| rows << row}
-      rows
-    end
-    
-    def each_row
-      header = nil
+    def each_unparsed_row
       CSV.open(@file, 'r') do |row|
-        if header.nil?
-          header = define_header(row)
-        else
-          yield Row.new(header, row)
-        end
+        yield row
       end
     end
-  
+    
     def default_output_file
       File.basename(@file).sub(/\..*/, '')
     end
-    
-    private
-
-    def define_header(header_row)
-      header = {}
-      header_row.each_with_index do |name, i|
-        header[name.downcase.gsub(' ', '_').to_sym] = i
-      end
-      return header
-    end
-
-    class Row
-      def initialize(header, row)
-        @header, @row = header, row
-      end
-
-      def [](key)
-        index = @header[key] || raise("can't find column header #{key.inspect} in #{@header.inspect}")
-        @row[index]
-      end
-
-      def to_h
-        h = {}
-        @header.each_key do |column_header|
-          val = @row[@header[column_header]]
-          h[column_header] = val unless val.blank?
-        end
-        h
-      end
-    end
   end
 end

data/lib/cards/numbers_parser.rb

@@ -0,0 +1,43 @@
+require 'rbosa'
+require 'cards/tabular_parser'
+
+module Cards
+  class NumbersParser
+    include TabularParser
+    
+    def initialize(file, table_name)
+      @file, @table_name = file, table_name
+    end
+
+    def each_unparsed_row
+      numbers = OSA.app('Numbers')
+      document = numbers.open(@file)
+      table = find_table(document, @table_name)
+
+      table.rows.each do |row|
+        values = []
+        row.cells.map do |cell|
+          value = cell.value
+          value = nil if value == 0
+          values << value
+        end
+        yield values
+      end
+    end
+
+    def default_output_file
+      @table_name
+    end
+    
+    private
+    
+    def find_table(document, name)
+      document.sheets.each do |sheet|
+        sheet.tables.each do |table|
+          return table if table.name.downcase == name.downcase
+        end
+      end
+      raise "table #{name} not found in #{document.name}"
+    end
+  end
+end

data/lib/cards/swim_lanes.rb

@@ -1,5 +1,6 @@
 require 'cards/card_wall'
 
+# todo ...
 module Cards
   class SwimLanes < CardWall
     def initialize

data/lib/cards/tabular_parser.rb

@@ -0,0 +1,78 @@
+module Cards
+  module TabularParser
+    def rows
+      rows = []
+      each_row {|row| rows << row}
+      rows
+    end
+
+    def each_row
+      header = nil
+      each_unparsed_row do |row|
+        if header.nil?
+          header = define_header(row)
+        else
+          yield Row.new(header, row)
+        end
+      end
+    end
+    
+    # this method will turn something of the form
+    #
+    # activity | task    | story   |
+    # a        |         |         |
+    #          | b       |         |
+    #          |         | c       |
+    #          |         | d       |
+    #
+    # into 
+    #
+    # activity | task    | story   |
+    # a        | b       | c       |
+    # a        | b       | d       |
+    #
+    def denormalized_rows(key_column, columns_to_denormalize)
+      last_row = {}
+      rows = []
+      each_row do |row|
+        row = row.to_h
+        columns_to_denormalize.each do |c|
+          row[c] = last_row[c] if row[c].blank?
+        end
+        rows << row unless row[key_column].blank?
+        last_row = row
+      end
+      rows
+    end
+    
+    private
+
+    def define_header(header_row)
+      header = {}
+      header_row.each_with_index do |name, i|
+        header[name.downcase.gsub(' ', '_').to_sym] = i
+      end
+      return header
+    end
+
+    class Row
+      def initialize(header, row)
+        @header, @row = header, row
+      end
+
+      def [](key)
+        index = @header[key] || raise("can't find column header #{key.inspect} in #{@header.inspect}")
+        @row[index]
+      end
+
+      def to_h
+        h = {}
+        @header.each_key do |column_header|
+          val = @row[@header[column_header]]
+          h[column_header] = val unless val.blank?
+        end
+        h
+      end
+    end
+  end
+end

data/lib/cards/tracker_csv.rb

@@ -1,19 +1,21 @@
 require 'cards/csv_builder'
 
-class TrackerCsv < CsvBuilder
-  def header
-    ["Story", "Labels", "Story Type", "Estimate", "Description"]
-  end
+module Cards
+  class TrackerCsv < CsvBuilder
+    def header
+      ["Story", "Labels", "Story Type", "Estimate", "Description"]
+    end
 
-  def add_story(name, params = {})
-    return unless [nil, '', 'Story', 'Chore'].include?(params[:story_type])
+    def add_story(name, params = {})
+      return unless [nil, '', 'Story', 'Chore'].include?(params[:story_type])
     
-    @csv << [
-              name,
-              @task,
-              params[:story_type],
-              nil, # params[:estimate],
-              "#{@activity}\n#{params[:description]}"
-            ]
+      @csv << [
+                name,
+                @task,
+                params[:story_type],
+                nil, # params[:estimate],
+                "#{@activity}\n#{params[:description]}"
+              ]
+    end
   end
 end

data/lib/cards/writers/dot_writer.rb

@@ -1,7 +1,11 @@
 module Cards
   class DotWriter
-    def initialize(file_name)
-      @file = File.open(file_name + ".dot", "w")
+    def initialize(file)
+      if file.respond_to? :puts
+        @file = file
+      else
+        @file = File.open(file + ".dot", "w")
+      end
       @node_color = {:green => "darkseagreen1", :blue => "lightblue", :red => "pink", :yellow => "lightyellow"}
       @nodes = []
 

data/spec/cards/csv_parser_spec.rb

@@ -7,22 +7,40 @@ include Cards
 describe CsvParser do
   include FileSandbox
   
-  it "should parse csv" do
+  before do
     sandbox.new :file => 'tmp.csv', :with_contents =>
 "activity,task,story,estimate
 manage email,,
 ,read email,
 ,,display email body
-manage email,think about email,,1
+manage email,think about email,mow the lawn,1
 ,read email,,2
 ,,display email body,3"
-    
+  end
+  
+  it "should parse csv" do    
     rows = CsvParser.new(sandbox['tmp.csv'].path).rows
     rows[0].to_h.should == {:activity => 'manage email'}
     rows[1].to_h.should == {:task => 'read email'}
     rows[2].to_h.should == {:story => 'display email body'}
-    rows[3].to_h.should == {:activity => 'manage email', :task => 'think about email', :estimate => "1"}
+    rows[3].to_h.should == {:activity => 'manage email', :task => 'think about email', :story => 'mow the lawn', :estimate => "1"}
     rows[4].to_h.should == {:task => 'read email', :estimate => "2"}
     rows[5].to_h.should == {:story => 'display email body', :estimate => "3"}
   end
+  
+  it "should denormalize rows" do
+    rows = CsvParser.new(sandbox['tmp.csv'].path).denormalized_rows(:story, [:activity, :task])
+    rows.size.should == 3
+    rows[0].should == {:activity => 'manage email', 
+                       :task => 'read email', 
+                       :story => 'display email body'}
+    rows[1].should == {:activity => 'manage email', 
+                       :task => 'think about email', 
+                       :story => 'mow the lawn', 
+                       :estimate => "1"}
+    rows[2].should == {:activity => 'manage email', 
+                       :task => 'read email', 
+                       :story => 'display email body',
+                       :estimate => '3'}
+  end
 end

data/spec/cards/numbers_parser_spec.rb

@@ -0,0 +1,25 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+require 'cards/numbers_parser'
+
+# not the best test, but it will do
+describe Cards::NumbersParser do
+  describe "each_row" do
+    it "should find all rows in Voting Example" do
+      file = File.expand_path(File.dirname(__FILE__) + "/../fixtures/Voting Example.numbers")
+      parser = Cards::NumbersParser.new(file, "Workflow")
+      rows = parser.rows
+      rows[0].to_h.should == {:role => "Voter", :task => "Vote on question"}
+      rows[1].to_h.should == {:task => "Navigate questions"}
+      rows[2].to_h.should == {:task => "Submit"}
+      rows[3].to_h.should == {:role => "Admin", :task => "Create questions"}
+      rows[4].to_h.should == {:task => "Compile votes"}
+      rows[5].to_h.should == {:task => "Announce winners"}
+    end
+  end
+  
+  describe "default_output_file" do
+    it "should be the table name" do
+      Cards::NumbersParser.new("some file.numbers", "larry").default_output_file.should == "larry"
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: cards
 version: !ruby/object:Gem::Version 
-  version: "0.7"
+  version: "0.9"
 platform: ruby
 authors: 
 - Jeremy Stell-Smith
@@ -9,17 +9,18 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-06-06 00:00:00 -07:00
+date: 2009-03-05 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: hoe
+  type: :development
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.5.3
+        version: 1.8.2
     version: 
 description: CardWallGen is a program that reads a requirements map and generates a view  of it.  Typically it reads it from excel or csv and generates a graphical  view in visio or omnigraffle, though it may also generate another csv view of it.
 email: jeremystellsmith@gmail.com
@@ -29,48 +30,67 @@ extensions: []
 
 extra_rdoc_files: 
 - CHANGES.txt
-- Manifest.txt
 - README.txt
 files: 
 - CHANGES.txt
-- Manifest.txt
-- README.txt
 - Rakefile
-- examples/csv to dot/Stories.csv
-- examples/csv to dot/Stories.dot
+- README.txt
+- examples/csv to dot
 - examples/csv to dot/generate_card_walls
-- examples/numbers to omnigraffle/Voting Example.numbers/Contents/PkgInfo
-- examples/numbers to omnigraffle/Voting Example.numbers/QuickLook/Thumbnail.jpg
-- examples/numbers to omnigraffle/Voting Example.numbers/document-thumbnail.tiff
-- examples/numbers to omnigraffle/Voting Example.numbers/index.xml.gz
-- examples/numbers to omnigraffle/Voting Example/Cards-Goals.csv
-- examples/numbers to omnigraffle/Voting Example/Cards-Stories.csv
-- examples/numbers to omnigraffle/Voting Example/Cards-Workflow.csv
+- examples/csv to dot/Stories.csv
+- examples/custom csv builder
+- examples/custom csv builder/generate_card_wall
+- examples/custom csv builder/Stories.csv
+- examples/custom csv builder/Stories.tracker.csv
+- examples/excel to visio
+- examples/excel to visio/Business Processes.xls
+- examples/excel to visio/generate card walls.rb
+- examples/excel to visio/readme.html
+- examples/excel to visio/TPS-small.png
+- examples/importing into tracker api
+- examples/importing into tracker api/appscript_example.rb
+- examples/importing into tracker api/from_numbers_09
+- examples/importing into tracker api/generate_card_wall
+- examples/importing into tracker api/osa.rb
+- examples/importing into tracker api/Stories.csv
+- examples/importing into tracker api/Voting Example.numbers
+- examples/numbers to omnigraffle
 - examples/numbers to omnigraffle/generate_card_walls
-- lib/cards.rb
+- examples/numbers to omnigraffle/Voting Example.numbers
+- lib/cards
 - lib/cards/builder.rb
 - lib/cards/card.rb
 - lib/cards/card_wall.rb
 - lib/cards/csv_builder.rb
 - lib/cards/csv_parser.rb
 - lib/cards/extensions.rb
+- lib/cards/layouts
 - lib/cards/layouts/column_layout.rb
 - lib/cards/layouts/nil_layout.rb
 - lib/cards/layouts/row_layout.rb
 - lib/cards/master_story_list.rb
+- lib/cards/numbers_parser.rb
 - lib/cards/swim_lanes.rb
+- lib/cards/tabular_parser.rb
 - lib/cards/text.rb
 - lib/cards/tracker_csv.rb
+- lib/cards/writers
 - lib/cards/writers/dot_writer.rb
 - lib/cards/writers/graffle_writer.rb
 - lib/cards/writers/text_writer.rb
+- lib/cards.rb
+- spec/cards
 - spec/cards/card_spec.rb
 - spec/cards/card_wall_spec.rb
 - spec/cards/csv_parser_spec.rb
 - spec/cards/extensions_spec.rb
+- spec/cards/numbers_parser_spec.rb
 - spec/cards/swim_lanes_spec.rb
+- spec/cards/writers
 - spec/cards/writers/dot_writer_spec.rb
 - spec/cards/writers/text_writer_spec.rb
+- spec/fixtures
+- spec/fixtures/Voting Example.numbers
 - spec/spec_helper.rb
 has_rdoc: true
 homepage: http://rubyforge.org/projects/cardwallgen
@@ -95,7 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: cardwallgen
-rubygems_version: 1.1.1
+rubygems_version: 1.3.1
 signing_key: 
 specification_version: 2
 summary: CardWallGen is a program that reads a requirements map and generates a view  of it.  Typically it reads it from excel or csv and generates a graphical  view in visio or omnigraffle, though it may also generate another csv view of it.

data/Manifest.txt

@@ -1,40 +0,0 @@
-CHANGES.txt
-Manifest.txt
-README.txt
-Rakefile
-examples/csv to dot/Stories.csv
-examples/csv to dot/Stories.dot
-examples/csv to dot/generate_card_walls
-examples/numbers to omnigraffle/Voting Example.numbers/Contents/PkgInfo
-examples/numbers to omnigraffle/Voting Example.numbers/QuickLook/Thumbnail.jpg
-examples/numbers to omnigraffle/Voting Example.numbers/document-thumbnail.tiff
-examples/numbers to omnigraffle/Voting Example.numbers/index.xml.gz
-examples/numbers to omnigraffle/Voting Example/Cards-Goals.csv
-examples/numbers to omnigraffle/Voting Example/Cards-Stories.csv
-examples/numbers to omnigraffle/Voting Example/Cards-Workflow.csv
-examples/numbers to omnigraffle/generate_card_walls
-lib/cards.rb
-lib/cards/builder.rb
-lib/cards/card.rb
-lib/cards/card_wall.rb
-lib/cards/csv_builder.rb
-lib/cards/csv_parser.rb
-lib/cards/extensions.rb
-lib/cards/layouts/column_layout.rb
-lib/cards/layouts/nil_layout.rb
-lib/cards/layouts/row_layout.rb
-lib/cards/master_story_list.rb
-lib/cards/swim_lanes.rb
-lib/cards/text.rb
-lib/cards/tracker_csv.rb
-lib/cards/writers/dot_writer.rb
-lib/cards/writers/graffle_writer.rb
-lib/cards/writers/text_writer.rb
-spec/cards/card_spec.rb
-spec/cards/card_wall_spec.rb
-spec/cards/csv_parser_spec.rb
-spec/cards/extensions_spec.rb
-spec/cards/swim_lanes_spec.rb
-spec/cards/writers/dot_writer_spec.rb
-spec/cards/writers/text_writer_spec.rb
-spec/spec_helper.rb

data/examples/csv to dot/Stories.dot

@@ -1,63 +0,0 @@
-digraph G {
-graph [nodesep=.1, ranksep=.1, ordering=out];
-node [shape=box, color=black, style=filled, width=2, height=1.2, fixedsize=true, labeljust="l"];
-edge [style=invis, weight=1];
-card_0_0 [label="Voter",fillcolor=lightblue];
-card_0_1 [label="Vote on question",fillcolor=pink];
-card_0_2 [label="Ability to see\nquestion  1",fillcolor=lightyellow];
-card_0_3 [label="Ability to see\nchoices  1",fillcolor=lightyellow];
-card_0_4 [label="Ability to choose\nThis is the server\ntrip  2",fillcolor=lightyellow];
-card_1_1 [label="Navigate questions",fillcolor=pink];
-card_1_2 [label="Ability to continue\nto next / prev  1",fillcolor=lightyellow];
-card_1_3 [label="Ability to see list\nof questions  This\nincludes ability to\njump to that\nquestion  4",fillcolor=lightyellow];
-card_2_1 [label="Submit",fillcolor=pink];
-card_2_2 [label="Ability to return to\nnew screen  1",fillcolor=lightyellow];
-card_3_0 [label="Admin",fillcolor=lightblue];
-card_3_1 [label="Create questions",fillcolor=pink];
-card_3_2 [label="Ability to enter\nquestion  4",fillcolor=lightyellow];
-card_3_3 [label="Ability to reorder\nquestion  4",fillcolor=lightyellow];
-card_3_4 [label="Ability to enter\nmultiple choice\nquestion  1",fillcolor=lightyellow];
-card_3_5 [label="Ability to enter\ntext question  1",fillcolor=lightyellow];
-card_4_2 [label="Ability to enter\nlong text question\n1",fillcolor=lightyellow];
-card_4_3 [label="Ability to enter\nlist question  2",fillcolor=lightyellow];
-card_5_1 [label="Compile votes",fillcolor=pink];
-card_5_2 [label="Ability to see\nresults in\nspreadsheet  4",fillcolor=lightyellow];
-card_5_3 [label="Ability to see\nsummary of results\nThis includes\npercentage of each\nquestion answering\nwhich answer  2",fillcolor=lightyellow];
-card_6_1 [label="Announce winners",fillcolor=pink];
-gap_1_0 [style=invis];
-gap_2_0 [style=invis];
-gap_4_0 [style=invis];
-gap_4_1 [style=invis];
-gap_5_0 [style=invis];
-gap_6_0 [style=invis];
-{rank=same; card_0_0; gap_1_0; gap_2_0; card_3_0; gap_4_0; gap_5_0; gap_6_0};
-{rank=same; card_0_1; card_1_1; card_2_1; card_3_1; gap_4_1; card_5_1; card_6_1};
-{rank=same; card_0_2; card_1_2; card_2_2; card_3_2; card_4_2; card_5_2};
-card_0_0 -> gap_1_0;
-gap_1_0 -> gap_2_0;
-gap_2_0 -> card_3_0;
-card_3_0 -> gap_4_0;
-gap_4_0 -> gap_5_0;
-gap_5_0 -> gap_6_0;
-card_0_0 -> card_0_1;
-card_0_1 -> card_0_2;
-card_0_2 -> card_0_3;
-card_0_3 -> card_0_4;
-gap_1_0 -> card_1_1;
-card_1_1 -> card_1_2;
-card_1_2 -> card_1_3;
-gap_2_0 -> card_2_1;
-card_2_1 -> card_2_2;
-card_3_0 -> card_3_1;
-card_3_1 -> card_3_2;
-card_3_2 -> card_3_3;
-card_3_3 -> card_3_4;
-card_3_4 -> card_3_5;
-gap_4_0 -> gap_4_1;
-gap_4_1 -> card_4_2;
-card_4_2 -> card_4_3;
-gap_5_0 -> card_5_1;
-card_5_1 -> card_5_2;
-card_5_2 -> card_5_3;
-gap_6_0 -> card_6_1;
-}

data/examples/numbers to omnigraffle/Voting Example.numbers/Contents/PkgInfo

@@ -1 +0,0 @@
-????????

data/examples/numbers to omnigraffle/Voting Example/Cards-Goals.csv

@@ -1,7 +0,0 @@
-Goal,Note
-Speed,
-Efficiency,For voter & admin
-Usability,
-Security,
-Traceability,
-Durability,We probably need to store results in a separate location

data/examples/numbers to omnigraffle/Voting Example/Cards-Stories.csv

@@ -1,16 +0,0 @@
-Role,Task,Story,Note,Estimate
-Voter,Vote on question,Ability to see question,,1
-,,Ability to see choices,,1
-,,Ability to choose,This is the server trip,2
-,Navigate questions,Ability to continue to next / prev,,1
-,,Ability to see list of questions,This includes ability to jump to that question,4
-,Submit,Ability to return to new screen,,1
-Admin,Create questions,Ability to enter question,,4
-,,Ability to reorder question,,4
-,,Ability to enter multiple choice question,,1
-,,Ability to enter text question,,1
-,,Ability to enter long text question,,1
-,,Ability to enter list question,,2
-,Compile votes,Ability to see results in spreadsheet,,4
-,,Ability to see summary of results,This includes percentage of each question answering which answer,2
-,Announce winners,,,

data/examples/numbers to omnigraffle/Voting Example/Cards-Workflow.csv

@@ -1,7 +0,0 @@
-Role,Task
-Voter,Vote on question
-,Navigate questions
-,Submit
-Admin,Create questions
-,Compile votes
-,Announce winners