jiraSOAP 0.1.2 → 0.2.0

data/README.markdown

@@ -46,11 +46,7 @@ Once that ugliness is over with, you can run a quick demo (making appropriate su
 
 Get the [Gist](http://gist.github.com/612186).
 
-
-Notes About Using This Gem
---------------------------
-
-1. URESOLVED issues have a Resolution with a value of `nil`.
+Read the documentation [here](http://rdoc.info/github/Marketcircle/jiraSOAP/master/frames). The meat of the service is in the `RemoteAPI` module.
 
 
 TODO
@@ -58,6 +54,7 @@ TODO
 
 - Performance optimizations; there are a number of places that can be optimized
   + Using GCD/Threads for parsing arrays of results; a significant speed up for large types and large arrays (ie. creating issues from JQL searches)
+- Refactor for a smaller code base
 - Fix type hacks;. dates should be `NSDate`s and URLs should be `NSURL`s, right now they are all strings
 - Public test suite
   + Needs a mock server

data/lib/jiraSOAP/JIRAservice.rb

@@ -9,25 +9,29 @@ module JIRA
 # 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
   include RemoteAPI
 
   attr_reader :auth_token, :user
 
   # Factory method to initialize and login.
-  #@param [String] url URL for the JIRA server
-  #@param [String] user JIRA user name to login with
-  #@param [String] password
-  def self.instance_at_url(url, user, password)
+  # @param [String] url URL for the JIRA server
+  # @param [String] user JIRA user name to login with
+  # @param [String] password
+  def self.instance_with_endpoint(url, user, password)
     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
+  # @param endpoint_url URL for the JIRA server
   def initialize(endpoint_url)
     super
 
@@ -39,11 +43,11 @@ class JIRAService < Handsoap::Service
     self.class.endpoint endpoint_data
   end
 
-  #PONDER: a finalizer that will try to logout
-
   # Something to help users out until the rest of the API is implemented.
   def method_missing(method, *args)
-    message  = 'Check the documentation; the method may not be implemented yet.'
+    message  = 'Check the documentation; the method may not be implemented or '
+    message << 'has changed in recent revisions. The client side API has not '
+    message << 'been stabilized yet.'
     raise NoMethodError, message, caller
   end
 

data/lib/jiraSOAP/handsoap_extensions.rb

@@ -1,24 +1,24 @@
-#Some simple extensions to Handsoap.
+# Some simple extensions to Handsoap.
 module Handsoap
-#Some simple extensions to XmlMason. Currently, this only includes methods to
-#make it easier to build SOAP messages that contain arrays.
+# Some simple extensions to XmlMason. Currently, this only includes methods to
+# make it easier to build SOAP messages that contain arrays.
 module XmlMason
-  #Represents a node in an XML document
+  # Represents a node in an XML document used for SOAP message creation.
   class Node
-    #@todo Make this method recursive
-    #@param [String] node_name
-    #@param [Array] array
-    #@param [Hash] options
+    # @todo Make this method recursive
+    # @param [String] node_name
+    # @param [Array] array
+    # @param [Hash] options
     def add_simple_array(node_name, array = [], options = {})
       prefix, name = parse_ns(node_name)
       node = append_child Element.new(self, prefix, name, nil, options)
       array.each { |element| node.add node_name, element }
     end
 
-    #@todo Make this method recursive
-    #@param [String] node_name
-    #@param [Array] array
-    #@param [Hash] options
+    # @todo Make this method recursive
+    # @param [String] node_name
+    # @param [Array] array
+    # @param [Hash] options
     def add_complex_array(node_name, array = [], options = {})
       prefix, name = parse_ns(node_name)
       node = append_child Element.new(self, prefix, name, nil, options)

data/lib/jiraSOAP/macruby_stuff.rb

@@ -1,4 +1,15 @@
-Handsoap.http_driver = :net_http  #curb does not build for MacRuby
+framework 'Foundation'
+
+# work around curb not building for MacRuby (ticket #941)
+Handsoap.http_driver = :net_http
+
+class URL
+  def initialize(url_string)
+    @url = NSURL.URLWithString url_string
+  end
+
+  alias_method absoluteString to_s
+end
 
 module JIRA
   #overrides for MacRuby

data/lib/jiraSOAP/remoteAPI.rb

@@ -3,29 +3,29 @@
 #@todo exception handling
 #@todo code refactoring and de-duplication
 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.
+  # 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.
   RESPONSE_XPATH = '/node()[1]/node()[1]/node()[1]/node()[2]'
 
-  #The first method to call. No other method will work unless you are logged in.
-  #@param [String] user JIRA user name to login with
-  #@param [String] password
-  #@return [boolean] true if successful, otherwise false
+  # 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 [true] true if successful, otherwise an exception is thrown
   def login(user, password)
     response = invoke('soap:login') { |msg|
       msg.add 'soap:in0', user
       msg.add 'soap:in1', password
     }
-    #cache now that we know it is safe to do so
+    # cache now that we know it is safe to do so
     @user       = user
     @auth_token = response.document.xpath('//loginReturn').first.to_s
     true
   end
 
-  #You only need to call this to make an exlicit logout; normally, a session
-  #willautomatically expire after a set time (configured on the server).
-  #@return [boolean] true if successful, otherwise false
+  # 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 [true] true if successful, otherwise false
   def logout
     response = invoke('soap:logout') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -33,8 +33,7 @@ module RemoteAPI
     response.document.xpath('//logoutReturn').first.to_s == 'true'
   end
 
-  #Get the global listing for types of priorities.
-  #@return [[JIRA::Priority]]
+  # @return [[JIRA::Priority]]
   def get_priorities
     response = invoke('soap:getPriorities') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -45,8 +44,7 @@ module RemoteAPI
     }
   end
 
-  #Get the global listing for types of resolutions.
-  #@return [[JIRA::Resolution]]
+  # @return [[JIRA::Resolution]]
   def get_resolutions
     response = invoke('soap:getResolutions') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -57,8 +55,7 @@ module RemoteAPI
     }
   end
 
-  #Get the global listing for types of custom fields.
-  #@return [[JIRA::Field]]
+  # @return [[JIRA::Field]]
   def get_custom_fields
     response = invoke('soap:getCustomFields') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -69,8 +66,7 @@ module RemoteAPI
     }
   end
 
-  #Get the global listing for types of issues.
-  #@return [[JIRA::IssueType]]
+  # @return [[JIRA::IssueType]]
   def get_issue_types
     response = invoke('soap:getIssueTypes') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -81,8 +77,7 @@ module RemoteAPI
     }
   end
 
-  #Get the global listing of status type.
-  #@return [[JIRA::Status]]
+  # @return [[JIRA::Status]]
   def get_statuses
     response = invoke('soap:getStatuses') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -93,8 +88,7 @@ module RemoteAPI
     }
   end
 
-  #Get the global listing for notification schemes.
-  #@return [[JIRA::Scheme]]
+  # @return [[JIRA::Scheme]]
   def get_notification_schemes
     response = invoke('soap:getNotificationSchemes') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -105,9 +99,8 @@ module RemoteAPI
     }
   end
 
-  #Get all the versions associated with a project.
-  #@param [String] project_key
-  #@return [[JIRA::Version]]
+  # @param [String] project_key
+  # @return [[JIRA::Version]]
   def get_versions_for_project(project_key)
     response = invoke('soap:getVersions') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -119,9 +112,8 @@ module RemoteAPI
     }
   end
 
-  #Get the information for a project with a given key.
-  #@param [String] project_key
-  #@return [JIRA::Project]
+  # @param [String] project_key
+  # @return [JIRA::Project]
   def get_project_with_key(project_key)
     response = invoke('soap:getProjectByKey') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -131,9 +123,8 @@ module RemoteAPI
     JIRA::Project.project_with_xml_fragment frag
   end
 
-  #This will only give you basic information about a user.
-  #@param [String] user_name
-  #@return [JIRA::User]
+  # @param [String] user_name
+  # @return [JIRA::User]
   def get_user_with_name(user_name)
     response = invoke('soap:getUser') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -142,10 +133,10 @@ module RemoteAPI
     JIRA::User.user_with_xml_fragment response.document.xpath '//getUserReturn'
   end
 
-  #Gives you the default avatar image for a project; if you want all
-  #the avatars for a project, use {#get_project_avatars_for_key}.
-  #@param [String] project_key
-  #@return [JIRA::Avatar]
+  # Gets you the default avatar image for a project; if you want all
+  # the avatars for a project, use {#get_project_avatars_for_key}.
+  # @param [String] project_key
+  # @return [JIRA::Avatar]
   def get_project_avatar_for_key(project_key)
     response = invoke('soap:getProjectAvatar') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -154,10 +145,10 @@ module RemoteAPI
     JIRA::Avatar.avatar_with_xml_fragment response.document.xpath '//getProjectAvatarReturn'
   end
 
-  #Gives ALL avatars for a given project use this method; if you
-  #just want the default avatar, use {#get_project_avatar_for_key}.
-  #@param [String] project_key
-  #@return [[JIRA::Avatar]]
+  # Gets ALL avatars for a given project use this method; if you
+  # just want the default avatar, use {#get_project_avatar_for_key}.
+  # @param [String] project_key
+  # @return [[JIRA::Avatar]]
   def get_project_avatars_for_key(project_key)
     response = invoke('soap:getProjectAvatars') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -169,12 +160,12 @@ module RemoteAPI
     }
   end
 
-  #This method is the equivalent of making an advanced search from the
-  #web interface.
-  #@param [String] jql_query JQL query as a string
-  #@param [Fixnum] max_results limit on number of returned results;
+  # This method is the equivalent of making an advanced search from the
+  # web interface.
+  # @param [String] jql_query JQL query as a string
+  # @param [Fixnum] max_results limit on number of returned results;
   #  the value may be overridden by the server if max_results is too large
-  #@return [[JIRA::Issue]]
+  # @return [[JIRA::Issue]]
   def get_issues_from_jql_search(jql_query, max_results = 500)
     response = invoke('soap:getIssuesFromJqlSearch') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -187,29 +178,29 @@ module RemoteAPI
     }
   end
 
-  #This method can update most, but not all, issue fields.
+  # This method can update most, but not all, issue fields.
   #
-  #Fields known to not update via this method:
+  # Fields known to not update via this method:
   #  - status - use {#progress_workflow_action}
   #  - attachments - use {#add_base64_encoded_attachment_to_issue}
   #
-  #Though JIRA::FieldValue objects have an id field, they do not expect
-  #to be given id values. You must use the name of the field you wish to update.
-  #@example Usage With A Normal Field
+  # Though JIRA::FieldValue objects have an id field, they do not expect to be
+  # given id values. You must use the name of the field you wish to update.
+  # @example Usage With A Normal Field
   #  summary        = JIRA::FieldValue.new
   #  summary.id     = 'summary'
   #  summary.values = ['My new summary']
-  #@example Usage With A Custom Field
+  # @example Usage With A Custom Field
   #  custom_field        = JIRA::FieldValue.new
   #  custom_field.id     = 'customfield_10060'
   #  custom_field.values = ['123456']
-  #@example Setting a field to be blank/nil
+  # @example Setting a field to be blank/nil
   #  description = JIRA::FieldValue.field_value_with_nil_values 'description'
-  #@example Calling the method to update an issue
+  # @example Calling the method to update an issue
   #  jira_service_instance.update_issue 'PROJECT-1', description, custom_field
-  #@param [String] issue_key
-  #@param [JIRA::FieldValue] *field_values
-  #@return [JIRA::Issue]
+  # @param [String] issue_key
+  # @param [JIRA::FieldValue] *field_values
+  # @return [JIRA::Issue]
   def update_issue(issue_key, *field_values)
     response = invoke('soap:updateIssue') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -222,16 +213,16 @@ module RemoteAPI
     JIRA::Issue.issue_with_xml_fragment frag
   end
 
-  #Some fields will be ignored when an issue is created:
+  # Some fields will be ignored when an issue is created.
   #  - reporter - you cannot override this value at creation
-  #  - due date - I think this is a bug in jiraSOAP or JIRA
+  #  - resolution
   #  - attachments
   #  - votes
   #  - status
-  #  - resolution
+  #  - due date - I think this is a bug in jiraSOAP or JIRA
   #  - environment - I think this is a bug in jiraSOAP or JIRA
-  #@param [JIRA::Issue] issue
-  #@return [JIRA::Issue]
+  # @param [JIRA::Issue] issue
+  # @return [JIRA::Issue]
   def create_issue_with_issue(issue)
     response = invoke('soap:createIssue') { |msg|
       msg.add 'soap:in0', @auth_token
@@ -242,39 +233,349 @@ module RemoteAPI
     frag = response.document.xpath '//createIssueReturn'
     JIRA::Issue.issue_with_xml_fragment frag
   end
+
+  # @todo test this method
+  # @param [String] issue_key
+  # @return [JIRA::Issue]
+  def get_issue_with_key(issue_key)
+    response = invoke('soap:getIssue') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', issue_key
+    }
+    frag = response.document.xpath '//getIssueReturn'
+    JIRA:Issue.issue_with_xml_fragment frag
+  end
+
+  # @todo test this method
+  # @param [String] issue_id
+  # @return [JIRA::Issue]
+  def get_issue_with_id(issue_id)
+    response = invoke('soap:getIssueById') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', issue_id
+    }
+    frag = response.document.xpath '//getIssueByIdReturn'
+    JIRA::Issue.issue_with_xml_fragment frag
+  end
+
+  # @todo test this method
+  # @param [String] issue_key
+  # @return [[JIRA::Attachment]]
+  def get_attachments_for_issue_with_key(issue_key)
+    response = invoke('soap:getAttachmentsFromIssue') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', issue_key
+    }
+    response.document.xpath("#{RESPONSE_XPATH}/getAttachmentsFromIssueReturn").map {
+      |frag|
+      JIRA::AttachmentMetadata.attachment_with_xml_fragment frag
+    }
+  end
+
+  # @todo test this method
+  # @param [String] project_key
+  # @param [JIRA::Version] version
+  # @return [JIRA::Version]
+  def add_version_to_project(project_key, version)
+    response = invoke('soap:addVersion') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', project_key
+      msg.add 'soap:in2' do |submsg| version.soapify_for submsg end
+    }
+    frag = response.document.xpath '//addVersionReturn'
+    JIRA::Version.version_with_xml_fragment frag
+  end
+
+  # @todo test this method
+  # @param [String] project_key
+  # @param [String] version_name
+  # @param [boolean] state
+  # @return [boolean] true if successful, otherwise an exception is thrown
+  def set_archive_state_for_version_for_project(project_key, version_name, state)
+    response = invoke('soap:archiveVersion') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', project_key
+      msg.add 'soap:in2', version_name
+      msg.add 'soap:in3', state
+    }
+    true
+  end
+
+  # @todo test this method
+  # @param [JIRA::Project] project
+  # @return [JIRA::Project]
+  def create_project_with_project(project)
+    response = invoke('soap:createProjectFromObject') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1' do |submsg| project.soapify_for submsg end
+    }
+    frag = response.document.xpath '//createProjectFromObjectReturn'
+    JIRA::Project.project_with_xml_fragment frag
+  end
+
+  # @todo test this method
+  # @param [JIRA::Project] project
+  # @return [JIRA::Project]
+  def update_project_with_project(project)
+    response = invoke('soap:updateProject') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1' do |submsg| project.soapify_for submsg end
+    }
+    frag = response.document.xpath '//updateProjectReturn'
+    JIRA::Project.project_with_xml_fragment frag
+  end
+
+  # @todo test this method
+  # @param [String] username
+  # @param [String] password
+  # @param [String] full_name
+  # @param [String] email
+  # @return [JIRA::User]
+  def create_user(username, password, full_name, email)
+    response = invoke('soap:createUser') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', username
+      msg.add 'soap:in2', password
+      msg.add 'soap:in3', full_name
+      msg.add 'soap:in4', email
+    }
+    frag = response.document.xpath '//createUserReturn'
+    JIRA::User.user_with_xml_fragment frag
+  end
+
+  # @todo test this method
+  # @param [String] username
+  # @return [boolean] true if successful, throws an exception otherwise
+  def delete_user_with_name(username)
+    response = invoke('soap:deleteUser') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', username
+    }
+    true
+  end
+
+  # @todo test this method
+  # @param [String] id
+  # @return [JIRA::Project]
+  def get_project_with_id(id)
+    response = invoke('soap:getProjectById') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', id
+    }
+    frag = response.document.xpath '//getProjectByIdReturn'
+    JIRA::Project.project_with_xml_fragment frag
+  end
+
+  # @todo test this method
+  # @param [String] issue_key
+  # @param [JIRA::Comment] comment
+  # @return [boolean] true if successful, throws an exception otherwise
+  def add_comment_to_issue(issue_key, comment)
+    response = 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
+    }
+    true
+  end
+
+  # @todo test this method
+  # @param [String] id
+  # @return [JIRA::Comment]
+  def get_comment_with_id(id)
+    response = invoke('soap:getComment') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', id
+    }
+    frag = response.document.xpath '//getCommentReturn'
+    JIRA::Comment.comment_with_xml_fragment frag
+  end
+
+  # @todo test this method
+  # @param [String] issue_key
+  # @return [[JIRA::Comment]]
+  def get_comments_for_issue(issue_key)
+    response = invoke('soap:getComments') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', issue_key
+    }
+    response.document.xpath("#{RESPONSE_XPATH}/getCommentsReturn").map {
+      |frag|
+      JIRA::Comment.comment_with_xml_fragment frag
+    }
+  end
+
+  # @todo test this method
+  # @param [String] project_name
+  # @return [[JIRA::IssueType]]
+  def get_issue_types_for_project_with_id(project_id)
+    response = invoke('soap:getIssueTypesForProject') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', project_id
+    }
+    response.document.xpath("#{RESPONSE_XPATH}/getIssueTypesForProjectReturn").map {
+      |frag|
+      JIRA::IssueType.issue_type_with_xml_fragment frag
+    }
+  end
+
+  # @todo test this method
+  # @param [String] query
+  # @param [Fixnum] max_results
+  # @param [Fixnum] offset
+  # @return [[JIRA::Issue]]
+  def get_issues_from_text_search(query, max_results = 500, offset = 0)
+    response = invoke('soap:getIssuesFromTextSearch') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', query
+      msg.add 'soap:in2', offset
+      msg.add 'soap:in3', max_results
+    }
+    response.document.xpath("#{RESPONSE_XPATH}/getIssuesFromTextSearchWithLimitReturn").map {
+     |frag|
+      JIRA::Issue.issue_with_xml_fragment frag
+    }
+  end
+
+  # @todo test this method
+  # @param [JIRA::Comment] comment
+  # @return [JIRA::Comment]
+  def update_comment(comment)
+    response = invoke('soap:editComment') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1' do |submsg| comment.soapify_for submsg end
+    }
+    frag = response.document.xpath '//editCommentReturn'
+    JIRA::Comment.comment_with_xml_fragment frag
+  end
+
+  # @todo test this method
+  # @return [[JIRA::IssueType]]
+  def get_subtask_issue_types
+    response = invoke('soap:getSubTaskIssueTypes') { |msg|
+      msg.add 'soap:in0', @auth_token
+    }
+    response.document.xpath("#{RESPONSE_XPATH}/getSubtaskIssueTypesReturn").map {
+      |frag|
+      JIRA::IssueType.issue_type_with_xml_fragment frag
+    }
+  end
+
+  # @todo test this method
+  # @param [String] project_id
+  # @return [[JIRA::IssueType]]
+  def get_subtask_issue_types_for_project_with_id(project_id)
+    response = invoke('soap:getSubTaskIssueTypesForProject') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', project_id
+    }
+    response.document.xpath("#{RESPONSE_XPATH}/getSubtaskIssueTypesForProjectReturn").map {
+      |frag|
+      JIRA::IssueType.issue_type_with_xml_fragment frag
+    }
+  end
+
+  # @todo test this method
+  # @todo find out what this method does
+  # @return [boolean] true if successful, throws an exception otherwise
+  def refresh_custom_fields
+    response = invoke('soap:refreshCustomFields') { |msg|
+      msg.add 'soap:in0', @auth_token
+    }
+    true
+  end
+
+  # @todo test this method
+  # Retrieves favourite filters for the currently logged in user.
+  # @return [JIRA::Filter]
+  def get_favourite_filters
+    response = invoke('soap:getFavouriteFilters') { |msg|
+      msg.add 'soap:in0', @auth_token
+    }
+    response.document.xpath("#{RESPONSE_XPATH}/getFavouriteFiltersReturn").map {
+      |frag|
+      JIRA::Filter.filter_with_xml_fragment frag
+    }
+  end
+
+  # @todo test this method
+  # @param [String] id
+  # @param [Fixnum] max_results
+  # @param [Fixnum] offset
+  # @return [[JIRA::Issue]]
+  def get_issues_from_filter_with_id(id, max_results = 500, offset = 0)
+    response = invoke('soap:getIssuesFromFilterWithLimit') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', id
+      msg.add 'soap:in2', offset
+      msg.add 'soap:in3', max_results
+    }
+    response.document.xpath("#{RESPONSE_XPATH}/getIssuesFromFilterWithLimitReturn").map {
+      |frag|
+      JIRA::Issue.issue_with_xml_fragment frag
+    }
+  end
+
+  # @todo test this method
+  # @param [String] project_name
+  # @param [JIRA::Version] version
+  # @return [boolean] true, throws an exception otherwise
+  def release_version_for_project(project_name, version)
+    response = invoke('soap:releaseVersion') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', project_name
+      msg.add 'soap:in2', version.id
+    }
+    true
+  end
+
+  # @todo test this method
+  # @param [String] id
+  # @return [Fixnum]
+  def get_issue_count_for_filter_with_id(id)
+    response = invoke('soap:getIssueCountForFilter') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', id
+    }
+    response.document.xpath('//getIssueCountForFilterReturn').to_s.to_i
+  end
+
+  # @todo test this method
+  # @todo optimize building the message, try a single pass
+  # Expect this method to be slow.
+  # @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
+  def add_base64_encoded_attachments_to_issue(issue_key, filenames, data)
+    response = invoke('soap:addBase64EncodedAttachmentsToIssue') { |msg|
+      msg.add 'soap:in0', @auth_token
+      msg.add 'soap:in1', issue_key
+      msg.add 'soap:in2' do |submsg|
+        filenames.each { |filename| submsg.add 'filenames', filename }
+      end
+      msg.add 'soap:in3' do |submsg|
+        data.each { |datum| submsg.add 'base64EncodedData', datum }
+      end
+    }
+    true
+  end
+
+  # @todo test this method
+  # @return [JIRA::ServerInfo]
+  def get_server_info
+    response = invoke('soap:getServerInfo') { |msg|
+      msg.add 'soap:in0', @auth_token
+    }
+    frag = response.document.xpath '//getServerInfoReturn'
+    JIRA::ServerInfo.server_info_with_xml_fragment frag
+  end
 end
 
-#TODO: next block of useful methods
-# addBase64EncodedAttachmentsToIssue
-# addComment
-# addVersion
-# archiveVersion
-# createProject
+#TODO: v0.3
 # createProjectRole
-# createUser
 # deleteProjectAvatar
-# deleteUser
-# editComment
-# getAttachmentsFromIssue
 # getAvailableActions
-# getComment
-# getComments
-# getComponents
-# getFavouriteFilters
-# getIssue
-# getIssueById
-# getIssueCountForFilter
-# getIssuesFromFilterWithLimit
-# getIssuesFromTextSearchWithLimit
-# getIssueTypesForProject
-# getProjectById
-# getServerInfo
-# getSubTaskIssueTypes
-# getSubTaskIssueTypesForProject
 # progressWorkflowAction
-# refreshCustomFields
-# releaseVersion
 # setProjectAvatar (change to different existing)
 # setNewProjectAvatar (upload new and set it)
-# updateProject
-# progressWorkflowAction

data/lib/jiraSOAP/remoteEntities.rb

@@ -1,34 +1,50 @@
 module JIRA
 
+# Represents a priority level. Straightforward.
 class Priority
   attr_accessor :id, :name, :color, :icon, :description
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @todo change @color to be some kind of hex Fixnum object
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Priority,nil]
   def self.priority_with_xml_fragment(frag)
     return if frag.nil?
     priority             = Priority.new
     priority.id          = frag.xpath('id').to_s
     priority.name        = frag.xpath('name').to_s
-    priority.color       = frag.xpath('color').to_s #PONDER: hex
-    priority.icon        = frag.xpath('icon').to_s #FIXME: NSURL
+    priority.color       = frag.xpath('color').to_s
+    priority.icon        = URL.new frag.xpath('icon').to_s
     priority.description = frag.xpath('description').to_s
     priority
   end
 end
 
+# Represents a resolution. Straightforward.
 class Resolution
   attr_accessor :id, :name, :icon, :description
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Resolution,nil]
   def self.resolution_with_xml_fragment(frag)
     return if frag.nil?
     resolution             = Resolution.new
     resolution.id          = frag.xpath('id').to_s
     resolution.name        = frag.xpath('name').to_s
-    resolution.icon        = frag.xpath('icon').to_s #FIXME: NSURL
+    resolution.icon        = URL.new frag.xpath('icon').to_s
     resolution.description = frag.xpath('description').to_s
     resolution
   end
 end
 
+# Represents a field mapping.
 class Field
   attr_accessor :id, :name
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Field,nil]
   def self.field_with_xml_fragment(frag)
     return if frag.nil?
     field      = Field.new
@@ -38,8 +54,14 @@ class Field
   end
 end
 
+# Represents a custom field with values.
+# @todo see if @key is always nil from the server
 class CustomField
   attr_accessor :id, :key, :values
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::CustomField,nil]
   def self.custom_field_with_xml_fragment(frag)
     return if frag.nil?
     custom_field        = CustomField.new
@@ -48,65 +70,145 @@ class CustomField
     custom_field.values = frag.xpath('values/*').map { |value| value.to_s }
     custom_field
   end
+
+  # Generate a SOAP message fragment for the object.
+  # @param [Handsoap::XmlMason::Node] msg SOAP message to add the object to
+  # @param [String] label tag name used in wrapping tags
+  # @return [Handsoap::XmlMason::Element]
   def soapify_for(msg, label = 'customFieldValues')
     msg.add label do |submsg|
       submsg.add 'customfieldId', @id
-      submsg.add 'key', @key #TODO: see if this is always nil
+      submsg.add 'key', @key
       submsg.add_simple_array 'values', @values
     end
   end
 end
 
+# Represents and issue type. Straight forward.
 class IssueType
   attr_accessor :id, :name, :icon, :description
   attr_writer   :subtask
+
+  # @return [boolean] true if the issue type is a subtask, otherwise false
   def subtask?; @subtask; end
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::IssueType,nil]
   def self.issue_type_with_xml_fragment(frag)
     return if frag.nil?
     issue_type             = IssueType.new
     issue_type.id          = frag.xpath('id').to_s
     issue_type.name        = frag.xpath('name').to_s
-    issue_type.icon        = frag.xpath('icon').to_s #FIXME: NSURL
+    issue_type.icon        = URL.new frag.xpath('icon').to_s
     issue_type.subtask     = frag.xpath('subtask').to_s == 'true'
     issue_type.description = frag.xpath('description').to_s
     issue_type
   end
 end
 
+# Represents a comment. Straight forward.
+class Comment
+  attr_accessor :id, :original_author, :role_level, :group_level, :body
+  attr_accessor :create_date, :last_updated, :update_author
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Comment,nil]
+  def self.comment_with_xml_fragment(frag)
+    return if frag.nil?
+    comment                 = Comment.new
+    comment.id              = frag.xpath('id').to_s
+    comment.original_author = frag.xpath('author').to_s
+    comment.body            = frag.xpath('body').to_s
+    comment.create_date     = Time.xmlschema frag.xpath('created').to_s
+    comment.group_level     = frag.xpath('updateAuthor').to_s
+    comment.role_level      = frag.xpath('roleLevel').to_s
+    comment.update_author   = frag.xpath('updateAuthor').to_s
+    comment.last_updated    = Time.xmlschema frag.xpath('updated').to_s
+    comment
+  end
+
+  # @param [Handsoap::XmlMason::Node] msg
+  # @return [Handsoap::XmlMason::Node]
+  def soapify_for(msg)
+    msg.add 'id', @id
+    msg.add 'author', @original_author
+    msg.add 'body', @body
+    msg.add 'created', @created
+    msg.add 'groupLevel', @group_level
+    msg.add 'roleLevel', @role_level
+    msg.add 'updateAuthor', @update_author
+    msg.add 'updated', @last_updated
+  end
+end
+
+# Represents a status. Straightforward.
 class Status
   attr_accessor :id, :name, :icon, :description
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Status,nil]
   def self.status_with_xml_fragment(frag)
     return if frag.nil?
     status             = Status.new
     status.id          = frag.xpath('id').to_s
     status.name        = frag.xpath('name').to_s
-    status.icon        = frag.xpath('icon').to_s #FIXME: NSURL
+    status.icon        = URL.new frag.xpath('icon').to_s
     status.description = frag.xpath('description').to_s
     status
   end
 end
 
+# Represents a version for a project. Straightforward.
+# @todo find out why we don't get a description for this object
 class Version
   attr_accessor :id, :name, :sequence, :released, :archived, :release_date
   attr_writer   :released, :archived
+
+  # @return [boolean] true if the version has been released, otherwise false
   def released?; @released; end
+
+  # @return [boolean] true if the version has been archive, otherwise false
   def archived?; @archived; end
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Status,nil]
   def self.version_with_xml_fragment(frag)
     return if frag.nil?
-    #TODO: find out why we don't get a description for this type
     version              = Version.new
     version.id           = frag.xpath('id').to_s
     version.name         = frag.xpath('name').to_s
     version.sequence     = frag.xpath('sequence').to_s.to_i
     version.released     = frag.xpath('released').to_s == 'true'
     version.archived     = frag.xpath('archived').to_s == 'true'
-    version.release_date = frag.xpath('releaseDate').to_s #FIXME: NSDate
+    version.release_date = Time.xmlschema frag.xpath('releaseDate')
     version
   end
+
+  # @param [Handsoap::XmlMason::Node] msg
+  # @return [Handsoap::XmlMason::Node]
+  def soapify_for(msg)
+    msg.add 'id', @id
+    msg.add 'name', @name
+    msg.add 'sequence', @sequence
+    msg.add 'released', @released
+    msg.add 'archived', @archived
+    msg.add 'releaseDate', @release_date
+  end
 end
 
+# Represents a scheme used by the server. Not very useful for the sake of the
+# API; a more useful case might be if you wanted to emulate the server's
+# behaviour.
 class Scheme
   attr_accessor :id, :name, :type, :description
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Scheme,nil]
   def self.scheme_with_xml_fragment(frag)
     return if frag.nil?
     scheme             = Scheme.new
@@ -118,8 +220,13 @@ class Scheme
   end
 end
 
+# Represents a component description for a project. Straightforward.
 class Component
   attr_accessor :id, :name
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Component,nil]
   def self.component_with_xml_fragment(frag)
     return if frag.nil?
     component      = Component.new
@@ -129,20 +236,25 @@ class Component
   end
 end
 
+# Represents a project configuration. NOT straightforward.
+# @todo find out why the server always seems to pass nil for schemes
 class Project
   attr_accessor :id, :name, :key, :url, :project_url, :lead, :description
   attr_accessor :issue_security_scheme, :notification_scheme, :permission_scheme
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Project,nil]
   def self.project_with_xml_fragment(frag)
     return if frag.nil?
     project = Project.new
     project.id                    = frag.xpath('id').to_s
     project.name                  = frag.xpath('name').to_s
     project.key                   = frag.xpath('key').to_s
-    project.url                   = frag.xpath('url').to_s #FIXME: NSURL
-    project.project_url           = frag.xpath('projectUrl').to_s #FIXME: NSURL
+    project.url                   = URL.new frag.xpath('url').to_s
+    project.project_url           = URL.new frag.xpath('projectUrl').to_s
     project.lead                  = frag.xpath('lead').to_s
     project.description           = frag.xpath('description').to_s
-    #TODO: find out why the server always seems to pass nil
     project.issue_security_scheme =
       Scheme.scheme_with_xml_fragment frag.xpath 'issueSecurityScheme'
     project.notification_scheme   =
@@ -151,12 +263,32 @@ class Project
       Scheme.scheme_with_xml_fragment frag.xpath 'permissionScheme'
     project
   end
+
+  # @todo encode the schemes
+  # @param [Handsoap::XmlMason::Node] msg
+  # @return [Handsoap::XmlMason::Node]
+  def soapify_for(msg)
+    msg.add 'id', @id
+    msg.add 'name', @name
+    msg.add 'key', @key
+    msg.add 'url', @url
+    msg.add 'projectUrl', @project_url
+    msg.add 'lead', @lead
+    msg.add 'description', @description
+  end
 end
 
+# Contains a base64 encoded avatar image and some metadata. Straightforward.
 class Avatar
   attr_accessor :id, :owner, :type, :content_type, :base64_data
   attr_writer   :system
+
+  # @return [boolean] true if avatar is the default system avatar, else false
   def system?; @system; end
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Avatar,nil]
   def self.avatar_with_xml_fragment(frag)
     return if frag.nil?
     avatar              = Avatar.new
@@ -170,14 +302,24 @@ class Avatar
   end
 end
 
-#easily the most convoluted structure in the API
-#will most likely be the greatest source of bugs
+# Represents a JIRA issue; easily the most convoluted structure in the API.
+# This structure and anything related directly to it will most likely be the
+# greatest source of bugs.
+#
+# The irony of the situation is that this structure is also the most critical
+# to have in working order.
+#
+# Issues with an UNRESOLVED status will have nil for the value of @resolution.
 class Issue
   attr_accessor :id, :key, :summary, :description, :type_id, :last_updated
   attr_accessor :votes, :status_id, :assignee_name, :reporter_name, :priority_id
   attr_accessor :project_name, :affects_versions, :create_date, :due_date
   attr_accessor :fix_versions, :resolution_id, :environment, :components
   attr_accessor :attachment_names, :custom_field_values
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Issue,nil]
   def self.issue_with_xml_fragment(frag)
     return if frag.nil?
     issue                     = Issue.new
@@ -201,28 +343,42 @@ class Issue
     issue.summary             = frag.xpath('summary').to_s
     issue.description         = frag.xpath('description').to_s
     issue.type_id             = frag.xpath('type').to_s
-    issue.last_updated        = frag.xpath('updated').to_s
+    issue.last_updated        = Time.xmlschema frag.xpath('updated').to_s
     issue.votes               = frag.xpath('votes').to_s.to_i
     issue.status_id           = frag.xpath('status').to_s
     issue.assignee_name       = frag.xpath('assignee').to_s
     issue.reporter_name       = frag.xpath('reporter').to_s
     issue.priority_id         = frag.xpath('priority').to_s
     issue.project_name        = frag.xpath('project').to_s
-    issue.create_date         = frag.xpath('created').to_s #FIXME: NSDate
-    issue.due_date            = frag.xpath('duedate').to_s #FIXME: NSDate
+    issue.create_date         = Time.xmlschema frag.xpath('created').to_s
+    issue.due_date            = Time.xmlschema frag.xpath('duedate').to_s
     issue.resolution_id       = frag.xpath('resolution').to_s
     issue.environment         = frag.xpath('environment').to_s
     issue
   end
-  #can you spot the oddities and inconsistencies? (hint: there are many)
-  def soapify_for(msg)
-    #we don't both including fields that are ignored
-      #I tried to only ignore fields that will never be needed at creation
-      #but I may have messed up. It should be easy to fix :)
-    #we don't wrap the whole thing in 'issue' tags for #create_issue calls
-      #this is an inconsistency in the way jiraSOAP works
-      #but you'll probably never know unless you read the source
 
+  # Generate the SOAP message fragment for an issue. Can you spot the oddities
+  # and inconsistencies? (hint: there are many).
+  #
+  # We don't bother including fields that are ignored. I tried to only
+  # ignore fields that will never be needed at creation time, but I may have
+  # messed up.
+  #
+  # We don't wrap the whole thing in 'issue' tags for
+  # {#RemoteAPI#create_issue_with_issue} calls; this is an inconsistency in the
+  # way jiraSOAP works and may need to be worked around for other {RemoteAPI}
+  # methods.
+  #
+  # Servers only seem to accept issues if components/versions are just ids
+  # and do not contain the rest of the {JIRA::Component}/{JIRA::Version}
+  # structure.
+  #
+  # To get the automatic assignee we pass '-1' as the value for @assignee.
+  #
+  # Passing an environment/due date field with a value of nil causes the
+  # server to complain about the formatting of the message.
+  # @param [Handsoap::XmlMason::Node] msg  message the node to add the object to
+  def soapify_for(msg)
     #might be going away, since it appears to have no effect at creation time
     msg.add 'reporter', @reporter_name unless @reporter.nil?
 
@@ -233,7 +389,6 @@ class Issue
     msg.add 'summary', @summary
     msg.add 'description', @description
 
-    #server only accepts issues if components/versions are just ids
     msg.add 'components' do |submsg|
       (@components || []).each { |component|
         submsg.add 'components' do |component_msg|
@@ -255,19 +410,21 @@ class Issue
       }
     end
 
-    #-1 is the value you send to get the automatic assignee
     msg.add 'assignee', (@assignee_name || '-1')
-
     msg.add_complex_array 'customFieldValues', (@custom_field_values || [])
 
-    #passing environment/due_date when nil seems to mess up the server
     msg.add 'environment', @environment unless @environment.nil?
-    msg.add 'duedate', @due_date unless @due_date.nil?
+    msg.add 'duedate', @due_date.xmlschema unless @due_date.nil?
   end
 end
 
+# Contains the basic information about a user. Straightforward.
 class User
   attr_accessor :name, :full_name, :email
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::User,nil]
   def self.user_with_xml_fragment(frag)
     return if frag.nil?
     user           = User.new
@@ -278,14 +435,25 @@ class User
   end
 end
 
+# A structure that is a bit of a hack. It is essentially just a key-value pair
+# that is used mainly by {RemoteAPI#update_issue}.
 class FieldValue
   attr_accessor :id, :values
+
+  # Factory method that gives you a nil value for the given id.
+  # @param [String] id name of the field for @values
+  # @return [JIRA::FieldValue] Will always have @values = [nil]
   def self.field_value_with_nil_values(id)
     fv = FieldValue.new
     fv.id = id
     fv.values = [nil]
     fv
   end
+
+  # Generate the SOAP message fragment for a field value.
+  # @param [Handsoap::XmlMason::Node] message the node to add the object to
+  # @param [String] label name for the tags that wrap the message
+  # @return [Handsoap::XmlMason::Element]
   def soapify_for(message, label = 'fieldValue')
     message.add label do |message|
       message.add 'id', @id
@@ -294,4 +462,85 @@ class FieldValue
   end
 end
 
+# Only contains the meta-data for an attachment. The URI for an attachment
+# appears to be of the form
+# $ENDPOINT_URL/secure/attachment/$ATTACHMENT_ID/$ATTACHMENT_FILENAME
+class AttachmentMetadata
+  attr_accessor :id, :author, :create_date, :filename, :file_size, :mime_type
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Attachment,nil]
+  def self.attachment_with_xml_fragment(frag)
+    return if frag.nil?
+    attachment             = Attachment.new
+    attachment.id          = frag.xpath('id').to_s
+    attachment.author      = frag.xpath('author').to_s
+    attachment.create_date = Time.xmlschema frag.xpath('created').to_s
+    attachment.filename    = frag.xpath('filename').to_s
+    attachment.file_size   = frag.xpath('filesize').to_s.to_i
+    attachment.mime_type   = frag.xpath('mimetype').to_s
+    attachment
+  end
+end
+
+# Only contains basic information about the endpoint server.
+class ServerInfo
+  attr_accessor :base_url, :build_date, :build_number, :edition
+  attr_accessor :server_time, :version
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::ServerInfo,nil]
+  def self.server_info_with_xml_fragment(frag)
+    return if frag.nil?
+    server_info = ServerInfo.new
+    server_info.base_url     = URL.new frag.xpath('baseUrl').to_s
+    server_info.build_date   = Time.xmlschema frag.xpath('buildDate').to_s
+    server_info.build_number = frag.xpath('buildNumber').to_s.to_i
+    server_info.edition      = frag.xpath('edition').to_s
+    server_info.version      = frag.xpath('version').to_s
+    server_info.server_time  =
+      TimeInfo.time_info_with_xml_fragment frag.xpath 'serverTime'
+    server_info
+  end
+end
+
+# Simple structure for a time and time zone; used oddly.
+class TimeInfo
+  attr_accessor :server_time, :timezone
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::TimeInfo,nil]
+  def self.time_info_with_xml_fragment(frag)
+    return if frag.nil?
+    time_info             = TimeInfo.new
+    time_info.server_time = Time.parse frag.xpath('serverTime').to_s
+    time_info.timezone    = frag.xpath('timeZoneId').to_s
+    time_info
+  end
+end
+
+# Represents a filter
+# @todo find out what @project is supposed to be for
+class Filter
+  attr_accessor :id, :name, :author, :project, :description, :xml
+
+  # Factory method that takes a fragment of a SOAP response.
+  # @param [Handsoap::XmlQueryFront::NokogiriDriver] frag
+  # @return [JIRA::Filter,nil]
+  def self.filter_with_xml_fragment(frag)
+    return if frag.nil?
+    filter             = Filter.new
+    filter.id          = frag.xpath('id').to_s
+    filter.name        = frag.xpath('name').to_s
+    filter.author      = frag.xpath('author').to_s
+    filter.project     = frag.xpath('project').to_s
+    filter.description = frag.xpath('description').to_s
+    filter.xml         = frag.xpath('xml').to_s
+    filter
+  end
+end
+
 end

data/lib/jiraSOAP/url.rb

@@ -0,0 +1,21 @@
+# A bit of a hack to support using an NSURL in MacRuby while still supporting
+# MRI by using the URI module.
+#
+# I suggest not thinking about it too much beyond this point: this is a
+# URI object if you are running on CRuby, but it will be an NSURL if you
+# are running on MacRuby.
+class URL
+  attr_accessor :url
+
+  # Initializes @url with the correct object type.
+  # @param [String] url string to turn into some kind of URL object
+  # @return [URI::HTTP,NSURL] URI::HTTP on CRuby, NSURL on MacRuby
+  def initialize(url)
+    @url = URI.parse url
+  end
+
+  # The magic of the hack, passing everything to the level beneath.
+  def method_missing(method, *args)
+    @url.send method, *args
+  end
+end

data/lib/jiraSOAP.rb

@@ -1,7 +1,9 @@
-#TODO: set a requirement on the handsoap version
 require 'handsoap'
 require 'logger'
+require 'time'
+require 'uri'
 
+require 'jiraSOAP/url.rb'
 require 'jiraSOAP/handsoap_extensions.rb'
 require 'jiraSOAP/remoteEntities.rb'
 require 'jiraSOAP/remoteAPI.rb'

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 1
   - 2
-  version: 0.1.2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Mark Rada
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-06 00:00:00 -04:00
+date: 2010-10-12 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -32,7 +32,7 @@ dependencies:
   type: :runtime
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
-  name: minitest
+  name: nokogiri
   prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
@@ -42,8 +42,34 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  type: :development
+  type: :runtime
   version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: minitest
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
 description: Written to run fast and work on Ruby 1.9 as well as MacRuby
 email: mrada@marketcircle.com
 executables: []
@@ -60,6 +86,7 @@ files:
 - lib/jiraSOAP/macruby_stuff.rb
 - lib/jiraSOAP/remoteAPI.rb
 - lib/jiraSOAP/remoteEntities.rb
+- lib/jiraSOAP/url.rb
 - LICENSE
 - README.markdown
 - test/jiraSOAP_test.rb