taskmapper-rally 0.3.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rbenv-gemsets

@@ -0,0 +1 @@
+ticketmaster-rally

data/.rspec

@@ -0,0 +1 @@
+--color

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.9.2@taskmapper-rally --create

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2

data/Gemfile

@@ -0,0 +1,20 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+
+gem "taskmapper", "~> 0.8"
+gem "rally_rest_api", "~> 1.0"
+
+group :development do
+  gem "rspec", "~> 2.3"
+  gem "yard", "~> 0.7"
+  gem "jeweler", "~> 1.5"
+  gem "fakeweb", "~> 1.3"
+  gem "vcr", "~> 1.11" 
+  gem 'ruby-debug', :platform => [:ruby_18]
+  gem 'ruby-debug19', :platform => [:ruby_19]
+end

data/Gemfile.lock

@@ -0,0 +1,80 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activemodel (3.2.3)
+      activesupport (= 3.2.3)
+      builder (~> 3.0.0)
+    activeresource (3.2.3)
+      activemodel (= 3.2.3)
+      activesupport (= 3.2.3)
+    activesupport (3.2.3)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    archive-tar-minitar (0.5.2)
+    builder (3.0.0)
+    columnize (0.3.6)
+    diff-lcs (1.1.3)
+    fakeweb (1.3.0)
+    git (1.2.5)
+    hashie (1.2.0)
+    i18n (0.6.0)
+    jeweler (1.8.3)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.6.5)
+    linecache (0.46)
+      rbx-require-relative (> 0.0.4)
+    linecache19 (0.5.12)
+      ruby_core_source (>= 0.1.4)
+    multi_json (1.3.5)
+    rake (0.9.2.2)
+    rally_rest_api (1.0.3)
+    rbx-require-relative (0.0.9)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+    ruby-debug-base19 (0.11.25)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby_core_source (>= 0.1.4)
+    ruby-debug19 (0.11.6)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby-debug-base19 (>= 0.11.19)
+    ruby_core_source (0.1.5)
+      archive-tar-minitar (>= 0.5.2)
+    taskmapper (0.8.0)
+      activeresource (~> 3.0)
+      activesupport (~> 3.0)
+      hashie (~> 1.2)
+    vcr (1.11.3)
+    yard (0.7.5)
+
+PLATFORMS
+  ruby
+  x86-mingw32
+
+DEPENDENCIES
+  fakeweb (~> 1.3)
+  jeweler (~> 1.5)
+  rally_rest_api (~> 1.0)
+  rspec (~> 2.3)
+  ruby-debug
+  ruby-debug19
+  taskmapper (~> 0.8)
+  vcr (~> 1.11)
+  yard (~> 0.7)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Simeon F. Willbanks, Rob Kaufman
+
+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,65 @@
+# taskmapper-rally
+
+This is a provider for [taskmapper](http://ticketrb.com). It provides interoperability with [Rally](http://www.rallydev.com/) and it's project planning system through the taskmapper gem.
+
+# Usage and Examples
+
+First we have to instantiate a new taskmapper instance, your Rally installation should have api access enable:
+
+      rally = taskmapper.new(:rally, {:username=> 'foo', 
+                                        :password => "bar", 
+                                        :url => "https://community.rallydev.com/slm"}) 
+
+If you do not pass in the url, username and password, you won't get any information.
+
+## Finding Projects(Projects)
+
+    rally = taskmapper.new(:rally, {:url => 'https://community.rallydev.com/slm', 
+                                             :username => 'foo', 
+                                             :password => 'bar'})
+    # Project with ID of 1
+    project = rally.project(1)
+    # Projects with IDs of 1 and 2
+    projects = rally.project([1,2])
+	
+## Finding Tickets(Defects,Tasks)
+
+    # Ticket with ID of 1
+    ticket = project.ticket(1)
+    # Tickets with ID's of 1 and 2
+    tickets = project.tickets([1,2])
+    # All tickets
+    tickets = project.tickets
+
+## Open Tickets
+    
+    # Create a new ticket
+    ticket = project.ticket!(:title => 'New Ticket', 
+                             :description => 'Description')
+
+## Finding comments
+  
+    # Finding all comments 
+    comments = ticket.comments
+    # Finding a comment with ID 1
+    comment = ticket.comment(1)
+  
+## Requirements
+
+* rubygems (obviously)
+* taskmapper gem (latest version preferred)
+* rally_rest_api
+* logger (only if you want Rally REST API to log activity)
+
+## Other Notes
+
+Since this and the taskmapper gem is still primarily a work-in-progress, minor changes may be incompatible with previous versions. Please be careful about using and updating this gem in production.
+
+If you see or find any issues, feel free to open up an issue report.
+
+## Copyright
+
+Copyright (c) 2011 Simeon F. Willbanks. See LICENSE.txt for
+further details.
+
+

data/Rakefile

@@ -0,0 +1,43 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "taskmapper-rally"
+  gem.homepage = "http://github.com/simeonwillbanks/taskmapper-rally"
+  gem.license = "MIT"
+  gem.summary = %Q{taskmapper provider for Rally's Ruby REST API}
+  gem.description = %Q{This is a provider for taskmapper. It provides interoperability with Rally and it's project planning system through the taskmapper gem}
+  gem.email = ["sfw@simeonfosterwillbanks.com", "rob@notch8.com", "george.rafael@gmail.com"]
+  gem.authors = ["Simeon F. Willbanks", "Rob Kaufman", "Rafael George"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  #  gem.add_runtime_dependency 'jabber4r', '> 0.1'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.3.0

data/lib/provider/comment.rb

@@ -0,0 +1,118 @@
+module TaskMapper::Provider
+  module Rally
+    # The comment class for taskmapper-rally
+    #
+    # Remaps 
+    #
+    # id => oid
+    # author => user_name
+    # body => text
+    # created_at => creation_date
+    # updated_at => creation_date    
+    class Comment < TaskMapper::Provider::Base::Comment
+      
+      def initialize(*object)
+        if object.first
+          args = object
+          comment = args.shift
+          project_id = args.shift
+          ticket_id = args.shift
+          @system_data = {:client => comment}
+          hash = {
+            :oid         => comment.oid,
+            :project_id  => project_id,
+            :ticket_id   => ticket_id,
+            :author      => comment.user_name,
+            :body        => comment.text,
+            :created_at  => comment.creation_date,
+            :updated_at  => comment.creation_date,
+            :post_number => comment.post_number,
+          }
+          super(hash)
+        end
+      end
+
+      def created_at
+        Time.parse(self[:created_at])
+      end
+
+      def updated_at
+        Time.parse(self[:updated_at])
+      end
+
+      # Rally REST API aliases String and Fixnum :to_q :to_s
+      # However, it does not alias Bignum
+      # If a ID is a Bignum, the API will throw undefined method
+      # Because of this, we pass all IDs to API as strings
+      # taskmapper specs set IDs as integers, so coerce type on get 
+      def id
+        self[:oid].to_i
+      end
+
+      def id=(id)
+        self[:oid] = id.to_s
+      end 
+
+      def self.find_by_id(project_id, ticket_id, id)
+        project = self.rally_project(project_id)
+        # Rally Ruby REST API expects IDs as strings
+        # For id.to_s see note on Project::id
+        query_result = TaskMapper::Provider::Rally.rally.find(:conversation_post, :fetch => false, :project => project) { equal :object_i_d, id.to_s }
+        self.new query_result.first, project_id
+      end
+
+      # Accepts a project id, ticket id and attributes hash and returns all 
+      # comments matching the project, ticket and those attributes in an array
+      # Should return all ticket comments if the attributes hash is empty
+      def self.find_by_attributes(project_id, ticket_id, attributes = {})
+        self.search(project_id, ticket_id, attributes)
+      end            
+      
+      # This is a helper method to find
+      def self.search(project_id, ticket_id, options = {}, limit = 1000)
+        project = self.rally_project(project_id)
+        artifact = project.ticket(:id => ticket_id.to_s)
+        query_result = TaskMapper::Provider::Rally.rally.find_all(:conversation_post, :project => project) { equal :artifact, artifact }
+        comments = query_result.collect do |comment| 
+          self.new comment, project_id, ticket_id
+        end
+        search_by_attribute(comments, options, limit)
+      end
+      
+      def self.create(*options)
+        options = options.shift
+        project = provider_parent(self)::Project.find_by_id(options[:project_id])
+        ticket = provider_parent(self)::Ticket.find_by_id(options[:project_id], options[:ticket_id])
+        comment = {
+          :project => project.system_data[:client],
+          :artifact => ticket.system_data[:client],
+          :text => options[:body]
+        }
+        new_comment = TaskMapper::Provider::Rally.rally.create(:conversation_post, comment)
+        self.new new_comment
+      end
+      
+      private
+      
+        def self.rally_project(project_id)
+          taskmapper_project = provider_parent(self)::Project.find_by_id(project_id)
+          taskmapper_project.system_data[:client]
+        end
+              
+        def self.to_rally_object(hash)
+          ticket = {
+            :name => hash[:title],
+            :description => hash[:description],
+            :schedule_state => hash[:resolution] ||= "Defined", 
+            :state => hash[:status] ||= "Submitted"     
+          }
+          # Rally optional attributes
+          ticket[:submitted_by] = hash[:requestor] if hash[:requestor]
+          ticket[:owner] = hash[:assignee] if hash[:assignee]
+          ticket[:priority] = hash[:priority] if hash[:priority]
+          ticket[:work_product] = hash[:work_product] if hash[:work_product]
+          ticket          
+        end
+    end
+  end
+end

data/lib/provider/project.rb

@@ -0,0 +1,86 @@
+module TaskMapper::Provider
+  module Rally
+    # Project class for taskmapper-rally
+    #
+    # Remaps 
+    #
+    # id => oid
+    # created_at => creation_date
+    # updated_at => creation_date
+    class Project < TaskMapper::Provider::Base::Project
+
+      def initialize(*object)
+        if object.first
+          project = object.first
+          # Store Rally Project object in taskmapper Project object
+          # This allows taskmapper to perform updates on Rally Project
+          @system_data = {:client => project}
+          hash = {:oid => project.oid, 
+                  :name => project.name, 
+                  :description => project.description,
+                  :created_at => project.creation_date, 
+                  # Rally Project object does not have a modified time
+                  :updated_at => project.creation_date}           
+          super hash
+        end
+      end
+
+      def created_at
+        Time.parse(self[:created_at])
+      end
+
+      def updated_at
+        Time.parse(self[:updated_at])
+      end
+
+      # Rally REST API aliases String and Fixnum :to_q :to_s
+      # However, it does not alias Bignum
+      # If a ID is a Bignum, the API will throw undefined method
+      # Because of this, we pass all IDs to API as strings
+      # taskmapper specs set IDs as integers, so coerce type on get 
+      def id
+        self[:oid].to_i
+      end
+
+      def id=(id)
+        self[:oid] = id.to_s
+      end      
+
+      # Accepts an integer id and returns the single project instance
+      def self.find_by_id(id)
+        # Rally Ruby REST API expects IDs as strings
+        # For id.to_s see note on Project::id
+        query_result = TaskMapper::Provider::Rally.rally.find(:project, :fetch => true) { equal :object_i_d, id.to_s }
+        self.new query_result.first
+      end
+      
+      # Accepts an attributes hash and returns all projects matching those attributes in an array
+      # Should return all projects if the attributes hash is empty
+      def self.find_by_attributes(attributes = {})
+        self.search(attributes)
+      end            
+      
+      # This is a helper method to find
+      def self.search(options = {}, limit = 1000)
+        projects = TaskMapper::Provider::Rally.rally.find_all(:project).collect do |project| 
+          self.new project
+        end
+        search_by_attribute(projects, options, limit)
+      end      
+      
+      # copy from this.copy(that) copies that into this
+      def copy(project)
+        project.tickets.each do |ticket|
+          copy_ticket = self.ticket!(:title => ticket.title, :description => ticket.description)
+          ticket.comments.each do |comment|
+            copy_ticket.comment!(:body => comment.body)
+            sleep 1
+          end
+        end
+      end
+
+    end
+  end
+end
+
+