crab 0.2.4 → 0.2.6

data/bin/crab-it

@@ -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-iteration-help"
+  exit 0
+end
+
+unless system("crab-iteration-#{cmd}", *ARGV)
+  if $?.exitstatus == 127 # bash 'command not found'
+    $stderr.puts "Unknown subcommand \"iteration #{cmd}\""
+    system "crab-iteration-help"
+    exit 127
+  end
+end

data/bin/crab-it-help

@@ -0,0 +1,12 @@
+# vim: set ft=ruby :
+
+puts <<-HELP
+Usage: crab iteration <command> [options*]
+
+  Available commands:
+
+  list  List iterations available
+  help  Show this help text
+
+     --help, -h:   Show this message
+HELP

data/bin/crab-it-list

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+# vim: set ft=ruby:
+
+require 'crab'
+
+include Crab::Utilities
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab iteration list: list iterations available in the current project
+
+Usage: crab iteration list [options*]
+  BANNER
+  opt :project, "Project to use (required unless set by 'crab project')", :short => "-p", :type => String
+  opt :dry, "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+pattern = ARGV.map(&:strip).reject(&:empty?)
+project_name = valid_project_name(opts)
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  project = rally.find_project(project_name)
+  Trollop::die "Project #{opts[:project].inspect} not found" if project.nil?
+
+  rally.find_iterations(project).each do |iteration|
+    puts iteration.name
+  end
+end

data/bin/crab-iteration-help

@@ -5,6 +5,7 @@ Usage: crab iteration <command> [options*]
 
   Available commands:
 
+  list  List iterations available
   help  Show this help text
 
      --help, -h:   Show this message

data/bin/crab-rel

@@ -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-release-help"
+  exit 0
+end
+
+unless system("crab-release-#{cmd}", *ARGV)
+  if $?.exitstatus == 127 # bash 'command not found'
+    $stderr.puts "Unknown subcommand \"release #{cmd}\""
+    system "crab-release-help"
+    exit 127
+  end
+end

data/bin/crab-rel-help

@@ -0,0 +1,12 @@
+# vim: set ft=ruby :
+
+puts <<-HELP
+Usage: crab release <command> [options*]
+
+  Available commands:
+
+  list  List releases available in the current project
+  help  Show this help text
+
+     --help, -h:   Show this message
+HELP

data/bin/crab-rel-list

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+# vim: set ft=ruby:
+
+require 'crab'
+
+include Crab::Utilities
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab release list: list releases available in the current project
+
+Usage: crab release list [options*]
+  BANNER
+  opt :project, "Project to use (required unless set by 'crab project')", :short => "-p", :type => String
+  opt :dry, "Dry-run (don't change anything)", :short => "-D", :default => false
+end
+
+pattern = ARGV.map(&:strip).reject(&:empty?)
+project_name = valid_project_name(opts)
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  project = rally.find_project(project_name)
+  Trollop::die "Project #{opts[:project].inspect} not found" if project.nil?
+
+  rally.find_releases(project).each do |release|
+    puts release.name
+  end
+end

data/bin/crab-st

@@ -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-story-help"
+  exit 0
+end
+
+unless system("crab-story-#{cmd}", *ARGV)
+  if $?.exitstatus == 127 # bash 'command not found'
+    $stderr.puts "Unknown subcommand \"story #{cmd}\""
+    system "crab-story-help"
+    exit 127
+  end
+end

data/bin/crab-st-add

@@ -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-change

@@ -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-create

@@ -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-del

@@ -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-delete

@@ -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-find

@@ -0,0 +1,34 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab story find: find a story in Rally
+
+Usage: crab story find [options*] [text]
+  BANNER
+  opt :project, "Project to use (required unless set by 'crab project')", :short => "-p", :type => String
+  opt :iteration, "Limit search to this iteration",         :short => "-i", :type => String
+  opt :release,   "Limit search to this release",           :short => "-r", :type => String
+  opt :parent,    "Limit search to children of this story", :short => "-P", :type => String
+  opt :dry,       "Dry-run (don't change anything)",        :short => "-D", :default => false
+end
+
+pattern = ARGV.map(&:strip).reject(&:empty?)
+project_name = valid_project_name(opts)
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  project = rally.find_project(project_name)
+  Trollop::die "Project #{opts[:project].inspect} not found" if project.nil?
+
+  find_opts = {}
+  find_opts[:iteration] = rally.find_iteration_by_name opts[:iteration], project if opts[:iteration_given]
+  find_opts[:release] = rally.find_release_by_name opts[:release], project if opts[:release_given]
+  find_opts[:parent] = rally.find_story_with_id opts[:parent] if opts[:parent_given]
+
+  rally.find_stories(project, pattern, find_opts).each do |story|
+    puts "#{story.formatted_id}: #{story.name} (#{story.state})"
+  end
+end

data/bin/crab-st-help

@@ -0,0 +1,19 @@
+# vim: set ft=ruby :
+
+puts <<-HELP
+Usage: crab story <command> [options*]
+
+  Available commands:
+
+  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-st-list

@@ -0,0 +1,34 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab story find: find a story in Rally
+
+Usage: crab story find [options*] [text]
+  BANNER
+  opt :project, "Project to use (required unless set by 'crab project')", :short => "-p", :type => String
+  opt :iteration, "Limit search to this iteration",         :short => "-i", :type => String
+  opt :release,   "Limit search to this release",           :short => "-r", :type => String
+  opt :parent,    "Limit search to children of this story", :short => "-P", :type => String
+  opt :dry,       "Dry-run (don't change anything)",        :short => "-D", :default => false
+end
+
+pattern = ARGV.map(&:strip).reject(&:empty?)
+project_name = valid_project_name(opts)
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  project = rally.find_project(project_name)
+  Trollop::die "Project #{opts[:project].inspect} not found" if project.nil?
+
+  find_opts = {}
+  find_opts[:iteration] = rally.find_iteration_by_name opts[:iteration], project if opts[:iteration_given]
+  find_opts[:release] = rally.find_release_by_name opts[:release], project if opts[:release_given]
+  find_opts[:parent] = rally.find_story_with_id opts[:parent] if opts[:parent_given]
+
+  rally.find_stories(project, pattern, find_opts).each do |story|
+    puts "#{story.formatted_id}: #{story.name} (#{story.state})"
+  end
+end

data/bin/crab-st-ls

@@ -0,0 +1,34 @@
+# vim: set ft=ruby :
+require 'crab'
+
+include Crab::Utilities
+
+opts = Trollop::options do
+  banner <<-BANNER
+crab story find: find a story in Rally
+
+Usage: crab story find [options*] [text]
+  BANNER
+  opt :project, "Project to use (required unless set by 'crab project')", :short => "-p", :type => String
+  opt :iteration, "Limit search to this iteration",         :short => "-i", :type => String
+  opt :release,   "Limit search to this release",           :short => "-r", :type => String
+  opt :parent,    "Limit search to children of this story", :short => "-P", :type => String
+  opt :dry,       "Dry-run (don't change anything)",        :short => "-D", :default => false
+end
+
+pattern = ARGV.map(&:strip).reject(&:empty?)
+project_name = valid_project_name(opts)
+
+Crab::Rally.new(opts[:dry]) do |rally|
+  project = rally.find_project(project_name)
+  Trollop::die "Project #{opts[:project].inspect} not found" if project.nil?
+
+  find_opts = {}
+  find_opts[:iteration] = rally.find_iteration_by_name opts[:iteration], project if opts[:iteration_given]
+  find_opts[:release] = rally.find_release_by_name opts[:release], project if opts[:release_given]
+  find_opts[:parent] = rally.find_story_with_id opts[:parent] if opts[:parent_given]
+
+  rally.find_stories(project, pattern, find_opts).each do |story|
+    puts "#{story.formatted_id}: #{story.name} (#{story.state})"
+  end
+end

data/bin/crab-st-move

@@ -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