minglemingle 0.0.1

data/install.rb

@@ -0,0 +1,88 @@
+require 'rbconfig'
+require 'find'
+require 'ftools'
+
+include Config
+
+$ruby = CONFIG['ruby_install_name']
+
+##
+# Install a binary file. We patch in on the way through to
+# insert a #! line. If this is a Unix install, we name
+# the command (for example) 'mm' and let the shebang line
+# handle running it. Under windows, we add a '.rb' extension
+# and let file associations to their stuff
+#
+
+def installBIN(from, opfile)
+
+  tmp_dir = nil
+  for t in [".", "/tmp", "c:/temp", $bindir]
+    stat = File.stat(t) rescue next
+    if stat.directory? and stat.writable?
+      tmp_dir = t
+      break
+    end
+  end
+
+  fail "Cannot find a temporary directory" unless tmp_dir
+  tmp_file = File.join(tmp_dir, "_tmp")
+
+  File.open(from) do |ip|
+    File.open(tmp_file, "w") do |op|
+      ruby = File.join($realbindir, $ruby)
+      op.puts "#!#{ruby}"
+      op.write ip.read
+    end
+  end
+
+  opfile += ".rb" if CONFIG["target_os"] =~ /mswin/i
+  File::install(tmp_file, File.join($bindir, opfile), 0755, true)
+  File::unlink(tmp_file)
+end
+
+$sitedir = CONFIG["sitelibdir"]
+unless $sitedir
+  version = CONFIG["MAJOR"]+"."+CONFIG["MINOR"]
+  $libdir = File.join(CONFIG["libdir"], "ruby", version)
+  $sitedir = $:.find {|x| x =~ /site_ruby/}
+  if !$sitedir
+    $sitedir = File.join($libdir, "site_ruby")
+  elsif $sitedir !~ Regexp.quote(version)
+    $sitedir = File.join($sitedir, version)
+  end
+end
+
+$bindir =  CONFIG["bindir"]
+
+$realbindir = $bindir
+
+bindir = CONFIG["bindir"]
+if (destdir = ENV['DESTDIR'])
+  $bindir  = destdir + $bindir
+  $sitedir = destdir + $sitedir
+
+  File::makedirs($bindir)
+  File::makedirs($sitedir)
+end
+
+mm_dest = File.join($sitedir, "mm")
+File::makedirs(mm_dest, true)
+File::chmod(0755, mm_dest)
+
+# The library files
+
+files = Dir.chdir('lib') { Dir['**/*.rb', '**/*.rake'] }
+
+for fn in files
+  fn_dir = File.dirname(fn)
+  target_dir = File.join($sitedir, fn_dir)
+  if ! File.exist?(target_dir)
+    File.makedirs(target_dir)
+  end
+  File::install(File.join('lib', fn), File.join($sitedir, fn), 0644, true)
+end
+
+# and the executable
+
+installBIN("bin/mm", "mm")

data/lib/mm.rb

@@ -0,0 +1,81 @@
+# Copyright (c) 2008 Li Xiao
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'mm/utils'
+require 'mm/rest_api'
+
+require 'mm/cmds/abstract_command'
+require 'mm/cmds/init'
+require 'mm/cmds/run'
+require 'mm/cmds/svncommit'
+require 'mm/cmds/user'
+require 'mm/cmds/card'
+require 'mm/cmds/cards'
+require 'mm/cmds/favorites'
+require 'mm/cmds/tabs'
+require 'mm/cmds/view'
+require 'mm/cmds/help'
+
+module MM
+  VERSION="0.0.1"
+  
+  module API
+    def team_members
+      return @team_members if defined?(@team_members)
+      init(Resource::User)
+      @team_members = Resource::User.find(:all)
+    end
+  
+    def property_definitions
+      return @property_definitions if defined?(@property_definitions)
+      init(Resource::PropertyDefinition)
+      @property_definitions = Resource::PropertyDefinition.find(:all)
+    end
+  
+    def favorites
+      init(Resource::Favorite)
+      Resource::Favorite.find(:all)
+    end
+    
+    def create_transition_execution(attrs)
+      init(Resource::TransitionExecution)
+      Resource::TransitionExecution.create(attrs)
+    end
+  
+    def find_card(options)
+      init(Resource::Card)
+      Resource::Card.find(:first, options)
+    end
+    
+    def find_card_by_number(number)
+      init(Resource::Card)
+      Resource::Card.find(number)
+    end
+    
+    def find_cards(options)
+      init(Resource::Card)
+      Resource::Card.find(:all, :params => options)
+    end
+    
+    def init(klass)
+      Command::Init.new.do_once(klass)
+    end
+    
+    def execute_cmd(cmd)
+      %x[#{cmd}]
+    end
+  end
+end
+
+MM::Command::AbstractCommand.send(:include, MM::API)

data/lib/mm/cmds/abstract_command.rb

@@ -0,0 +1,78 @@
+# Copyright (c) 2008 Li Xiao
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+require 'mm/repository'
+
+module MM
+  module Command
+    class AbstractCommand
+      def run(argv)
+        if respond_to?(:option_parser)
+          option_parser.parse!(argv)
+        end
+        parse(argv) unless argv.empty?
+        cache_options
+        view do_once
+      end
+      
+      def view(result)
+        output result
+      end
+      
+      def options
+        @options ||= Repository.new[self.class.name] || {}
+      end
+      
+      def parse(argv)
+      end
+      
+      def doc
+        puts(respond_to?(:option_parser) ? option_parser : "No document.")
+      end
+      
+      def cache_options
+        Repository.new[self.class.name] = options
+      end
+
+      def output(message=nil)
+        if block_given?
+          output yield
+          return
+        elsif message.is_a?(String)
+          puts message
+        elsif options[:attr]
+          value = if pd = property_definitions.find{|pd| pd.name.downcase == options[:attr].downcase}
+            property_value(pd, message)
+          else
+            message.send(options[:attr])
+          end
+          output(" * #{options[:attr]}: #{value}")
+        else
+          output(message.to_yaml)
+        end
+      end
+      
+      def property_value(pd, card)
+        obj_value = card.send(pd.column_name)
+        case
+        when pd.card_property?(obj_value)
+          find_card(:id => obj_value).short_summarization
+        when pd.user_property?(obj_value)
+          team_members.find{|u|u.id==obj_value}.name
+        else
+          obj_value
+        end
+      end
+    end
+  end
+end

data/lib/mm/cmds/card.rb

@@ -0,0 +1,57 @@
+# Copyright (c) 2008 Li Xiao
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+require 'mm/cmds/abstract_command'
+
+module MM
+  module Command
+    class Card < AbstractCommand
+      def view(card)
+        if options[:attr] || options[:show_all]
+          super(card)
+        else
+          super(card.summarization) 
+        end
+      end
+      
+      def do_once
+        output "card number => #{options[:number]}"
+        find_card_by_number(options[:number])
+      end
+      
+      def parse(argv)
+        options[:number] = argv[0].gsub(/[^\d]/, '').strip
+      end
+      
+      def option_parser
+        OptionParser.new do |opts|
+          opts.banner = "usage: mm card <card_number>"
+          opts.separator ""
+          opts.separator "Synopsis:"
+          opts.separator "mm card 1 => find card by card number 1 and show all attributes"
+          opts.separator "mm card 1 -a description => find card by card number 1 and show its description"
+          opts.separator ""
+          opts.separator "Options:"
+
+          opts.on_tail("-a", "--attribute ATTR_NAME", "show specified attribute value") do |attr_name|
+            options[:attr] = attr_name
+          end
+
+          opts.on_tail("-s", "--show_all", "show all card attributes") do
+            options[:show_all] = true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mm/cmds/cards.rb

@@ -0,0 +1,58 @@
+# Copyright (c) 2008 Li Xiao
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+require 'mm/cmds/abstract_command'
+
+module MM
+  module Command
+    class Cards < AbstractCommand
+      def view(cards)
+        cards.each do |card|
+          output '----------'
+          output card.short_summarization
+          if options[:attrs]
+            options[:attrs].each do |attr_name|
+              options[:attr] = attr_name
+              output card
+            end
+          end
+        end
+      end
+      
+      def do_once
+        output "card list params => #{options.inspect}"
+        find_cards(options)
+      end
+      
+      def parse(argv)
+        view_options = argv.join(' ').strip
+        options.merge!(eval(view_options =~ /^\{.*\}$/ ? view_options : "{#{view_options}}"))
+      end
+      
+      def option_parser
+        OptionParser.new do |opts|
+          opts.banner = "usage: mm cards [options]"
+          opts.separator ""
+          opts.separator "Synopsis:"
+          opts.separator "mm cards \"{:view => 'favorite/tab name'}\" => find cards by favorite's/tab's name"
+          opts.separator "mm cards \"{:view => 'favorite/tab name', :page => 2}\" => find cards in the page 2 by favorite's/tab's name"
+          opts.separator ""
+          opts.separator "Options:"
+          opts.on("-a att_name1,attr_name2", Array, "show specified attribute value.") do |names|
+            options[:attrs] = names
+          end
+        end
+      end
+    end
+  end
+end

data/lib/mm/cmds/favorites.rb

@@ -0,0 +1,29 @@
+# Copyright (c) 2008 Li Xiao
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+require 'mm/cmds/abstract_command'
+
+#not finished yet
+module MM
+  module Command
+    class Favorites < AbstractCommand
+      def view(favorites)
+        output "All favorites: \n#{favorites.collect{|f| "  * #{f.name}"}.join("\n")}"
+      end
+      
+      def do_once
+        favorites
+      end
+    end
+  end
+end

data/lib/mm/cmds/help.rb

@@ -0,0 +1,70 @@
+# Copyright (c) 2008 Li Xiao
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+require 'mm/cmds/abstract_command'
+
+module MM
+  module Command
+    class Help < AbstractCommand
+      def do_once
+        return doc if options[:cmd].blank?
+        "#{MM.cmd_instance(options[:cmd]).doc}\n"
+      rescue Exception => e
+        "Unknow subcommand: #{options[:cmd]}\n#{doc}\n"
+      end
+      
+      def parse(argv)
+        options[:cmd] = argv.first
+      end
+      
+      #don't want to cache options of this command
+      def cache_options
+      end
+      
+      def doc
+%{
+mingle mingle, version #{MM::VERSION}
+Type 'mm help <subcommand>' for help on a specific subcommand.
+
+Queck start:
+  * Suppose I am working on a project pet_store checked out at '~/pet_store'.
+  * cd ~/pet_store
+  * mm init http://my_login:password@mingle_server/projects/pet_store
+  * mm cards => list first page cards on All tab
+  * mm view My Work -a owner,priority => list cards on card list view named 'My Work' including property owner and priority
+  * mm card 102 => show name and description of the card
+  * mm run 'Start fix #102' => run transition 'Start fix' on card 102
+  * mm svnci -m "[complete development #1 with 'fixed revision' => \#{revision}, resolution => fixed (some comment)] blabla..." => commit code and run transition script inside of []
+  * mm view => show view cached which is 'My Work' with property 'owner' and 'priority' by last time using view command
+  * mm card => show card cached number of which is 102 by last time using card command
+
+Available subcommands:
+  help [subcommand] show help doc of subcommand
+  init [url]        init MingleMingle working directory with Mingle REST api project base url
+  card [number]     show card content by card number
+  cards [params]    show cards by params, it will do nothing without params.
+  user [id/login]   show user info by id/login
+  view name         show cards find by view/tab name
+  run script        run transition
+  svncommit(svnci)  run transition execution script inside the commit message after committed code(subversion)
+
+MingleMingle is a tool for integrating Mingle(http://studios.thoughtworks.com/) with command-line
+For additional information, see http://minglemingle.rubyforge.org
+Notes: 
+  * In the command line, should use \\! instead of !.
+  * There would be a '.mm_pstore' file created for cache in the MingleMingle working directory.
+}
+      end
+    end
+  end
+end