schubert-minglr 1.1.0 → 1.2.0

data/lib/minglr/resources/card.rb

@@ -0,0 +1,107 @@
+module Resources
+  
+  class Card < Base
+    
+    def self.create(options = {}, status_property = nil)
+      options.merge!({status_property.to_sym => "New"}) if status_property
+      card = self.new(options)
+      if card.save
+        card.reload
+        puts "Card #{card.number} created"
+      else
+        warn "Unable to create card"
+      end
+    end
+    
+    def self.move(card_number, options = {}, config = {})
+      if card_to_move = find(card_number)
+        transition_options = { :card => card_number }
+        transition_options.merge!({ :comment => options[:comment]}) if options[:comment]
+        current_status = card_to_move.send(config[:status_property]) if config[:status_property]
+        next_transition = nil
+        
+        card_type = card_to_move.card_type_name.downcase
+        case card_type
+        when /defect/
+          status_states = config.select do |key, value|
+            key.to_s =~ /^defect/
+          end
+        when /task/
+          status_states = config.select do |key, value|
+            key.to_s =~ /^task_state_/
+          end
+        when /story/
+          status_states = config.select do |key, value|
+            key.to_s =~ /^story_state/
+          end
+        else
+          puts "No transitions defined for card of type #{card_to_move.card_type_name}"  
+        end
+        status_states = status_states.collect {|state| state.last }.collect {|state| state.split(">").collect { |value| value.strip } }
+        next_transition = status_states.select {|state| state.first.downcase == current_status.downcase }.first.last
+        transition_options.merge!({ :transition => next_transition })
+
+        if response = TransitionExecution.create(transition_options)
+          if response.attributes["status"] == "completed"
+            puts "Moved card from #{current_status} to #{next_transition}"
+          end
+        end
+      else
+        warn "No card #{card_number} found to move"
+      end
+    end
+    
+    def self.print_all(options = [], status_property = nil)
+      attributes = [:number, :card_type_name, status_property, :name].compact
+      cards = Resources::Card.find(:all)
+      cards.send(:extend, Minglr::Extensions::Array)
+      cards = cards.filter(attributes, options)
+      if cards.any?
+        print_collection(cards, attributes)
+      else
+        warn "No cards found"
+      end
+    end
+    
+    def self.print_card(card_number, status_property = nil)
+      attributes = [:number, :card_type_name, status_property, :name, :description].compact
+      if card = find(card_number)
+        puts card.to_s(status_property)
+      else
+        warn "No card ##{card_number} found"
+      end
+    end
+    
+    def self.update(card_number, options = {})
+      if card_to_update = find(card_number)
+        options.each do |attribute, value|
+          card_to_update.send("#{attribute.to_s}=".to_sym, value)
+        end
+        card_to_update.save
+        puts "Card #{card_to_update.number} updated\n\n"
+        puts card.to_s
+      else
+        warn "Unable to update card #{card_number}"
+      end
+    end
+    
+    def to_s(status_property = nil)
+      attachments = Resources::Attachment.find(:all, :params => { :card_number => number })
+      attachments = attachments.collect do |attachment|
+        "* #{attachment.file_name}: #{Resources::Base.site + attachment.url}"
+      end
+      output = <<-EOS
+     Number: #{number}
+       Name: #{name}
+       Type: #{card_type_name}
+     Status: #{send(status_property) if status_property}
+Description: #{description}
+
+Attachments:
+  #{attachments.join("\n")}
+    EOS
+      output
+    end
+    
+  end
+end

data/lib/minglr/resources/project.rb

@@ -0,0 +1,25 @@
+module Resources
+  
+  class Project < Base
+    
+    def self.configure
+      self.prefix = self.prefix.split("/")[0...-1].join("/")
+      self.site = self.prefix
+    end
+    
+    def self.print_all(options = [], status_property = nil)
+      attributes = [:name, :description]
+      projects = find(:all)
+      projects.send(:extend, Minglr::Extensions::Array)
+      projects = projects.filter(attributes, options)
+      
+      if projects.any?
+        print_collection projects, attributes
+      else
+        warn "No projects found"
+      end
+    end
+    
+  end
+  
+end

data/lib/minglr/resources/property_definition.rb

@@ -0,0 +1,12 @@
+module Resources
+  
+  class PropertyDefinition < Base
+    
+    def self.project_options
+      properties = find(:all)
+      properties.collect { |property| [property.column_name.to_sym, property.name] }
+    end
+    
+  end
+  
+end

data/lib/minglr/resources/transition_execution.rb

@@ -0,0 +1,6 @@
+module Resources
+  
+  class TransitionExecution < Base
+  end
+  
+end

data/lib/minglr/resources/user.rb

@@ -0,0 +1,25 @@
+module Resources
+  
+  class User < Base
+    
+    def self.print_all(options = [])
+      attributes = [:login, :name, :email]
+      users = find(:all).collect! { |user| user.user }
+      users.send(:extend, Minglr::Extensions::Array)
+      users = users.filter(attributes, options)
+      if users.any?
+        print_collection users, attributes, :right
+      else
+        warn "No users in project"
+      end
+    end
+    
+    def self.find_user_id_for_user(user)
+      if user = Resources::User.find(:all).select { |user| user.user.login == user }.first
+        user.user_id
+      end
+    end
+    
+  end
+  
+end

data/minglr.gemspec

@@ -1,12 +1,12 @@
-# -*- encoding: utf-8 -*-
-
 Gem::Specification.new do |s|
   s.name = %q{minglr}
-  s.version = "1.1.0"
+  s.version = "1.2.0"
+
+  s.specification_version = 2 if s.respond_to? :specification_version=
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Michael Schubert", "Stephen Chu", "Chris O'Meara"]
-  s.date = %q{2009-07-09}
+  s.date = %q{2009-07-26}
   s.description = %q{* This gem provides two executable binaries to interact with Mingle (http://mingle.thoughtworks.com/mingle-agile-project-management) through its API. It also has sample interactive Rake task on how to facilitate easy card movements when a card enters/exits the development queue.  * mtx is a binary that facilities transition changes for use on rake tasks * minglr is a more interactive tool that provides a quick interface for many common uses}
   s.email = %q{michael@schubert.cx}
   s.executables = ["mtx", "minglr"]
@@ -25,23 +25,30 @@ Gem::Specification.new do |s|
      "bin/minglr",
      "bin/mtx",
      "lib/minglr.rb",
-     "lib/minglr/attachment.rb",
-     "lib/minglr/card.rb",
+     "lib/minglr/action.rb",
+     "lib/minglr/config_parser.rb",
+     "lib/minglr/extensions/array.rb",
      "lib/minglr/input_cache.rb",
-     "lib/minglr/mingle_resource.rb",
-     "lib/minglr/minglr_action.rb",
-     "lib/minglr/minglr_config_parser.rb",
-     "lib/minglr/minglr_options_parser.rb",
      "lib/minglr/mtx_options_parser.rb",
-     "lib/minglr/property_definition.rb",
-     "lib/minglr/transition_execution.rb",
-     "lib/minglr/user.rb",
+     "lib/minglr/options_parser.rb",
+     "lib/minglr/resources/attachment.rb",
+     "lib/minglr/resources/base.rb",
+     "lib/minglr/resources/card.rb",
+     "lib/minglr/resources/project.rb",
+     "lib/minglr/resources/property_definition.rb",
+     "lib/minglr/resources/transition_execution.rb",
+     "lib/minglr/resources/user.rb",
      "minglr.gemspec",
      "minglrconfig.sample",
      "tasks/commit.sample.rake",
      "tasks/svn.sample.rake",
-     "test/attachment_test.rb",
-     "test/minglr_resource_test.rb",
+     "test/extensions/array_test.rb",
+     "test/resources/attachment_test.rb",
+     "test/resources/base_test.rb",
+     "test/resources/card_test.rb",
+     "test/resources/project_test.rb",
+     "test/resources/property_definition_test.rb",
+     "test/resources/user_test.rb",
      "test/test_helper.rb"
   ]
   s.has_rdoc = true
@@ -49,21 +56,16 @@ Gem::Specification.new do |s|
   s.post_install_message = %q{PostInstall.txt}
   s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.1}
+  s.rubygems_version = %q{1.0.1}
   s.summary = %q{command line user tool for Mingle (http://mingle.thoughtworks.com/mingle-agile-project-management)}
   s.test_files = [
-    "test/attachment_test.rb",
-     "test/minglr_resource_test.rb",
+    "test/extensions/array_test.rb",
+     "test/resources/attachment_test.rb",
+     "test/resources/base_test.rb",
+     "test/resources/card_test.rb",
+     "test/resources/project_test.rb",
+     "test/resources/property_definition_test.rb",
+     "test/resources/user_test.rb",
      "test/test_helper.rb"
   ]
-
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 2
-
-    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-    else
-    end
-  else
-  end
 end

data/minglrconfig.sample

@@ -16,3 +16,22 @@
 	task_state_3 = Dev In Progress > Story from Dev in Progress to Dev Complete
 	story_checkout = story_state_1
 	task_checkout = story_state_2
+
+# Mingle Project Templates
+# [blank]
+# 	url = http://localhost:9090/projects/blank
+# 
+# [agilehybrid]
+# 	url = http://localhost:9090/projects/agilehybrid
+# 	status_property = cp_status
+# 
+# [scrum]
+# 	url = http://localhost:9090/projects/scrum
+# 	status_property = cp_status
+# 
+# [storytracker]
+# 	url = http://localhost:9090/projects/storytracker
+# 	status_property = cp_status
+# 
+# [xp]
+# 	url = http://localhost:9090/projects/xp

data/test/extensions/array_test.rb

@@ -0,0 +1,41 @@
+require 'test_helper'
+
+module Minglr
+  module Extensions
+  
+    class ArrayTest < Test::Unit::TestCase
+
+      context Array do
+    
+        context "filter" do
+          
+          setup do
+            class TestObject
+              attr_accessor :name
+            end
+            @test1 = TestObject.new
+            @test2 = TestObject.new
+            @test1.name = "test1"
+            @test2.name = "test2"
+            @collection = [@test1, @test2]
+            @collection.send(:extend, Minglr::Extensions::Array)
+          end
+          
+          should "include elements matching words in attributes" do
+            assert_equal [@test1], @collection.filter([:name], ["1"])
+            assert_equal [@test1, @test2], @collection.filter([:name], ["test"])
+          end
+
+          should "deal with empty words and attributes" do
+            assert_equal [@test1, @test2], @collection.filter([], [])
+            assert_equal [@test1, @test2], @collection.filter([:name], [])
+            assert_equal [], @collection.filter([], ["1"])
+          end
+    
+        end
+    
+      end
+
+    end
+  end
+end

data/test/resources/attachment_test.rb

@@ -0,0 +1,40 @@
+require 'test_helper'
+
+module Resources
+  
+  class AttachmentTest < Test::Unit::TestCase
+  
+    context Attachment do
+    
+      context "configure" do
+        
+        should "append to the site url" do
+          options = { :username => "user",
+                      :password => "pass",
+                      :url => "proto://somehost.com:1234/projects/my_project" }
+          Base.configure(options)
+          Attachment.configure
+          assert_equal  "/projects/my_project/cards/1/", Attachment.prefix(:card_number => 1)
+        end
+      
+      end
+      
+      context "fetch" do
+        
+        should_eventually "download all found attachments for a given card number" do
+        end
+      
+      end
+      
+      context "attach" do
+        
+        should_eventually "upload file for a given card number" do
+        end
+      
+      end
+    
+    end
+
+  end
+  
+end

data/test/resources/base_test.rb

@@ -0,0 +1,45 @@
+require 'test_helper'
+
+module Resources
+  
+  class BaseTest < Test::Unit::TestCase
+  
+    context Base do
+    
+      context "configure" do
+      
+        should "combine options to build url" do
+          options = { :username => "user",
+                      :password => "pass",
+                      :url => "proto://somehost.com:1234/projects/my_project" }
+          Base.configure(options)
+          assert_equal  "proto://user:pass@somehost.com:1234/projects/my_project",
+                        Base.site.to_s
+        end
+    
+      end
+      
+      context "warn" do
+        
+        should "prepend message with warning" do
+          Base.expects(:puts).with("Warning: test")
+          Base.warn("test")
+        end
+      
+      end
+      
+      context "print_collection" do
+        
+        should_eventually "print values of attributes of objects separated by dashes and aligning columns of values" do
+        end
+        
+        should_eventually "allow for right adjusted values" do
+        end
+        
+      end
+      
+    end
+
+  end
+
+end

data/test/resources/card_test.rb

@@ -0,0 +1,89 @@
+require 'test_helper'
+
+module Resources
+  
+  class CardTest < Test::Unit::TestCase
+  
+    context Card do
+      
+      context "create" do
+        
+        should_eventually "create a card with options passed in" do
+        end
+        
+        should_eventually "create a card with the status of new if status property is available" do
+        end
+        
+        should_eventually "warn if it is unable to create the card" do
+        end
+        
+      end
+      
+      context "move" do
+        
+        should "move card from one state to the next as defined" do
+        end
+        
+        should "warn if card cannot be found" do
+        end
+        
+      end
+      
+      context "print_all" do
+        
+        should "warn if there are no cards" do
+          Card.expects(:find).with(:all).returns([])
+          Card.expects(:warn).with("No cards found")
+          Card.print_all
+        end
+        
+        should "print the cards found with format" do
+          card1 = stub("Card", :number => 1, :card_type_name => "Story", :name => "Some Story")
+          card2 = stub("Card", :number => 2, :card_type_name => "Task", :name => "Some Task")
+          Card.expects(:find).with(:all).returns([card1, card2])
+          Card.expects(:puts).with("1 - Story - Some Story")
+          Card.expects(:puts).with("2 - Task  - Some Task ")
+          Card.print_all
+        end
+        
+        should "print cards with status property if available" do
+          card1 = stub("Card", :number => 1, :card_type_name => "Story", :name => "Some Story", :cp_status => "Ready")
+          Card.expects(:find).with(:all).returns([card1])
+          Card.expects(:puts).with("1 - Story - Ready - Some Story")
+          Card.print_all([], "cp_status")
+        end
+      
+      end
+      
+      context "print_card" do
+        
+        should_eventually "print the details for a given card" do
+        end
+        
+      end
+      
+      context "update" do
+        
+        should_eventually "update a card with the options passed in" do
+        end
+        
+        should_eventually "print out the details of the card after updating" do
+        end
+        
+        should_eventually "warn if it is not able to find the card" do
+        end
+        
+      end
+      
+      context "to_s" do
+        
+        should_eventually "format the details of a given card including attachments" do
+        end
+        
+      end
+    
+    end
+
+  end
+  
+end