geera 1.2.3

data/.autotest

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+# Autotest.add_hook :initialize do |at|
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception 'vendor'
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/ChangeLog

@@ -0,0 +1,43 @@
+Fri Jun 18 14:26:00 2010  Aaron Patterson <aaron@tenderlovemaking.com>
+
+	* Added a custom field for the "closer" of a ticket.
+
+Fri Mar  5 08:59:37 2010  Aaron Patterson <aaron@tenderlovemaking.com>
+
+	* Priority is copied around when starting or fixing.
+
+Thu Mar  4 09:24:46 2010  Aaron Patterson <aaron@tenderlovemaking.com>
+
+	* Description is no longer required to create a ticket
+
+Thu Mar  4 09:21:03 2010  Aaron Patterson <aaron@tenderlovemaking.com>
+
+	* bin/geera raises an exception on an unknown command.
+
+Thu Mar  4 09:18:08 2010  Aaron Patterson <aaron@tenderlovemaking.com>
+
+	* 'geera filters' will list your available filters
+
+Thu Mar  4 09:01:12 2010  Aaron Patterson <aaron@tenderlovemaking.com>
+
+	* 'geera show TICKET' will let you view info about TICKET
+
+Wed Mar  3 17:50:26 2010  Aaron Patterson <aaron@tenderlovemaking.com>
+
+	* added hacks for silencing Jira4R
+
+Wed Mar  3 14:40:56 2010  Aaron Patterson <aaron@tenderlovemaking.com>
+
+	* starting and fixing a ticket will maintain description
+
+Tue Mar  2 10:31:42 2010  Aaron Patterson <aaron@tenderlovemaking.com>
+
+	* Changed "mv" command to "assign".
+	* Added the "create" command.
+
+=== 1.0.0 / 2010-02-26
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,30 @@
+.autotest
+ChangeLog
+Manifest.txt
+README.rdoc
+Rakefile
+bin/geera
+lib/geera.rb
+lib/geera/client.rb
+lib/geera/commands/assign.rb
+lib/geera/commands/command.rb
+lib/geera/commands/estimate.rb
+lib/geera/commands/filters.rb
+lib/geera/commands/fix.rb
+lib/geera/commands/list.rb
+lib/geera/commands/show.rb
+lib/geera/commands/start.rb
+lib/geera/commands/take.rb
+lib/geera/executable.rb
+lib/geera/ticket.rb
+lib/template.txt
+test/commands/test_assign.rb
+test/commands/test_estimate.rb
+test/commands/test_filters.rb
+test/commands/test_fix.rb
+test/commands/test_list.rb
+test/commands/test_show.rb
+test/commands/test_start.rb
+test/commands/test_take.rb
+test/test_client.rb
+test/test_ticket.rb

data/README.rdoc

@@ -0,0 +1,189 @@
+= geera
+
+* http://atti.com/
+
+== DESCRIPTION:
+
+Geera is a command line tool for dealing with Jira tickets.
+
+== FEATURES/PROBLEMS:
+
+* Uses soap4r
+
+== SYNOPSIS:
+
+Geera provides a command line tool for interacting with the Jira ticketing
+system.
+
+After you've installed Geera, you must configure your ~/.geera file like this:
+
+  $ geera setup
+
+That command will create a $HOME/.geera file for you to fill out.  The config
+file will look something like this:
+
+  ---
+  url: FIXME
+  username: FIXME
+  qa: FIXME
+  password: FIXME
+
+The "url" value should point to the Jira API url.  "username" and "password"
+are your username and password for the Jira system.  When running "geera fix",
+the ticket will be automatically reassigned to the username listed in "qa".
+If the "qa" value is removed, the ticket will not be reassigned when the
+ticket is fixed.
+
+=== Basic Usage
+
+Geera commands have the basic form of "geera ACTION TICKET", where
+ACTION is the action you want to perform, and TICKET is the ticket on which
+you wish to perform that action.
+
+The current available commands are:
+
+  * start
+  * fix
+  * assign
+  * take
+  * create
+  * comment
+  * list
+
+=== "start" command
+
+The "start" command lets you start a ticket.  This command only works when the
+ticket is in a startable state.  For example:
+
+  $ geera start BZ-1000
+
+This command will set the state of BZ-1000 to "start".  If the ticket is not
+in a startable state, an error will be displayed.
+
+=== "fix" command
+
+The "fix" command puts the ticket in to a fixed state.  If the ticket is
+startable, it will first start the ticket, then put the ticket in fixed state.
+
+  $ geera fix BZ-1000
+
+The ticket BZ-1000 should be in the "fixed" state.  If a user is specified in
+the "qa" section of the configuration file, the ticket will be automatically
+reassigned to that user.
+
+=== "assign" command
+
+The "assign" command reassigns a ticket to another user.  The following command
+will reassign the ticket BZ-1000 to the user "foo":
+
+  $ geera assign BZ-1000 foo
+
+=== "take" command
+
+The "take" command is similar to the "mv" command, but assigns the ticket to
+the user listed in the "username" section of the configuration file.  This
+command is useful when you wish to "take" a ticket from someone:
+
+  $ geera take BZ-1000
+
+=== "create" command
+
+The "create" command will create a new ticket in the JIRA system.  It requires
+a project name on which to create the ticket.  For example, if you want to
+create a ticket in the "BZ" project, the command will look like this:
+
+  $ geera create BZ
+
+This command will open $EDITOR with a form to fill out.  Enter the details of
+the ticket, and the ticket will be created.
+
+=== "comment" command
+
+The "comment" command lets you comment on a ticket.  Comments are passed in
+through the -m flag.  For example:
+
+  $ geera comment BZ-1000 -m'This is a comment'
+
+=== "list" command
+
+The "list" command lets you list tickets in a filter.  You can then take the
+ticket numbers returned and assign them or whatever.
+
+  $ geera list 1138
+
+This command prints out the first 10 tickets in the 1138 filter. Of course,
+named filters would be much nicer.  If you add a "filters" hash in your
+~/.geera file, you can assign names to filter ids.
+
+filters:
+  all: 12482
+  features: 12481
+  bugs: 12480
+
+Then you can run:
+
+  $ geera list bugs
+
+And get the tickets from filter id 12480.
+
+== Comments
+
+An optional "-m" flag is available on every command.  The "-m" flag will
+automatically attach a comment to the ticket in addition to the original
+command performed.  For example, we can fix a ticket and add a comment at the
+same time by doing:
+
+  $ geera fix BZ-1000 -m'I totally fixed this ticket'
+
+== Example Workflows
+
+First, start the ticket, then do work, then fix the ticket:
+
+  $ geera start BZ-1000 -m'starting to work on awesome feature'
+  $ ...
+  $ ...
+  $ geera fix BZ-1000 -m'finished awesome feature'
+
+Maybe you need to add comments while fixing stuff:
+
+  $ geera start BZ-1000 -m'starting to work on awesome feature'
+  $ ...
+  $ geera comment BZ-1000 -m'I had to totally do this thing'
+  $ ...
+  $ geera fix BZ-1000 -m'finished awesome feature'
+
+You do some work, then need to give the ticket to someone else:
+
+  $ geera start BZ-1000 -m'starting to work on awesome feature'
+  $ ...
+  $ geera mv BZ-1000 coworker -m'This was too hard for me!'
+
+
+== INSTALL:
+
+* sudo gem install geera
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2010 ATT Interactive
+
+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/Rakefile

@@ -0,0 +1,15 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.spec 'geera' do
+  developer('Aaron Patterson', 'apatterson@atti.com')
+  self.readme_file      = 'README.rdoc'
+  self.history_file     = 'ChangeLog'
+  self.extra_rdoc_files = FileList['*.rdoc']
+  self.extra_deps       << ['jira4r', '>= 0.3.0']
+  self.extra_dev_deps   << ['flexmock', '>= 0']
+end
+
+# vim: syntax=ruby

data/bin/geera

@@ -0,0 +1,118 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'tmpdir'
+require 'geera'
+require 'yaml'
+require 'optparse'
+
+config = File.join(ENV['HOME'], '.geera')
+login  = YAML.load(File.read config) rescue nil
+BUG_TEMPLATE = File.expand_path(File.join(
+  File.dirname(__FILE__), '..', 'lib', 'template.txt'))
+
+unless login
+  File.open config, 'wb' do |f|
+
+    options = {
+      'username' => 'FIXME',
+      'password' => 'FIXME',
+      'url'      => 'FIXME',
+      'qa'       => 'FIXME'
+    }
+
+    YAML.dump options, f
+    f.chmod(0600)
+  end
+  abort "Created ~/.geera for you. Fill it out"
+end
+
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = <<-EOF
+  Usage: geera <command> <ticket|project> [options]
+
+  Commands:
+    show - Shows ticket details
+      `geera show TK-421`
+    create - Creates a new ticket in a project
+      `geera create TK`
+    fix - Marks a ticket as fixed and assigns to QA.
+      `geera fix TK-421`
+    assign - Assigns a ticket to someone else
+      `geera reassign TK-421 glucas`
+    take - Assigns a ticket to yourself
+      `geera take TK-421`
+    list - Lists tickets in a filter
+      `geera list 1138`
+      `geera list my-filter-name`
+    filters - Lists your filters
+      `geera filters`
+    comment - Simply comment on the ticket
+      `geera comment TK-421 --message 'This is a difficult bug.'`
+
+    Options:
+  EOF
+
+  opts.on("-m", "--message MESSAGE", "Add a comment") do |v|
+    options[:message] = v
+  end
+end.parse!
+
+exec = Geera::Executable.new login, ARGV, options
+geera = exec.geera
+
+command = ARGV.shift
+number  = ARGV.shift
+ticket  = geera.ticket number
+
+case command
+when 'start'
+  command = Geera::Commands::Start.new login, number, geera, ARGV
+  command.execute!
+when 'estimate'
+  command = Geera::Commands::Estimate.new login, number, geera, ARGV
+  command.execute!
+when 'fix'
+  command = Geera::Commands::Fix.new login, number, geera, ARGV
+  command.execute!
+when 'assign'
+  command = Geera::Commands::Assign.new login, number, geera, ARGV
+  command.execute!
+when 'take'
+  command = Geera::Commands::Take.new login, number, geera, ARGV
+  command.execute!
+when 'show'
+  command = Geera::Commands::Show.new login, number, geera, ARGV
+  command.execute!
+when 'filters'
+  command = Geera::Commands::Filters.new login, number, geera, ARGV
+  command.execute!
+when 'list'
+  number = (login['filters'] && login['filters'][number]) || number
+
+  command = Geera::Commands::List.new login, number, geera, ARGV
+  command.execute!
+when 'create'
+  fname = File.join(Dir.tmpdir, 'bug.txt')
+  File.open(fname, 'wb') do |f|
+    f.write File.read(BUG_TEMPLATE)
+  end
+
+  system("#{ENV['EDITOR'] || 'vi'} #{fname}")
+  contents = File.read(fname)
+  sum, desc = contents.split('##### Description is below here #####')
+
+  ticket = geera.create_ticket :project     => number,
+                               :summary     => sum.sub(/^Summary:/, '').strip,
+                               :description => desc && desc.strip
+
+  puts "Created ticket: #{ticket.number}"
+when 'comment'
+  # Do nothing, let the -m flag pick it up
+else
+  raise "unknown command: #{command}"
+end
+
+ticket.comment options[:message] if options[:message]

data/lib/geera.rb

@@ -0,0 +1,23 @@
+require 'jira4r'
+require 'geera/client'
+require 'geera/ticket'
+require 'geera/executable'
+require 'geera/commands/command'
+require 'geera/commands/assign'
+require 'geera/commands/start'
+require 'geera/commands/fix'
+require 'geera/commands/take'
+require 'geera/commands/show'
+require 'geera/commands/filters'
+require 'geera/commands/list'
+require 'geera/commands/estimate'
+
+module Geera
+  VERSION = '1.2.3'
+end
+
+# Total hacks for shutting up Jira4R
+class Jira4R::JiraTool
+  def puts *args
+  end
+end