cardigan 0.0.2 → 0.0.3

data/README.rdoc

@@ -2,6 +2,12 @@
 
 A simple command line project task tracking tool.
 
+== Rationale
+
+* command line tools are faster and cooler than any gui or web interface
+* it makes sense to store work items in your source repository 
+* tab completion is awesome
+
 == Installation
 
   gem install cardigan
@@ -18,27 +24,26 @@ So what now?
 
 == Listing mode
 
-You are in listing mode.
+You start in listing mode.
 
 The commands available are (with the awesome power of tab completion):
 
-* quit
-* exit
+* quit or exit or ctrl-d - exit
 * list - shows all cards
 * filter <filter> - sets the filter for cards - this is ruby code such as card[:name].start_with?('a')
-* claim <name> - sets the owner of the card
-* unclaim <name> - removes the card owner
+* claim <numbers> - sets the owner of the specified cards (by index number from the list view)
+* unclaim <numbers> - removes the owner from the specified cards (by index number from the list view)
 * create <name> - creates a card with the specified name
 * open <name> - creates or opens the card and enters edit mode
-* columns - changes the list of columns to be displayed
+* columns - lists or changes the columns to be displayed by the list command
 * destroy <numbers> - deletes the specified cards (by index number from the list view)
 
 == Editing mode
 
-* quit
-* exit
-* set <key> - creates a new key and prompts for the new value
+* quit or exit or ctrl-d - exit
+* show - dumps the values of all card field values
+* set <key> - creates a new field and prompts for the new value
 
 == Future plans
 
-Refer to the .cards for detailed story breakdown but mostly importing, exporting and generating pretty html reports/charts.
+Refer to the .cards for detailed story breakdown but mostly simple worflow, importing, exporting and generating pretty html reports/charts.

data/lib/cardigan/entry_context.rb

@@ -6,12 +6,18 @@ module Cardigan
     
     def initialize io, entry
       @io, @entry = io, entry
-      @prompt_text = "#{File.expand_path('.').split('/').last.slice(0..1)}/#{entry['name']} > "
-      @commands = ['set']
+      @prompt_text = "#{File.expand_path('.').split('/').last.slice(0..0)}/#{entry['name']} > "
+      @commands = ['set', 'show']
     end
 
     def set_command key
       @entry[key] = @io.ask("Enter the new value for #{key}")
     end
+    
+    def show_command ignored=nil
+      @entry.keys.sort.each do |key|
+        @io.say "#{key}: #{@entry[key]}"
+      end
+    end
   end
 end

data/lib/cardigan/root_context.rb

@@ -1,5 +1,6 @@
 require 'rubygems'
 require 'uuidtools'
+require 'set'
 require 'cardigan/context'
 require 'cardigan/entry_context'
 require 'cardigan/text_report_formatter'
@@ -16,15 +17,9 @@ module Cardigan
 
     def refresh_commands
       @repository.refresh
-      @commands = ['create', 'list', 'filter', 'unfilter', 'columns']
+      @commands = ['create', 'list', 'filter', 'unfilter', 'columns', 'claim', 'unclaim', 'destroy']
       @repository.cards.each do |card|
         @commands << "open #{card['name']}"
-        @commands << "destroy #{card['name']}"
-        if card['owner'] == @name
-          @commands << "unclaim #{card['name']}"
-        else
-          @commands << "claim #{card['name']}"
-        end
       end
     end
 
@@ -32,16 +27,14 @@ module Cardigan
       @repository.save @repository.find_or_create(name)
     end
 
-    def open_command text
+    def open_command name
       card = @repository.find_or_create(name)
       EntryContext.new(@io, card).push
       @repository.save card
     end
 
-    def destroy_command text
-      cards = sorted_selection
-      text.scan(/\d+/).each do |n|
-        card = cards[n.to_i - 1]
+    def destroy_command numbers
+      each_card_from_indices(numbers) do |card|
         @io.say "destroying \"#{card['name']}\""
         @repository.destroy card
       end
@@ -62,7 +55,16 @@ module Cardigan
     end
     
     def columns_command text
-      @columns = text.split(',') if text
+      if text
+        @columns = text.scan(/\w+/) 
+      else
+        @io.say "current columns: #{@columns.join(',')}"
+        columns = Set.new
+        sorted_selection.each do |card|
+          columns += card.keys
+        end
+        @io.say "available columns: #{columns.sort.join(',')}"
+      end
     end
     
     def filter_command code
@@ -76,32 +78,36 @@ module Cardigan
       end
     end
     
-    def claim_command name
-      set_key name, 'owner', @name
+    def claim_command numbers
+      each_card_from_indices(numbers) do |card|
+        @io.say "claiming \"#{card['name']}\""
+        card['owner'] = @name
+        @repository.save card
+      end
     end
     
-    def unclaim_command name
-      set_key name, 'owner', nil
+    def unclaim_command numbers
+      each_card_from_indices(numbers) do |card|
+        @io.say "claiming \"#{card['name']}\""
+        card.delete('owner')
+        @repository.save card
+      end
     end
 private
-    def max_field_length cards, name
-      cards.map {|v| v[name] ? v[name].length : 0 }.max
+    def each_card_from_indices numbers
+      cards = sorted_selection
+      numbers.scan(/\d+/).each do |n|
+        yield cards[n.to_i - 1]
+      end
     end
 
+    def max_field_length cards, name
+      cards.map {|card| card[name] ? card[name].length : 0 }.max
+    end
+ 
     def sorted_selection
       cards = @filter ? @repository.cards.select {|card| eval @filter } : @repository.cards
       cards.sort {|a,b| a['name'] <=> b['name'] }
     end
-
-    def set_key name, key, value
-      card = @repository.find_card(name)
-      if card
-        card[key] = value
-        @repository.save card
-      else
-        @io.say "unknown card #{text}"
-      end
-    end
   end
 end
-    

data/lib/cardigan/text_report_formatter.rb

@@ -18,7 +18,7 @@ module Cardigan
       row 'index', @columns.map {|tuple| tuple.first }
       hline
       hashes.each_with_index do |h,i|
-        row i.to_s, @columns.map {|tuple| h[tuple.first]}
+        row (i+1).to_s, @columns.map {|tuple| h[tuple.first]}
       end
       hline
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: cardigan
 version: !ruby/object:Gem::Version 
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors: 
 - Mark Ryall
@@ -9,19 +9,9 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-12 00:00:00 +11:00
+date: 2010-03-13 00:00:00 +11:00
 default_executable: 
 dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: highline
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        version: 1.5.1
-    version: 
 - !ruby/object:Gem::Dependency 
   name: uuidtools
   type: :runtime
@@ -32,26 +22,6 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 2.1.1
     version: 
-- !ruby/object:Gem::Dependency 
-  name: crypt
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        version: 1.1.4
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: pathname2
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        version: 1.6.3
-    version: 
 description: |
   A command line utility that manages cards as individual files so that they can be added to a version control system