jiraSOAP 0.5.3 → 0.6.0

data/ChangeLog

@@ -1,6 +1,28 @@
 Version 0.6
 
+	* Added RemoteAPI#get_projects_without_schemes
+	* Added RemoteAPI#delete_project_avatar_with_id
+	* Added RemoteAPI#delete_project_with_key
+	* Added RemoteAPI#set_project_avatar_for_project_with_key
+	* Added RemoteAPI#set_new_project_avatar_for_project_with_key
+	* Added RemoteAPI#get_resolution_date_for_issue_with_id
+	* Added RemoteAPI#get_resolution_date_for_issue_with_key
+	* Added RemoteAPI#get_project_roles and friends
+
+	* Changed parsing logic (1.5-2x faster)
 	* Changed Scheme#type to return a Class constant
+	* Changed #color in JIRA::Priority to be formatted as an array
+	triple
+	* Alias #colour to #color in JIRA::Priority
+	* Changed instances of #lead to #lead_username
+	* Changed instances of #create_date to #create_time
+	* Changed instances of #last_updated to #last_updated_time
+	* Changed instances of #filename to #file_name
+	* Changed instances of #original_author to #author
+	* Changed instances of #reporter_name to #reporter_username
+	* Changed instances of #assignee_name to #assignee_username
+	* Consolidated Handsoap parsing extensions into NokogiriDriver
+	* Various documentation updates
 
 Version 0.5
 

data/README.markdown

@@ -26,13 +26,17 @@ Pick up where `jira4r` left off:
 Getting Started
 ---------------
 
-`jiraSOAP` should run on Ruby 1.9.2 and MacRuby 0.8. You can install it using `gem`, or build from source:
+`jiraSOAP` should run on Ruby 1.9.2 and MacRuby 0.8 or newer. It is available through rubygems or you can build from source:
 
+        # Using rubygems
+        sudo gem install jiraSOAP
+
+        # Building from source
         git clone git://github.com/Marketcircle/jiraSOAP.git
         rake build
         rake install
 
-Once that ugliness is over with, you can run a quick demo (making appropriate substitutions):
+Once installed, you can run a quick demo (making appropriate substitutions):
 
      require 'jiraSOAP'
 

data/lib/jiraSOAP.rb

@@ -1,16 +1,20 @@
 require 'logger'
 require 'time'
 require 'uri'
+require 'nokogiri'
 
 require 'handsoap'
 Handsoap.http_driver = :net_http
 
 require 'jiraSOAP/url.rb'
 require 'jiraSOAP/handsoap_extensions.rb'
+
+# All the remote entities as well as the SOAP service client.
+module JIRA
+end
+
 require 'jiraSOAP/entities.rb'
 require 'jiraSOAP/api.rb'
-
 require 'jiraSOAP/JIRAservice.rb'
 
-#overrides and additions
 require 'jiraSOAP/macruby_bonuses.rb' if RUBY_ENGINE == 'macruby'

data/lib/jiraSOAP/JIRAservice.rb

@@ -1,21 +1,15 @@
-# All the remote entities as well as the SOAP service client.
-module JIRA
-
-# Interface to the JIRA endpoint server; set at initialization.
+# @todo consider adding a finalizer that will try to logout
+# @note HTTPS is not supported in this version.
+# Interface to the JIRA endpoint server.
 #
 # Due to limitations in Handsoap::Service, there can only be one endpoint.
 # You can have multiple instances of that one endpoint if you would
 # like; but if you try to set a differnt endpoint for a new instance you
 # will end up messing up any other instances currently being used.
 #
-# It is best to treat this class as a singleton. There should only be one.
-# However, this is not enforced, in case you want to be able to login as
-# multiple users to the same endpoint.
-#
-# HTTPS is not supported in this version.
-#
-# @todo consider adding a finalizer that will try to logout
-class JIRAService < Handsoap::Service
+# It is best to treat this class as a singleton, but it is not enforced
+# in case you want to be able to login as multiple users to the same endpoint.
+class JIRA::JIRAService < Handsoap::Service
   include RemoteAPI
 
   # @return [String]
@@ -24,47 +18,50 @@ class JIRAService < Handsoap::Service
   # @return [String]
   attr_reader :user
 
-  # @return [String]
+  # @return [URL]
   attr_reader :endpoint_url
 
-  # Factory method to initialize and login.
-  # @param [String] url URL for the JIRA server
+  # Initialize and log in.
+  # @param [String,URL] url URL for the JIRA server
   # @param [String] user JIRA user name to login with
   # @param [String] password
   # @return [JIRA::JIRAService]
-  def self.instance_with_endpoint(url, user, password)
-    jira = JIRAService.new url
+  def self.instance_with_endpoint url, user, password
+    jira = JIRA::JIRAService.new url
     jira.login user, password
     jira
   end
 
-  # Slightly hacky in order to set the endpoint at the initialization.
-  # @param endpoint_url URL for the JIRA server
-  def initialize(endpoint_url)
+  # @param [String,URL] endpoint_url for the JIRA server
+  def initialize endpoint_url
     @endpoint_url = endpoint_url
-    endpoint_data = {
-      :uri => "#{endpoint_url}/rpc/soap/jirasoapservice-v2",
-      :version => 2
-    }
-    self.class.endpoint endpoint_data
+    JIRA::JIRAService.endpoint({
+      uri:"#{endpoint_url.to_s}/rpc/soap/jirasoapservice-v2",
+      version:2
+    })
   end
 
-  # Something to help users out until the rest of the API is implemented.
+  # An extra note for users when things break.
+  # @deprecated This will be removed in v1.0 when the API is stable.
   # @return [nil]
-  def method_missing(method, *args)
+  def method_missing method, *args
     message  = "#{method} is not a valid method. Check the documentation; the "
-    message << 'method may not be implemented or has changed in recent '
-    message << 'revisions. The API has not been stabilized yet.'
+    message << 'API is not stabale yet and the method name likely changed.'
     STDERR.puts message
     super method, *args
   end
 
+
   protected
-  def on_create_document(doc)
+
+  # Makes sure the correct namespace is set
+  def on_create_document doc
     doc.alias 'soap', 'http://soap.rpc.jira.atlassian.com'
   end
-  def on_response_document(doc)
+
+  # Make sure that the required namespace is added
+  def on_response_document doc
     doc.add_namespace 'jir', @endpoint_url
   end
-end
+
 end

data/lib/jiraSOAP/api.rb

@@ -1,16 +1,15 @@
-# Contains the API defined by Atlassian for the JIRA SOAP service. The JavaDoc
-# for the SOAP API is located at http://docs.atlassian.com/software/jira/docs/api/rpc-jira-plugin/latest/com/atlassian/jira/rpc/soap/JiraSoapService.html.
-# @todo exception handling
+# Contains the API defined by Atlassian for the [JIRA SOAP service](http://docs.atlassian.com/software/jira/docs/api/rpc-jira-plugin/latest/com/atlassian/jira/rpc/soap/JiraSoapService.html).
+#
+# There are several cases where this API diverges from the one defined by
+# Atlassian; most notably, this API tries to be more idomatically Ruby by using
+# snake case for method names.
 # @todo logging
 # @todo code refactoring and de-duplication
-# @todo break the API down by task, like Apple's developer documentation
-# @todo deleteProjectAvatar [target v0.5]
-# @todo setProjectAvatar (change to different existing) [target v0.5]
-# @todo setNewProjectAvatar (upload new and set it) [target v0.5]
-# @todo createProjectRole [v0.6]
-# @todo getAvailableActions [target v0.7]
-# @todo progressWorkflowAction [target v0.7]
+# @todo break the API down by task, like Apple's developer documentation;
+#  I can break the tasks down by CRUD or by what they affect, or both
+# @todo progressWorkflowAction and friends [target v0.7]
 module RemoteAPI
+
   # XPath constant to get a node containing a response array.
   # This could be used for all responses, but is only used in cases where we
   # cannot use a more blunt XPath expression.
@@ -19,7 +18,7 @@ module RemoteAPI
   # The first method to call; other methods will fail until you are logged in.
   # @param [String] user JIRA user name to login with
   # @param [String] password
-  # @return [boolean] true if successful, otherwise an exception is thrown
+  # @return [true]
   def login(user, password)
     response = invoke('soap:login') { |msg|
       msg.add 'soap:in0', user
@@ -33,7 +32,7 @@ module RemoteAPI
 
   # You only need to call this to make an explicit logout; normally, a session
   # will automatically expire after a set time (configured on the server).
-  # @return [boolean] true if successful, otherwise false
+  # @return [true,false] true if successful, otherwise false
   def logout
     response = invoke('soap:logout') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -47,7 +46,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
     }
     response.document.xpath("#{RESPONSE_XPATH}/getPrioritiesReturn").map {
-      |frag| JIRA::Priority.new_with_xml_fragment frag
+      |frag| JIRA::Priority.new_with_xml frag
     }
   end
 
@@ -57,7 +56,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
     }
     response.document.xpath("#{RESPONSE_XPATH}/getResolutionsReturn").map {
-      |frag| JIRA::Resolution.new_with_xml_fragment frag
+      |frag| JIRA::Resolution.new_with_xml frag
     }
   end
 
@@ -67,7 +66,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
     }
     response.document.xpath("#{RESPONSE_XPATH}/getCustomFieldsReturn").map {
-      |frag| JIRA::Field.new_with_xml_fragment frag
+      |frag| JIRA::Field.new_with_xml frag
     }
   end
 
@@ -77,7 +76,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
     }
     response.document.xpath("#{RESPONSE_XPATH}/getIssueTypesReturn").map {
-      |frag| JIRA::IssueType.new_with_xml_fragment frag
+      |frag| JIRA::IssueType.new_with_xml frag
     }
   end
 
@@ -87,7 +86,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
     }
     response.document.xpath("#{RESPONSE_XPATH}/getStatusesReturn").map {
-      |frag| JIRA::Status.new_with_xml_fragment frag
+      |frag| JIRA::Status.new_with_xml frag
     }
   end
 
@@ -97,7 +96,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
     }
     response.document.xpath("#{RESPONSE_XPATH}/getNotificationSchemesReturn").map {
-      |frag| JIRA::NotificationScheme.new_with_xml_fragment frag
+      |frag| JIRA::NotificationScheme.new_with_xml frag
     }
   end
 
@@ -109,7 +108,7 @@ module RemoteAPI
       msg.add 'soap:in1', project_key
     }
     response.document.xpath("#{RESPONSE_XPATH}/getVersionsReturn").map {
-      |frag| JIRA::Version.new_with_xml_fragment frag
+      |frag| JIRA::Version.new_with_xml frag
     }
   end
 
@@ -123,7 +122,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', project_key
     }
-    JIRA::Project.new_with_xml_fragment response.document.xpath('//getProjectByKeyReturn').first
+    JIRA::Project.new_with_xml response.document.xpath('//getProjectByKeyReturn').first
   end
 
   # @param [String] user_name
@@ -133,7 +132,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', user_name
     }
-    JIRA::User.new_with_xml_fragment response.document.xpath('//getUserReturn').first
+    JIRA::User.new_with_xml response.document.xpath('//getUserReturn').first
   end
 
   # Gets you the default avatar image for a project; if you want all
@@ -145,13 +144,13 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', project_key
     }
-    JIRA::Avatar.new_with_xml_fragment response.document.xpath('//getProjectAvatarReturn').first
+    JIRA::Avatar.new_with_xml response.document.xpath('//getProjectAvatarReturn').first
   end
 
   # Gets ALL avatars for a given project with this method; if you
   # just want the project avatar, use {#get_project_avatar_for_key}.
   # @param [String] project_key
-  # @param [boolean] include_default_avatars
+  # @param [true,false] include_default_avatars
   # @return [[JIRA::Avatar]]
   def get_project_avatars_for_key(project_key, include_default_avatars = false)
     response = invoke('soap:getProjectAvatars') { |msg|
@@ -160,7 +159,7 @@ module RemoteAPI
       msg.add 'soap:in2', include_default_avatars
     }
     response.document.xpath("#{RESPONSE_XPATH}/getProjectAvatarsReturn").map {
-      |frag| JIRA::Avatar.new_with_xml_fragment frag
+      |frag| JIRA::Avatar.new_with_xml frag
     }
   end
 
@@ -183,7 +182,7 @@ module RemoteAPI
       msg.add 'soap:in2', max_results
     }
     response.document.xpath("#{RESPONSE_XPATH}/getIssuesFromJqlSearchReturn").map {
-      |frag| JIRA::Issue.new_with_xml_fragment frag
+      |frag| JIRA::Issue.new_with_xml frag
     }
   end
 
@@ -217,7 +216,7 @@ module RemoteAPI
         field_values.each { |fv| fv.soapify_for submsg }
       end
     }
-    JIRA::Issue.new_with_xml_fragment response.document.xpath('//updateIssueReturn').first
+    JIRA::Issue.new_with_xml response.document.xpath('//updateIssueReturn').first
   end
 
   # Some fields will be ignored when an issue is created.
@@ -237,7 +236,7 @@ module RemoteAPI
         issue.soapify_for submsg
       end
     }
-    JIRA::Issue.new_with_xml_fragment response.document.xpath('//createIssueReturn').first
+    JIRA::Issue.new_with_xml response.document.xpath('//createIssueReturn').first
   end
 
   # @param [String] issue_key
@@ -247,7 +246,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', issue_key
     }
-    JIRA::Issue.new_with_xml_fragment response.document.xpath('//getIssueReturn').first
+    JIRA::Issue.new_with_xml response.document.xpath('//getIssueReturn').first
   end
 
   # @param [String] issue_id
@@ -257,7 +256,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', issue_id
     }
-    JIRA::Issue.new_with_xml_fragment response.document.xpath('//getIssueByIdReturn').first
+    JIRA::Issue.new_with_xml response.document.xpath('//getIssueByIdReturn').first
   end
 
   # @param [String] issue_key
@@ -268,7 +267,7 @@ module RemoteAPI
       msg.add 'soap:in1', issue_key
     }
     response.document.xpath("#{RESPONSE_XPATH}/getAttachmentsFromIssueReturn").map {
-      |frag| JIRA::AttachmentMetadata.new_with_xml_fragment frag
+      |frag| JIRA::AttachmentMetadata.new_with_xml frag
     }
   end
 
@@ -290,17 +289,17 @@ module RemoteAPI
       msg.add 'soap:in1', project_key
       msg.add 'soap:in2' do |submsg| version.soapify_for submsg end
     }
-    JIRA::Version.new_with_xml_fragment response.document.xpath('//addVersionReturn').first
+    JIRA::Version.new_with_xml response.document.xpath('//addVersionReturn').first
   end
 
   # The archive state can only be set to true for versions that have not been
   # released. However, this is not reflected by the return value of this method.
   # @param [String] project_key
   # @param [String] version_name
-  # @param [boolean] state
-  # @return [boolean] true if successful, otherwise an exception is thrown
+  # @param [true,false] state
+  # @return [true]
   def set_archive_state_for_version_for_project(project_key, version_name, state)
-    response = invoke('soap:archiveVersion') { |msg|
+    invoke('soap:archiveVersion') { |msg|
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', project_key
       msg.add 'soap:in2', version_name
@@ -320,15 +319,15 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1' do |submsg| project.soapify_for submsg end
     }
-    JIRA::Project.new_with_xml_fragment response.document.xpath('//createProjectFromObjectReturn').first
+    JIRA::Project.new_with_xml response.document.xpath('//createProjectFromObjectReturn').first
   end
 
   # You can set the release state for a project with this method.
   # @param [String] project_name
   # @param [JIRA::Version] version
-  # @return [boolean] true, throws an exception otherwise
+  # @return [true]
   def release_state_for_version_for_project(project_name, version)
-    response = invoke('soap:releaseVersion') { |msg|
+    invoke('soap:releaseVersion') { |msg|
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', project_name
       msg.add 'soap:in2' do |submsg| version.soapify_for submsg end
@@ -345,7 +344,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1' do |submsg| project.soapify_for submsg end
     }
-    JIRA::Project.new_with_xml_fragment response.document.xpath('//updateProjectReturn').first
+    JIRA::Project.new_with_xml response.document.xpath('//updateProjectReturn').first
   end
 
   # It seems that creating a user without any permission groups will trigger
@@ -366,13 +365,13 @@ module RemoteAPI
       msg.add 'soap:in3', full_name
       msg.add 'soap:in4', email
     }
-    JIRA::User.new_with_xml_fragment response.document.xpath('//createUserReturn').first
+    JIRA::User.new_with_xml response.document.xpath('//createUserReturn').first
   end
 
   # @param [String] username
-  # @return [boolean] true if successful, throws an exception otherwise
+  # @return [true]
   def delete_user_with_name(username)
-    response = invoke('soap:deleteUser') { |msg|
+    invoke('soap:deleteUser') { |msg|
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', username
     }
@@ -386,7 +385,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', project_id
     }
-    JIRA::Project.new_with_xml_fragment response.document.xpath('//getProjectByIdReturn').first
+    JIRA::Project.new_with_xml response.document.xpath('//getProjectByIdReturn').first
   end
 
   # @todo parse the permission scheme
@@ -398,14 +397,14 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', project_id
     }
-    JIRA::Project.new_with_xml_fragment response.document.xpath('//getProjectWithSchemesByIdReturn').first
+    JIRA::Project.new_with_xml response.document.xpath('//getProjectWithSchemesByIdReturn').first
   end
 
   # @param [String] issue_key
   # @param [JIRA::Comment] comment
-  # @return [boolean] true if successful, throws an exception otherwise
+  # @return [true]
   def add_comment_to_issue_with_key(issue_key, comment)
-    response = invoke('soap:addComment') { |msg|
+    invoke('soap:addComment') { |msg|
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', issue_key
       msg.add 'soap:in2' do |submsg| comment.soapify_for submsg end
@@ -420,7 +419,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', id
     }
-    JIRA::Comment.new_with_xml_fragment response.document.xpath('//getCommentReturn').first
+    JIRA::Comment.new_with_xml response.document.xpath('//getCommentReturn').first
   end
 
   # @param [String] issue_key
@@ -431,7 +430,7 @@ module RemoteAPI
       msg.add 'soap:in1', issue_key
     }
     response.document.xpath("#{RESPONSE_XPATH}/getCommentsReturn").map {
-      |frag| JIRA::Comment.new_with_xml_fragment frag
+      |frag| JIRA::Comment.new_with_xml frag
     }
   end
 
@@ -443,7 +442,7 @@ module RemoteAPI
       msg.add 'soap:in1', project_id
     }
     response.document.xpath("#{RESPONSE_XPATH}/getIssueTypesForProjectReturn").map {
-      |frag| JIRA::IssueType.new_with_xml_fragment frag
+      |frag| JIRA::IssueType.new_with_xml frag
     }
   end
 
@@ -455,7 +454,7 @@ module RemoteAPI
       msg.add 'soap:in1' do |submsg| comment.soapify_for submsg end
     }
     frag = response.document.xpath('//editCommentReturn').first
-    JIRA::Comment.new_with_xml_fragment frag
+    JIRA::Comment.new_with_xml frag
   end
 
   # @return [[JIRA::IssueType]]
@@ -464,7 +463,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
     }
     response.document.xpath("#{RESPONSE_XPATH}/getSubTaskIssueTypesReturn").map {
-      |frag| JIRA::IssueType.new_with_xml_fragment frag
+      |frag| JIRA::IssueType.new_with_xml frag
     }
   end
 
@@ -476,15 +475,15 @@ module RemoteAPI
       msg.add 'soap:in1', project_id
     }
     response.document.xpath("#{RESPONSE_XPATH}/getSubtaskIssueTypesForProjectReturn").map {
-      |frag| JIRA::IssueType.new_with_xml_fragment frag
+      |frag| JIRA::IssueType.new_with_xml frag
     }
   end
 
   # I have no idea what this method does.
   # @todo find out what this method does
-  # @return [boolean] true if successful, throws an exception otherwise
+  # @return [true]
   def refresh_custom_fields
-    response = invoke('soap:refreshCustomFields') { |msg|
+    invoke('soap:refreshCustomFields') { |msg|
       msg.add 'soap:in0', @auth_token
     }
     true
@@ -497,7 +496,7 @@ module RemoteAPI
       msg.add 'soap:in0', @auth_token
     }
     response.document.xpath("#{RESPONSE_XPATH}/getFavouriteFiltersReturn").map {
-      |frag| JIRA::Filter.new_with_xml_fragment frag
+      |frag| JIRA::Filter.new_with_xml frag
     }
   end
 
@@ -513,7 +512,7 @@ module RemoteAPI
       msg.add 'soap:in3', max_results
     }
     response.document.xpath("#{RESPONSE_XPATH}/getIssuesFromFilterWithLimitReturn").map {
-      |frag| JIRA::Issue.new_with_xml_fragment frag
+      |frag| JIRA::Issue.new_with_xml frag
     }
   end
 
@@ -532,9 +531,9 @@ module RemoteAPI
   # @param [String] issue_key
   # @param [[String]] filenames names to put on the files
   # @param [[String]] data base64 encoded data
-  # @return [boolean] true if successful, otherwise an exception is thrown
+  # @return [true]
   def add_base64_encoded_attachments_to_issue_with_key(issue_key, filenames, data)
-    response = invoke('soap:addBase64EncodedAttachmentsToIssue') { |msg|
+    invoke('soap:addBase64EncodedAttachmentsToIssue') { |msg|
       msg.add 'soap:in0', @auth_token
       msg.add 'soap:in1', issue_key
       msg.add 'soap:in2' do |submsg|
@@ -553,7 +552,7 @@ module RemoteAPI
     response = invoke('soap:getServerInfo') { |msg|
       msg.add 'soap:in0', @auth_token
     }
-    JIRA::ServerInfo.new_with_xml_fragment response.document.xpath('//getServerInfoReturn').first
+    JIRA::ServerInfo.new_with_xml response.document.xpath('//getServerInfoReturn').first
   end
 
   # @return [JIRA::ServerConfiguration]
@@ -561,6 +560,168 @@ module RemoteAPI
     response = invoke('soap:getConfiguration') { |msg|
       msg.add 'soap:in0', @auth_token
     }
-    JIRA::ServerConfiguration.new_with_xml_fragment response.document.xpath('//getConfigurationReturn').first
+    JIRA::ServerConfiguration.new_with_xml response.document.xpath('//getConfigurationReturn').first
+  end
+
+  # @note This will not fill in JIRA::Scheme data for the projects.
+  # @return [[JIRA::Project]]
+  def get_projects_without_schemes
+    response = invoke('soap:getProjectsNoSchemes') { |msg|
+      msg.add 'soap:in0', @auth_token
+    }
+    response.document.xpath("#{RESPONSE_XPATH}/getProjectsNoSchemesReturn").map {
+      |frag| JIRA::Project.new_with_xml frag
+    }
+  end
+
+  # @param [#to_s] issue_id
+  # @return [Time]
+  def get_resolution_date_for_issue_with_id issue_id
+    response = invoke('soap:getResolutionDateById') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', issue_id
+    }
+    response.document.xpath('//getResolutionDateByIdReturn').to_date
+  end
+
+  # @param [String] issue_key
+  # @return [Time]
+  def get_resolution_date_for_issue_with_key issue_key
+    response = invoke('soap:getResolutionDateByKey') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', issue_key
+    }
+    response.document.xpath('//getResolutionDateByKeyReturn').to_date
+  end
+
+  # @param [String] project_key
+  # @return [true]
+  def delete_project_with_key project_key
+    invoke('soap:deleteProject') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', project_key
+    }
+    true
+  end
+
+  # @todo add tests for this method
+  # @note You cannot delete the system avatar
+  # @note You need project administration permissions to delete an avatar
+  # @param [#to_s] avatar_id
+  # @return [true]
+  def delete_project_avatar_with_id avatar_id
+    invoke('soap:deleteProjectAvatar') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', avatar_id
+    }
+    true
+  end
+
+  # @note You need project administration permissions to edit an avatar
+  # @note JIRA does not care if the avatar_id is valid
+  # Change the project avatar to another existing avatar. If you want to
+  # upload a new avatar and set it to be the new project avatar use
+  # {#set_new_project_avatar} instead.
+  # @return [true]
+  def set_project_avatar_for_project_with_key project_key, avatar_id
+    invoke('soap:setProjectAvatar') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', project_key
+      msg.add 'soap:in2', avatar_id
+    }
+    true
+  end
+
+  # @note You need project administration permissions to edit an avatar
+  # Use this method to create a new custom avatar for a project and set it
+  # to be current avatar for the project.
+  #
+  # The image, provided as base64 encoded data, should be a 48x48 pixel square.
+  # If the image is larger, the top left 48 pixels are taken, if it is smaller
+  # then it will be upscaled to 48 pixels.
+  # The small version of the avatar image (16 pixels) is generated
+  # automatically.
+  # If you want to switch a project avatar to an avatar that already exists on
+  # the system then use {#set_project_avatar_for_project_with_key} instead.
+  # @param [String] project_key
+  # @param [String] mime_type
+  # @param [#to_s] base64_image
+  # @return [true]
+  def set_new_project_avatar_for_project_with_key project_key, mime_type, base64_image
+    invoke('soap:setNewProjectAvatar') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', project_key
+      msg.add 'soap:in2', mime_type
+      msg.add 'soap:in3', base64_image
+    }
+    true
+  end
+
+  # @return [[JIRA::ProjectRole]]
+  def get_project_roles
+    response = invoke('soap:getProjectRoles') { |msg|
+      msg.add 'soap:in0', @auth_token
+    }
+    response.document.xpath("#{RESPONSE_XPATH}/getProjectRolesReturn").map {
+      |frag| JIRA::ProjectRole.new_with_xml frag
+    }
   end
+
+  # @param [#to_s] role_id
+  # @return [JIRA::ProjectRole]
+  def get_project_role_with_id role_id
+    response = invoke('soap:getProjectRole') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', role_id
+    }
+    JIRA::ProjectRole.new_with_xml response.document.xpath('//getProjectRoleReturn').first
+  end
+
+  # @param [JIRA::ProjectRole] project_role
+  # @return [JIRA::ProjectRole] the role that was created
+  def create_project_role_with_role project_role
+    response = invoke('soap:createProjectRole') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1' do |submsg| project_role.soapify_for submsg end
+    }
+    JIRA::ProjectRole.new_with_xml response.document.xpath('//createProjectRoleReturn').first
+  end
+
+  # @note JIRA 4.0 returns an exception if the name already exists
+  # Returns true if the name does not exist.
+  # @param [String] project_role_name
+  # @return [true,false]
+  def project_role_name_unique? project_role_name
+    response = invoke('soap:isProjectRoleNameUnique') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', project_role_name
+    }
+    response.document.xpath('//isProjectRoleNameUniqueReturn').to_boolean
+  end
+
+  # @note the confirm argument appears to do nothing (at least on JIRA 4.0)
+  # @param [JIRA::ProjectRole] project_role
+  # @param [true,false] confirm
+  # @return [true]
+  def delete_project_role project_role, confirm = true
+    invoke('soap:deleteProjectRole') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1' do |submsg| project_role.soapify_for submsg end
+      msg.add 'soap:in2', confirm
+    }
+    true
+  end
+
+  # @note JIRA 4.0 will not update project roles, it will instead throw
+  #  an exception telling you that the project role already exists
+  # @param [JIRA::ProjectRole] project_role
+  # @return [JIRA::ProjectRole] the role after the update
+  def update_project_role_with_role project_role
+    response = invoke('soap:updateProjectRole') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1' do |submsg| project_role.soapify_for submsg end
+    }
+    JIRA::ProjectRole.new_with_xml response.document.xpath('//updateProjectRoleReturn').first
+  end
+
 end