minglr 1.3.11

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,19 @@
+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
+    
+  end
+  
+end

data/minglr.gemspec

@@ -0,0 +1,120 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE
+# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{minglr}
+  s.version = "1.3.11"
+
+  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-09-17}
+  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"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "PostInstall.txt",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "bin/minglr",
+     "bin/mtx",
+     "cucumber.yml",
+     "features/cards.feature",
+     "features/step_definitions/minglr_steps.rb",
+     "features/step_definitions/shared_steps.rb",
+     "features/users.feature",
+     "lib/minglr.rb",
+     "lib/minglr/action.rb",
+     "lib/minglr/config_parser.rb",
+     "lib/minglr/extensions/array.rb",
+     "lib/minglr/mtx/input_cache.rb",
+     "lib/minglr/mtx/options_parser.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/action_test.rb",
+     "test/commands_test.rb",
+     "test/config_parser_test.rb",
+     "test/extensions/array_test.rb",
+     "test/options_parser_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.homepage = %q{http://github.com/schubert/minglr}
+  s.post_install_message = %q{PostInstall.txt}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{command line user tool for Mingle (http://mingle.thoughtworks.com/mingle-agile-project-management)}
+  s.test_files = [
+    "test/action_test.rb",
+     "test/commands_test.rb",
+     "test/config_parser_test.rb",
+     "test/extensions/array_test.rb",
+     "test/options_parser_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 = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httpclient>, [">= 0"])
+      s.add_runtime_dependency(%q<activeresource>, [">= 2.3.0"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.3.0"])
+      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+      s.add_development_dependency(%q<mocha>, [">= 0"])
+      s.add_development_dependency(%q<relevance-rcov>, [">= 0"])
+      s.add_development_dependency(%q<cucumber>, [">= 0"])
+      s.add_development_dependency(%q<redgreen>, [">= 0"])
+    else
+      s.add_dependency(%q<httpclient>, [">= 0"])
+      s.add_dependency(%q<activeresource>, [">= 2.3.0"])
+      s.add_dependency(%q<activesupport>, [">= 2.3.0"])
+      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+      s.add_dependency(%q<mocha>, [">= 0"])
+      s.add_dependency(%q<relevance-rcov>, [">= 0"])
+      s.add_dependency(%q<cucumber>, [">= 0"])
+      s.add_dependency(%q<redgreen>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<httpclient>, [">= 0"])
+    s.add_dependency(%q<activeresource>, [">= 2.3.0"])
+    s.add_dependency(%q<activesupport>, [">= 2.3.0"])
+    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    s.add_dependency(%q<mocha>, [">= 0"])
+    s.add_dependency(%q<relevance-rcov>, [">= 0"])
+    s.add_dependency(%q<cucumber>, [">= 0"])
+    s.add_dependency(%q<redgreen>, [">= 0"])
+  end
+end

data/minglrconfig.sample

@@ -0,0 +1,37 @@
+[global]
+	default = someproject
+	username = yourusername
+	
+[someproject]
+	url = http://your.mingle.host.com/mingle/projects/someproject
+	username = yourusername
+	password = YOURMINGLEPASSWORD
+	delete_property = cp_story_status
+	delete_state = Deleted
+	status_property = cp_story_status
+	story_state_1 = Ready For Development > Sign Up for Story
+	story_state_2 = Dev In Progress > Dev Complete
+	task_state_1 = New > New to ready for Dev for Task
+	task_state_2 = Ready for Development > Dev in Progress
+	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/tasks/commit.sample.rake

@@ -0,0 +1,86 @@
+require 'minglr'
+
+desc "Run this if you have new code to check in"
+task :check_in => %w( minglr:dev_complete:prepare
+                      svn:add
+                      svn:rm
+                      svn:up
+                      svn:conflict_check
+                      db:migrate
+                      test
+                      svn:ci  
+                      minglr:dev_complete:transition )  
+
+namespace :minglr do  
+  task :prepare do
+    @host_port  = 'mingle-host:8080' # REPLACE WITH YOUR MINGLE HOST AND PORT
+    @project    = 'project_4808'   # REPLACE WITH YOUR MINGLE PROJECT IDENTIFIER
+  end
+  
+  namespace :dev_complete do
+    desc "Gather inputs to execute a 'Development Complete' card transition."
+    task :prepare => 'minglr:prepare' do
+      @transition     = 'Transition Uno' # REPLACE WITH THE TRANSITION YOU WANT TO EXECUTE
+      @username       = prompt 'Please enter your Mingle username', :cache_key => 'username'
+      @password       = prompt 'Please enter your Mingle password', :secure => true
+      @card           = prompt 'Please enter a Mingle card number', :cache_key => 'card'
+      @commit_message = prompt 'Please enter a commit message', :cache_key => 'commit_message'
+      @comment        = prompt 'Please enter a comment for the transition', :cache_key => 'transition_comment'
+      @properties     = ['Actual Effort', 'Property Dos'].inject([]) do |memo, property_name|
+        memo << [ %Q|"#{escape(property_name)}"|,
+                  %Q|"#{prompt(%Q{Please enter the value for the property "#{property_name}"}, :cache_key => property_name)}"|]
+        memo
+      end.flatten.join(',')
+      @story_complete = prompt('Is the story complete? (y/N)', :cache_key => 'story_complete').to_s.downcase == 'y'
+    end
+
+    desc "Executes a 'Development Complete' card transition."
+    task :transition => 'minglr:dev_complete:prepare' do
+      if @story_complete
+        cmd = %Q|#{Minglr::ROOT}/bin/mtx --username "#{@username}" --password "#{@password}" --card "#{@card}" --comment "#{@comment}" --transition "#{@transition}" --properties #{@properties} --host_port "#{@host_port}" --project "#{@project}"|
+        `#{cmd}`
+        raise "Minglr transition failed with exit status #{$?}." unless $?.success?
+      end
+    end
+  end
+  
+  private
+  
+  def prompt(message, options = { :secure => false })
+    require 'rubygems'
+    begin
+      require 'password' rescue Exception 
+    rescue Exception
+       @clear_text_password = true
+    end
+    
+    user_input = if options[:secure]
+        if @clear_text_password
+          puts "NOTE: You do not have the 'rb-password' port installed. Perform 'sudo port install rb-password' to avoid your password shown in clear text as you type below."
+          print "#{message}: "
+          $stdin.gets.chop
+        else
+          Password.get "#{message}: "
+        end
+      else
+        print "#{message}"
+        if cache = MTX::InputCache.get(options[:cache_key])
+          print " [#{cache}]"
+        end
+        print ": "
+        $stdin.gets.chop
+      end
+
+    if !options[:secure] && cache_key = options.delete(:cache_key)
+      user_input = MTX::InputCache.get(cache_key) if user_input.blank?
+      MTX::InputCache.put(cache_key, user_input)
+    end
+    
+    user_input = escape(user_input)
+  end
+  
+  def escape(user_input)
+    user_input.gsub(/["]/, %q{\"}) if user_input
+  end
+  
+end

data/tasks/svn.sample.rake

@@ -0,0 +1,27 @@
+namespace :svn do
+  desc "Updates your local WC"
+  task :up do
+    `svn up`
+  end
+
+  desc "Adds new local WC files"
+  task :add do
+    `svn st | grep '^?' | xargs svn add`
+  end
+  
+  desc "Removes deleted local WC files"
+  task :rm do
+    `svn st | grep '^!' | xargs svn rm`
+  end
+  
+  desc "Check-in your local WC changes"
+  task :ci do
+    `svn ci -m "#{@commit_message || ENV['commit_message']}"`
+  end
+  
+  desc "Checks if your WC has merge conflicts."
+  task :conflict_check do
+    `svn st | awk '{ if( $1 == "C" ) exit 1}'`
+    raise 'You have conflicts!' unless $?.success?
+  end
+end

data/test/action_test.rb

@@ -0,0 +1,75 @@
+require 'test_helper'
+
+module Minglr
+  
+  class ActionTest < Test::Unit::TestCase
+  
+    context Action do
+    
+      context "valid_actions" do
+        
+        should "return an array of valid actions" do
+          valid_actions = ["users", "cards", "card", "move", "update", "attach", "projects", "create", "fetch"].sort
+          assert_equal [], (valid_actions - Action.valid_actions)
+        end
+      
+      end
+      
+      context "valid_action?" do
+        
+        should "return true if action is a valid action" do
+          assert_equal true, Action.valid_action?("move")
+        end
+        
+        should "return false if action is not a valid action" do
+          assert_equal false, Action.valid_action?("frobble")
+        end
+        
+      end
+      
+      context "execute" do
+        
+        should "ignore the first option if no project is specified" do
+          action = :someaction
+          options = ["someaction", "option2"]
+          flag_options = { :foo => "bar" }
+          config = { :foo => "bar" }
+          
+          Minglr::Action::Commands.expects(:send).with(action, ["option2"], flag_options, config)
+          Action.execute(action, options, flag_options, config)
+        end
+        
+        should "ignore the first two options if project is specified" do
+          action = :someaction
+          options = ["someproject", "someaction", "option2"]
+          flag_options = { :foo => "bar" }
+          config = { :foo => "bar" }
+          
+          Minglr::Action::Commands.expects(:send).with(action, ["option2"], flag_options, config)
+          Action.execute(action, options, flag_options, config)          
+        end
+        
+        should "send the action to commands" do
+          action = "someaction"
+          options = ["option1", "option2"]
+          flag_options = { :foo => "bar" }
+          config = { :foo => "bar" }
+          
+          Minglr::Action::Commands.expects(:send).with(action, options, flag_options, config)
+          Action.execute(action, options, flag_options, config)
+        end
+        
+        should "rescue and print an error if the resource can't be found" do
+          Action.expects(:puts).with("Failed with MyError  for URL '#{Resources::Base.site}' ...")
+          Minglr::Action::Commands.expects(:send).raises(ActiveResource::ResourceNotFound, stub("Response", :code => "MyError"))
+          
+          Action.execute("someaction", ["someaction"])
+        end
+        
+      end
+       
+    end
+  
+  end
+  
+end

data/test/commands_test.rb

@@ -0,0 +1,111 @@
+require 'test_helper'
+
+module Minglr
+  
+  class CommandsTest < Test::Unit::TestCase
+
+    context Action::Commands do
+      
+      setup do
+        @options = []
+        @flag_options = {}
+        @config = { :status_property => "cp_status", :username => "user", :password => "password" }
+      end
+      
+      context "attach" do
+        
+        should "parse card number and file number as options and call resource" do
+          @options << "1"
+          @flag_options[:file_attachment] = "file"
+          
+          Resources::Attachment.expects(:attach).with("1", "file", "user", "password")
+          Action::Commands.attach(@options, @flag_options, @config)
+        end
+    
+      end 
+  
+      context "card" do
+    
+        should "parse card number and call resource" do
+          @options << "1"
+          
+          Resources::Card.expects(:print_card).with("1", "cp_status")
+          Action::Commands.card(@options, @flag_options, @config)
+        end
+    
+      end
+  
+      context "cards" do
+    
+        should "call resource" do
+          Resources::Card.expects(:print_all).with(@options, "cp_status")
+          Action::Commands.cards(@options, @flag_options, @config)
+        end
+    
+      end
+  
+      context "create" do
+    
+        should "call resource" do
+          Resources::Card.expects(:create).with(@flag_options, "cp_status")
+          Action::Commands.create(@options, @flag_options, @config)
+        end
+    
+      end
+  
+      context "fetch" do
+    
+        should "parse card number and call resource" do
+          @options << "1"
+          
+          Resources::Attachment.expects(:fetch).with("1", "user", "password")
+          Action::Commands.fetch(@options, @flag_options, @config)
+        end
+    
+      end
+  
+      context "move" do
+    
+        should "parse card number and call resource" do
+          @options << "1"
+
+          Resources::Card.expects(:move).with("1", @flag_options, @config)
+          Action::Commands.move(@options, @flag_options, @config)
+        end
+  
+      end
+  
+      context "projects" do
+    
+        should "call resource" do
+          Resources::Project.expects(:print_all).with(@options, "cp_status")
+          Action::Commands.projects(@options, @flag_options, @config)
+        end
+    
+      end
+  
+      context "update" do
+    
+        should "parse card number and call resource" do
+          @options << "1"
+          
+          Resources::Card.expects(:update).with("1", @flag_options)
+          Action::Commands.update(@options, @flag_options, @config)
+        end
+    
+      end
+  
+      context "users" do
+    
+        should "call resource" do
+          Resources::User.expects(:print_all).with(@options)
+          Action::Commands.users(@options, @flag_options, @config)
+        end
+  
+      end
+  
+    end
+  
+  end
+  
+end