minglr 1.3.11

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/*
+coverage/*
+.DS_Store

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Michael Schubert
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/PostInstall.txt

@@ -0,0 +1 @@
+= Don't not forget to enable your Mingle API authentication by configuring the auth_config.yml file! =

data/README.rdoc

@@ -0,0 +1,87 @@
+= minglr
+
+* http://github.com/schubert/minglr/tree/master
+
+== DESCRIPTION:
+
+* 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
+
+== MINGLR FEATURES:
+* lists cards
+	$ minglr cards
+	266 - Task   - Development Complete  - Investigate new tool
+	265 - Defect - New                   - The background is the wrong color
+
+* list users
+	$ minglr users
+	schubert - Michael Schubert - michael@yourcompany.com
+
+* list all cards with the word "foo"
+	$ minglr cards foo
+
+* list details for card 215
+	$ minglr card 215
+	     Number: 215
+	       Name: Add the frobble to the bobble
+	       Type: Story
+	     Status: In Development
+	Description: Lorem Ipsum
+
+* create new story card
+	$ minglr create -t Story -n "My New Story" -d "Story Description"
+	Created story card 271
+
+* update a card
+	$ minglr update 271 -d "Bettter Description"
+	Card 271 updated
+
+	     Number: 271
+	       Name: Add the frobble to the bobble
+	       Type: Task
+	     Status: Ready for Development
+	Description: Better Description
+
+* move card based on defined transitions
+	$ minglr move 266 -c "All done with development"
+	Moved card from In Development to Dev Complete
+
+== MTX FEATURES:
+
+* Executes a card transition through the Mingle API.
+* Caches user-entered information during Rake task execution.
+* SVN Rake tasks to perform update, remove, add, and conflict check.
+* Sample Rake tasks to illustrate a single Rake command line that will grab latest changes, check for conflicts, run tests, check-in, and finally move card on Mingle.
+
+== SYNOPSIS:
+
+Do you forget to update a story card on Mingle when the card has moved into developers' hands? How about forgetting to update the story card to kick-off its sign off process when story is completed? If we let these sloppiness happen too often, communication flow will be hindered, and the time it takes to provide business value through story completions will be lengthened. Fortunately, Minglr can help.
+
+Minglr allows you to write Rake tasks to execute Mingle card transitions as part of your build process. For example, for a developer to check-in new code, s/he could run the following Rake task:
+
+$ rake check_in
+
+At the end of this Rake task, it can execute a Mingle API call through the help of Minglr to execute the appropriate transition for the card being worked on, be it to move a card into 'In Development', or mark it as 'Story Completed'.
+
+Of course, frequently additional user inputs are required to transition a card. For example, a card number and a comment. Minglr also provides Rake helpers to easily prompt users for inputs as part of their Rake runs, as well as caching them to save future typings.
+
+Minglr can be used regardless your application is a Ruby on Rails web application or a simple Ruby application. In fact, it can even be used as a command line tool to transition cards on Mingle.
+
+== INSTALL:
+
+* sudo gem install schubert-minglr -s http://gems.github.com
+
+* Enable Mingle API basic authentication in auth_config.yml, then restart it.
+
+* Preferably install rb-password (http://www.caliban.org/ruby/ruby-password.shtml), through Macports (sudo port install rb-password)
+* Copy over the "path-to-minglr/tasks/*.sample.rake" files and start customizing for your check-in needs.
+
+== CREDITS:
+
+Thank you to Stephen Chu and Chris O'Meara for their original work.
+
+== Copyright
+
+Copyright (c) 2009 Michael Schubert. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,90 @@
+require 'rubygems'
+require 'rake'
+
+task :default => [:rcov]
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    if File.exist?('VERSION.yml')
+      config = YAML.load(File.read('VERSION.yml'))
+      gem.version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+    else
+      gem.version = ""
+    end
+    gem.post_install_message = %q{PostInstall.txt}
+    
+    gem.name = "minglr"
+    gem.summary = %q{command line user tool for Mingle (http://mingle.thoughtworks.com/mingle-agile-project-management)}
+    gem.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}
+    gem.email = "michael@schubert.cx"
+    gem.homepage = "http://github.com/schubert/minglr"
+    gem.authors = ["Michael Schubert", "Stephen Chu", "Chris O'Meara"]
+    gem.executables = ["mtx", "minglr"]
+    
+    gem.add_dependency "httpclient"
+    gem.add_dependency "activeresource", ">= 2.3.0"
+    gem.add_dependency "activesupport", ">= 2.3.0"
+    
+    gem.add_development_dependency "thoughtbot-shoulda"
+    gem.add_development_dependency "mocha"
+    gem.add_development_dependency "relevance-rcov"
+    gem.add_development_dependency "cucumber"
+    gem.add_development_dependency "redgreen"
+    
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.rcov_opts = ['--exclude', 'gems,/System/Library/Frameworks/Ruby.framework/', "--text-report", "--only-uncovered"]
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install relevance-rcov"
+  end
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "minglr #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+begin
+  require 'cucumber'
+  require 'cucumber/rake/task'
+
+  Cucumber::Rake::Task.new(:features) do |t|
+    t.cucumber_opts = "features --format pretty"
+  end
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+task "ci" => ["rcov", "features", "gemspec", "build", "install"]

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:major: 1
+:minor: 3
+:patch: 11

data/bin/minglr

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'minglr'))
+
+rc_config = Minglr::ConfigParser.parse
+uri_options = rc_config[:global] || {}
+project = rc_config[:global][:default].to_sym if rc_config[:global][:default]
+original_arguments = ARGV
+
+if Minglr::Action.valid_action?(ARGV[0])
+  action = ARGV[0]
+else
+  if ARGV[0] && (ARGV[0] =~ /^--/).nil?
+    project = ARGV[0].to_sym 
+    action = ARGV[1]
+  end
+end
+
+unless project.nil?
+  if action.nil?
+    puts "No action specified. Valid actions are: #{Minglr::Action.valid_actions.join(", ")}"
+    exit 1
+  end
+  uri_options.merge! rc_config[project]
+  Resources::Base.configure uri_options
+  Resources::Attachment.configure
+  extra_options = Minglr::OptionsParser.parse(original_arguments)
+  Minglr::Action.execute(action, ARGV, extra_options, rc_config[project])
+end

data/bin/mtx

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'minglr'))
+
+uri_options, execution_options = MTX::OptionsParser.parse(ARGV, :card, :transition)
+
+Resources::Base.configure uri_options
+
+if card = Resources::Card.find(execution_options[:card])
+  execution = Resources::TransitionExecution.create(execution_options)
+  raise "Transition aborted. Errors: #{execution.errors.full_messages}" if execution.errors.any?
+else
+  raise "Card '#{execution_options[:card]}' cannot be found."
+end

data/cucumber.yml

@@ -0,0 +1,2 @@
+default: --format profile features
+html_report: --format pretty features

data/features/cards.feature

@@ -0,0 +1,27 @@
+Feature: Cards
+  
+  Scenario: Print list of cards in the project
+    Given the project "xp"
+    When I issue the "cards" action
+    Then the result should have "119 - Task      - Build PDF Export Widget on UI" in it
+    And the result should have "105 - Epic      - Find people, projects and documents" in it
+
+  Scenario: Print list of cards in the project with a filter
+    Given the project "xp"
+    And a keyword of "Project"
+    When I issue the "cards" action
+    Then the result should not have "119 - Task      - Build PDF Export Widget on UI" in it
+    Then the result should have "113 - Feature - Update Project" in it
+    And the result should have "112 - Feature - Create Project" in it
+    And the result should have "105 - Epic    - Find people, projects and documents" in it
+
+  Scenario: Print the details of a card in the project
+    Given the project "xp"
+    And the card number "112"
+    When I issue the "card" action
+    Then the result should have "Number: 112" in it
+    And the result should have "Name: Create Project" in it
+    And the result should have "Type: Feature" in it
+    And the result should have "Status:" in it
+    And the result should have "Description: N/A" in it
+    And the result should have "Attachments:" in it

data/features/step_definitions/minglr_steps.rb

@@ -0,0 +1,34 @@
+require File.join(File.dirname(__FILE__), "shared_steps")
+
+Given /^the project "([^\"]*)"$/ do |project|
+  @project = project
+end
+
+Given /^the card number "([^\"]*)"$/ do |card_number|
+  if @options
+    @options << [card_number]
+  else
+    @options = [card_number]
+  end
+end
+
+Given /^a keyword of "([^\"]*)"$/ do |keyword|
+  if @options
+    @options << [keyword]
+  else
+    @options = [keyword]
+  end
+end
+
+When /^I issue the "([^\"]*)" action$/ do |action|
+  @action = action
+  @response = execute_minglr_command(@project, @action, @options)
+end
+
+Then /^the result should have "([^\"]*)" in it$/ do |string|
+  assert @response.split("\n").join(" ").include?(string), "Expected #{@response.inspect} to contain '#{string}'"
+end
+
+Then /^the result should not have "([^\"]*)" in it$/ do |string|
+  assert !@response.split("\n").join(" ").include?(string), "Expected #{@response.inspect} to not contain '#{string}'"
+end

data/features/step_definitions/shared_steps.rb

@@ -0,0 +1,69 @@
+require "test/unit/assertions"
+require File.join(File.dirname(__FILE__), "..", "..", "lib", "minglr")
+World(Test::Unit::Assertions)
+
+module Kernel
+
+  def capture_stdout
+    $stdout = $cucumberout
+    yield
+    return $cucumberout
+  ensure
+    $stdout = STDOUT
+  end
+ 
+end
+
+def rc_config
+  { 
+    :scrum => {
+      :url              => "http://localhost:9090/projects/scrum",
+      :password         => "mingle",
+      :status_property  => "cp_status",
+      :username         => "schubert"
+    }, 
+    :global => {
+      :default          => "blank",
+      :username         => "schubert"
+    },
+    :storytracker => {
+      :url              => "http://localhost:9090/projects/storytracker",
+      :password         => "mingle",
+      :status_property  => "cp_status",
+      :username         => "schubert"
+    },
+    :xp => {
+      :url => "http://localhost:9090/projects/xp",
+      :password => "mingle",
+      :username => "schubert"
+    },
+    :blank => {
+      :url => "http://localhost:9090/projects/blank",
+      :password => "mingle",
+      :username => "schubert"
+    },
+    :agilehybrid => {
+      :url => "http://localhost:9090/projects/agilehybrid",
+      :password => "mingle",
+      :status_property => "cp_status",
+      :username=>"schubert"
+    }
+  }
+end
+
+def execute_minglr_command(project, action, extra_arguments = [])
+  $cucumberout = StringIO.new
+  extra_arguments = [] if extra_arguments.nil?
+  uri_options = rc_config[:global] || {}
+  original_arguments = ([project, action] + extra_arguments)
+  
+  uri_options.merge! rc_config[project.to_sym]
+  Resources::Base.configure uri_options
+  Resources::Attachment.configure
+  extra_options = Minglr::OptionsParser.parse(original_arguments)
+  
+  output = capture_stdout do
+    Minglr::Action.execute(action, original_arguments, extra_options, rc_config[project.to_sym])
+  end
+  output.string.strip
+end

data/features/users.feature

@@ -0,0 +1,6 @@
+Feature: Users
+  
+  Scenario: Print list of users on the project
+    Given the project "xp"
+    When I issue the "users" action
+    Then the result should have "schubert - Michael Schubert - michael@schubert.cx" in it

data/lib/minglr.rb

@@ -0,0 +1,34 @@
+MINGLR_ENV = "normal" unless defined?(MINGLR_ENV)
+
+require 'rubygems'
+require 'activeresource'
+require 'activesupport'
+require 'optparse'
+
+prefix = File.join(File.dirname(__FILE__), "minglr")
+require File.join(prefix, "action")
+require File.join(prefix, "options_parser")
+require File.join(prefix, "config_parser")
+
+mtx = File.join(prefix, "mtx", "*")
+Dir[mtx].each do |file_name|
+  load file_name
+end
+
+require File.join(prefix, "resources", "base")
+resources = File.join(prefix, "resources", "*")
+Dir[resources].each do |file_name|
+  load file_name
+end
+
+extensions = File.join(prefix, "extensions", "*")
+Dir[extensions].each do |file_name|
+  load file_name
+end
+
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+module Minglr
+  ROOT    = File.expand_path File.join(File.dirname(__FILE__), '..')
+end