crab 0.2.4 → 0.2.6

data/bin/crab-st-mv

@@ -0,0 +1,26 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab story move: move a story from one status to the next (or previous)
+
+Usage: crab story move <id> [options*]
+  BANNER
+  opt :back, "Move story backwards (from accepted to completed, for example)"
+  opt :dry, "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+id = ARGV.join(" ")
+Trollop::die "No story given" if id.empty?
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  story = rally.find_story_with_id id
+  state = state_from(story.state)
+
+  story.update :schedule_state => (opts[:back] ? state_before(state) : state_after(state))
+
+  puts "#{story.formatted_id}: #{story.name} (#{story.state})"
+end

data/bin/crab-st-new

@@ -0,0 +1,19 @@
+# vim: set ft=ruby :
+require 'crab'
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab story create: create a new story in Rally
+
+Usage: crab story create <name> [options*]
+  BANNER
+  opt :dry, "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+name = ARGV.join(" ")
+Trollop::die "Please specify a name for the story" if name.blank?
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  story = rally.create_story :name => name
+  puts "#{story.formatted_id}: #{story.name} (#{story.state})"
+end

data/bin/crab-st-pull

@@ -0,0 +1,37 @@
+# vim: set ft=ruby :
+require 'crab'
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab story pull: pulls stories from Rally and writes them out as Cucumber features
+
+Usage: crab story pull <id> [id*] [options*]
+  BANNER
+  opt :language, "Language to generate Cucumber features in (ISO code)", :default => "en", :short => "-l"
+  opt :dry, "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+Crab::Rally.new(opts[:dry]) do |rally|
+
+  ARGV.each do |story_number|
+    story = rally.find_story_with_id story_number
+    Trollop::die "Could not find story with ID #{story_number}" if story.nil?
+
+    puts "#{story.formatted_id}: #{story.full_file_name}"
+
+    fileutils_opts = opts[:dry] ? { :noop => true, :verbose => true } : {}
+
+    FileUtils.mkdir_p File.dirname(story.full_file_name), fileutils_opts
+    FileUtils.touch story.full_file_name, fileutils_opts
+
+    output = Crab::CucumberFeature.new(opts[:language]).generate_from story
+
+    if opts[:dry]
+      puts "Would write to #{story.full_file_name}:\n\n#{output}"
+    else
+      File.open(story.full_file_name, "w") do |file|
+        file.write output
+      end
+    end
+  end
+end

data/bin/crab-st-ren

@@ -0,0 +1,27 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab story rename: rename a story
+
+Usage: crab story rename <id> <name> [options*]
+  BANNER
+  opt :dry, "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+id = ARGV.shift
+Trollop::die "No story given" if id.empty?
+
+name = ARGV.join(" ").squish
+Trollop::die "No name given" if name.empty?
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  story = rally.find_story_with_id id
+
+  story.update :name => name
+
+  puts "#{story.formatted_id}: #{story.name} (#{story.state})"
+end

data/bin/crab-st-rename

@@ -0,0 +1,27 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab story rename: rename a story
+
+Usage: crab story rename <id> <name> [options*]
+  BANNER
+  opt :dry, "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+id = ARGV.shift
+Trollop::die "No story given" if id.empty?
+
+name = ARGV.join(" ").squish
+Trollop::die "No name given" if name.empty?
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  story = rally.find_story_with_id id
+
+  story.update :name => name
+
+  puts "#{story.formatted_id}: #{story.name} (#{story.state})"
+end

data/bin/crab-st-rm

@@ -0,0 +1,21 @@
+# vim: set ft=ruby :
+require 'crab'
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab story delete: delete an existing story in Rally
+
+Usage: crab story delete <id> [options*]
+  BANNER
+  opt :dry, "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+id = ARGV.join(" ")
+Trollop::die "Story ID must be specified" if id.blank?
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  story = rally.find_story_with_id id
+  story.delete
+
+  puts "Story #{id} deleted."
+end

data/bin/crab-st-show

@@ -0,0 +1,19 @@
+# vim: set ft=ruby :
+require 'crab'
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab story show: displays a story in Rally as a Cucumber feature
+
+Usage: crab story show <id> [options*]"
+  BANNER
+  opt :language, "Language to display Cucumber features in (ISO code)", :default => "en", :short => "-l"
+  opt :dry, "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+id = ARGV.first
+Crab::Rally.new(opts[:dry]) do |rally|
+  story = rally.find_story_with_id(id)
+
+  puts Crab::CucumberFeature.new(opts[:language]).generate_from story
+end

data/bin/crab-st-up

@@ -0,0 +1,62 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+cmd_opts = Trollop::options do
+  banner <<-BANNER
+crab story update: update a story in Rally
+
+Usage: crab story update <id> [options*]
+  BANNER
+  opt :name,      "Name (title)", :type => String, :short => "-n"
+  opt :state,     "State (one of: #{Crab::Story::VALID_STATES.join(" ")})", :type => String, :short => "-t"
+  opt :estimate,  "Estimate",     :type => :int,   :short => "-e"
+  opt :iteration, "Iteration",    :type => String, :short => "-i"
+  opt :release,   "Release",      :type => String, :short => "-r"
+  opt :blocked,   "Blocked",      :short => "-b"
+  opt :unblocked, "Unblocked",    :short => "-u"
+  opt :parent,    "Parent",       :type => String, :short => "-p"
+  opt :dry,       "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+Trollop::die "No story given" if ARGV.empty?
+Trollop::die "Nothing to update. Please provide some options" unless cmd_opts.any? {|k, v| k.to_s =~ /_given$/ }
+
+opts = {}
+opts[:name] = cmd_opts[:name] if cmd_opts[:name_given]
+opts[:schedule_state] = state_from(cmd_opts[:state]) if cmd_opts[:state_given]
+
+if cmd_opts[:estimate_given]
+  opts[:plan_estimate] = cmd_opts[:estimate] # nobody is going to remember "Plan Estimate", really
+end
+
+opts[:blocked] = cmd_opts[:blocked] if cmd_opts[:blocked_given]
+opts[:blocked] = !cmd_opts[:unblocked] if cmd_opts[:unblocked_given]
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  rally.connect
+
+  story = rally.find_story_with_id ARGV.first
+
+  if cmd_opts[:iteration_given]
+    opts[:iteration] = rally.find_iteration_by_name cmd_opts[:iteration], story.rally_object.project
+    Trollop::die "Unknown iteration \"#{cmd_opts[:iteration]}\"" if opts[:iteration].nil?
+  end
+
+  if cmd_opts[:release_given]
+    opts[:release] = rally.find_release_by_name cmd_opts[:release], story.rally_object.project
+    Trollop::die "Unknown release \"#{cmd_opts[:release]}\"" if opts[:release].nil?
+  end
+
+  if cmd_opts[:parent_given]
+    opts[:parent] = rally.find_story_with_id(cmd_opts[:parent]).rally_object
+    Trollop::die "Unknown story \"#{cmd_opts[:parent]}\"" if opts[:parent].nil?
+  end
+
+  opts[:name] = story.name if opts[:name].blank?
+
+  story.update opts
+
+  puts "#{story.formatted_id}: #{story.name} (#{story.state})"
+end

data/bin/crab-st-update

@@ -0,0 +1,62 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+cmd_opts = Trollop::options do
+  banner <<-BANNER
+crab story update: update a story in Rally
+
+Usage: crab story update <id> [options*]
+  BANNER
+  opt :name,      "Name (title)", :type => String, :short => "-n"
+  opt :state,     "State (one of: #{Crab::Story::VALID_STATES.join(" ")})", :type => String, :short => "-t"
+  opt :estimate,  "Estimate",     :type => :int,   :short => "-e"
+  opt :iteration, "Iteration",    :type => String, :short => "-i"
+  opt :release,   "Release",      :type => String, :short => "-r"
+  opt :blocked,   "Blocked",      :short => "-b"
+  opt :unblocked, "Unblocked",    :short => "-u"
+  opt :parent,    "Parent",       :type => String, :short => "-p"
+  opt :dry,       "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+Trollop::die "No story given" if ARGV.empty?
+Trollop::die "Nothing to update. Please provide some options" unless cmd_opts.any? {|k, v| k.to_s =~ /_given$/ }
+
+opts = {}
+opts[:name] = cmd_opts[:name] if cmd_opts[:name_given]
+opts[:schedule_state] = state_from(cmd_opts[:state]) if cmd_opts[:state_given]
+
+if cmd_opts[:estimate_given]
+  opts[:plan_estimate] = cmd_opts[:estimate] # nobody is going to remember "Plan Estimate", really
+end
+
+opts[:blocked] = cmd_opts[:blocked] if cmd_opts[:blocked_given]
+opts[:blocked] = !cmd_opts[:unblocked] if cmd_opts[:unblocked_given]
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  rally.connect
+
+  story = rally.find_story_with_id ARGV.first
+
+  if cmd_opts[:iteration_given]
+    opts[:iteration] = rally.find_iteration_by_name cmd_opts[:iteration], story.rally_object.project
+    Trollop::die "Unknown iteration \"#{cmd_opts[:iteration]}\"" if opts[:iteration].nil?
+  end
+
+  if cmd_opts[:release_given]
+    opts[:release] = rally.find_release_by_name cmd_opts[:release], story.rally_object.project
+    Trollop::die "Unknown release \"#{cmd_opts[:release]}\"" if opts[:release].nil?
+  end
+
+  if cmd_opts[:parent_given]
+    opts[:parent] = rally.find_story_with_id(cmd_opts[:parent]).rally_object
+    Trollop::die "Unknown story \"#{cmd_opts[:parent]}\"" if opts[:parent].nil?
+  end
+
+  opts[:name] = story.name if opts[:name].blank?
+
+  story.update opts
+
+  puts "#{story.formatted_id}: #{story.name} (#{story.state})"
+end

data/bin/crab-story-change

@@ -45,7 +45,7 @@ Crab::Rally.new(opts[:dry]) do |rally|
   end
 
   if cmd_opts[:release_given]
-    opts[:release] = rally.find_release_by_name cmd_opts[:release], story.project
+    opts[:release] = rally.find_release_by_name cmd_opts[:release], story.rally_object.project
     Trollop::die "Unknown release \"#{cmd_opts[:release]}\"" if opts[:release].nil?
   end
 

data/bin/crab-story-help

@@ -5,7 +5,15 @@ Usage: crab story <command> [options*]
 
   Available commands:
 
-  help  Show this help text
+  create  Create stories
+  delete  Delete stories
+    find  Find stories
+    help  This help message
+    move  Move story status (from completed to accepted, etc)
+    pull  Pull stories as Cucumber features
+  rename  Rename stories
+    show  Show stories as Cucumber features
+  update  Update stories
 
      --help, -h:   Show this message
 HELP

data/bin/crab-story-up

@@ -45,7 +45,7 @@ Crab::Rally.new(opts[:dry]) do |rally|
   end
 
   if cmd_opts[:release_given]
-    opts[:release] = rally.find_release_by_name cmd_opts[:release], story.project
+    opts[:release] = rally.find_release_by_name cmd_opts[:release], story.rally_object.project
     Trollop::die "Unknown release \"#{cmd_opts[:release]}\"" if opts[:release].nil?
   end
 

data/bin/crab-story-update

@@ -45,7 +45,7 @@ Crab::Rally.new(opts[:dry]) do |rally|
   end
 
   if cmd_opts[:release_given]
-    opts[:release] = rally.find_release_by_name cmd_opts[:release], story.project
+    opts[:release] = rally.find_release_by_name cmd_opts[:release], story.rally_object.project
     Trollop::die "Unknown release \"#{cmd_opts[:release]}\"" if opts[:release].nil?
   end
 

data/bin/crab-tc

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+# vim: set ft=ruby:
+
+cmd = ARGV.shift # get the subcommand
+
+case cmd
+when "-h", "--help", NilClass
+  system "crab-testcase-help"
+  exit 0
+end
+
+unless system("crab-testcase-#{cmd}", *ARGV)
+  if $?.exitstatus == 127 # bash 'command not found'
+    $stderr.puts "Unknown subcommand \"testcase #{cmd}\""
+    system "crab-testcase-help"
+    exit 127
+  end
+end

data/bin/crab-tc-add

@@ -0,0 +1,29 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+opts = add_or_update_options <<-BANNER
+crab testcase create: add a test case to a story in Rally
+
+Usage: crab testcase create <story> <name> [options*]
+BANNER
+
+story_id = ARGV.shift
+unless story_id
+  $stderr.puts "Error: Story ID not provided."
+  system "crab-testcase-help"
+  exit 1
+end
+
+name = ARGV.join(" ")
+unless name
+  $stderr.puts "Error: Test case name not provided."
+  system "crab-testcase-help"
+  exit 1
+end
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  tc = rally.create_test_case(story_id, name, sanitize_options(opts))
+  puts "#{tc.story.formatted_id}/#{tc.formatted_id}: #{tc.name} (#{tc.tags.join(" ")})"
+end

data/bin/crab-tc-change

@@ -0,0 +1,18 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+opts = add_or_update_options <<-BANNER
+crab testcase update: update a test case in Rally
+
+Usage: crab testcase update <id> [options*]
+BANNER
+
+tc_id = ARGV.shift
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  tc = rally.find_test_case(tc_id)
+  tc.update(sanitize_options(opts))
+  puts "#{tc.story.formatted_id}/#{tc.formatted_id}: #{tc.name} (#{tc.tags.join(" ")})"
+end

data/bin/crab-tc-create

@@ -0,0 +1,29 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+opts = add_or_update_options <<-BANNER
+crab testcase create: add a test case to a story in Rally
+
+Usage: crab testcase create <story> <name> [options*]
+BANNER
+
+story_id = ARGV.shift
+unless story_id
+  $stderr.puts "Error: Story ID not provided."
+  system "crab-testcase-help"
+  exit 1
+end
+
+name = ARGV.join(" ")
+unless name
+  $stderr.puts "Error: Test case name not provided."
+  system "crab-testcase-help"
+  exit 1
+end
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  tc = rally.create_test_case(story_id, name, sanitize_options(opts))
+  puts "#{tc.story.formatted_id}/#{tc.formatted_id}: #{tc.name} (#{tc.tags.join(" ")})"
+end