geera 1.2.3

data/lib/geera/client.rb

@@ -0,0 +1,63 @@
+module Geera
+  class Client
+    attr_reader :username
+    attr_reader :ctx
+
+    def initialize url
+      @ctx = Jira4R::JiraTool.new 2, url
+
+      # Make jira4r quiet
+      @ctx.logger = Logger.new nil
+      @username = nil
+    end
+
+    ###
+    # Login with +user+ and +password+
+    def login user, password
+      @username = user
+      @ctx.login user, password
+    end
+
+    ###
+    # Get the ticket with +number+.  Returns a Geera::Ticket object.
+    #
+    #   client.ticket 'BZ-123' # => #<Geera::Ticket>
+    def ticket number
+      Geera::Ticket.new self, number
+    end
+
+    ###
+    # Create a ticket using +params+.  +params+ should be a hash, and *must*
+    # have a +project+, +summary+, and +description+ field.
+    #
+    # For example:
+    #
+    #   client.create_ticket :project => 'AB',
+    #                        :summary => 'foo',
+    #                        :description => 'bar'
+    #
+    def create_ticket params
+      [:project, :summary].each do |param|
+        raise(ArgumentError, "#{param} required") unless params[param]
+      end
+
+      issue = Jira4R::V2::RemoteIssue.new
+      issue.project     = params[:project]
+      issue.summary     = params[:summary]
+      issue.description = params[:description]
+      issue.assignee    = params[:assignee] || @username
+      issue.type        = '1' #FIXME: wtf is this for?
+      issue.priority    = '5'
+      issue = @ctx.createIssue issue
+      ticket issue.key
+    end
+
+    def filters
+      @ctx.getSavedFilters
+    end
+
+    def list filter
+      @ctx.getIssuesFromFilter filter
+    end
+  end
+end

data/lib/geera/commands/assign.rb

@@ -0,0 +1,13 @@
+module Geera
+  module Commands
+    class Assign < Geera::Commands::Command
+      def self.handle? command
+        'assign' == command
+      end
+
+      def execute!
+        ticket.assign_to argv.shift
+      end
+    end
+  end
+end

data/lib/geera/commands/command.rb

@@ -0,0 +1,19 @@
+module Geera
+  module Commands
+    class Command
+      attr_reader :geera, :number, :config, :argv
+
+      def initialize config, number, geera, argv
+        @argv   = argv
+        @config = config
+        @number = number
+        @geera  = geera
+        @ticket = nil
+      end
+
+      def ticket
+        @ticket ||= geera.ticket number
+      end
+    end
+  end
+end

data/lib/geera/commands/estimate.rb

@@ -0,0 +1,13 @@
+module Geera
+  module Commands
+    class Estimate < Geera::Commands::Command
+      def self.handle? command
+        'estimate' == command
+      end
+
+      def execute!
+        ticket.estimate = argv.shift
+      end
+    end
+  end
+end

data/lib/geera/commands/filters.rb

@@ -0,0 +1,16 @@
+module Geera
+  module Commands
+    class Filters < Geera::Commands::Command
+      def self.handle? command
+        'filters' == command
+      end
+
+      def execute!
+        puts "# Your filters"
+        geera.filters.each do |filter|
+          puts "  * #{filter.name.inspect}"
+        end
+      end
+    end
+  end
+end

data/lib/geera/commands/fix.rb

@@ -0,0 +1,15 @@
+module Geera
+  module Commands
+    class Fix < Geera::Commands::Command
+      def self.handle? command
+        'fix' == command
+      end
+
+      def execute!
+        ticket.start! if ticket.startable?
+        ticket.fix! if ticket.fixable?
+        ticket.assign_to config['qa'] if config['qa']
+      end
+    end
+  end
+end

data/lib/geera/commands/list.rb

@@ -0,0 +1,29 @@
+module Geera
+  module Commands
+    class List < Geera::Commands::Command
+      def self.handle? command
+        'list' == command
+      end
+
+      def number
+        ## Ensure that +number+ is actually a number
+        begin
+          @number = Integer(super)
+        rescue ArgumentError
+          @number = geera.filters.find { |f| f.name == super }.id
+        end
+      end
+
+      def execute!
+        tickets = geera.list number
+        if tickets.empty?
+          puts "No Tickets found"
+        else
+          tickets.first(10).each do |ticket|
+            puts "#{ticket.key.ljust(8)} #{ticket.summary}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/geera/commands/show.rb

@@ -0,0 +1,13 @@
+module Geera
+  module Commands
+    class Show < Geera::Commands::Command
+      def self.handle? command
+        'show' == command
+      end
+
+      def execute!
+        puts ticket.inspect
+      end
+    end
+  end
+end

data/lib/geera/commands/start.rb

@@ -0,0 +1,17 @@
+module Geera
+  module Commands
+    class Start < Geera::Commands::Command
+      def self.handle? command
+        'start' == command
+      end
+
+      def execute!
+        unless ticket.startable?
+          abort "Ticket #{@number} is not startable. Available actions:\n" \
+            "  - #{ticket.available_actions.map { |x| x.name + "\n" }.join("  - ")}"
+        end
+        ticket.start!
+      end
+    end
+  end
+end

data/lib/geera/commands/take.rb

@@ -0,0 +1,13 @@
+module Geera
+  module Commands
+    class Take < Geera::Commands::Command
+      def self.handle? command
+        'take' == command
+      end
+
+      def execute!
+        ticket.assign_to config['username']
+      end
+    end
+  end
+end

data/lib/geera/executable.rb

@@ -0,0 +1,10 @@
+module Geera
+  class Executable
+    attr_reader :geera
+
+    def initialize config, argv, cmd_opts
+      @geera = Geera::Client.new(config['url'])
+      @geera.login(config['username'], config['password'])
+    end
+  end
+end

data/lib/geera/ticket.rb

@@ -0,0 +1,116 @@
+require 'erb'
+
+module Geera
+  class Ticket
+    attr_reader :number
+
+    ###
+    # Create a new Ticket using Geera::Client +client+ and +ticket_number+.
+    # This constructor should not be called directly, use Geera::Client#ticket
+    # instead.
+    def initialize client, ticket_number
+      @client = client
+      @ctx    = client.ctx
+      @number = ticket_number
+      @issue  = nil
+    end
+
+    ###
+    # Add a comment to this ticket with +text+.
+    def comment text
+      @ctx.addComment @number, Jira4R::V2::RemoteComment.new(nil, text)
+    end
+
+    ###
+    # Returns a list of the actions that can be performed on this ticket.
+    def available_actions
+      @ctx.getAvailableActions @number
+    end
+
+    def startable?
+      available_actions.map { |a| a.name }.include?('Start')
+    end
+
+    ###
+    # Start this ticket.
+    def start!
+      action = available_actions.find { |x| x.name == 'Start' }
+      @ctx.progressWorkflowAction(@number, action.id, passthrough_attributes)
+    end
+
+    ###
+    # Is this ticket in a Fix able state?
+    def fixable?
+      available_actions.map { |a| a.name }.include?('Fix')
+    end
+
+    ###
+    # Fix this ticket.
+    def fix!
+      action = available_actions.find { |x| x.name == 'Fix' }
+      @ctx.progressWorkflowAction(@number, action.id, passthrough_attributes + [
+       Jira4R::V2::RemoteFieldValue.new('customfield_10176', @client.username),
+      ])
+    end
+
+    ###
+    # Assign this ticket to +username+
+    def assign_to username
+      assign = Jira4R::V2::RemoteFieldValue.new('assignee', username)
+      @ctx.updateIssue(@number, [assign])
+    end
+
+    def estimate= amount
+      assign = Jira4R::V2::RemoteFieldValue.new('timetracking', amount)
+      @ctx.updateIssue(@number, [assign])
+    end
+
+    def description
+      issue.description
+    end
+
+    def inspect
+      template = ERB.new <<-eoinspect
+## Reporter: <%= issue.reporter %>
+## Assignee: <%= issue.assignee %>
+## Priority: <%= issue.priority %>
+## Fix Versions: <%= issue.fixVersions.map {|fv| fv.name}.join(', ') %>
+
+## Summary
+
+<%= issue.summary %>
+
+## Description:
+
+<%= issue.description %>
+
+## Comments:
+<% comments.each do |comment| %>
+* <%= comment.author %>
+  <% comment.body.split(/[\r\n]+/).each do |line| %>
+  > <%= line %><% end %>
+<% end %>
+
+      eoinspect
+      template.result binding
+    end
+
+    private
+    def issue
+      @issue ||= @ctx.getIssue(@number)
+    end
+
+    def comments
+      @ctx.getComments @number
+    end
+
+    def passthrough_attributes
+      [
+       Jira4R::V2::RemoteFieldValue.new('assignee', @client.username),
+       Jira4R::V2::RemoteFieldValue.new('description', description),
+       Jira4R::V2::RemoteFieldValue.new('priority', issue.priority),
+      ]
+    end
+
+  end
+end

data/lib/template.txt

@@ -0,0 +1,12 @@
+Summary: Enter your ticket summary here
+
+##### Description is below here #####
+
+What I did:
+
+
+What I expected:
+
+
+What actually happened:
+

data/test/commands/test_assign.rb

@@ -0,0 +1,27 @@
+require "test/unit"
+require "geera"
+require 'flexmock/test_unit'
+
+module Geera
+  module Commands
+    class TestAssign < Test::Unit::TestCase
+      def test_handle?
+        assert Assign.handle?('assign')
+      end
+
+      def test_execute!
+        recorder = Object.new
+        flexmock(recorder) do |thing|
+          thing.should_receive(:assign_to).with('foo').once
+        end
+
+        Class.new(Geera::Commands::Assign) {
+          def initialize ticket, argv
+            super(nil, nil, nil, argv)
+            @ticket = ticket
+          end
+        }.new(recorder, ['foo']).execute!
+      end
+    end
+  end
+end

data/test/commands/test_estimate.rb

@@ -0,0 +1,27 @@
+require "test/unit"
+require "geera"
+require 'flexmock/test_unit'
+
+module Geera
+  module Commands
+    class TestEstimate < Test::Unit::TestCase
+      def test_handle?
+        assert Estimate.handle?('estimate')
+      end
+
+      def test_execute!
+        recorder = Object.new
+        flexmock(recorder) do |thing|
+          thing.should_receive(:estimate=).with('3h').once
+        end
+
+        Class.new(Geera::Commands::Estimate) {
+          def initialize ticket, argv
+            super(nil, nil, nil, argv)
+            @ticket = ticket
+          end
+        }.new(recorder, %w{3h}).execute!
+      end
+    end
+  end
+end

data/test/commands/test_filters.rb

@@ -0,0 +1,34 @@
+require "test/unit"
+require "geera"
+require 'flexmock/test_unit'
+
+module Geera
+  module Commands
+    class TestFilters < Test::Unit::TestCase
+      def test_handle?
+        assert Filters.handle?('filters')
+      end
+
+      def test_execute!
+        filter = Struct.new(:name).new('hi')
+
+        recorder = Object.new
+        flexmock(recorder) do |thing|
+          thing.should_receive(:filters).once.and_return([filter])
+        end
+
+        cmd = fake_command.new(recorder)
+        flexmock(cmd).should_receive(:puts)
+        cmd.execute!
+      end
+
+      def fake_command
+        Class.new(Geera::Commands::Filters) {
+          def initialize geera
+            super(nil, nil, geera, nil)
+          end
+        }
+      end
+    end
+  end
+end