crab 0.1.5 → 0.1.6

data/README.md

@@ -74,13 +74,32 @@ steps:
       ...
 
 Some data about stories can also be edited straight from the command line.
-In that sense, `crab` acts more like a command-line interface to Rally than a bridge
-between Rally and Cucumber, but the team thought these were *very* convenient
-features to have:
+In that sense, `crab` acts more like a command-line interface to Rally than a
+bridge between Rally and Cucumber, but the team thought these were *very*
+convenient features to have:
+
+    $ crab create "Secure Access to Flying Fortress Controls"
+    US1004: Secure Access to Flying Fortress Controls (grooming)
 
     $ crab update US1001 --name "Arms Rockets Upon Successful Boot" --state completed
+    US1001: Arms Rockets Upon Successful Boot (completed)
+
+    $ crab delete US1004 # not in this movie :(
+    Story US1004 deleted.
+
+It is also possible to add, update and delete test cases inside Rally straight
+from the command line:
+
+    $ crab testcase add US1001 "Rocket Silo Is Unlocked"
+    US1001/TC1501: Rocket Silo Is Unlocked (important medium automated acceptance)
+
+    $ crab testcase update TC1501 --priority critical --risk low
+    US1001/TC1501: Rocket Silo Is Unlocked (critical low automated acceptance)
+
+    $ crab testcase delete TC1501
+    Test case TC1501 deleted.
 
-There are more switches. Check out `crab update --help` to find out more.
+There are more switches. Try `crab --help` to find out more.
 
 i18n Support
 ------------
@@ -91,7 +110,7 @@ included:
     $ crab show US1001 -l ja
     機能: [US1001] Arms Rockets Upon Successful Boot
     ...
-    シナリオ: [TC10388] Rocket Silo Is Unlocked
+    シナリオ: [TC1501] Rocket Silo Is Unlocked
       Given a silo where the rockets are stored
       ...
 
@@ -125,7 +144,6 @@ To do
 
 - Add a config command + .crab/config file to hold settings like project, etc
 - Add a `push` subcommand which parses a Cucumber feature and adds or updates it in Rally
-- Add a way to create, edit and delete test cases / scenarios from the command line
 - `pull` is not very smart and could detect feature files being moved from one dir to another
 - Recursively look for a `.crab` directory like Git does with `.git`
 - Encrypt password in generated `~/.crab/credentials`

data/lib/crab.rb

@@ -13,6 +13,7 @@ require 'sanitize'
 require "crab/utilities"
 require "crab/rally"
 require "crab/story"
+require "crab/testcase"
 require "crab/cli"
 require "crab/scenario"
 

data/lib/crab/commands/testcase.rb

@@ -5,16 +5,97 @@ module Crab::Commands
     def initialize(global_opts, args)
       @global_opts = global_opts
       @args = args
+      @rally = Crab::Rally.new
+
       @cmd_opts = Trollop::options do
         banner "crab testcase: manage test cases in a story (add, update, delete)
 
 Usage: crab [options] testcase add story name [options]
        crab [options] testcase update testcase [options]
        crab [options] testcase delete testcase [options]"
+
+        stop_on %w{add update delete}
       end
     end
 
     def run
+      sub = ARGV.shift
+      case sub
+      when "add"
+        opts = Trollop::options do
+          banner "crab testcase add: add a test case to a story in Rally"
+          opt :priority, "Priority (one of: #{Crab::TestCase::PRIORITIES.join(" ")}", :default => "important", :short => '-p'
+          opt :risk,     "Risk (one of: #{Crab::TestCase::RISKS.join(" ")})", :default => "medium", :short => '-r'
+          opt :method,   "Method (one of: #{Crab::TestCase::METHODS.join(" ")})", :default => "automated", :short => '-m'
+          opt :type,     "Type (one of: #{Crab::TestCase::TYPES.join(" ")})", :default => "acceptance", :short => '-t'
+          opt :pre,      "Pre-conditions", :default => "N/A"
+          opt :post,     "Post-conditions", :default => "N/A"
+          opt :desc,     "Description", :default => "N/A", :short => '-d'
+        end
+
+        story_id = ARGV.shift
+        name = ARGV.join(" ")
+        add(story_id, name, opts)
+
+      when "update"
+        opts = Trollop::options do
+          banner "crab testcase update: update a test case in Rally"
+          opt :priority, "Priority (one of: #{Crab::TestCase::PRIORITIES.join(" ")}", :default => "important", :short => '-p'
+          opt :risk,     "Risk (one of: #{Crab::TestCase::RISKS.join(" ")})", :default => "medium", :short => '-r'
+          opt :method,   "Method (one of: #{Crab::TestCase::METHODS.join(" ")})", :default => "automated", :short => '-m'
+          opt :type,     "Type (one of: #{Crab::TestCase::TYPES.join(" ")})", :default => "acceptance", :short => '-t'
+          opt :pre,      "Pre-conditions", :default => "N/A"
+          opt :post,     "Post-conditions", :default => "N/A"
+          opt :desc,     "Description", :default => "N/A", :short => '-d'
+        end
+
+        tc_id = ARGV.shift
+        update(tc_id, opts)
+
+      when "delete"
+        Trollop::options do
+          banner "crab testcase delete: delete a test case in Rally"
+        end
+
+        tc_id = ARGV.shift
+        delete(tc_id)
+
+      else
+        Trollop::die "Unknown subcommand#{' ' + sub.inspect if sub}"
+      end
+    end
+
+    def add(story_id, name, opts)
+      @rally.connect
+      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
+
+    def update(tc_id, opts)
+      @rally.connect
+      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
+
+    def delete(tc_id)
+      @rally.connect
+      tc = @rally.find_test_case(tc_id)
+      tc.delete
+      puts "Test case #{tc_id} deleted."
+    end
+
+    def sanitize_options(opts, creating=true)
+      result = {}
+      result[:priority] = opts[:priority].capitalize if creating || opts[:priority_given]
+      result[:risk] = opts[:risk].capitalize if creating || opts[:risk_given]
+      result[:method] = opts[:method].capitalize if creating || opts[:method_given]
+      result[:type] = opts[:type].capitalize if creating || opts[:type_given]
+      result[:pre_conditions] = opts[:pre] if creating || opts[:pre_given]
+      result[:post_conditions] = opts[:post] if creating || opts[:post_given]
+      result[:description] = opts[:desc] if creating || opts[:desc_given]
+      result
     end
   end
 end

data/lib/crab/rally.rb

@@ -49,5 +49,15 @@ module Crab
     def create_story(opts)
       Crab::Story.new @rally.create(:hierarchical_requirement, opts)
     end
+
+    def create_test_case(story_id, name, opts)
+      story = find_story_with_id story_id
+      Crab::TestCase.new @rally.create(:test_case, {:name => name, :work_product => story.rally_object, :project => story.rally_object.project}.merge(opts))
+    end
+
+    def find_test_case(tc_id)
+      Crab::TestCase.new @rally.find(:test_case) { equal :formatted_i_d, tc_id }.first
+    end
+
   end
 end

data/lib/crab/testcase.rb

@@ -0,0 +1,55 @@
+module Crab
+
+  class TestCase
+
+    PRIORITIES = %w{useful important critical}
+    RISKS = %w{low medium high}
+    METHODS = %w{automated manual}
+    TYPES = %w{acceptance functional non-functional performance regression usability}
+
+    def initialize(rally_test_case)
+      @rally_test_case = rally_test_case
+    end
+
+    def formatted_id
+      @rally_test_case.formatted_i_d
+    end
+
+    def name
+      @rally_test_case.name
+    end
+
+    def tags
+      [priority, risk, test_method, test_type].map &:parameterize
+    end
+
+    def priority
+      @rally_test_case.priority
+    end
+
+    def risk
+      @rally_test_case.risk
+    end
+
+    def test_method
+      @rally_test_case.elements[:method]
+    end
+
+    def test_type
+      @rally_test_case.elements[:type]
+    end
+
+    def story
+      Crab::Story.new @rally_test_case.work_product
+    end
+
+    def delete
+      @rally_test_case.delete
+    end
+
+    def update(options)
+      @rally_test_case.update options
+    end
+
+  end
+end

data/lib/crab/version.rb

@@ -1,3 +1,3 @@
 module Crab
-  VERSION = "0.1.5"
+  VERSION = "0.1.6"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: crab
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 23
   prerelease: 
   segments: 
   - 0
   - 1
-  - 5
-  version: 0.1.5
+  - 6
+  version: 0.1.6
 platform: ruby
 authors: 
 - Carlos Villela
@@ -187,6 +187,7 @@ files:
 - lib/crab/rally.rb
 - lib/crab/scenario.rb
 - lib/crab/story.rb
+- lib/crab/testcase.rb
 - lib/crab/utilities.rb
 - lib/crab/version.rb
 has_rdoc: true