gojira 0.1.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Sean Sorrell
+
+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/README.md

@@ -0,0 +1,22 @@
+# gojira
+gojira is a command line interface to Atlassian Jira. It currently supports reading and updating of issues and comments. More features (search, comments) are planned.
+
+## installation
+'gem install gojira' should do the trick. This will install two executable links - 'gojira' and 'gj'.  
+gojira will look for a config file at ~/.gojira  
+expected format is:  
+	full path to jira  
+	username  
+	password  
+
+## usage
+### commands:
+*	gojira i[ssues] - show all issues assigned to you
+*	gojira i[ssue] issue - show information about an issue with the given key
+*	gojira p[rojects] - show all projects on the current Jira instance
+*	gojira u[pdate] issue - show all valid actions that can be performed on an issue
+*	gojira u[pdate] issue action_id - move the issue to the specified status
+
+### arguments:
+	issue => an internal gojira ID (ie. from 'gojira issues')
+	action_id => an internal gojira action_ID (ie. from 'gojira update issue')

data/bin/gj

@@ -0,0 +1,97 @@
+#!/usr/bin/env ruby
+require 'gojira_api.rb'
+
+CONFIG_PATH = File.join(ENV['HOME'], '.gojira')
+
+class Gojira
+	attr_reader :gojira
+
+	def initialize(url, user, pass)
+		@gojira = GojiraAPI.new url
+		@gojira.login user,pass
+	end
+
+	def self.load_config
+		if not File.exist? CONFIG_PATH
+			puts "no config found at ~/.gojira \nformat: \n\tpath\n\tuser\n\tpass"
+			exit
+		end
+		File.read(CONFIG_PATH).split("\n")
+	end
+
+	def run(args)
+		parse_args(args)
+	end
+
+
+	def show_projects
+		output = @gojira.projects.map do |project|
+			"#{project.key} - #{project.url}"
+		end
+		print output
+	end
+	
+	def show_issues issue_id=nil
+		output = @gojira.user_issues.enum_with_index.map do |issue,id|
+			"#{id} #{format_issue issue,issue_id}"
+		end
+		output = output[issue_id] if issue_id
+		print output
+	end
+
+	def update_status(issue,new_action=nil)
+		issue = externalize_issue(issue)
+		valid_actions = @gojira.valid_actions(issue)
+		output = valid_actions.enum_with_index.map do |action,id|
+			"#{id} - #{format_action action}"
+		end
+		if new_action
+			if (resp = @gojira.set_action issue, valid_actions[new_action.to_i][:id])
+				output = "set to #{resp[:name]}"
+			else
+				output = "failed to perform action - maybe it is invalid?"
+			end
+		end
+		print output
+	end
+
+	protected
+	def print out
+		puts out
+		return out
+	end
+
+	def format_issue(issue, verbose=false)
+		status = @gojira.issue_status issue.key
+		priority = @gojira.issue_priority issue.key
+
+		"#{issue.key} - #{issue.summary} \n\t #{status[:name]} - #{priority[:name]} \n #{issue.description if verbose}\n\n"
+	end
+
+	def format_action(action)
+		"#{action[:name]}"
+	end
+
+	def externalize_issue(key)
+		@gojira.user_issues[key.to_i].key
+	end
+
+	def parse_args(args)
+		command = args[0]
+		case command
+			when /i/
+				then show_issues args[1]
+			when /p/
+				then show_projects
+			when /u/
+				then update_status args[1], args[2]
+			else
+				show_issues
+		end
+	end
+end
+
+
+
+gj = Gojira.new *Gojira.load_config
+gj.run ARGV

data/bin/gojira

@@ -0,0 +1,97 @@
+#!/usr/bin/env ruby
+require 'gojira_api.rb'
+
+CONFIG_PATH = File.join(ENV['HOME'], '.gojira')
+
+class Gojira
+	attr_reader :gojira
+
+	def initialize(url, user, pass)
+		@gojira = GojiraAPI.new url
+		@gojira.login user,pass
+	end
+
+	def self.load_config
+		if not File.exist? CONFIG_PATH
+			puts "no config found at ~/.gojira \nformat: \n\tpath\n\tuser\n\tpass"
+			exit
+		end
+		File.read(CONFIG_PATH).split("\n")
+	end
+
+	def run(args)
+		parse_args(args)
+	end
+
+
+	def show_projects
+		output = @gojira.projects.map do |project|
+			"#{project.key} - #{project.url}"
+		end
+		print output
+	end
+	
+	def show_issues issue_id=nil
+		output = @gojira.user_issues.enum_with_index.map do |issue,id|
+			"#{id} #{format_issue issue,issue_id}"
+		end
+		output = output[issue_id] if issue_id
+		print output
+	end
+
+	def update_status(issue,new_action=nil)
+		issue = externalize_issue(issue)
+		valid_actions = @gojira.valid_actions(issue)
+		output = valid_actions.enum_with_index.map do |action,id|
+			"#{id} - #{format_action action}"
+		end
+		if new_action
+			if (resp = @gojira.set_action issue, valid_actions[new_action.to_i][:id])
+				output = "set to #{resp[:name]}"
+			else
+				output = "failed to perform action - maybe it is invalid?"
+			end
+		end
+		print output
+	end
+
+	protected
+	def print out
+		puts out
+		return out
+	end
+
+	def format_issue(issue, verbose=false)
+		status = @gojira.issue_status issue.key
+		priority = @gojira.issue_priority issue.key
+
+		"#{issue.key} - #{issue.summary} \n\t #{status[:name]} - #{priority[:name]} \n #{issue.description if verbose}\n\n"
+	end
+
+	def format_action(action)
+		"#{action[:name]}"
+	end
+
+	def externalize_issue(key)
+		@gojira.user_issues[key.to_i].key
+	end
+
+	def parse_args(args)
+		command = args[0]
+		case command
+			when /i/
+				then show_issues args[1]
+			when /p/
+				then show_projects
+			when /u/
+				then update_status args[1], args[2]
+			else
+				show_issues
+		end
+	end
+end
+
+
+
+gj = Gojira.new *Gojira.load_config
+gj.run ARGV

data/bin/gojira.rb

@@ -0,0 +1,97 @@
+#!/usr/bin/env ruby
+require 'gojira_api.rb'
+
+CONFIG_PATH = File.join(ENV['HOME'], '.gojira')
+
+class Gojira
+	attr_reader :gojira
+
+	def initialize(url, user, pass)
+		@gojira = GojiraAPI.new url
+		@gojira.login user,pass
+	end
+
+	def self.load_config
+		if not File.exist? CONFIG_PATH
+			puts "no config found at ~/.gojira \nformat: \n\tpath\n\tuser\n\tpass"
+			exit
+		end
+		File.read(CONFIG_PATH).split("\n")
+	end
+
+	def run(args)
+		parse_args(args)
+	end
+
+
+	def show_projects
+		output = @gojira.projects.map do |project|
+			"#{project.key} - #{project.url}"
+		end
+		print output
+	end
+	
+	def show_issues issue_id=nil
+		output = @gojira.user_issues.enum_with_index.map do |issue,id|
+			"#{id} #{format_issue issue,issue_id}"
+		end
+		output = output[issue_id] if issue_id
+		print output
+	end
+
+	def update_status(issue,new_action=nil)
+		issue = externalize_issue(issue)
+		valid_actions = @gojira.valid_actions(issue)
+		output = valid_actions.enum_with_index.map do |action,id|
+			"#{id} - #{format_action action}"
+		end
+		if new_action
+			if (resp = @gojira.set_action issue, valid_actions[new_action.to_i][:id])
+				output = "set to #{resp[:name]}"
+			else
+				output = "failed to perform action - maybe it is invalid?"
+			end
+		end
+		print output
+	end
+
+	protected
+	def print out
+		puts out
+		return out
+	end
+
+	def format_issue(issue, verbose=false)
+		status = @gojira.issue_status issue.key
+		priority = @gojira.issue_priority issue.key
+
+		"#{issue.key} - #{issue.summary} \n\t #{status[:name]} - #{priority[:name]} \n #{issue.description if verbose}\n\n"
+	end
+
+	def format_action(action)
+		"#{action[:name]}"
+	end
+
+	def externalize_issue(key)
+		@gojira.user_issues[key.to_i].key
+	end
+
+	def parse_args(args)
+		command = args[0]
+		case command
+			when /i/
+				then show_issues args[1]
+			when /p/
+				then show_projects
+			when /u/
+				then update_status args[1], args[2]
+			else
+				show_issues
+		end
+	end
+end
+
+
+
+gj = Gojira.new *Gojira.load_config
+gj.run ARGV

data/lib/gojira_api.rb

@@ -0,0 +1,90 @@
+require 'jira4r'
+class GojiraAPI
+	attr_reader :user
+	def initialize(url)
+		@jira = Jira4R::JiraTool.new 2, url
+		@jira.logger=Logger.new("/dev/null")
+	end
+
+	def login(user,pass)
+		@user = user
+		@jira.login user, pass
+	end
+
+	def projects
+		@jira.getProjectsNoSchemes
+	end
+
+	def user_issues(limit = 100)
+		@jira.getIssuesFromJqlSearch "assignee = currentUser()", limit
+	end
+
+	def issue(key)
+		@jira.getIssue(key)
+	end
+
+	def priorities
+		@priorities ||= @jira.getPriorities.map do |p|
+			{
+				:id => p.id,
+				:name => p.name,
+				:desc => p.description
+			}
+		end
+	end
+
+	def priority(id)
+		priorities.find { |p| p[:id] == id }
+	end
+
+	def statuses
+		@statuses ||= @jira.getStatuses.map do |s| 
+			{
+				:id => s.id, 
+				:name => s.name,
+				:desc => s.description,
+			}
+		end
+	end
+
+	def status(id)
+		statuses.find{|s| s[:id] == id}
+	end
+
+	def issue_status(key)
+		issue = issue(key)
+		status(issue.status)
+	end
+
+	def issue_priority(key)
+		issue = issue(key)
+		priority(issue.priority)
+	end
+	
+	def valid_actions(key)
+		@jira.getAvailableActions(key).map do |action|
+			{
+				:id => action.id,
+				:name => action.name
+			}
+		end
+	end
+
+	def add_comment(key, body)
+		comment = Jira4R::V2::RemoteComment.new
+		comment.body = body
+		@jira.addComment key, comment rescue return
+		comment
+	end
+
+	def set_action(issue_key, action_key)
+		action = valid_actions(issue_key).find {|action| action[:id] == action_key}
+		return if not action
+		@jira.progressWorkflowAction(issue_key, action_key, []) rescue return
+		action
+	end
+
+	def method_missing(sym, *args, &block)
+		@jira.send sym, *args, &block
+	end
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: gojira
+version: !ruby/object:Gem::Version 
+  hash: 25
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- Sean Sorrell
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-23 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: wireframe-jira4r
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: gojira provides the ability to view tickets and move them through a Jira workflow
+email: seansorrell@gmail.com
+executables: 
+- gojira
+- gj
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/gj
+- bin/gojira
+- bin/gojira.rb
+- lib/gojira_api.rb
+- LICENSE
+- README.md
+has_rdoc: true
+homepage: http://github.com/rudle/gojira
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: a git-like command interface to Atlassian Jira
+test_files: []
+